1GRUBBY(8)                   System Manager's Manual                  GRUBBY(8)
2
3
4

NAME

6       grubby - command line tool for configuring grub, lilo, and elilo
7
8

SYNOPSIS

10       grubby [--add-kernel=kernel-path] [--args=args]
11              [--bad-image-okay] [--boot-filesystem=bootfs]
12              [--bootloader-probe] [--config-file path]
13              [--copy-default] [--default-kernel]
14              [--grub] [--lilo] [--yaboot] [--silo] [--zipl]
15              [--info=kernel-path] [--initrd=initrd-path]
16              [--make-default] [-o path] [--version]
17              [--remove-kernel=kernel-path] [--remove-args=args]
18              [--set-default=kernel-path] [--title=entry-title]
19              [--add-multiboot=multiboot-path] [--mbargs=args]
20              [--remove-multiboot=multiboot-path] [--remove-mbargs=args]
21
22

DESCRIPTION

24       grubby  is  a command line tool for updating and displaying information
25       about the configuration files for the grub, lilo, elilo (ia64),  yaboot
26       (powerpc)  and zipl (s390) boot loaders. It is primarily designed to be
27       used from scripts which install new kernels and need to  find  informa‐
28       tion about the current boot environment.
29
30       On Intel x86 platforms, grub is the default bootloader and the configu‐
31       ration file is in /boot/grub/grub.conf. On Intel ia64 platforms,  elilo
32       mode  is  used  and  the default location for the configuration file is
33       /boot/grub/grub.conf. On PowerPC platforms, yaboot parsing is used  and
34       the configuration file should be in /etc/yaboot.conf.
35
36       There  are  a  number  of  ways  to specify the kernel used for --info,
37       --remove-kernel,  and  --update-kernel.  Specificying  DEFAULT  or  ALL
38       selects  the  default entry and all of the entries, respectively.  If a
39       comma separated list of numbers is given, the boot entries  indexed  by
40       those  numbers  are selected. Finally, the title of a boot entry may be
41       specified by using TITLE=title as the argument; all entries  with  that
42       title are used.
43
44

OPTIONS

46       --add-kernel=kernel-path
47              Add a new boot entry for the kernel located at kernel-path.
48
49
50       --args=kernel-args
51              When  a  new  kernel  is  added, this specifies the command line
52              arguments which should be passed to the kernel by default  (note
53              they  are merged with the arguments from the template if --copy-
54              default is used).  When --update-kernel is used, this  specifies
55              new arguments to add to the argument list. Multiple, space sepa‐
56              rated arguments may be used. If an argument already  exists  the
57              new  value  replaces  the  old values. The root= kernel argument
58              gets special handling if the configuration file has special han‐
59              dling for specifying the root filesystem (like lilo.conf does).
60
61
62       --bad-image-okay
63              When grubby is looking for a entry to use for something (such as
64              a template or a default boot entry) it uses sanity checks,  such
65              as  ensuring  that  the kernel exists in the filesystem, to make
66              sure entries that obviously won't  work  aren't  selected.  This
67              option  overrides  that  behavior, and is designed primarily for
68              testing.
69
70
71       --boot-filesystem=bootfs
72              The grub boot loader expects file paths listed in it's  configu‐
73              ration path to be relative to the top of the filesystem they are
74              on, rather then relative to  the  current  root  filesystem.  By
75              default  grubby  searches the list of currently mounted filesys‐
76              tems to determine this. If this option is given grubby  acts  as
77              if  the  specified  filesystem was the filesystem containing the
78              kernel (this option is designed primarily for testing).
79
80
81       --bootloader-probe
82              grubby  tries  to  determine  if  grub  or  lilo  is   currently
83              installed.  When  one  of those bootloaders is found the name of
84              that bootloader is displayed on stdout.  Both could be installed
85              (on  different  devices), and grubby will print out the names of
86              both bootloaders, one per line. The probe for  grub  requires  a
87              commented out boot directive grub.conf identical to the standard
88              directive in the lilo configuration file. If this is not present
89              grubby  will  assume  grub  is not installed (note that anaconda
90              places this directive in  grub.conf  files  it  creates).   This
91              option is only available on ia32 platforms.
92
93
94
95       --config-file=path
96              Use path as the configuration file rather then the default.
97
98
99       --copy-default
100              grubby  will  copy as much information (such as kernel arguments
101              and root device) as possible from the  current  default  kernel.
102              The kernel path and initrd path will never be copied.
103
104
105       --default-kernel
106              Display the full path to the current default kernel and exit.
107
108
109       --elilo
110              Use an elilo style configuration file.
111
112
113       --grub Use  a grub style configuration file instead of lilo style. This
114              is the default on ia32 platforms.
115
116
117       --info=kernel-path
118              Display information on all boot entries which match kernel-path.
119              I
120
121
122       --initrd=initrd-path
123              Use  initrd-path  as  the  path to an initial ram disk for a new
124              kernel being added.
125
126
127       --lilo Use a lilo style configuration file.
128
129
130       --make-default
131              Make the new kernel entry being added the default entry.
132
133
134       --remove-args=kernel-args
135              The arguments specified by kernel-args are removed from the ker‐
136              nels  specified  by --update-kernel. The root argument gets spe‐
137              cial handling for configuration files that support separate root
138              filesystem configuration.
139
140
141       --remove-kernel=kernel-path
142              Removes  all  boot  entries which match kernel-path. This may be
143              used along with --add-kernel, in which case the new kernel being
144              added will never be removed.
145
146
147       --set-default=kernel-path
148              The  first  entry  which  boots the specified kernel is made the
149              default boot entry.
150
151
152       --title=entry-title
153              When a new kernel entry is added  entry-title  is  used  as  the
154              title  (lilo label) for the entry. If entry-title is longer then
155              maximum length allowed by the bootloader (15 for lilo, unlimited
156              for grub and elilo) the title is shortened to a (unique) entry.
157
158
159       --update-kernel=kernel-path
160              The  entries  for kernels matching kernel-path are updated. Cur‐
161              rently the only items that can be updated is the kernel argument
162              list,  which  is  modified  via  the  --args  and  --remove-args
163              options.
164
165
166       --version
167              Display the version of grubby being run and  then  exit  immedi‐
168              ately.
169
170
171       --yaboot
172              Use an yaboot style configuration file.
173
174
175       --zipl Use an zipl style configuration file.
176
177

MULTIBOOT OPTIONS

179       The Multiboot Specification provides a genreic interface for boot load‐
180       ers and operating systems.  It is supported by the GRUB bootloader.
181
182
183       --add-multiboot=multiboot-path
184              Add a new boot entry for the multiboot kernel located at  multi‐
185              boot-path.   Note  that  this  is  generally  accompanied with a
186              --add-kernel option.
187
188
189       --remove-multiboot=multiboot-path
190              Removes all boot entries which match multiboot-path.
191
192
193       --mbargs=multiboot-args
194              When a new multiboot kernel is added, this specifies the command
195              line  arguments which should be passed to that kernel by default
196              When --update-kernel is used, this specifies  new  arguments  to
197              add  to  the  argument list. Multiple, space separated arguments
198              may be used.  If  an  argument  already  exists  the  new  value
199              replaces the old values.
200
201
202       --remove-mbargs=multiboot-args
203              The  arguments  specified by multiboot-args are removed from the
204              kernels specified by --update-kernel.
205
206
207

BUGS

209       The command line syntax is more than a little  baroque.  This  probably
210       won't  be  fixed  as  grubby  is  only intended to be called from shell
211       scripts which can get it right.
212
213

SEE ALSO

215       grub(8), lilo(8), yaboot(8), mkinitrd(8)
216
217

AUTHORS

219       Erik Troan
220       Jeremy Katz
221       Peter Jones
222
223
224
225                                Tue Jan 18 2005                      GRUBBY(8)
Impressum