Go to main content

Booting and Shutting Down Oracle® Solaris 11.3 Systems

Exit Print View

Updated: October 2017

x86: Administering the GRUB Configuration by Using the bootadm Command

On systems that support GRUB Legacy, you primarily manage the GRUB configuration and the GRUB menu by editing the menu.lst file. Systems that support GRUB 2 use the grub.cfg file. However, instead of manually editing this file, you use the boot administration interface, bootadm. You can use the bootadm command to administer most of the tasks that you previously did by editing the menu.lst file. These tasks include administering boot loader settings and the GRUB menu, as well as the individual attributes of a particular boot entry.

Note -  Because changes made to the boot loader by using either the bootadm command or the beadm command can overwrite the grub.cfg file , this file should never be directly edited.

The following bootadm subcommands support the administration of the GRUB 2 configuration:


Adds a boot entry to the GRUB menu.


Changes the attributes of a specified boot entry in the GRUB menu.


Generates a new boot loader configuration file.


Installs the system boot loader. This subcommand applies to both x86 and SPARC platforms.


Displays the current boot entries in the GRUB menu.

The –P option supports displaying boot entries for a specified root pool. The –i option displays information about a specific menu entry identified by an index number. The –t option selects the menu entry by the title.


Removes a boot entry from the GRUB menu.


Maintains the GRUB menu. You can use this subcommand to set a particular GRUB menu entry as the default, to add security protection to the GRUB menu, and to set other menu options and boot loader options.

The –P option supports changing menus on multiple root pools.


Sets a password to prevent the GRUB menu from being seen.


Shows a boot entry from the GRUB menu. This subcommand is equivalent to list-menu.

Note -  Because SPARC platforms do not use GRUB, tno boot menu management by using the bootadm command. However, you can use the bootadm command on SPARC based systems to list the contents of the boot archive, to manually update the boot archive, and to install the boot loader. See Managing the Oracle Solaris Boot Archives.

The following procedures describe how to use the bootadm command to manage the GRUB configuration and the GRUB menu. For more complete information, see the bootadm(1M) man page.