plymouth - Man Page
Send commands to plymouthd
Synopsis
plymouth [OPTION...]
plymouth COMMAND [OPTION...]
Description
The plymouth sends commands to a running plymouthd. This is used during the boot process to control the display of the graphical boot splash.
Options
The following options are understood. These options are supported for compatibility with the old rhgb-client interface, and have been replaced by the commands that are described in the next section.
- --help
- Show summary of options. 
- --debug
- Enable verbose debug logging. 
- --get-splash-plugin-path
- Get directory where splash plugins are installed. 
- --newroot=[STRING]
- Tell plymouthd that the new root filesystem is mounted. 
- --quit
- Tell plymouthd to quit. 
- --ping
- Check if plymouthd is running. 
- --has-active-vt
- Check if plymouthd has an active vt. 
- --sysinit
- Tell plymouthd root filesystem is mounted read-write. 
- --show-splash
- Show the splash screen. 
- --hide-splash
- Hide the splash screen. 
- --ask-for-password
- Ask the user for a password. 
- --ignore-keystroke=[STRING]
- Remove sensitivity to a keystroke. 
- --update=[STRING]
- Tell plymouthd an update about boot progress. 
- --details
- Tell plymouthd there were errors during boot. 
- --wait
- Wait for plymouthd to quit. 
Commands
The following commands are understood:
- change-mode OPTION
- Change the operation mode. - --boot-up
- Start the system up 
- --shutdown
- Shutting the system up 
- --updates
- Applying updates 
 
- system-update OPTION
- Tell plymouthd about boot progress. - --progress=INTEGER
- The percentage progress of the updates 
 
- update OPTION
- Tell plymouthd about boot status changes. - --status=STRING
- Tell plymouthd the current boot status 
 
- update-root-fs OPTION
- Tell plymouthd about root filesystem changes. - --new-root-dir=STRING
- Root filesystem is about to change 
- --read-write
- Root filesystem is no longer read-only 
 
- show-splash
- Tell plymouthd to show splash screen. 
- hide-splash
- Tell plymouthd to hide splash screen. 
- ask-for-password OPTION
- Ask the user for a password. - --command=STRING
- Command to send password to via standard input 
- --prompt=STRING
- Message to display when asking for password 
- --number-of-tries=INTEGER
- Number of times to ask before giving up (requires --command) 
- --dont-pause-progress
- Don't pause boot progress bar while asking 
 
- ask-question
- Ask the user a question. - --command=STRING
- Command to send the answer to via standard input 
- --prompt=STRING
- Message to display when asking the question 
- --dont-pause-progress
- Don't pause boot progress bar while asking 
 
- display-message OPTION
- Display a message. - --text=STRING
- The message text 
 
- hide-message OPTION
- Hide a message. - --text=STRING
- The message text 
 
- watch-keystroke OPTION
- Become sensitive to a keystroke. - --command=STRING
- Command to send keystroke to via standard input 
- --keys=STRING
- Keys to become sensitive to 
 
- ignore-keystroke OPTION
- Remove sensitivity to a keystroke. - --keys=STRING
- Keys to remove sensitivity from 
 
- pause-progress
- Pause boot progress bar. 
- unpause-progress
- Unpause boot progress bar. 
- report-error
- Tell plymouthd there were errors during boot. 
- deactivate
- Tell plymouthd to deactivate. 
- reactivate
- Tell plymouthd to reactivate. 
- quit OPTION
- Tell plymouthd to quit. - --retain-splash
- Don't explicitly hide boot splash on exit 
 
See Also
grub(8), plymouth(8), plymouthd(8), http://www.freedesktop.org/wiki/Software/Plymouth