remove installboot(8) for alpha, sparc, sparc64, sun3 and vax, as they
do not install /usr/mdec/installboot anymore.
This commit is contained in:
grant
parent
7b2c9d8551
commit
4276beff76
|
|
@ -1,4 +1,4 @@
|
|||
# $NetBSD: mi,v 1.497 2002/06/27 15:18:22 christos Exp $
|
||||
# $NetBSD: mi,v 1.498 2002/06/28 08:45:55 grant Exp $
|
||||
./usr/share/info/am-utils.info man-amd-info
|
||||
./usr/share/info/as.info man-computil-info
|
||||
./usr/share/info/awk.info man-util-info
|
||||
|
|
@ -1245,7 +1245,6 @@
|
|||
./usr/share/man/cat8/algor/makedev.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/alpha/MAKEDEV.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/alpha/boot.0 man-sys-catman
|
||||
./usr/share/man/cat8/alpha/installboot.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/alpha/makedev.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/alpha/mkbootimage.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/alpha/setnetbootinfo.0 man-sysutil-catman
|
||||
|
|
@ -1664,11 +1663,9 @@
|
|||
./usr/share/man/cat8/sparc/MAKEDEV.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sparc/binstall.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sparc/boot.0 man-sys-catman
|
||||
./usr/share/man/cat8/sparc/installboot.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sparc/makedev.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sparc/tadpolectl.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sparc64/MAKEDEV.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sparc64/installboot.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sparc64/makedev.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/spawn.0 man-postfix-catman
|
||||
./usr/share/man/cat8/spray.0 man-netutil-catman
|
||||
|
|
@ -1685,7 +1682,6 @@
|
|||
./usr/share/man/cat8/sun2/makedev.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sun3/MAKEDEV.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sun3/boot.0 man-sys-catman
|
||||
./usr/share/man/cat8/sun3/installboot.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/sun3/makedev.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/supfilesrv.0 man-sup-catman
|
||||
./usr/share/man/cat8/supscan.0 man-sup-catman
|
||||
|
|
@ -1729,7 +1725,6 @@
|
|||
./usr/share/man/cat8/vax/crash.0 man-sys-catman
|
||||
./usr/share/man/cat8/vax/drtest.0 man-sys-catman
|
||||
./usr/share/man/cat8/vax/format.0 man-sys-catman
|
||||
./usr/share/man/cat8/vax/installboot.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/vax/makedev.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/vipw.0 man-sysutil-catman
|
||||
./usr/share/man/cat8/virtual.0 man-sysutil-catman
|
||||
|
|
@ -2984,7 +2979,6 @@
|
|||
./usr/share/man/man8/algor/makedev.8 man-sysutil-man
|
||||
./usr/share/man/man8/alpha/MAKEDEV.8 man-sysutil-man
|
||||
./usr/share/man/man8/alpha/boot.8 man-sys-man
|
||||
./usr/share/man/man8/alpha/installboot.8 man-sysutil-man
|
||||
./usr/share/man/man8/alpha/makedev.8 man-sysutil-man
|
||||
./usr/share/man/man8/alpha/mkbootimage.8 man-sysutil-man
|
||||
./usr/share/man/man8/alpha/setnetbootinfo.8 man-sysutil-man
|
||||
|
|
@ -3403,11 +3397,9 @@
|
|||
./usr/share/man/man8/sparc/MAKEDEV.8 man-sysutil-man
|
||||
./usr/share/man/man8/sparc/binstall.8 man-sys-man
|
||||
./usr/share/man/man8/sparc/boot.8 man-sys-man
|
||||
./usr/share/man/man8/sparc/installboot.8 man-sysutil-man
|
||||
./usr/share/man/man8/sparc/makedev.8 man-sysutil-man
|
||||
./usr/share/man/man8/sparc/tadpolectl.8 man-sysutil-man
|
||||
./usr/share/man/man8/sparc64/MAKEDEV.8 man-sysutil-man
|
||||
./usr/share/man/man8/sparc64/installboot.8 man-sysutil-man
|
||||
./usr/share/man/man8/sparc64/makedev.8 man-sysutil-man
|
||||
./usr/share/man/man8/spawn.8 man-postfix-man
|
||||
./usr/share/man/man8/spray.8 man-netutil-man
|
||||
|
|
@ -3424,7 +3416,6 @@
|
|||
./usr/share/man/man8/sun2/makedev.8 man-sysutil-man
|
||||
./usr/share/man/man8/sun3/MAKEDEV.8 man-sysutil-man
|
||||
./usr/share/man/man8/sun3/boot.8 man-sys-man
|
||||
./usr/share/man/man8/sun3/installboot.8 man-sysutil-man
|
||||
./usr/share/man/man8/sun3/makedev.8 man-sysutil-man
|
||||
./usr/share/man/man8/supfilesrv.8 man-sup-man
|
||||
./usr/share/man/man8/supscan.8 man-sup-man
|
||||
|
|
@ -3468,7 +3459,6 @@
|
|||
./usr/share/man/man8/vax/crash.8 man-sys-man
|
||||
./usr/share/man/man8/vax/drtest.8 man-sys-man
|
||||
./usr/share/man/man8/vax/format.8 man-sys-man
|
||||
./usr/share/man/man8/vax/installboot.8 man-sysutil-man
|
||||
./usr/share/man/man8/vax/makedev.8 man-sysutil-man
|
||||
./usr/share/man/man8/vipw.8 man-sysutil-man
|
||||
./usr/share/man/man8/virtual.8 man-sysutil-man
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# $NetBSD: obsolete.mi,v 1.49 2002/06/26 16:59:10 bouyer Exp $
|
||||
# $NetBSD: obsolete.mi,v 1.50 2002/06/28 08:45:56 grant Exp $
|
||||
/usr/share/man/cat1/amq.0
|
||||
/usr/share/man/cat1/g711conv.0
|
||||
/usr/share/man/cat1/i386
|
||||
|
|
@ -72,6 +72,7 @@
|
|||
/usr/share/man/cat5/uuencode.format.0
|
||||
/usr/share/man/cat5/ypserv.acl.0
|
||||
/usr/share/man/cat7/miscellaneous.0
|
||||
/usr/share/man/cat8/alpha/installboot.0
|
||||
/usr/share/man/cat8/alpha/installboot.old.0
|
||||
/usr/share/man/cat8/gettable.0
|
||||
/usr/share/man/cat8/greconfig.0
|
||||
|
|
@ -93,12 +94,16 @@
|
|||
/usr/share/man/cat8/portmap.0
|
||||
/usr/share/man/cat8/pppd.cbcp.0
|
||||
/usr/share/man/cat8/rdconfig.0
|
||||
/usr/share/man/cat8/sparc/installboot.0
|
||||
/usr/share/man/cat8/sparc64/installboot.0
|
||||
/usr/share/man/cat8/statmsg.0
|
||||
/usr/share/man/cat8/sun3/installboot.0
|
||||
/usr/share/man/cat8/sun3x
|
||||
/usr/share/man/cat8/sun3x/installboot.0
|
||||
/usr/share/man/cat8/sysconfd.0
|
||||
/usr/share/man/cat8/update.0
|
||||
/usr/share/man/cat8/usbd.0
|
||||
/usr/share/man/cat8/vax/installboot.0
|
||||
/usr/share/man/cat8/vmstat.0
|
||||
/usr/share/man/cat8/xntpd.0
|
||||
/usr/share/man/cat8/xntpdc.0
|
||||
|
|
@ -175,6 +180,7 @@
|
|||
/usr/share/man/man5/securenet.5
|
||||
/usr/share/man/man5/uuencode.format.5
|
||||
/usr/share/man/man5/ypserv.acl.5
|
||||
/usr/share/man/man8/alpha/installboot.8
|
||||
/usr/share/man/man8/alpha/installboot.old.8
|
||||
/usr/share/man/man8/gettable.8
|
||||
/usr/share/man/man8/greconfig.8
|
||||
|
|
@ -196,12 +202,16 @@
|
|||
/usr/share/man/man8/portmap.8
|
||||
/usr/share/man/man8/pppd.cbcp.8
|
||||
/usr/share/man/man8/rdconfig.8
|
||||
/usr/share/man/man8/sparc/installboot.8
|
||||
/usr/share/man/man8/sparc64/installboot.8
|
||||
/usr/share/man/man8/statmsg.8
|
||||
/usr/share/man/man8/sun3/installboot.8
|
||||
/usr/share/man/man8/sun3x
|
||||
/usr/share/man/man8/sun3x/installboot.8
|
||||
/usr/share/man/man8/sysconfd.8
|
||||
/usr/share/man/man8/update.8
|
||||
/usr/share/man/man8/usbd.8
|
||||
/usr/share/man/man8/vax/installboot.8
|
||||
/usr/share/man/man8/vmstat.8
|
||||
/usr/share/man/man8/xntpd.8
|
||||
/usr/share/man/man8/xntpdc.8
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# $NetBSD: Makefile,v 1.6 2002/05/03 15:40:12 lukem Exp $
|
||||
# $NetBSD: Makefile,v 1.7 2002/06/28 08:45:51 grant Exp $
|
||||
|
||||
MAN= MAKEDEV.8 boot.8 installboot.8 mkbootimage.8 setnetbootinfo.8
|
||||
MAN= MAKEDEV.8 boot.8 mkbootimage.8 setnetbootinfo.8
|
||||
MLINKS= MAKEDEV.8 makedev.8
|
||||
MANSUBDIR=/alpha
|
||||
|
||||
|
|
|
|||
|
|
@ -1,212 +0,0 @@
|
|||
.\" $NetBSD: installboot.8,v 1.20 2002/02/13 08:18:24 ross 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 for the
|
||||
.\" NetBSD Project. See http://www.netbsd.org/ for
|
||||
.\" information about NetBSD.
|
||||
.\" 4. 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.
|
||||
.\"
|
||||
.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
|
||||
.\"
|
||||
.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 nsv
|
||||
.Ar disk
|
||||
.Ar bootstrap
|
||||
.Nm /usr/mdec/installboot
|
||||
.Op Fl nsv
|
||||
.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 s
|
||||
Arrange for the final checksum to be Sun and
|
||||
.Nx Ns /sparc Ns -compatible .
|
||||
.if 0 \{\
|
||||
by modifying the sector interior so
|
||||
the alpha 64-bit checksum also contains the embedded 16-bit sum and
|
||||
16-bit magic number expected by such systems.
|
||||
.\}
|
||||
.Em Note :
|
||||
The existing
|
||||
.Nx Ns /sparc
|
||||
disklabel should use no more than 4 partitions.
|
||||
.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 \*[Gt]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/bootxx_lfs
|
||||
primary bootstrap for
|
||||
.Dq lfs
|
||||
file system
|
||||
(BSD Log-Structured File System)
|
||||
.It Pa /usr/mdec/boot
|
||||
secondary bootstrap
|
||||
.El
|
||||
.Sh EXAMPLES
|
||||
.if t .ne 4
|
||||
Install the Berkeley Fast File System primary bootstrap on to disk sd0:
|
||||
.D1 Ic installboot /dev/rsd0c /usr/mdec/bootxx_ffs
|
||||
.Pp
|
||||
Remove the primary bootstrap from disk sd1:
|
||||
.Dl Ic installboot -c /dev/rsd1c
|
||||
.Pp
|
||||
Install the ISO 9660 primary bootstrap in the file
|
||||
.Pa /tmp/cd-image :
|
||||
.Dl Ic installboot /tmp/cd-image /usr/mdec/bootxx_cd9660
|
||||
.Sh SEE ALSO
|
||||
.Xr boot 8 ,
|
||||
.Xr mkbootimage 8
|
||||
.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
|
||||
.Nm
|
||||
utility was written by Chris Demetriou and Ross Harvey.
|
||||
.if 0 \{\
|
||||
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.
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
# @(#)Makefile 5.1 (Berkeley) 3/22/91
|
||||
# $NetBSD: Makefile,v 1.9 2002/01/06 07:44:11 mrg Exp $
|
||||
# $NetBSD: Makefile,v 1.10 2002/06/28 08:45:52 grant Exp $
|
||||
|
||||
MAN= MAKEDEV.8 boot.8 installboot.8 binstall.8
|
||||
MAN= MAKEDEV.8 boot.8 binstall.8
|
||||
MLINKS= MAKEDEV.8 makedev.8
|
||||
MANSUBDIR=/sparc
|
||||
|
||||
|
|
|
|||
|
|
@ -1,215 +0,0 @@
|
|||
.\" $NetBSD: installboot.8,v 1.13 2001/11/24 16:38:08 perry Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" This code is derived from software contributed to The NetBSD Foundation
|
||||
.\" by Paul Kranenburg.
|
||||
.\"
|
||||
.\" 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 NetBSD
|
||||
.\" Foundation, Inc. and its contributors.
|
||||
.\" 4. Neither the name of The NetBSD Foundation 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
|
||||
.\"
|
||||
.Dd November 24, 2001
|
||||
.Dt INSTALLBOOT 8 sparc
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm installboot
|
||||
.Nd install a bootstrap on an FFS file system partition
|
||||
.Sh SYNOPSIS
|
||||
.Nm /usr/mdec/installboot
|
||||
.Op Fl U
|
||||
.Op Fl nv
|
||||
.Ar boot
|
||||
.Ar bootxx
|
||||
.Ar device
|
||||
.Nm /usr/mdec/installboot
|
||||
.Op Fl u
|
||||
.Op Fl nv
|
||||
.Ar bootblk
|
||||
.Ar device
|
||||
.Sh DESCRIPTION
|
||||
.Nm
|
||||
prepares a FFS file system 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
|
||||
(and hence is limited in size to SBSIZE - DEV_BSIZE bytes),
|
||||
and a second-stage program that resides in the file system proper.
|
||||
.Pp
|
||||
The first-stage program is loaded into memory by the PROM. After it receiving
|
||||
control, it loads the second stage program from a set of file system block
|
||||
numbers that have been hard-coded into it by the
|
||||
.Nm
|
||||
program, or, on the UltraSPARC, finds the second stage boot program by a
|
||||
name lookup in the file system.
|
||||
.Pp
|
||||
The second-stage boot program uses the device driver interface to
|
||||
the PROM and the stand-alone file system code in
|
||||
.Dq libsa.a
|
||||
to locate and load the kernel.
|
||||
For non-UltraSPARC machines,
|
||||
the second-stage boot program and the prototype code for the
|
||||
first-stage bootprogram can be found in
|
||||
.Pa /usr/mdec/boot
|
||||
and
|
||||
.Pa /usr/mdec/bootxx
|
||||
respectively. The second-stage program commonly resides in the root directory
|
||||
as
|
||||
.Pa /boot .
|
||||
For UltraSPARC machines, these files live in
|
||||
.Pa /usr/mdec/bootblk
|
||||
and
|
||||
.Pa /usr/mdec/ofwboot
|
||||
respectively, and the second-stage program resides in the root directly as
|
||||
.Pa /ofwboot .
|
||||
The
|
||||
.Pa /usr/mdec/ofwboot.net
|
||||
file includes netboot support and currently must be used to boot a kernel
|
||||
over the network.
|
||||
The utility
|
||||
.Pa /usr/mdec/binstall
|
||||
can be used to properly copy the a second-stage bootprogram to its
|
||||
destination.
|
||||
.Pp
|
||||
Note that not all PROM versions accept the same layout of the first-stage
|
||||
boot program: Sun 4 systems with the
|
||||
.Dq old monitor
|
||||
interface require that executable instructions be present right at the
|
||||
start of the program, while
|
||||
.Tn Openboot
|
||||
machines expect a
|
||||
.Xr a.out 5
|
||||
header on the front of the boot program.
|
||||
.Nm
|
||||
takes care of this by constructing an artificial a.out header which has
|
||||
enough of the magic numbers in it to appease
|
||||
.Tn Openboot
|
||||
ROMs, while simultaneously consisting of instructions
|
||||
(in fact, just a branch past the rest of the header)
|
||||
for Sun 4
|
||||
.Dq old monitor
|
||||
ROMs to execute. On the UltraSPARC machines, the first stage loader
|
||||
is actually a Forth program compiled into Fcode, executed by the Open
|
||||
Firmware.
|
||||
.Pp
|
||||
There are three options with these meaning:
|
||||
.Bl -tag -width flag
|
||||
.It Fl n
|
||||
Do not actually write anything on the disk.
|
||||
.It Fl u
|
||||
Install sparc64 (UltraSPARC) Forth boot block. Note that this option
|
||||
is the default if we are running on a sparc64 machine.
|
||||
.It Fl U
|
||||
Force SPARC boot block semantics. This allows SPARC boot blocks to be
|
||||
installed on an UltraSPARC machine. This option is the default if we
|
||||
are running on a sparc machine.
|
||||
.It Fl v
|
||||
Verbose mode: prints internal informational messages on standard output.
|
||||
.El
|
||||
.Pp
|
||||
The arguments for the standard SPARC are:
|
||||
.Bl -tag -width bootxx
|
||||
.It Ar boot
|
||||
the name of the second-stage boot program in the file system
|
||||
where the first-stage boot program is to be installed.
|
||||
.It Ar bootxx
|
||||
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 boot
|
||||
is mounted.
|
||||
.El
|
||||
.Pp
|
||||
The arguments for the UltraSPARC are:
|
||||
.Bl -tag -width bootblk
|
||||
.It Ar bootblk
|
||||
the name of 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.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width /usr/mdec/installboot -compact
|
||||
.It Pa /usr/mdec/installboot
|
||||
program to install first-stage boot blocks
|
||||
.It Pa /usr/mdec/binstall
|
||||
front-end script to installing boot blocks
|
||||
.It Pa /usr/mdec/bootxx
|
||||
SPARC first-stage boot block
|
||||
.It Pa /usr/mdec/bootblk
|
||||
UltraSPARC first-stage boot block
|
||||
.It Pa /usr/mdec/boot
|
||||
SPARC second-stage boot block
|
||||
.It Pa /usr/mdec/ofwboot
|
||||
UltraSPARC second-stage boot block
|
||||
.It Pa /usr/mdec/ofwboot.net
|
||||
UltraSPARC second-stage network boot block
|
||||
.El
|
||||
.Sh EXAMPLES
|
||||
The following command will install the first-stage bootblocks in the
|
||||
root file system of a SPARC
|
||||
(assumed to be mounted on
|
||||
.Dq sd0a )
|
||||
using the file
|
||||
.Pa /boot
|
||||
as the second-level boot program:
|
||||
.Bd -literal -offset indent
|
||||
/usr/mdec/installboot /boot /usr/mdec/bootxx /dev/rsd0a
|
||||
.Ed
|
||||
.Pp
|
||||
The following command will perform the same, but for an UltraSPARC machine.
|
||||
.Bd -literal -offset indent
|
||||
/usr/mdec/installboot /boot /usr/mdec/bootxx /dev/rsd0a
|
||||
.Ed
|
||||
.Pp
|
||||
The following command will install the first-stage bootblocks for a
|
||||
SPARC machine, whether run on a SPARC or UltraSPARC machine
|
||||
.Bd -literal -offset indent
|
||||
/usr/mdec/installboot -U /boot /usr/mdec/bootxx /dev/rsd0a
|
||||
.Ed
|
||||
.Sh SEE ALSO
|
||||
.Xr disklabel 8 ,
|
||||
.Xr init 8
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm
|
||||
first appeared in
|
||||
.Nx 1.1 .
|
||||
.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
|
||||
(the default),
|
||||
so
|
||||
.Nm
|
||||
only works in single-user mode
|
||||
(or insecure mode - see
|
||||
.Xr init 8 ) .
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
# $NetBSD: Makefile,v 1.3 2000/08/26 02:14:34 mrg Exp $
|
||||
# $NetBSD: Makefile,v 1.4 2002/06/28 08:45:53 grant Exp $
|
||||
|
||||
MAN= MAKEDEV.8 installboot.8
|
||||
MAN= MAKEDEV.8
|
||||
MLINKS= MAKEDEV.8 makedev.8
|
||||
MANSUBDIR=/sparc64
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# @(#)Makefile 5.1 (Berkeley) 3/22/91
|
||||
# $NetBSD: Makefile,v 1.6 1997/10/11 08:22:18 mycroft Exp $
|
||||
# $NetBSD: Makefile,v 1.7 2002/06/28 08:45:53 grant Exp $
|
||||
|
||||
MAN= MAKEDEV.8 boot.8 installboot.8
|
||||
MAN= MAKEDEV.8 boot.8
|
||||
MLINKS= MAKEDEV.8 makedev.8
|
||||
MANSUBDIR=/sun3
|
||||
|
||||
|
|
|
|||
|
|
@ -1,58 +0,0 @@
|
|||
.\" $NetBSD: installboot.8,v 1.9 2001/12/26 02:12:05 wiz Exp $
|
||||
.\"
|
||||
.Dd May 31, 1995
|
||||
.Dt INSTALLBOOT 8 sun3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm installboot
|
||||
.Nd install a bootstrap on a UFS disk
|
||||
.Sh SYNOPSIS
|
||||
.Nm /usr/mdec/installboot
|
||||
.Fl n | Fl v
|
||||
.Ar ufsboot
|
||||
.Ar bootxx
|
||||
.Ar rawdev
|
||||
.Sh DESCRIPTION
|
||||
.Nm
|
||||
is used to install a "first-stage" boot program into the boot area
|
||||
of a UFS disk partition, and initialize the table of block numbers the
|
||||
.Ar bootxx
|
||||
program uses to load the second-stage boot program.
|
||||
.Pp
|
||||
The options are as follows:
|
||||
.Bl -tag -width flag
|
||||
.It Fl n
|
||||
Do not actually write anything on the disk.
|
||||
.It Fl v
|
||||
Be verbose, printing out the block numbers that
|
||||
.Ar bootxx
|
||||
will use to load
|
||||
.Ar ufsboot .
|
||||
.El
|
||||
.Pp
|
||||
The arguments are:
|
||||
.Bl -tag -width ufsboot
|
||||
.It Ar ufsboot
|
||||
the name of the second-stage boot program in the file system
|
||||
where the first-stage boot program is to be installed.
|
||||
.It Ar bootxx
|
||||
the name of the prototype file for the first stage boot program.
|
||||
.It Ar rawdev
|
||||
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 ufsboot
|
||||
is mounted.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr disklabel 8 ,
|
||||
.Xr init 8
|
||||
.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 (the default), so
|
||||
.Nm
|
||||
only works in single-user mode (or insecure mode - see
|
||||
.Xr init 8 ) .
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
# $NetBSD: Makefile,v 1.8 1997/10/19 13:04:24 mrg Exp $
|
||||
# $NetBSD: Makefile,v 1.9 2002/06/28 08:45:54 grant Exp $
|
||||
# from: @(#)Makefile 8.1 (Berkeley) 6/5/93
|
||||
|
||||
MAN= MAKEDEV.8 boot.8 crash.8 drtest.8 format.8 installboot.8
|
||||
MAN= MAKEDEV.8 boot.8 crash.8 drtest.8 format.8
|
||||
MLINKS= MAKEDEV.8 makedev.8
|
||||
MANSUBDIR=/vax
|
||||
|
||||
|
|
|
|||
|
|
@ -1,240 +0,0 @@
|
|||
.\" $NetBSD: installboot.8,v 1.15 2002/02/13 08:18:33 ross 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 for the
|
||||
.\" NetBSD Project. See http://www.netbsd.org/ for
|
||||
.\" information about NetBSD.
|
||||
.\" 4. 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.
|
||||
.\"
|
||||
.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
|
||||
.\"
|
||||
.Dd April 3, 1999
|
||||
.Dt INSTALLBOOT 8 vax
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm installboot
|
||||
.Nd install and remove vax disk and CD-ROM bootstrap software
|
||||
.Sh SYNOPSIS
|
||||
.Nm /usr/mdec/installboot
|
||||
.Op Fl a | Fl i Ar isoblock
|
||||
.Op Fl nsv
|
||||
.Ar disk
|
||||
.Ar bootstrap
|
||||
.Nm /usr/mdec/installboot
|
||||
.Op Fl nsv
|
||||
.Fl c
|
||||
.Ar disk
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
utility installs and removes
|
||||
.Nx Ns Tn /vax
|
||||
disk and CD-ROM bootstrap software. Installing bootstrap
|
||||
software on a device allows the DECstation PROM to boot from that
|
||||
device. As far as the PROM 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 /vax
|
||||
disk bootstrap software consists of two parts: a
|
||||
.Dq primary
|
||||
bootstrap program usually written into the disklabel area of the
|
||||
disk, and a
|
||||
.Dq secondary
|
||||
bootstrap program that usually resides in a file system on the disk.
|
||||
When booting, the primary bootstrap program is loaded and invoked by
|
||||
the PROM. 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 /vax
|
||||
disk bootable by the PROM, 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.vax
|
||||
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.vax
|
||||
in the root directory of the file system which contains it.
|
||||
Note that is is not 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 a
|
||||
Append the primary bootstrap to the end of
|
||||
.Ar disk .
|
||||
.Em Note :
|
||||
this option can be used only if
|
||||
.Ar disk
|
||||
is a regular file.
|
||||
.It Fl c
|
||||
Instead of installing a primary bootstrap program, remove any existing
|
||||
primary bootstrap program.
|
||||
.It Fl i Ar isoblock
|
||||
Install the primary bootstrap at ISO block number
|
||||
.Ar isoblock
|
||||
in the ISO filesystem on
|
||||
.Ar disk .
|
||||
See the
|
||||
.Sx EXAMPLES
|
||||
section below for an example of this option.
|
||||
.It Fl n
|
||||
Do not actually write anything to the disk.
|
||||
.It Fl s
|
||||
Recalculate and restore the Sun and
|
||||
.Nx Ns Tn /sparc
|
||||
compatible checksum. This option is used
|
||||
when making an ISO image which will boot on both
|
||||
.Nx Ns Tn /sparc
|
||||
and
|
||||
.Nx Ns Tn /vax .
|
||||
.Em Note : No The existing
|
||||
.Nx Ns Tn /sparc
|
||||
disklabel should use no more than 4 partitions.
|
||||
.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 \*[Gt]0 if an error occurs.
|
||||
.Sh FILES
|
||||
.Bl -tag -width /usr/mdec/boot.vax -compact
|
||||
.It Pa /usr/mdec/bootxx
|
||||
primary bootstrap program
|
||||
.It Pa /usr/mdec/boot.vax
|
||||
secondary bootstrap
|
||||
.It Pa /boot.vax
|
||||
secondary bootstrap (installed)
|
||||
.El
|
||||
.Sh EXAMPLES
|
||||
.if t .ne 4
|
||||
Install the primary bootstrap to disk sd0:
|
||||
.D1 Ic /usr/mdec/installboot /dev/rsd0c /usr/mdec/bootxx
|
||||
.Pp
|
||||
Remove the primary bootstrap from disk sd1:
|
||||
.Dl Ic /usr/mdec/installboot -c /dev/rsd1c
|
||||
.Pp
|
||||
Install the primary bootstrap in the file
|
||||
.Pa /tmp/cd-image :
|
||||
.Dl Ic /usr/mdec/installboot /tmp/cd-image /usr/mdec/bootxx
|
||||
.Pp
|
||||
Make an ISO 9660 filesystem in the file
|
||||
.Pa /tmp/cd-image
|
||||
and install the primary bootstrap in the filesystem, where the
|
||||
source directory for the ISO 9660 filesystem contains a kernel, the
|
||||
primary bootstrap
|
||||
.Pa bootxx
|
||||
and the secondary bootstrap
|
||||
.Pa boot.vax :
|
||||
.Dl Ic mkisofs -o /tmp/cd-image -a -l -v iso-source-dir
|
||||
.Dl Li ...
|
||||
.Dl Li 48 51 iso-source-dir/bootxx
|
||||
.Dl Li ...
|
||||
.Dl Ic /usr/mdec/installboot -i 48 /tmp/cd-image /usr/mdec/bootxx
|
||||
.Sh SEE ALSO
|
||||
.Xr boot 8
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nx Ns Tn /vax
|
||||
.Nm
|
||||
first appeared in
|
||||
.Nx 1.5 ,
|
||||
and is based on the
|
||||
.Nx Ns Tn /pmax
|
||||
.Nm
|
||||
command that first appeared in
|
||||
.Nx 1.5 .
|
||||
.Sh AUTHORS
|
||||
The
|
||||
.Nx Ns Tn /vax
|
||||
modifications to the
|
||||
.Nm
|
||||
command were written by Matt Thomas. The
|
||||
.Nx Ns Tn /alpha
|
||||
.Nm
|
||||
version of this utility was written by Chris Demetriou and Ross Harvey.
|
||||
The
|
||||
.Nx Ns Tn /alpha
|
||||
.Nm
|
||||
version was modified to produce the
|
||||
.Nx Ns Tn /pmax
|
||||
.Nm
|
||||
by Simon Burge which formed the starting point for this program.
|
||||
.if 0 \{\
|
||||
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 /vax
|
||||
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.
|
||||
Loading…
Reference in New Issue