Annotation of sys/arch/alpha/stand/installboot.8, Revision 1.1
1.1 ! nbrk 1: .\" $OpenBSD: installboot.8,v 1.10 2007/05/31 19:20:01 jmc Exp $
! 2: .\" $NetBSD: installboot.8,v 1.2 1997/04/06 08:41:11 cgd Exp $
! 3: .\"
! 4: .\" Copyright (c) 1996, 1997 Christopher G. Demetriou. All rights reserved.
! 5: .\" Copyright (c) 1995 Paul Kranenburg
! 6: .\" All rights reserved.
! 7: .\"
! 8: .\" Redistribution and use in source and binary forms, with or without
! 9: .\" modification, are permitted provided that the following conditions
! 10: .\" are met:
! 11: .\" 1. Redistributions of source code must retain the above copyright
! 12: .\" notice, this list of conditions and the following disclaimer.
! 13: .\" 2. Redistributions in binary form must reproduce the above copyright
! 14: .\" notice, this list of conditions and the following disclaimer in the
! 15: .\" documentation and/or other materials provided with the distribution.
! 16: .\" 3. All advertising materials mentioning features or use of this software
! 17: .\" must display the following acknowledgement:
! 18: .\" This product includes software developed by Paul Kranenburg.
! 19: .\" 3. The name of the author may not be used to endorse or promote products
! 20: .\" derived from this software without specific prior written permission
! 21: .\"
! 22: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
! 23: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
! 24: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
! 25: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
! 26: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
! 27: .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
! 28: .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
! 29: .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
! 30: .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
! 31: .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
! 32: .\"
! 33: .Dd $Mdocdate: May 31 2007 $
! 34: .Dt INSTALLBOOT 8 alpha
! 35: .Os
! 36: .Sh NAME
! 37: .Nm installboot
! 38: .Nd install disk bootstrap software
! 39: .Sh SYNOPSIS
! 40: .Nm installboot
! 41: .Op Fl nv
! 42: .Ar boot
! 43: .Ar bootxx
! 44: .Ar rawdiskdevice
! 45: .Sh DESCRIPTION
! 46: The
! 47: .Nm installboot
! 48: utility prepares a disk for bootstrapping.
! 49: .Pp
! 50: The OpenBSD/alpha disk bootstrap software is split into two parts:
! 51: a small first-stage boot program that is written into the disklabel
! 52: area of a disk
! 53: .Po
! 54: and hence is limited in size to 7680 bytes
! 55: .Pc ,
! 56: and a second-stage boot program that resides in the filesystem proper
! 57: .Po
! 58: typically with the name
! 59: .Pa /boot
! 60: .Pc .
! 61: The first-stage boot program is loaded into memory by the SRM console
! 62: software.
! 63: After receiving control of the system, it loads the second-stage boot
! 64: program from a set of filesystem block numbers that have been
! 65: hard-coded into it by
! 66: .Nm installboot .
! 67: The second-stage boot program locates and loads the kernel.
! 68: .Pp
! 69: The second-stage boot program and the prototype code for the
! 70: first-stage boot program can be found in
! 71: .Pa /usr/mdec/boot
! 72: and
! 73: .Pa /usr/mdec/bootxx ,
! 74: respectively.
! 75: .Pa /usr/mdec/boot
! 76: may be installed simply by copying it to the root directory of the
! 77: partition you wish to boot from, but after it is installed
! 78: .Nm installboot
! 79: .Em must
! 80: be run.
! 81: .Pp
! 82: The options recognized by
! 83: .Nm installboot
! 84: are as follows:
! 85: .Bl -tag -width flag
! 86: .It Fl n
! 87: Do not actually write anything on the disk.
! 88: .It Fl v
! 89: Verbose mode.
! 90: .El
! 91: .Pp
! 92: The arguments are:
! 93: .Bl -tag -width rawdiskdevice
! 94: .It Ar boot
! 95: The name of the second-stage boot program in the file system
! 96: where the first-stage boot program is to be installed.
! 97: .It Ar bootxx
! 98: The name of the prototype file for the first-stage boot program.
! 99: .It Ar rawdiskdevice
! 100: The name of the device corresponding to the raw whole-disk partition (the
! 101: .Dq raw partition )
! 102: of the disk on which the first-stage boot program is to be installed.
! 103: .El
! 104: .Sh EXAMPLES
! 105: .Pa boot
! 106: resides in the FFS file system mounted on
! 107: .Pa /
! 108: from
! 109: .Dq sd0a ,
! 110: you would install the first-stage boot program on the disk
! 111: (and therefore make the disk bootable) by using the command:
! 112: .Bd -literal -offset indent
! 113: # cp /usr/mdec/boot /boot
! 114: # /usr/mdec/installboot -n -v /boot /usr/mdec/bootxx /dev/rsd0c
! 115: .Ed
! 116: .Pp
! 117: And if the information supplied looks right, run the above without the
! 118: .Fl n
! 119: flag.
! 120: .Sh SEE ALSO
! 121: .Xr disklabel 8 ,
! 122: .Xr init 8 ,
! 123: .Xr sysctl 8
! 124: .Sh HISTORY
! 125: The alpha
! 126: .Nm
! 127: command first appeared in
! 128: .Nx 1.2 .
! 129: .Sh BUGS
! 130: The OpenBSD/alpha boot blocks can only load kernels from disks'
! 131: .Dq a
! 132: partitions.
! 133: (However, the second-stage boot program may be located on any FFS file system
! 134: partition on the disk.)
! 135: .Pp
! 136: .Nm Installboot
! 137: requires simultaneous access to the mounted file system and
! 138: the disks' raw partition.
! 139: That is not allowed with the kernel
! 140: .Dv securelevel
! 141: variable
! 142: .Po
! 143: see
! 144: .Xr sysctl 8
! 145: .Pc
! 146: set to a value greater than one, or with
! 147: .Dv securelevel
! 148: set to one if the
! 149: .Dq boot
! 150: program resides in a file system on the disk's raw partition.
CVSweb