Magellan Linux

  • Back to homepage
    • /[magellan-source]/tags/grubby-8_40_20170706/grubby.8

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

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

    revision 1332 by niro, Fri Jun 3 20:32:19 2011 UTC revision 3008 by niro, Tue Jun 27 14:29:11 2017 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] [--set-index=\fIentry-index\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 42  with that title are used. Line 49  with that title are used.
    49  Add a new boot entry for the kernel located at \fIkernel-path\fR.  Add a new boot entry for the kernel located at \fIkernel-path\fR.
    50    
    51  .TP  .TP
    52    \fB-\-set-index\fR=\fIentry-index\fR
    53    Set the position at which to add a new entry created with \fB-\-add-kernel\fR.
    54    
    55    .TP
    56  \fB-\-args\fR=\fIkernel-args\fR  \fB-\-args\fR=\fIkernel-args\fR
    57  When a new kernel is added, this specifies the command line arguments  When a new kernel is added, this specifies the command line arguments
    58  which should be passed to the kernel by default (note they are merged  which should be passed to the kernel by default (note they are merged
    # Line 94  root device) as possible from the curren Line 105  root device) as possible from the curren
    105  and initrd path will never be copied.  and initrd path will never be copied.
    106    
    107  .TP  .TP
    108    \fB-\-debug\fR
    109    Display extra debugging information for failures.
    110    
    111    .TP
    112  \fB-\-default-kernel\fR  \fB-\-default-kernel\fR
    113  Display the full path to the current default kernel and exit.  Display the full path to the current default kernel and exit.
    114    
    115  .TP  .TP
    116    \fB-\-default-index\fR
    117    Display the numeric index of the current default boot entry and exit.
    118    
    119    .TP
    120    \fB-\-default-title\fR
    121    Display the title of the current default boot entry and exit.
    122    
    123    .TP
    124    \fB-\-devtree\fR=\fIpath\fR
    125    Use \fIpath\fR for device tree path in place of the path of any devicetree
    126    directive found in the template stanza.
    127    
    128    .TP
    129  \fB-\-elilo\fR  \fB-\-elilo\fR
    130  Use an \fBelilo\fR style configuration file.  Use an \fBelilo\fR style configuration file.
    131    
    # Line 142  The first entry which boots the specifie Line 170  The first entry which boots the specifie
    170  boot entry.  boot entry.
    171    
    172  .TP  .TP
    173    \fB-\-set-default-index\fR=\fIentry-index\fR
    174    Makes the given entry number the default boot entry.
    175    
    176    .TP
    177  \fB-\-title\fR=\fIentry-title\fR  \fB-\-title\fR=\fIentry-title\fR
    178  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
    179  (\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.1332  
    changed lines
      Added in v.3008