Magellan Linux

Diff of /tags/grubby-8_40_20170706/grubby.8

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1721 by niro, Sat Feb 18 00:52:28 2012 UTC revision 2966 by niro, Wed Jun 29 14:53:04 2016 UTC
# Line 1  Line 1 
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         [--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
# Line 94  root device) as possible from the curren Line 100  root device) as possible from the curren
100  and initrd path will never be copied.  and initrd path will never be copied.
101    
102  .TP  .TP
103    \fB-\-debug\fR
104    Display extra debugging information for failures.
105    
106    .TP
107  \fB-\-default-kernel\fR  \fB-\-default-kernel\fR
108  Display the full path to the current default kernel and exit.  Display the full path to the current default kernel and exit.
109    
# Line 106  Display the numeric index of the current Line 116  Display the numeric index of the current
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    
# Line 150  The first entry which boots the specifie Line 165  The first entry which boots the specifie
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

Legend:
Removed from v.1721  
changed lines
  Added in v.2966