diff options
Diffstat (limited to 'sys')
| -rw-r--r-- | sys/arch/sparc64/stand/installboot/Makefile | 4 | ||||
| -rw-r--r-- | sys/arch/sparc64/stand/installboot/installboot.8 | 116 |
2 files changed, 118 insertions, 2 deletions
diff --git a/sys/arch/sparc64/stand/installboot/Makefile b/sys/arch/sparc64/stand/installboot/Makefile index e48934d1f8f..4e072b055be 100644 --- a/sys/arch/sparc64/stand/installboot/Makefile +++ b/sys/arch/sparc64/stand/installboot/Makefile @@ -1,4 +1,4 @@ -# $OpenBSD: Makefile,v 1.2 2001/09/06 19:24:47 jason Exp $ +# $OpenBSD: Makefile,v 1.3 2001/09/06 19:49:17 jason Exp $ # $NetBSD: Makefile,v 1.13 2000/08/16 08:24:01 mrg Exp $ .include <bsd.own.mk> @@ -6,7 +6,7 @@ WARNS?=1 PROG= installboot SRCS= installboot.c loadfile.c -NOMAN= +MAN= installboot.8 LIBSA_I=${.CURDIR}/../../../../lib/libsa diff --git a/sys/arch/sparc64/stand/installboot/installboot.8 b/sys/arch/sparc64/stand/installboot/installboot.8 new file mode 100644 index 00000000000..36d9251c03b --- /dev/null +++ b/sys/arch/sparc64/stand/installboot/installboot.8 @@ -0,0 +1,116 @@ +.\" $OpenBSD: installboot.8,v 1.1 2001/09/06 19:49:17 jason Exp $ +.\" $NetBSD: installboot.8,v 1.1 1995/09/30 21:32:14 pk Exp $ +.\" +.\" Copyright (c) 1995 Paul Kranenburg +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Paul Kranenburg. +.\" 3. The name of the author may not be used to endorse or promote products +.\" derived from this software without specific prior written permission +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd September 6, 2001 +.Dt INSTALLBOOT 8 sparc64 +.Os +.Sh NAME +.Nm installboot +.Nd install a bootstrap on an FFS filesystem partition +.Sh SYNOPSIS +.Nm installboot +.Op Fl nv +.Ar bootblk +.Ar device +.Sh DESCRIPTION +.Nm installboot +prepares a FFS filesystem partition for boot-strapping from the PROM. +The sparc bootblocks are split into two parts: a small first-stage program that +is written into the superblock area in a partition +.Po +and hence is limited in size to SBSIZE - DEV_BSIZE bytes +.Pc , +and a second-stage program that resides in the filesystem proper. +The first-stage program is loaded into memory by the PROM. After it receiving +control, it loads the second stage program +.Ar ofwboot +from the filesystem. +The second-stage boot program uses the device driver interface to +the PROM and the stand-alone filesystem code in +.Dq libsa.a +to locate and load the kernel. +The second-stage boot program and the prototype code for the +first-stage bootprogram can be found in +.Pa /usr/mdec/ofwboot +and +.Pa /usr/mdec/bootblk +respectively. The second-stage program commonly resides in the root directory +as +.Pa /ofwboot . +.Pp +The options are as follows: +.Bl -tag -width flag +.It Fl n +Do not actually write anything on the disk. +.It Fl v +Verbose mode. +.El +.Pp +The arguments are: +.Bl -tag -width bootxx +.It Ar bootblk +the name of the prototype file for the first stage boot program. +.It Ar device +the name of the raw device in which the first-stage boot program +is to be installed. This should correspond to the block device +on which the file system containing +.Ar ofwboot +is mounted. +.El +.Sh EXAMPLES +The following command will install the first-stage bootblocks in the +root filesystem +.Pq assumed to be mounted on Dq sd0a +using the file +.Pa /ofwboot +as the second-level boot program: +.Bd -literal -offset indent +installboot /usr/mdec/bootblk /dev/rsd0a +.Ed +.Sh BUGS +.Nm +requires simultaneous access to the mounted file system and +the raw device, but that is not allowed with the kernel +.Dv securelevel +variable set to a value greater than zero +.Pq the default , +so +.Nm installboot +only works in single-user mode +.Pq or insecure mode - see Xr init 8 . +.Sh SEE ALSO +.Xr disklabel 8 , +.Xr init 8 +.Sh HISTORY +The +.Nm +first appeared in +.Nx 1.1 |