Magellan Linux

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

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

trunk/mkinitrd-magellan/grubby/grubby.8 revision 532 by niro, Sat Sep 1 22:45:15 2007 UTC trunk/grubby/grubby.8 revision 2967 by niro, Wed Jun 29 15:00:53 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]         [--bootloader-probe] [--config-file \fIpath\fR] [--copy-default]
9         [--copy-default] [--default-kernel]         [--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.  On
36    s390 platforms the \fBzipl bootloader\fR will read from \fB/etc/zipl.conf\fR.
37    
38  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,
39  \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 101  root device) as possible from the curren
101  and initrd path will never be copied.  and initrd path will never be copied.
102    
103  .TP  .TP
104    \fB-\-debug\fR
105    Display extra debugging information for failures.
106    
107    .TP
108  \fB-\-default-kernel\fR  \fB-\-default-kernel\fR
109  Display the full path to the current default kernel and exit.  Display the full path to the current default kernel and exit.
110    
111  .TP  .TP
112    \fB-\-default-index\fR
113    Display the numeric index of the current default boot entry and exit.
114    
115    .TP
116    \fB-\-default-title\fR
117    Display the title of the current default boot entry and exit.
118    
119    .TP
120    \fB-\-devtree\fR=\fIpath\fR
121    Use \fIpath\fR for device tree path in place of the path of any devicetree
122    directive found in the template stanza.
123    
124    .TP
125  \fB-\-elilo\fR  \fB-\-elilo\fR
126  Use an \fBelilo\fR style configuration file.  Use an \fBelilo\fR style configuration file.
127    
# Line 142  The first entry which boots the specifie Line 166  The first entry which boots the specifie
166  boot entry.  boot entry.
167    
168  .TP  .TP
169    \fB-\-set-default-index\fR=\fIentry-index\fR
170    Makes the given entry number the default boot entry.
171    
172    .TP
173  \fB-\-title\fR=\fIentry-title\fR  \fB-\-title\fR=\fIentry-title\fR
174  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
175  (\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
# Line 195  kernels specified by \fB-\-update-kernel Line 223  kernels specified by \fB-\-update-kernel
223    
224    
225  .SH "BUGS"  .SH "BUGS"
226  The command line syntax is more then a little baroque. This probably  The command line syntax is more than a little baroque. This probably
227  won't be fixed as \fBgrubby\fR is only intended to be called from shell  won't be fixed as \fBgrubby\fR is only intended to be called from shell
228  scripts which can get it right.  scripts which can get it right.
229    
# Line 207  scripts which can get it right. Line 235  scripts which can get it right.
235    
236  .SH AUTHORS  .SH AUTHORS
237  .nf  .nf
238  Erik Troan <ewt@redhat.com>  Erik Troan
239  Jeremy Katz <katzj@redhat.com>  Jeremy Katz
240    Peter Jones
241  .fi  .fi

Legend:
Removed from v.532  
changed lines
  Added in v.2967