Merge branch 'master' of git://github.com/illumos/illumos-gate
[unleashed.git] / usr / src / man / man5 / grub.5
blob7caa7e45665883520ac7c67f9cf8c4119788ea11
1 '\" te
2 .\"  Copyright (c) 2005 Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH GRUB 5 "Apr 21, 2005"
7 .SH NAME
8 grub \- GRand Unified Bootloader software on Solaris
9 .SH DESCRIPTION
10 .sp
11 .LP
12 The current release of the Solaris operating system is shipped with the GRUB
13 (GRand Unified Bootloader) software.  GRUB is developed and supported by the
14 Free Software Foundation.
15 .sp
16 .LP
17 The overview for the GRUB Manual, accessible at \fBwww.gnu.org\fR, describes
18 GRUB:
19 .sp
20 .LP
21 Briefly, a boot loader is the first software program that runs when a computer
22 starts. It is responsible for loading and transferring control to an operating
23 system kernel software (such as Linux or GNU Mach). The kernel, in turn,
24 initializes the rest of the operating system (for example, a GNU [Ed. note: or
25 Solaris] system).
26 .sp
27 .LP
28 GNU GRUB is a very powerful boot loader that can load a wide variety of free,
29 as well as proprietary, operating systems, by means of chain-loading. GRUB is
30 designed to address the complexity of booting a personal computer; both the
31 program and this manual are tightly bound to that computer platform, although
32 porting to other platforms may be addressed in the future. [Ed. note: Sun has
33 ported GRUB to the Solaris operating system.]
34 .sp
35 .LP
36 One of the important features in GRUB is flexibility; GRUB understands
37 filesystems and kernel executable formats, so you can load an arbitrary
38 operating system the way you like, without recording the physical position of
39 your kernel on the disk. Thus you can load the kernel just by specifying its
40 file name and the drive and partition where the kernel resides.
41 .sp
42 .LP
43 Among Solaris machines, GRUB is supported on x86 platforms. The GRUB software
44 that is shipped with Solaris adds two utilities not present in the open-source
45 distribution:
46 .sp
47 .ne 2
48 .na
49 \fB\fBbootadm\fR(1M)\fR
50 .ad
51 .RS 19n
52 Enables you to manage the boot archive and make changes to the GRUB menu.
53 .RE
55 .sp
56 .ne 2
57 .na
58 \fB\fBinstallgrub\fR(1M)\fR
59 .ad
60 .RS 19n
61 Loads the boot program from disk.
62 .RE
64 .sp
65 .LP
66 Both of these utilities are described in Solaris man pages.
67 .sp
68 .LP
69 Beyond these two Solaris-specific utilities, the GRUB software is described in
70 the GRUB manual, a PDF version of which is available from the Sun web site.
71 Available in the same location is the \fBgrub(8)\fR open-source man page.  This
72 man page describes the GRUB shell.
73 .SH SEE ALSO
74 .sp
75 .LP
76 \fBboot\fR(1M), \fBbootadm\fR(1M), \fBinstallgrub\fR(1M)
77 .sp
78 .LP
79 \fISolaris Express Installation Guide: Basic Installations\fR
80 .sp
81 .LP
82 \fISystem Administration Guide: Basic Administration\fR
83 .sp
84 .LP
85 http://www.gnu.org/software/grub