1 |
.TH GRUBBY 8 "Tue Jan 18 2005" |
.TH GRUBBY 8 "Tue Jan 18 2005" |
2 |
.SH NAME |
.SH NAME |
3 |
grubby \- command line tool for configuring grub, lilo, and elilo |
grubby \- command line tool for configuring grub, lilo, elilo, yaboot and zipl |
4 |
|
|
5 |
.SH SYNOPSIS |
.SH SYNOPSIS |
6 |
\fBgrubby\fR [--add-kernel=\fIkernel-path\fR] [--args=\fIargs\fR] |
\fBgrubby\fR [--add-kernel=\fIkernel-path\fR] [--args=\fIargs\fR] |
7 |
[--bad-image-okay] [--boot-filesystem=\fIbootfs\fR] |
[--bad-image-okay] [--boot-filesystem=\fIbootfs\fR] |
8 |
[--bootloader-probe] [--config-file \fIpath\fR] [--copy-default] |
[--bootloader-probe] [--config-file \fIpath\fR] [--copy-default] |
9 |
[--debug] [--default-kernel] [--default-index] [--default-title] |
[--debug] [--default-kernel] [--default-index] [--default-title] |
10 |
|
[--devtree=\fIdevicetree.dtb\fR] |
11 |
[--grub] [--lilo] [--yaboot] [--silo] [--zipl] |
[--grub] [--lilo] [--yaboot] [--silo] [--zipl] |
12 |
[--info=\fIkernel-path\fR] [--initrd=\fIinitrd-path\fR] |
[--info=\fIkernel-path\fR] [--initrd=\fIinitrd-path\fR] |
13 |
[--make-default] [-o path] [--version] |
[--make-default] [-o path] [--version] |
14 |
[--remove-kernel=\fIkernel-path\fR] [--remove-args=\fIargs\fR] |
[--remove-kernel=\fIkernel-path\fR] [--remove-args=\fIargs\fR] |
15 |
[--set-default=\fIkernel-path\fR] [--title=entry-title] |
[--set-default=\fIkernel-path\fR] [--set-default-index=\fientry-index\fR] |
16 |
[--add-multiboot=\fImultiboot-path\fR] [--mbargs=\fIargs\fR] |
[--title=entry-title] [--add-multiboot=\fImultiboot-path\fR] |
17 |
[--remove-multiboot=\fImultiboot-path\fR] [--remove-mbargs=\fIargs\fR] |
[--mbargs=\fIargs\fR] [--remove-multiboot=\fImultiboot-path\fR] |
18 |
|
[--remove-mbargs=\fIargs\fR] |
19 |
|
|
20 |
.SH DESCRIPTION |
.SH DESCRIPTION |
21 |
\fBgrubby\fR is a command line tool for updating and displaying information |
\fBgrubby\fR is a command line tool for updating and displaying information |
22 |
about the configuration files for the \fBgrub\fR, \fBlilo\fR, \fBelilo\fR |
about the configuration files for the \fBgrub\fR, \fBlilo\fR, \fBelilo\fR |
23 |
(ia64), \fByaboot\fR (powerpc) and \fBzipl\fR (s390) boot loaders. It |
(ia64), \fByaboot\fR (powerpc) and \fBzipl\fR (s390) boot loaders. It |
24 |
is primarily designed to be used from scripts which install new |
is primarily designed to be used from scripts which install new |
25 |
kernels and need to find information about the current boot environment. |
kernels and need to find information about the current boot environment. |
26 |
|
|
27 |
On Intel x86 platforms, \fBgrub\fR is the default bootloader and the |
On BIOS-based Intel x86 platforms, \fBgrub2\fR is the default bootloader and |
28 |
configuration file is in \fB/boot/grub/grub.conf\fR. On Intel ia64 platforms, |
the configuration file is in \fB/boot/grub2/grub.cfg\fR. On UEFI-based Intel |
29 |
\fBelilo\fR mode is used and the default location for the configuration file |
x86 platforms, \fBgrub2\fR is the default bootloader, and the configuration |
30 |
is \fB/boot/grub/grub.conf\fR. On PowerPC platforms, \fByaboot\fR parsing |
file is in \fB/boot/efi/EFI/redhat/grub.cfg\fR. On Intel ia64 platforms, |
31 |
is used and the configuration file should be in \fB/etc/yaboot.conf\fR. |
\fBelilo\fR mode is used and the default location for the configuration file |
32 |
|
is \fB/boot/efi/EFI/redhat/elilo.conf\fR. On PowerPC platforms, systems based |
33 |
|
on Power8 now support \fBgrub2\fR as a bootloader and store using a default |
34 |
|
config stored in \fB/boot/grub2/grub.cfg\fR. The earlier Power7 systems use \fByaboot\fR |
35 |
|
parsing and the configuration file should be in \fB/etc/yaboot.conf\fR. |
36 |
|
|
37 |
There are a number of ways to specify the kernel used for \fB-\-info\fR, |
There are a number of ways to specify the kernel used for \fB-\-info\fR, |
38 |
\fB-\-remove-kernel\fR, and \fB-\-update-kernel\fR. Specificying \fBDEFAULT\fR |
\fB-\-remove-kernel\fR, and \fB-\-update-kernel\fR. Specificying \fBDEFAULT\fR |
116 |
Display the title of the current default boot entry and exit. |
Display the title of the current default boot entry and exit. |
117 |
|
|
118 |
.TP |
.TP |
119 |
|
\fB-\-devtree\fR=\fIpath\fR |
120 |
|
Use \fIpath\fR for device tree path in place of the path of any devicetree |
121 |
|
directive found in the template stanza. |
122 |
|
|
123 |
|
.TP |
124 |
\fB-\-elilo\fR |
\fB-\-elilo\fR |
125 |
Use an \fBelilo\fR style configuration file. |
Use an \fBelilo\fR style configuration file. |
126 |
|
|
165 |
boot entry. |
boot entry. |
166 |
|
|
167 |
.TP |
.TP |
168 |
|
\fB-\-set-default-index\fR=\fIentry-index\fR |
169 |
|
Makes the given entry number the default boot entry. |
170 |
|
|
171 |
|
.TP |
172 |
\fB-\-title\fR=\fIentry-title\fR |
\fB-\-title\fR=\fIentry-title\fR |
173 |
When a new kernel entry is added \fIentry-title\fR is used as the title |
When a new kernel entry is added \fIentry-title\fR is used as the title |
174 |
(\fBlilo\fR label) for the entry. If \fIentry-title\fR is longer then maximum |
(\fBlilo\fR label) for the entry. If \fIentry-title\fR is longer then maximum |