[src/trunk]: src/share/man/man8/man8.alpha manual page for the new alpha inst...

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

details:   https://anonhg.NetBSD.org/src/rev/2cd188b15146
branches:  trunk
changeset: 471574:2cd188b15146
user:      cgd <cgd%NetBSD.org@localhost>
date:      Mon Apr 05 03:24:35 1999 +0000

description:
manual page for the new alpha installboot(8)

diffstat:

 share/man/man8/man8.alpha/installboot.8 |  194 ++++++++++++++++++++++++++++++++
 1 files changed, 194 insertions(+), 0 deletions(-)

diffs (198 lines):

diff -r 4396cba3d869 -r 2cd188b15146 share/man/man8/man8.alpha/installboot.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man8/man8.alpha/installboot.8   Mon Apr 05 03:24:35 1999 +0000
@@ -0,0 +1,194 @@
+.\" $NetBSD: installboot.8,v 1.9 1999/04/05 03:24:35 cgd Exp $
+.\"
+.\" Copyright (c) 1999 Christopher G. Demetriou.  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 Christopher G. Demetriou
+.\"      for the NetBSD Project.
+.\" 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 April 3, 1999
+.Dt INSTALLBOOT 8 alpha
+.Os
+.Sh NAME
+.Nm installboot
+.Nd install and remove Alpha disk and CD-ROM bootstrap software
+.Sh SYNOPSIS
+.Nm /usr/mdec/installboot
+.Op Fl nv
+.Ar disk
+.Ar bootstrap
+.Nm /usr/mdec/installboot
+.Op Fl nv
+.Fl c
+.Ar disk
+.Sh DESCRIPTION
+The
+.Nm
+utility installs and removes
+.Nx Ns Tn /alpha
+disk and CD-ROM bootstrap software.  Installing bootstrap
+software on a device allows the SRM console to boot from
+that device.  As far as the console is concerned, booting
+from disk, CD-ROM, and other random-access block devices
+is the same; in the rest of this manual page, unless
+otherwise noted, the description applies equally to both
+disks and CD-ROMs.
+.Pp
+.Nx Ns Tn /alpha
+disk bootstrap software consists of two parts: a
+.Dq primary
+bootstrap program written into the disklabel area of the disk, and a
+.Dq secondary
+bootstrap program that resides in a file system on the disk.
+When booting, the primary bootstrap program is loaded and
+invoked by the console.  After receiving control of the system
+it loads and runs the secondary bootstrap program, which in turn
+loads and runs the kernel.
+.Pp
+To make a
+.Nx Ns Tn /alpha
+disk bootable by the SRM console, use
+.Nm
+to install a primary bootstrap program on the disk's raw
+.Pq Dq c
+partition.
+Then copy the secondary bootstrap program
+.Pa /usr/mdec/boot
+to the root directory of the file system that starts at the
+beginning (block 0) of the disk.
+Note that the primary bootstrap program used must support the type of
+file system which contains the secondary bootstrap program, and that
+the secondary bootstrap program must be named
+.Dq boot
+in the root directory of the file system which contains it.
+(Unlike previous versions of
+.Nm installboot ,
+it is no longer necessary to run installboot after changing
+the secondary bootstrap program.)
+.Pp
+The options recognized by
+.Nm
+are as follows:
+.Bl -tag -width flag
+.It Fl c
+Instead of installing a primary bootstrap program, remove any existing
+primary bootstrap program.
+.It Fl n
+Do not actually write anything to the disk.
+.It Fl v
+Print information about what
+.Nm
+is doing.
+.El
+.Pp
+The arguments given to
+.Nm
+are as follows:
+.Bl -tag -width bootstrap
+.It Ar disk
+The name of the disk on which to install the primary
+bootstrap program.  Typically this will be the raw disk device belonging
+to the disk containing the file system which holds the secondary
+bootstrap program.  In some cases this can be a file, e.g. if
+.Nm
+is being used to install the primary bootstrap program into a
+file containing a ISO-9660 CD-ROM image.
+.It Ar bootstrap
+The primary bootstrap program to install.  (This argument
+may not be specified if the
+.Fl c
+flag is being used.)
+.El
+.Pp
+The
+.Nm
+utility exits 0 on success, and >0 if an error occurs.
+.Sh FILES
+.Bl -tag -width /usr/mdec/bootxx_cd9660 -compact
+.It Pa /usr/mdec/bootxx_cd9660
+primary bootstrap for
+.Dq cd9660
+(ISO-9660) file system
+.It Pa /usr/mdec/bootxx_ffs
+primary bootstrap for
+.Dq ffs
+file system
+(Berkeley Fast File System)
+.It Pa /usr/mdec/boot
+secondary bootstrap
+.El
+.Sh EXAMPLES
+.Dl installboot /dev/rsd0c /usr/mdec/bootxx_ffs
+.Pp
+Install the Berkeley Fast File System primary bootstrap on to disk sd0.
+.Pp
+.Dl installboot -c /dev/rsd1c
+.Pp
+Remove the primary bootstrap from disk sd1.
+.Pp
+.Dl installboot /tmp/cd-image /usr/mdec/bootxx_cd9660
+.Pp
+Install the ISO-9660 primary bootstrap in the file
+.Pa /tmp/cd-image .
+.Sh SEE ALSO
+.Xr mkbootimage 8
+.Rs
+.\" XXX Alpha Architecture Reference Manual reference
+.%T "Alpha Architecture Reference Manual"
+.Re
+.Sh HISTORY
+The current version of the
+.Nx Ns Tn /alpha
+.Nm
+command first appeared in
+.Nx 1.4 .
+A previous version which operated quite differently was introduced in
+.Nx 1.2 .
+.Sh AUTHORS
+The current version of the
+.Nm
+utility was written by Chris Demetriou.
+The previous version of the
+.Nx Ns Tn /alpha
+.Nm
+utility was originally written by Paul Kranenburg for
+.Nx Ns Tn /sparc
+and modified for use with
+.Nx Ns Tn /alpha
+by Chris Demetriou, Jason Thorpe, Ross Harvey, and others.
+.Sh BUGS
+The
+.Nx Ns Tn /alpha
+primary bootstrap program can only load the secondary bootstrap
+program from file systems starting at the beginning (block 0)
+of disks.  Similarly, the secondary bootstrap program can only
+load kernels from file systems starting at the beginning of disks.
+.Pp
+The size of primary bootstrap programs is restricted to 7.5KB, even
+though some file systems (e.g. ISO-9660) are able to accomodate larger
+ones.
+.Pp
+There are not currently primary bootstraps to support all file systems
+types which are capable of being the root file system.