bootadm man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

BOOTADM(1M)							   BOOTADM(1M)

       bootadm - manage bootability of GRUB-enabled operating system

       /sbin/bootadm update-archive [-vn] [-R altroot [-p platform]]

       /sbin/bootadm list-archive [-vn] [-R altroot [-p platform]]

	x86 only

       /sbin/bootadm set-menu [-R altroot [-p platform]] key=value

       /sbin/bootadm list-menu [-R altroot [-p platform]]

       The  bootadm  command manages the boot archive and, with x86 boot envi‐
       ronments, the GRUB (GRand Unified Bootloader) menu. The	update-archive
       option  provides a way for user to update the boot archive as a preven‐
       tative measure or as part of a recovery procedure. The set-menu subcom‐
       mand  allows you to switch the auto-boot timeout and default boot entry
       in the GRUB menu.

       The list-menu subcommand displays the location of the GRUB menu and the
       current	GRUB menu entries. While the typical location of the GRUB menu
       is /boot/grub/menu.lst, depending on the install method used the active
       GRUB menu might be located somewhere else. Use the list-menu subcommand
       to locate the active GRUB menu. See the EXAMPLES	 section  for  typical
       output from the list-menu option.

       Note that OpenBoot PROM (OBP)-based machines, such as SPARC systems, do
       not use GRUB and have no boot menu manageable by bootadm.

       The bootadm command determines dynamically the options supported by the
       image  to  be  managed,	so that bootadm invoked on one platform can be
       used to manage diskless clients of a different platform type.

       The bootadm command has the following subcommands:


	   Updates current boot archive if required. Applies to both SPARC and
	   x86 platforms.


	   Lists the files and directories to be included in the boot archive.
	   Applies to both SPARC and x86 platforms.


	   Maintain   the   GRUB   menu.   The	 current    GRUB    menu    is
	   boot/grub/menu.lst,	relative  to root. Do not depend on this loca‐
	   tion, because it is subject to change.  Applies  to	x86  platforms


	   Lists  the location of the active GRUB menu, as well as the current
	   GRUB menu entries. This includes the autoboot-timeout, the  default
	   entry number, and the title of each entry. Applies to x86 platforms

       The bootadm command has the following options:


	   In an  update-archive  operation,  stale  files  are	 displayed  on


	   In  an update-archive operation, archive content is checked but not

       -p platform

	   The platform, or machine hardware class, of the client.  The	 plat‐
	   form	 type can only be specified together with -R, and is generally
	   useful only for managing a diskless client where the client is of a
	   different  platform	class than the server. Platform must be one of
	   i86pc, sun4u, or sun4v.

       -R altroot

	   Operation is applied to an alternate root path.

	   Note -

	     The root file system of any non-global zones must not  be	refer‐
	     enced with the -R option. Doing so might damage the global zone's
	     file system, might compromise the security of  the	 global	 zone,
	     and might damage the non-global zone's file system. See zones(5).


	   Possible values are:


	       The item number (for example, 0, 1, or 2) in the GRUB menu des‐
	       ignating the operating system to boot when the timer expires.


	       The number of seconds before the operating system designated by
	       the  default  item  number  is booted. If the value is -1, auto
	       boot is disabled.

       Example 1 Updating the Current Boot Archive

       The following command updates the current boot archive:

	 # bootadm update-archive

       Example 2 Updating the Boot Archive on an Alternate Root

       The following command updates the boot archive on an alternate root:

	 # bootadm update-archive -R /a

       Example 3 Listing Installed OS Instances

       The following command lists the installed operating system instances in
       a GRUB menu:

	 # bootadm list-menu

	 (0) Solaris10
	 (1) Solaris10 Failsafe
	 (2) Linux

       Example 4 Switching Default Boot Entry

       The  following  command	refers	to  the menu displayed in the previous
       example. The user selects Linux (item 2).

	 # bootadm set-menu default=2

       Example 5 Listing GRUB Menu Entries and Location of GRUB Menu

       The following command lists the GRUB menu entries and the  location  of
       the GRUB menu:

	 # bootadm list-menu
	 The location for the active GRUB menu is: /stubboot/boot/grub/menu.lst
	 default 0
	 timeout 10
	 0 Solaris10
	 1 Solaris10 failsafe
	 2 Linux

       Example 6 Displaying Location of GRUB Menu

       The following command displays the location of the GRUB menu:

	 # bootadm list-menu
	 The location for the active GRUB menu is: /dev/dsk/c0t1d0s0 (not mounted)
	 The filesystem type of the menu device is <ufs>
	 default 2
	 timeout 10
	 0 c0t1d0s3
	 1 c0t1d0s3 failsafe
	 2 Solaris10
	 3 Solaris10 failsafe

       In  this	 example, the active GRUB menu is located on a device which is
       not mounted. To access the GRUB menu, mount the device and  access  the
       GRUB menu at <mountpoint>/boot/grub/menu.lst.

       The following exit values are returned:


	   The command completed successfully.


	   The command exited due to an error.

       See attributes(5) for descriptions of the following attributes:

       │Interface Stability │ Committed	      │

       boot(1M), installgrub(1M), attributes(5)

       Consult the GRUB home page, under:

				 Apr 25, 2008			   BOOTADM(1M)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net