installboot manpage canabalized from sparc (only documents sparc64 options, tho)

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