plymouth(1)

NAME

   plymouth - 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 sensitivitiy 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

---

Free and Open Source Software