grub(5) [sunos man page]

grub(5) 																   grub(5)

NAME

       grub - GRand Unified Bootloader software on Solaris

       The  current  release  of the Solaris operating system is shipped with the GRUB (GRand Unified Bootloader) software.  GRUB is developed and
       supported by the Free Software Foundation.

       The overview for the GRUB Manual, accessible at www.gnu.org, describes GRUB:

	      Briefly, a boot loader is the first software program that runs when a computer starts. It is responsible for loading  and  transfer-
	      ring  control  to  an operating system kernel software (such as Linux or GNU Mach). The kernel, in turn, initializes the rest of the
	      operating system (for example, a GNU [Ed. note: or Solaris] system).

	      GNU GRUB is a very powerful boot loader that can load a wide variety of free, as well as proprietary, operating systems, by means of
	      chain-loading.  GRUB  is	designed  to  address  the complexity of booting a personal computer; both the program and this manual are
	      tightly bound to that computer platform, although porting to other platforms may be addressed in the  future.  [Ed.  note:  Sun  has
	      ported GRUB to the Solaris operating system.]

	      One of the important features in GRUB is flexibility; GRUB understands filesystems and kernel executable formats, so you can load an
	      arbitrary operating system the way you like, without recording the physical position of your kernel on the disk. Thus you  can  load
	      the kernel just by specifying its file name and the drive and partition where the kernel resides.

       Among  Solaris  machines, GRUB is supported on  platforms. The GRUB software that is shipped with Solaris adds two utilities not present in
       the open-source distribution:

       bootadm(1M)

	   Enables you to manage the boot archive and make changes to the GRUB menu.

       installgrub(1M)

	   Loads the boot program from disk.

       Both of these utilities are described in Solaris man pages.

       Beyond these two Solaris-specific utilities, the GRUB software is described in the GRUB manual, a PDF version of which  is  available  from
       the Sun web site.  Available in the same location is the grub(8) open-source man page.  This man page describes the GRUB shell.

       boot(1M), bootadm(1M), installgrub(1M)

       http://www.gnu.org/software/grub

								    21 Apr 2005 							   grub(5)

installgrub(1M)                                                                                                                    installgrub(1M)

NAME

       installgrub - install GRUB in a disk partition or a floppy

SYNOPSIS

       /sbin/installgrub [-fm] stage1 stage2 raw-device

       The installgrub command is an -only program. GRUB stands for GRand Unified Bootloader.

       installgrub  installs  GRUB  stage  1  and  stage  2  files on the boot area of a disk partition. If you specify the -m option, installgrub
       installs the stage 1 file on the master boot sector of the disk.

       The installgrub command accepts the following options:

       -f

           Suppresses interaction when overwriting the master boot sector.

       -m

           Installs GRUB stage1 on the master boot sector interactively.

       The installgrub command accepts the following operands:

       stage1

           The name of the GRUB stage 1 file.

       stage2

           The name of the GRUB stage 2 file.

       raw-device

           The name of the device onto which GRUB code is to be installed. It must be a character device that is readable and writable.  For  disk
           devices,  specify  the  slice  where  the  GRUB  menu  file  is  located.  (For Solaris it is the root slice.) For a floppy disk, it is
           /dev/rdiskette.

       Example 1: Installing GRUB on a Hard Disk Slice

       The following command installs GRUB on a system where the root slice is c0d0s0:

       example# /sbin/installgrub /boot/grub/stage1 
                /boot/grub/stage2 /dev/rdsk/c0d0s0

       Example 2: Installing GRUB on a Floppy

       The following command installs GRUB on a formatted floppy:

       example# mount -F pcfs /dev/diskette /mnt
       # mkdir -p /mnt/boot/grub
       # cp /boot/grub/* /mnt/boot/grub
       # umount /mnt
       # cd /boot/grub
       # /sbin/installgrub stage1 stage2 /dev/rdiskette

       /boot/grub

           Directory where GRUB files reside.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWcsu                      |
       +-----------------------------+-----------------------------+
       |Interface Stability          |Evolving                     |
       +-----------------------------+-----------------------------+

       boot(1M), fdisk(1M), fmthard(1M), kernel(1M), attributes(5)

       Installing GRUB on the master boot sector (-m option) overrides any boot manager currently installed on the machine. The system will always
       boot the GRUB in the Solaris partition regardless of which fdisk partition is active.

                                                                    24 May 2005                                                    installgrub(1M)