You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
62 lines
2.9 KiB
62 lines
2.9 KiB
\" Hey, EMACS: -*- nroff -*-
|
|
.TH PLYMOUTH 8 "December 15, 2009"
|
|
.SH NAME
|
|
plymouth \- A graphical boot system and logger
|
|
.SH SYNOPSIS
|
|
.B plymouth-set-default-theme
|
|
.RI [ options ] " \<theme\>"
|
|
.SH DESCRIPTION
|
|
\fBplymouth\fP is a graphical boot system for Linux which takes advantage of the kernel-based
|
|
mode setting (KMS) available for modern graphic cards to provide a seamless, flickerfree
|
|
and attractive boot screen. It allows to choose between various, static or
|
|
animated graphical themes to spruce up the startup and avoid the noise
|
|
generated by the vast amount of kernel messages while the machine boots into X.
|
|
On systems where kernel-based mode setting is not available, plymouth falls
|
|
back to a text mode boot screen which provides a simple progress bar to provide
|
|
feedback during boot.
|
|
.PP
|
|
To configure plymouth, that is to choose and install the preferred boot theme, the
|
|
user has to invoke \fBplymouth-set-default-theme\fP. It changes the configuration
|
|
to the new theme and also performs the necessary regeneration of the initial ramdisk
|
|
(initrd) since plymouth is loaded from the boot loader from the initrd
|
|
prior to the mounting of the root filesystem. The options available to this
|
|
script are explained in the \fBOPTIONS\fP paragraph.
|
|
.PP
|
|
In order for the configured default plymouth theme to be loaded during boot,
|
|
the option `splash' (or `rhgb' for backward compatibility with the RHGB boot
|
|
splash) must be provided at the kernel command line. With this command line
|
|
option, plymouth will default to showing detailed boot output.
|
|
.SH OPTIONS
|
|
plymouth-set-default-theme follows the usual GNU command line syntax, with long
|
|
options starting with two dashes (`-') and short variants of each of them.
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show summary of options.
|
|
.TP
|
|
.B \-l, \-\-list
|
|
List available themes.
|
|
.TP
|
|
.B \-r, \-\-reset
|
|
Reset to default theme.
|
|
.TP
|
|
.B \-R, \-\-rebuild\-initrd
|
|
Rebuild initrd (necessary after changing theme).
|
|
.TP
|
|
.B \<theme-name\>
|
|
Name of new theme to use. If you want to see which themes are available, invoke the script with just \-\-list.
|
|
.PP
|
|
If plymouth-set-default-theme is invoked with no options or parameters, it shows the currently selected theme
|
|
by default. This output is used by the helper scripts `plymouth-generate-initrd' and `plymouth-update-initrd'
|
|
to set the proper theme in the initial ramdisk.
|
|
.SH SEE ALSO
|
|
.BR grub (8)
|
|
.br
|
|
.SH AUTHOR
|
|
plymouth was originally prototyped and named by Kristian H�gsberg <krh@bitplanet.net>,
|
|
originally written by Ray Strode <halfline@gmail.com> and has had significant contributions
|
|
from Charlie Brej <cbrej@cs.man.ac.uk>. It has also had contributions from
|
|
Peter Jones <pjones@redhat.com>, Adam Jackson <ajax@nwnk.net>,
|
|
Frederic Crozat <fcrozat@mandriva.com> and others.
|
|
It can be downloaded here: <http://www.freedesktop.org/wiki/Software/Plymouth>.
|
|
.PP
|
|
This manual page was written by Adrian Glaubitz <glaubitz@physik.fu-berlin.de>.
|
|
|