[src/netbsd-1-6]: src/share/man/man8/man8.sun2 Create new file from rev 1.1-1...

[grant <grant%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/849e1d6e9393
branches:  netbsd-1-6
changeset: 530317:849e1d6e9393
user:      grant <grant%NetBSD.org@localhost>
date:      Mon Jun 16 21:39:32 2003 +0000

description:
Create new file from rev 1.1-1.3 (requested by fair in ticket #1278):

Added a boot(8) man page for sun2.
Use more mdoc macros; comment out reference to non-existing crash(8)
from SEE ALSO.

Added a SYNOPSIS section, added content about boot device
selection, and added the man page to the set lists.

New sentence, new line; drop trailing spaces.

diffstat:

 share/man/man8/man8.sun2/boot.8 |  178 ++++++++++++++++++++++++++++++++++++++++
 1 files changed, 178 insertions(+), 0 deletions(-)

diffs (182 lines):

diff -r e20ab7712f21 -r 849e1d6e9393 share/man/man8/man8.sun2/boot.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man8/man8.sun2/boot.8   Mon Jun 16 21:39:32 2003 +0000
@@ -0,0 +1,178 @@
+.\"    $NetBSD: boot.8,v 1.4.2.2 2003/06/16 21:39:32 grant Exp $
+.\"
+.\" Copyright (c) 1992, 1993
+.\"    The Regents of the University of California.  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 the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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.
+.\"
+.\"     @(#)boot_sparc.8       8.2 (Berkeley) 4/19/94
+.\"
+.Dd April 8, 2003
+.Dt BOOT 8 sun2
+.Os
+.Sh NAME
+.Nm boot
+.Nd system bootstrapping procedures
+.Sh SYNOPSIS
+.Nm b
+.Oo
+.Ar dev 
+.Oo ( Ar cntrl , unit , part )
+.Oc
+.Oc
+.Op Ar file
+.Op Fl adqsv
+.Sh DESCRIPTION
+.Ss Power fail and crash recovery
+Normally, the system will reboot itself at power-up or after crashes.
+An automatic consistency check of the file systems will be performed
+as described in
+.Xr fsck 8 ,
+and unless this fails, the system will resume multi-user operations.
+.Ss Selecting the device and kernel to boot
+Normally, the
+.Nm b
+command alone is sufficient to boot the system, as the PROM chooses
+a default boot device
+.Ar dev
+if none is specified.  The PROM chooses the first device present on
+the system from the following ordered list:
+.Pp 
+.Bd -unfilled -offset indent -compact
+sd     SCSI disk
+ie     Intel Ethernet
+ec     3Com Ethernet
+.Ed
+.Pp
+Unless specified, the controller number
+.Ar cntrl ,
+unit number
+.Ar unit ,
+and partition number
+.Ar part
+default to zero, which is almost always correct.
+.Pp
+The controller number can
+be specified if there is more than one of the given device in the system.
+For example, use
+.Dq ie(1,,)
+to boot off of the second Intel Ethernet in the system.
+.Pp
+The unit number specifies one of the many devices attached to a 
+controller.  The exact meaning and values vary depending on the device name.
+For example,
+.Dq sd(,18,)
+boots the disk at target 6 on the first SCSI controller, 18 being the target
+number 6, multiplied by 4, and given in hexadecimal.
+.Pp
+The partition number specifies one of the many partitions on a device.  The
+exact meaning and values vary depending on the device name.  For example,
+.Dq sd(,18,1)
+boots the second partition on the disk at target 6 on the first SCSI
+controller.
+.Pp
+The PROM only loads a first-stage boot program, currently either
+.Pa /usr/mdec/bootxx
+(for a disk boot), or
+.Pa /usr/mdec/bootyy
+(for a network boot).  This first-stage boot program then loads the
+second-stage boot program from the same device, currently either
+.Pa /usr/mdec/ufsboot
+(for a disk boot), or
+.Pa /usr/mdec/netboot
+(for a network boot).
+.Pp
+The second-stage boot program will then attempt to load the kernel named
+.Ar file
+(or
+.Pa vmunix
+if none is specified).
+The second-stage disk boot program
+.Pa /usr/mdec/ufsboot
+loads the kernel from the same device that it was loaded from, 
+while the second-stage network boot program
+.Pa /usr/mdec/netboot
+will load the kernel
+from the NFS root as determined by the procedure described in
+.Xr diskless 8 .
+.Ss Boot program options
+.Bl -tag -width xxx
+.It Fl a
+Prompt for the root file system device, the system crash dump
+device, and the path to
+.Xr init 8 .
+.It Fl d
+Bring the system up in debug mode.
+Here it waits for a kernel debugger connect; see
+.Xr ddb 4 .
+.It Fl q
+Boot the system in quiet mode.
+.It Fl s
+Bring the system up in single-user mode.
+.It Fl v
+Boot the system in verbose mode.
+.El
+.Pp
+Other flags are currently ignored.
+.Pp
+At any time you can break back to the ROM by pressing the
+.Sq L1
+and
+.Sq a
+keys at the same time (if the console is a serial port the same is
+achieved by sending a
+.Sq break ) .
+If you do this accidentally you can continue whatever was in progress
+by typing
+.Sq c
+followed by the return key.
+.Sh FILES
+.Bl -tag -width /usr/mdec/installbootXX -compact
+.It Pa /netbsd
+system code
+.It Pa /usr/mdec/bootxx
+first-level boot block for disks
+.It Pa /usr/mdec/bootyy
+first-level boot block for NFS (diskless) boot
+.It Pa /usr/mdec/netboot
+boot program for NFS (diskless) boot
+.It Pa /usr/mdec/ufsboot
+second-level boot program for UFS disks
+.It Pa /usr/sbin/installboot
+program to install bootxx on a disk
+.El
+.Sh SEE ALSO
+.\" .Xr crash 8 ,
+.Xr disklabel 8 ,
+.Xr fsck 8 ,
+.Xr halt 8 ,
+.Xr init 8 ,
+.Xr rc 8 ,
+.Xr shutdown 8 ,
+.Xr syslogd 8