usr/src/man/man1m/installgrub.1m

   1 '\" te
   2 .\" Copyright 2015 Nexenta Systems Inc.
   3 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   4 .\" 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. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   5 .\"  See the License for the specific language governing permissions and limitations under the License. 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
   6 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH INSTALLGRUB 1M "Jan 14, 2015"
   8 .SH NAME
   9 installgrub \- install GRUB in a disk partition or a floppy
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/sbin/installgrub\fR [\fB-fm\fR] \fIstage1\fR \fIstage2\fR \fIraw-device\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .LP
  18 The \fBinstallgrub\fR command is an x86-only program. GRUB stands for GRand
  19 Unified Bootloader.
  20 .sp
  21 .LP
  22 \fBinstallgrub\fR installs GRUB stage 1 and stage 2 files on the boot area of a
  23 disk partition. If you specify the \fB-m\fR option, \fBinstallgrub\fR installs
  24 the stage 1 file on the master boot sector of the disk.
  25 .SH OPTIONS
  26 .LP
  27 The \fBinstallgrub\fR command accepts the following options:
  28 .sp
  29 .ne 2
  30 .na
  31 \fB\fB-f\fR\fR
  32 .ad
  33 .RS 6n
  34 Suppresses interaction when overwriting the master boot sector.
  35 .RE
  36
  37 .sp
  38 .ne 2
  39 .na
  40 \fB\fB-m\fR\fR
  41 .ad
  42 .RS 6n
  43 Installs GRUB \fIstage1\fR on the master boot sector interactively. You must
  44 use this option if Solaris is installed on an extended FDISK or an EFI/GPT
  45 partition.
  46 .RE
  47
  48 .SH OPERANDS
  49 .LP
  50 The \fBinstallgrub\fR command accepts the following operands:
  51 .sp
  52 .ne 2
  53 .na
  54 \fB\fIstage1\fR\fR
  55 .ad
  56 .RS 14n
  57 The name of the GRUB stage 1 file.
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fIstage2\fR\fR
  64 .ad
  65 .RS 14n
  66 The name of the GRUB stage 2 file.
  67 .RE
  68
  69 .sp
  70 .ne 2
  71 .na
  72 \fB\fIraw-device\fR\fR
  73 .ad
  74 .RS 14n
  75 The name of the device onto which GRUB code is to be installed. It must be a
  76 character device that is readable and writable. For disk devices, specify the
  77 slice where the GRUB menu file is located. (For Solaris it is the root slice.)
  78 For a floppy disk, it is \fB/dev/rdiskette\fR.
  79 .RE
  80
  81 .SH EXAMPLES
  82 .LP
  83 \fBExample 1 \fRInstalling GRUB on a Hard Disk Slice
  84 .sp
  85 .LP
  86 The following command installs GRUB on a system where the root slice is
  87 \fBc0d0s0\fR:
  88
  89 .sp
  90 .in +2
  91 .nf
  92 example# /sbin/installgrub /boot/grub/stage1 \e
  93          /boot/grub/stage2 /dev/rdsk/c0d0s0
  94 .fi
  95 .in -2
  96
  97 .LP
  98 \fBExample 2 \fRInstalling GRUB on a Floppy
  99 .sp
 100 .LP
 101 The following command installs GRUB on a formatted floppy:
 102
 103 .sp
 104 .in +2
 105 .nf
 106 example# mount -F pcfs /dev/diskette /mnt
 107 # mkdir -p /mnt/boot/grub
 108 # cp /boot/grub/* /mnt/boot/grub
 109 # umount /mnt
 110 # cd /boot/grub
 111 # /sbin/installgrub stage1 stage2 /dev/rdiskette
 112 .fi
 113 .in -2
 114
 115 .SH FILES
 116 .ne 2
 117 .na
 118 \fB\fB/boot/grub\fR\fR
 119 .ad
 120 .RS 14n
 121 Directory where GRUB files reside.
 122 .RE
 123
 124 .SH ATTRIBUTES
 125 .LP
 126 See \fBattributes\fR(5) for descriptions of the following attributes:
 127 .sp
 128
 129 .sp
 130 .TS
 131 box;
 132 c | c
 133 l | l .
 134 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 135 _
 136 Interface Stability     Uncommitted
 137 .TE
 138
 139 .SH SEE ALSO
 140 .LP
 141 \fBboot\fR(1M), \fBfdisk\fR(1M), \fBfmthard\fR(1M), \fBkernel\fR(1M),
 142 \fBattributes\fR(5)
 143 .SH WARNINGS
 144 .LP
 145 Installing GRUB on the master boot sector (\fB-m\fR option) overrides any boot
 146 manager currently installed on the machine. The system will always boot the
 147 GRUB in the Solaris partition regardless of which \fBfdisk\fR partition is
 148 active.