Annotation of sys/arch/amd64/stand/installboot/installboot.8, Revision 1.1.1.1
1.1 nbrk 1: .\" $OpenBSD: installboot.8,v 1.3 2007/05/31 19:20:02 jmc Exp $
2: .\"
3: .\" Copyright (c) 1997 Michael Shalayeff
4: .\" All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
14: .\"
15: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
19: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25: .\" SUCH DAMAGE.
26: .\"
27: .\"
28: .Dd $Mdocdate: May 31 2007 $
29: .Dt INSTALLBOOT 8 amd64
30: .Os
31: .Sh NAME
32: .Nm installboot
33: .Nd installs a bootstrap on an FFS disk or partition
34: .Sh SYNOPSIS
35: .Nm installboot
36: .Op Fl nv
37: .Ar boot
38: .Ar biosboot
39: .Ar disk
40: .Sh DESCRIPTION
41: .Nm
42: is used to install a
43: .Dq first-stage
44: boot program into the boot area of an FFS disk partition.
45: It inserts the block number and offset of the inode of
46: the second-stage boot program
47: .Xr boot 8
48: so that the
49: .Xr biosboot 8
50: program can load it.
51: Various filesystem parameters are also patched into the boot block.
52: .Pp
53: The options are as follows:
54: .Bl -tag -width flag_opt
55: .It Fl n
56: Do not actually write anything on the disk.
57: .It Fl v
58: Be verbose, printing out the data that are stored in
59: .Ar biosboot
60: along with lots of other information.
61: .El
62: .Pp
63: The arguments are:
64: .Bl -tag -width biosboot
65: .It Ar boot
66: The name of the second-stage boot program in the mounted file system
67: where the first-stage boot program is to be installed.
68: This should be a full pathname.
69: .It Ar biosboot
70: The name of the prototype file for the first stage boot program,
71: usually
72: .Pa /usr/mdec/biosboot .
73: .It Ar disk
74: The name of the disk containing the partition in which the second-stage
75: boot program resides and the first-stage boot program is to be installed.
76: This can either be specified in short form (e.g.,
77: .Sq sd0
78: or
79: .Sq wd0 ) ,
80: or as the explicit device node, such as
81: .Pa /dev/rsd0c
82: or
83: .Pa /dev/rwd0c .
84: .Pp
85: Note that you must be in single-user mode or have your kernel in
86: insecure mode (see the
87: .Xr sysctl 8
88: .Va kern.securelevel
89: variable or
90: .Pa /etc/rc.securelevel )
91: to enable access to the raw partition of a mounted disk.
92: .Pp
93: The
94: .Sq c
95: partition is always used to represent the
96: .Dq entire
97: disk on amd64.
98: .El
99: .Sh EXAMPLES
100: The typical use is
101: .Bd -literal -offset indent
102: # cp /usr/mdec/boot /boot
103: # /usr/mdec/installboot -n -v /boot /usr/mdec/biosboot sd0
104: .Ed
105: .Pp
106: And if the information supplied looks right, run the above without the
107: .Fl n
108: flag.
109: If you are upgrading an old system, you may need to perform
110: some additional steps first.
111: For example:
112: .Bd -literal -offset indent
113: boot the floppy.fs filesystem floppy
114: # fsck /dev/rsd0a
115: # mount /dev/sd0a /mnt
116: # cp /usr/mdec/boot /mnt/boot
117: # /usr/mdec/installboot -v /mnt/boot /usr/mdec/biosboot sd0
118: .Ed
119: .Sh SEE ALSO
120: .Xr biosboot 8 ,
121: .Xr boot 8 ,
122: .Xr disklabel 8 ,
123: .Xr fdisk 8 ,
124: .Xr init 8
125: .Sh CAVEATS
126: The disklabel
127: .Va d_type
128: field must be set to a value other than
129: .Dq unknown .
130: .Pp
131: .Pa /boot
132: must be on the drive/partition specified by
133: .Pa disk ;
134: you cannot perform cross-device
135: .Nm Ns s .
CVSweb