Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎


     bootadm - manage bootability of GRUB-enabled operating  sys-

     /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 environments, the GRUB (GRand Unified Bootloader) menu.
     The update-archive option provides a way for user to  update
     the  boot  archive as a preventative measure or as part of a
     recovery procedure. The set-menu subcommand  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. For example, if a system was
     installed using Live Upgrade, the GRUB  menu  might  not  be
     located  in  the  current boot environment. 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

     The bootadm command determines dynamically the options  sup-
     ported  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 location, because it is subject to change.  Applies
         to x86 platforms only.


         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 only.

     The bootadm command has the following options:


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


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

     -p platform

         The platform, or machine hardware class, of the  client.
         The  platform  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  referenced with the -R option. Doing so might dam-
           age 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  designating 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  alter-
     nate 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

     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

       # 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

     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  attri-

    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWcsu                     |
    | Interface Stability         | Committed                   |

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

     Consult the GRUB home page, under:


Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.