Remove NetBSD-specific leftover files
This commit is contained in:
Eirikr Hinngart
parent
5188a03964
commit
6b41fd71e8
11980
external/gpl2/gmake/patches/0000-gmake-nbsd.patch
vendored
11980
external/gpl2/gmake/patches/0000-gmake-nbsd.patch
vendored
File diff suppressed because it is too large
Load Diff
37997
external/gpl3/binutils/patches/0000-binutils_nbsd.patch
vendored
37997
external/gpl3/binutils/patches/0000-binutils_nbsd.patch
vendored
File diff suppressed because it is too large
Load Diff
25562
external/gpl3/gcc/patches/0000-gcc_nbsd.patch
vendored
25562
external/gpl3/gcc/patches/0000-gcc_nbsd.patch
vendored
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
|
|
@ -1,863 +0,0 @@
|
|||
.\" $NetBSD: installboot_nbsd.8,v 1.79 2011/11/03 20:09:18 martin Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 2002-2009 The NetBSD Foundation, Inc.
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" This code is derived from software contributed to The NetBSD Foundation
|
||||
.\" by Luke Mewburn of Wasabi Systems.
|
||||
.\"
|
||||
.\" 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.
|
||||
.\"
|
||||
.\" 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 August 3, 2011
|
||||
.Dt INSTALLBOOT 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm installboot_nbsd
|
||||
.Nd install disk bootstrap software
|
||||
.
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Op Fl fnv
|
||||
.Op Fl B Ar s2bno
|
||||
.Op Fl b Ar s1bno
|
||||
.Op Fl o Ar options
|
||||
.Op Fl t Ar fstype
|
||||
.Ar filesystem
|
||||
.Ar primary
|
||||
.Op Ar secondary
|
||||
.Nm
|
||||
.Fl c
|
||||
.Op Fl fnv
|
||||
.Op Fl o Ar options
|
||||
.Op Fl t Ar fstype
|
||||
.Ar filesystem
|
||||
.Nm
|
||||
.Fl e
|
||||
.Op Fl fnv
|
||||
.Op Fl o Ar options
|
||||
.Ar bootstrap
|
||||
.Nm
|
||||
.Fl m(aster)
|
||||
.Ar device
|
||||
.Ar masterboot
|
||||
.
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
utility installs and removes
|
||||
.Nx
|
||||
disk bootstrap software into a file system.
|
||||
.Nm
|
||||
can install
|
||||
.Ar primary
|
||||
into
|
||||
.Ar filesystem ,
|
||||
or disable an existing bootstrap in
|
||||
.Ar filesystem .
|
||||
.Pp
|
||||
On some architectures the options of an existing installed bootstrap,
|
||||
or those of a bootstrap file can be changed.
|
||||
Installing a new primary bootstrap will reset those options to default
|
||||
values.
|
||||
.Pp
|
||||
Generally,
|
||||
.Nx
|
||||
disk bootstrap software consists of two parts: a
|
||||
.Dq primary
|
||||
bootstrap program usually written into the disklabel area of the
|
||||
file system by
|
||||
.Nm ,
|
||||
and a
|
||||
.Dq secondary
|
||||
bootstrap program that usually resides as an ordinary file in the file system.
|
||||
.Pp
|
||||
When booting, the primary bootstrap program is loaded and invoked by
|
||||
the machine's PROM or BIOS.
|
||||
After receiving control of the system it loads and runs the secondary
|
||||
bootstrap program, which in turn loads and runs the kernel.
|
||||
The secondary bootstrap may allow control over various boot parameters
|
||||
passed to the kernel.
|
||||
.Pp
|
||||
Perform the following steps to make a file system bootable:
|
||||
.Bl -enum
|
||||
.It
|
||||
Copy the secondary bootstrap (usually
|
||||
.Pa /usr/mdec/boot. Ns Sy MACHINE
|
||||
or
|
||||
.Pa /usr/mdec/boot )
|
||||
to the root directory of the target file system.
|
||||
.Pp
|
||||
.
|
||||
.It
|
||||
Use
|
||||
.Nm
|
||||
to install the primary bootstrap program
|
||||
(usually
|
||||
.Pa /usr/mdec/bootxx_ Ns Sy FSTYPE )
|
||||
into
|
||||
.Ar filesystem .
|
||||
.Pp
|
||||
The following platforms do not require this step if the primary bootstrap
|
||||
already exists and the secondary bootstrap file is just being updated:
|
||||
.Sy alpha ,
|
||||
.Sy amd64 ,
|
||||
.Sy amiga ,
|
||||
.Sy i386 ,
|
||||
.Sy pmax ,
|
||||
.Sy sparc64 ,
|
||||
and
|
||||
.Sy vax .
|
||||
.Pp
|
||||
The following platform does not require the first step since a
|
||||
single bootstrap file is used.
|
||||
The single bootstrap is installed like the primary bootstrap on
|
||||
other platforms:
|
||||
.Sy next68k .
|
||||
.Pp
|
||||
.El
|
||||
.Pp
|
||||
The options and arguments recognized by
|
||||
.Nm
|
||||
are as follows:
|
||||
.
|
||||
.Bl -tag -width "optionsxxx"
|
||||
.
|
||||
.It Fl B Ar s2bno
|
||||
When hard-coding the blocks of
|
||||
.Ar secondary
|
||||
into
|
||||
.Ar primary ,
|
||||
start from block
|
||||
.Ar s2bno
|
||||
instead of trying to determine the block numbers occupied by
|
||||
.Ar secondary
|
||||
by examining
|
||||
.Ar filesystem .
|
||||
If this option is supplied,
|
||||
.Ar secondary
|
||||
should refer to an actual secondary bootstrap (rather than the
|
||||
file name of the one present in
|
||||
.Ar filesystem )
|
||||
so that its size can be determined.
|
||||
.
|
||||
.It Fl b Ar s1bno
|
||||
Install
|
||||
.Ar primary
|
||||
at block number
|
||||
.Ar s1bno
|
||||
instead of the default location for the machine and file system type.
|
||||
.Sy [ alpha ,
|
||||
.Sy pmax ,
|
||||
.Sy vax ]
|
||||
.
|
||||
.It Fl c
|
||||
Clear (remove) any existing bootstrap instead of installing one.
|
||||
.
|
||||
.It Fl e
|
||||
Edit the options of an existing bootstrap.
|
||||
This can be use to change the options in bootxx_xxxfs files,
|
||||
raw disk partitions, and the
|
||||
.Pa pxeboot_ia32.bin
|
||||
file.
|
||||
With
|
||||
.Fl v
|
||||
and without
|
||||
.Fl o ,
|
||||
show the current options.
|
||||
.Sy [ amd64 , i386 ]
|
||||
.
|
||||
.It Fl f
|
||||
Forces
|
||||
.Nm
|
||||
to ignore some errors.
|
||||
.
|
||||
.It Fl n
|
||||
Do not write to
|
||||
.Ar filesystem .
|
||||
.
|
||||
.It Fl o Ar options
|
||||
Machine specific
|
||||
.Nm
|
||||
options, comma separated.
|
||||
.Pp
|
||||
Supported options are (with the machines for they are valid in brackets):
|
||||
.
|
||||
.Bl -tag -offset indent -width alphasum
|
||||
.
|
||||
.It Sy alphasum
|
||||
.Sy [ alpha ]
|
||||
Recalculate and restore the Alpha checksum.
|
||||
This is the default for
|
||||
.Nx Ns Tn /alpha .
|
||||
.
|
||||
.It Sy append
|
||||
.Sy [ alpha ,
|
||||
.Sy pmax ,
|
||||
.Sy vax ]
|
||||
Append
|
||||
.Ar primary
|
||||
to the end of
|
||||
.Ar filesystem ,
|
||||
which must be a regular file in this case.
|
||||
.
|
||||
.It Sy bootconf
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
(Don't) read a
|
||||
.Dq boot.cfg
|
||||
file.
|
||||
.
|
||||
.It Sy command=\*[Lt]boot command\*[Gt]
|
||||
.Sy [ amiga ]
|
||||
Modify the default boot command line.
|
||||
.
|
||||
.It Sy console=\*[Lt]console name\*[Gt]
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
Set the console device, \*[Lt]console name\*[Gt] must be one of:
|
||||
pc, com0, com1, com2, com3, com0kbd, com1kbd, com2kbd or com3kbd.
|
||||
.
|
||||
.It Sy ioaddr=\*[Lt]ioaddr\*[Gt]
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
Set the IO address to be used for the console serial port.
|
||||
Defaults to the IO address used by the system BIOS for the specified port.
|
||||
.
|
||||
.It Sy keymap=\*[Lt]keymap\*[Gt]
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
Set a boot time keyboard translation map.
|
||||
Each character in \*[Lt]keymap\*[Gt] will be replaced by the one following it.
|
||||
For example, an argument of
|
||||
.Dq zyz
|
||||
would swap the lowercase letters
|
||||
.Sq y
|
||||
and
|
||||
.Sq z .
|
||||
.
|
||||
.It Sy modules
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
(Don't) load kernel modules.
|
||||
.
|
||||
.It Sy password=\*[Lt]password\*[Gt]
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
Set the password which must be entered before the boot menu can be accessed.
|
||||
.
|
||||
.It Sy resetvideo
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
Reset the video before booting.
|
||||
.
|
||||
.It Sy speed=\*[Lt]baud rate\*[Gt]
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
Set the baud rate for the serial console.
|
||||
If a value of zero is specified, then the current baud rate (set by the
|
||||
BIOS) will be used.
|
||||
.
|
||||
.It Sy sunsum
|
||||
.Sy [ alpha ,
|
||||
.Sy pmax ,
|
||||
.Sy vax ]
|
||||
Recalculate and restore the Sun and
|
||||
.Nx Ns Tn /sparc
|
||||
compatible checksum.
|
||||
.Em Note :
|
||||
The existing
|
||||
.Nx Ns Tn /sparc
|
||||
disklabel should use no more than 4 partitions.
|
||||
.
|
||||
.It Sy timeout=\*[Lt]seconds\*[Gt]
|
||||
.Sy [ amd64 ,
|
||||
.Sy i386 ]
|
||||
Set the timeout before the automatic boot begins to the given number of seconds.
|
||||
.El
|
||||
.
|
||||
.It Fl t Ar fstype
|
||||
Use
|
||||
.Ar fstype
|
||||
as the type of
|
||||
.Ar filesystem .
|
||||
The default operation is to attempt to auto-detect this setting.
|
||||
The following file system types are currently supported by
|
||||
.Nm :
|
||||
.
|
||||
.Bl -tag -offset indent -width raid
|
||||
.
|
||||
.It Sy ffs
|
||||
.Bx
|
||||
Fast File System.
|
||||
.
|
||||
.It Sy raid
|
||||
Mirrored RAIDframe File System.
|
||||
.
|
||||
.It Sy raw
|
||||
.Sq Raw
|
||||
image.
|
||||
Note: if a platform needs to hard-code the block offset of the secondary
|
||||
bootstrap, it cannot be searched for on this file system type, and must
|
||||
be provided with
|
||||
.Fl B Ar s2bno .
|
||||
.El
|
||||
.
|
||||
.It Fl v
|
||||
Verbose operation.
|
||||
.
|
||||
.It Ar filesystem
|
||||
The path name of the device or file system image that
|
||||
.Nm
|
||||
is to operate on.
|
||||
It is not necessary for
|
||||
.Ar filesystem
|
||||
to be a currently mounted file system.
|
||||
.
|
||||
.It Ar primary
|
||||
The path name of the
|
||||
.Dq primary
|
||||
boot block to install.
|
||||
The path name must refer to a file in a file system that is currently
|
||||
mounted.
|
||||
.
|
||||
.It Ar secondary
|
||||
The path name of the
|
||||
.Dq secondary
|
||||
boot block, relative to the root of
|
||||
the file system in the device or image specified by the
|
||||
.Ar filesystem
|
||||
argument.
|
||||
Note that this may refer to a file in a file system that is not mounted.
|
||||
Most systems require
|
||||
.Ar secondary
|
||||
to be in the
|
||||
.Dq root
|
||||
directory of the file system, so the leading
|
||||
.Dq Pa /
|
||||
is not necessary on
|
||||
.Ar secondary .
|
||||
.Pp
|
||||
Only certain combinations of
|
||||
platform
|
||||
.Pq Fl m Ar machine
|
||||
and file system type
|
||||
.Pq Fl t Ar fstype
|
||||
require that the name of the secondary bootstrap is
|
||||
supplied as
|
||||
.Ar secondary ,
|
||||
so that information such as the disk block numbers occupied
|
||||
by the secondary bootstrap can be stored in the primary bootstrap.
|
||||
These are:
|
||||
.Bl -column "Platform" "File systems" -offset indent
|
||||
.It Sy "Platform" Ta Sy "File systems"
|
||||
.It macppc Ta ffs, raw
|
||||
.It news68k Ta ffs, raw
|
||||
.It newsmips Ta ffs, raw
|
||||
.It sparc Ta ffs, raid, raw
|
||||
.It sun2 Ta ffs, raw
|
||||
.It sun3 Ta ffs, raw
|
||||
.El
|
||||
.El
|
||||
.Pp
|
||||
.Nm
|
||||
exits 0 on success, and \*[Gt]0 if an error occurs.
|
||||
.
|
||||
.Sh ENVIRONMENT
|
||||
.Nm
|
||||
uses the following environment variables:
|
||||
.
|
||||
.Bl -tag -width "MACHINE"
|
||||
.
|
||||
.It Ev MACHINE
|
||||
Default value for
|
||||
.Ar machine ,
|
||||
overriding the result from
|
||||
.Xr uname 3 .
|
||||
.
|
||||
.El
|
||||
.
|
||||
.Sh FILES
|
||||
Most
|
||||
.Nx
|
||||
ports will contain variations of the following files:
|
||||
.Pp
|
||||
.Bl -tag -width /usr/mdec/bootxx_ustarfs
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_ Ns Sy FSTYPE
|
||||
Primary bootstrap for file system type
|
||||
.Sy FSTYPE .
|
||||
Installed into the bootstrap area of the file system by
|
||||
.Nm .
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_fat16
|
||||
Primary bootstrap for
|
||||
.Tn MS-DOS
|
||||
.Sy FAT16
|
||||
file systems.
|
||||
This differs from
|
||||
.Nm bootxx_msdos
|
||||
in that it doesn't require the filesystem to have been initialised with
|
||||
any
|
||||
.Ql reserved sectors .
|
||||
It also uses the information in the
|
||||
.Ql Boot Parameter Block
|
||||
to get the media and filesytem properties.
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_ffsv1
|
||||
Primary bootstrap for
|
||||
.Sy FFSv1
|
||||
file systems
|
||||
(the "traditional"
|
||||
.Nx
|
||||
file system).
|
||||
Use
|
||||
.Xr dumpfs 8
|
||||
to confirm the file system format is
|
||||
.Sy FFSv1 .
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_ffsv2
|
||||
Primary bootstrap for
|
||||
.Sy FFSv2
|
||||
file systems.
|
||||
Use
|
||||
.Xr dumpfs 8
|
||||
to confirm the file system format is
|
||||
.Sy FFSv2 .
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_lfsv1
|
||||
Primary bootstrap for
|
||||
.Sy LFSv1
|
||||
file systems.
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_lfsv2
|
||||
Primary bootstrap for
|
||||
.Sy LFSv2
|
||||
file systems
|
||||
(the default LFS version).
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_msdos
|
||||
Primary bootstrap for
|
||||
.Tn MS-DOS
|
||||
.Sy FAT
|
||||
file systems.
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx_ustarfs
|
||||
Primary bootstrap for
|
||||
.Sy TARFS
|
||||
boot images.
|
||||
This is used by various install media.
|
||||
.
|
||||
.It Pa /usr/mdec/boot. Ns Sy MACHINE
|
||||
Secondary bootstrap for machine type
|
||||
.Sy MACHINE .
|
||||
This should be installed into the file system before
|
||||
.Nm
|
||||
is run.
|
||||
.
|
||||
.It Pa /usr/mdec/boot
|
||||
Synonym for
|
||||
.Pa /usr/mdec/boot. Ns Sy MACHINE
|
||||
.
|
||||
.It Pa /boot. Ns Sy MACHINE
|
||||
Installed copy of secondary bootstrap for machine type
|
||||
.Sy MACHINE .
|
||||
.
|
||||
.It Pa /boot
|
||||
Installed copy of secondary bootstrap.
|
||||
Searched for by the primary bootstrap if
|
||||
.Pa /boot. Ns Sy MACHINE
|
||||
is not found.
|
||||
.
|
||||
.El
|
||||
.
|
||||
.Ss Nx Ns Tn /macppc files
|
||||
.
|
||||
.Bl -tag -width /usr/mdec/bootxx_ustarfs
|
||||
.
|
||||
.It Pa /usr/mdec/bootxx
|
||||
.Nx Ns Tn /macppc
|
||||
primary bootstrap.
|
||||
.
|
||||
.It Pa /usr/mdec/ofwboot
|
||||
.Nx Ns Tn /macppc
|
||||
secondary bootstrap.
|
||||
.
|
||||
.It Pa /ofwboot
|
||||
Installed copy of
|
||||
.Nx Ns Tn /macppc
|
||||
secondary bootstrap.
|
||||
.
|
||||
.El
|
||||
.
|
||||
.Ss Nx Ns Tn /next68k files
|
||||
.
|
||||
.Bl -tag -width /usr/mdec/bootxx_ustarfs
|
||||
.
|
||||
.It Pa /usr/mdec/boot
|
||||
.Nx Ns Tn /next68k
|
||||
bootstrap.
|
||||
.
|
||||
.El
|
||||
.
|
||||
.Ss Nx Ns Tn /sparc64 files
|
||||
.
|
||||
.Bl -tag -width /usr/mdec/bootxx_ustarfs
|
||||
.
|
||||
.It Pa /usr/mdec/bootblk
|
||||
.Nx Ns Tn /sparc64
|
||||
primary bootstrap.
|
||||
.
|
||||
.It Pa /usr/mdec/ofwboot
|
||||
.Nx Ns Tn /sparc64
|
||||
secondary bootstrap.
|
||||
.
|
||||
.It Pa /ofwboot
|
||||
Installed copy of
|
||||
.Nx Ns Tn /sparc64
|
||||
secondary bootstrap.
|
||||
.
|
||||
.El
|
||||
.
|
||||
.Sh EXAMPLES
|
||||
.
|
||||
.Ss common
|
||||
Verbosely install the Berkeley Fast File System primary bootstrap on to disk
|
||||
.Sq sd0 :
|
||||
.Dl Ic installboot_nbsd -v /dev/rsd0c /usr/mdec/bootxx_ffs
|
||||
Note: the
|
||||
.Dq whole disk
|
||||
partition (c on some ports, d on others) is used here, since the a partition
|
||||
probably is already opened (mounted as
|
||||
.Pa / ) ,
|
||||
so
|
||||
.Nm
|
||||
would not be able to access it.
|
||||
.Pp
|
||||
Remove the primary bootstrap from disk
|
||||
.Sq sd1 :
|
||||
.Dl Ic installboot_nbsd -c /dev/rsd1c
|
||||
.
|
||||
.Ss Nx Ns Tn /amiga
|
||||
Modify the command line to change the default from "netbsd -ASn2" to
|
||||
"netbsd -S":
|
||||
.Dl Ic installboot_nbsd -m amiga -o command="netbsd -S" /dev/rsd0a /usr/mdec/bootxx_ffs
|
||||
.
|
||||
.Ss Nx Ns Tn /ews4800mips
|
||||
Install the System V Boot File System primary bootstrap on to disk
|
||||
.Sq sd0 ,
|
||||
with the secondary bootstrap
|
||||
.Sq Pa /boot
|
||||
already present in the SysVBFS partition on the disk:
|
||||
.Dl Ic installboot_nbsd /dev/rsd0c /usr/mdec/bootxx_bfs
|
||||
.
|
||||
.Ss Nx Ns Tn /i386 and Nx Ns Tn /amd64
|
||||
Install new boot blocks on an existing mounted root file system on
|
||||
.Sq wd0 ,
|
||||
setting the timeout to five seconds, after copying a new secondary
|
||||
bootstrap:
|
||||
.Dl Ic cp /usr/mdec/boot /boot
|
||||
.Dl Ic installboot_nbsd -v -o timeout=5 /dev/rwd0a /usr/mdec/bootxx_ffsv1
|
||||
.
|
||||
.Pp
|
||||
Create a bootable CD-ROM with an ISO9660
|
||||
file system for an i386 system with a serial console:
|
||||
.Dl Ic mkdir cdrom
|
||||
.Dl Ic cp sys/arch/i386/compile/mykernel/netbsd cdrom/netbsd
|
||||
.Dl Ic cp /usr/mdec/boot cdrom/boot
|
||||
.Dl Ic cp /usr/mdec/bootxx_cd9660 bootxx
|
||||
.Dl Ic installboot_nbsd -o console=com0,speed=19200 -m i386 -e bootxx
|
||||
.Dl Ic makefs -t cd9660 -o 'bootimage=i386;bootxx,no-emul-boot' boot.iso \
|
||||
cdrom
|
||||
.
|
||||
.Pp
|
||||
Create a bootable floppy disk with an FFSv1
|
||||
file system for a small custom kernel (note: bigger kernels needing
|
||||
multiple disks are handled with the ustarfs file system):
|
||||
.Dl Ic newfs -s 1440k /dev/rfd0a
|
||||
.Bd -ragged -offset indent-two -compact
|
||||
.Em Note :
|
||||
Ignore the warnings that
|
||||
.Xr newfs 8
|
||||
displays; it can not write a disklabel,
|
||||
which is not a problem for a floppy disk.
|
||||
.Ed
|
||||
.Dl Ic mount /dev/fd0a /mnt
|
||||
.Dl Ic cp /usr/mdec/boot /mnt/boot
|
||||
.Dl Ic gzip -9 \*[Lt] sys/arch/i386/compile/mykernel/netbsd \*[Gt] /mnt/netbsd.gz
|
||||
.Dl Ic umount /mnt
|
||||
.Dl Ic installboot_nbsd -v /dev/rfd0a /usr/mdec/bootxx_ffsv1
|
||||
.
|
||||
.Pp
|
||||
Create a bootable FAT file system on
|
||||
.Sq wd1a ,
|
||||
which should have the same offset and size as a FAT primary partition
|
||||
in the Master Boot Record (MBR):
|
||||
.Dl Ic newfs_msdos -r 16 /dev/rwd1a
|
||||
.Bd -ragged -offset indent-two -compact
|
||||
.Em Notes :
|
||||
The
|
||||
.Fl r Ar 16
|
||||
is to reserve space for the primary bootstrap.
|
||||
.Xr newfs_msdos 8
|
||||
will display an
|
||||
.Dq MBR type
|
||||
such as
|
||||
.Ql 1 ,
|
||||
.Ql 4 ,
|
||||
or
|
||||
.Ql 6 ;
|
||||
the MBR partition type of the appropriate primary partition should be
|
||||
changed to this value.
|
||||
.Ed
|
||||
.Dl Ic mount -t msdos /dev/wd1a /mnt
|
||||
.Dl Ic cp /usr/mdec/boot /mnt/boot
|
||||
.Dl Ic cp path/to/kernel /mnt/netbsd
|
||||
.Dl Ic umount /mnt
|
||||
.Dl Ic installboot_nbsd -t raw /dev/rwd1a /usr/mdec/bootxx_msdos
|
||||
.Pp
|
||||
Make the existing FAT16 filesystem on
|
||||
.Sq sd0e
|
||||
bootable.
|
||||
This can be used to make USB memory bootable provided it has 512 byte
|
||||
sectors and that the manufacturer correctly initialised the file system.
|
||||
.Dl Ic mount -t msdos /dev/sd0e /mnt
|
||||
.Dl Ic cp /usr/mdec/boot /mnt/boot
|
||||
.Dl Ic cp path/to/kernel /mnt/netbsd
|
||||
.Dl Ic umount /mnt
|
||||
.Dl Ic installboot_nbsd /dev/rsd0e /usr/mdec/bootxx_fat16
|
||||
It may also be necessary to use
|
||||
.Nm fdisk
|
||||
to make the device itself bootable.
|
||||
.
|
||||
.Pp
|
||||
Switch the existing installed bootstrap to use a serial console without
|
||||
reinstalling or altering other options such as timeout.
|
||||
.Dl Ic installboot_nbsd -e -o console=com0 /dev/rwd0a
|
||||
.Ss Nx Ns Tn /macppc
|
||||
Note the
|
||||
.Nm
|
||||
utility is only required for macppc machines with OpenFirmware version 2
|
||||
to boot.
|
||||
OpenFirmware 3 cannot load bootblocks specified in the Apple partition
|
||||
map.
|
||||
.Pp
|
||||
Install the Berkeley Fast File System primary bootstrap on to disk
|
||||
.Sq wd0 :
|
||||
.Dl Ic installboot_nbsd /dev/rwd0c /usr/mdec/bootxx /ofwboot
|
||||
.Pp
|
||||
The secondary
|
||||
.Nx Ns Tn /macppc
|
||||
bootstrap is located in
|
||||
.Pa /usr/mdec/ofwboot .
|
||||
.Pp
|
||||
The primary bootstrap requires the raw
|
||||
.Pa ofwboot
|
||||
for the secondary bootstrap, not
|
||||
.Pa ofwboot.xcf ,
|
||||
which is used for the OpenFirmware to load kernels.
|
||||
.Ss Nx Ns Tn /next68k
|
||||
Install the bootstrap on to disk
|
||||
.Sq sd0 :
|
||||
.Dl Ic installboot_nbsd /dev/rsd0c /usr/mdec/boot
|
||||
.Pp
|
||||
.
|
||||
.Ss Nx Ns Tn /pmax
|
||||
Install the Berkeley Fast File System primary bootstrap on to disk
|
||||
.Sq sd0 :
|
||||
.Dl Ic installboot_nbsd /dev/rsd0c /usr/mdec/bootxx_ffs
|
||||
.Pp
|
||||
.Nx Ns Tn /pmax
|
||||
requires that this file system starts at block 0 of the disk.
|
||||
.Pp
|
||||
Install the ISO 9660 primary bootstrap in the file
|
||||
.Pa /tmp/cd-image :
|
||||
.Dl Ic installboot_nbsd -m pmax /tmp/cd-image /usr/mdec/bootxx_cd9660
|
||||
.Pp
|
||||
Make an ISO 9660 filesystem in the file
|
||||
.Pa /tmp/cd-image
|
||||
and install the ISO 9660 primary bootstrap in the filesystem, where the
|
||||
source directory for the ISO 9660 filesystem contains a kernel, the
|
||||
primary bootstrap
|
||||
.Pa bootxx_cd9660
|
||||
and the secondary bootstrap
|
||||
.Pa boot.pmax :
|
||||
.Dl Ic mkisofs -o /tmp/cd-image -a -l -v iso-source-dir
|
||||
.Dl ...
|
||||
.Dl 48 51 iso-source-dir/bootxx_cd9660
|
||||
.Dl ...
|
||||
.Dl Ic installboot_nbsd -b `expr 48 \e* 4` /tmp/cd-image /usr/mdec/bootxx_cd9660
|
||||
.
|
||||
.Ss Nx Ns Tn /sparc
|
||||
Install the Berkeley Fast File System primary bootstrap on to disk
|
||||
.Sq sd0 ,
|
||||
with the secondary bootstrap
|
||||
.Sq Pa /boot
|
||||
already present:
|
||||
.Dl Ic installboot_nbsd /dev/rsd0c /usr/mdec/bootxx /boot
|
||||
.
|
||||
.Ss Nx Ns Tn /sparc64
|
||||
Install the primary bootstrap on to disk
|
||||
.Sq sd0 :
|
||||
.Dl Ic installboot_nbsd /dev/rsd0c /usr/mdec/bootblk
|
||||
.Pp
|
||||
The secondary
|
||||
.Nx Ns Tn /sparc64
|
||||
bootstrap is located in
|
||||
.Pa /usr/mdec/ofwboot .
|
||||
.
|
||||
.Ss Nx Ns Tn /sun2 and Nx Ns Tn /sun3
|
||||
Install the Berkeley Fast File System primary bootstrap on to disk
|
||||
.Sq sd0 ,
|
||||
with the secondary bootstrap
|
||||
.Sq Pa /boot
|
||||
already present:
|
||||
.Dl Ic installboot_nbsd /dev/rsd0c /usr/mdec/bootxx /boot
|
||||
.
|
||||
.Sh SEE ALSO
|
||||
.Xr uname 3 ,
|
||||
.Xr boot 8 ,
|
||||
.Xr disklabel 8 ,
|
||||
.Xr dumpfs 8 ,
|
||||
.Xr fdisk 8 ,
|
||||
.Xr pxeboot 8
|
||||
.
|
||||
.Sh HISTORY
|
||||
This implementation of
|
||||
.Nm
|
||||
appeared in
|
||||
.Nx 1.6 .
|
||||
.
|
||||
.Sh AUTHORS
|
||||
The machine independent portion of this implementation of
|
||||
.Nm
|
||||
was written by Luke Mewburn.
|
||||
The following people contributed to the various machine dependent
|
||||
back-ends:
|
||||
Simon Burge (pmax),
|
||||
Chris Demetriou (alpha),
|
||||
Matthew Fredette (sun2, sun3),
|
||||
Matthew Green (sparc64),
|
||||
Ross Harvey (alpha),
|
||||
Michael Hitch (amiga),
|
||||
Paul Kranenburg (sparc),
|
||||
David Laight (i386),
|
||||
Christian Limpach (next68k),
|
||||
Luke Mewburn (macppc),
|
||||
Matt Thomas (vax),
|
||||
Izumi Tsutsui (news68k, newsmips),
|
||||
and
|
||||
UCHIYAMA Yasushi (ews4800mips).
|
||||
.
|
||||
.Sh BUGS
|
||||
There are not currently primary bootstraps to support all file systems
|
||||
types which are capable of being the root file system.
|
||||
.Pp
|
||||
If a disk has been converted from
|
||||
.Sy FFS
|
||||
to
|
||||
.Sy RAID
|
||||
without the contents of the disk erased, then the original
|
||||
.Sy FFS
|
||||
installation may be auto-detected instead of the
|
||||
.Sy RAID
|
||||
installation.
|
||||
In this case, the
|
||||
.Fl t Ar raid
|
||||
option must be provided.
|
||||
.
|
||||
.Ss Nx Ns Tn /alpha
|
||||
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 accommodate larger
|
||||
ones.
|
||||
.
|
||||
.Ss Nx Ns Tn /hp300
|
||||
The disk must have a boot partition large enough to hold the bootstrap code.
|
||||
Currently the primary bootstrap must be a LIF format file.
|
||||
.
|
||||
.Ss Nx Ns Tn /i386 and Nx Ns Tn /amd64
|
||||
The bootstrap must be installed in the
|
||||
.Nx
|
||||
partition that starts at the beginning of the mbr partition.
|
||||
If that is a valid filesystem and contains the
|
||||
.Pa /boot
|
||||
program then it will be used as the root filesystem, otherwise the
|
||||
.Sq a
|
||||
partition will be booted.
|
||||
.Pp
|
||||
The size of primary bootstrap programs is restricted to 8KB, even
|
||||
though some file systems (e.g., ISO 9660) are able to accommodate larger
|
||||
ones.
|
||||
.
|
||||
.Ss Nx Ns Tn /macppc
|
||||
Due to restrictions in
|
||||
.Nm
|
||||
and the secondary bootstrap implementation, file systems where kernels exist
|
||||
must start at the beginning of disks.
|
||||
.Pp
|
||||
Currently,
|
||||
.Nm
|
||||
doesn't recognize an existing Apple partition map on the disk
|
||||
and always writes a faked map to make disks bootable.
|
||||
.Pp
|
||||
The
|
||||
.Nx Ns Tn /macppc
|
||||
bootstrap program can't load kernels from
|
||||
.Sy FFSv2
|
||||
partitions.
|
||||
.Ss Nx Ns Tn /next68k
|
||||
The size of bootstrap programs is restricted to the free space before
|
||||
the file system at the beginning of the disk minus 8KB.
|
||||
.
|
||||
.Ss Nx Ns Tn /pmax
|
||||
The
|
||||
.Nx Ns Tn /pmax
|
||||
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 accommodate larger
|
||||
ones.
|
||||
.
|
||||
.Ss Nx Ns Tn /sun2 and Nx Ns Tn /sun3
|
||||
The
|
||||
.Nx Ns Tn /sun2
|
||||
and
|
||||
.Nx Ns Tn /sun3
|
||||
secondary bootstrap program can only load kernels from file
|
||||
systems starting at the beginning of disks.
|
||||
.
|
||||
.Ss Nx Ns Tn /vax
|
||||
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 accommodate larger
|
||||
ones.
|
||||
Loading…
Reference in New Issue
Block a user