diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 15:32:58 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 15:32:58 -0400 |
| commit | 5cb84ec742fd33f78c8022863fadaa8d0d93e176 (patch) | |
| tree | 1a81ca3665e6153923e40db7b0d988f8573ab59c /static/netbsd/man8/man8.prep | |
| parent | a59214f344567c037d5776879bcfc5fcc1d4d5f6 (diff) | |
feat: Added NetBSD man pages
Diffstat (limited to 'static/netbsd/man8/man8.prep')
| -rw-r--r-- | static/netbsd/man8/man8.prep/Makefile | 4 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.prep/boot.8 | 86 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.prep/mkbootimage.8 | 153 |
3 files changed, 243 insertions, 0 deletions
diff --git a/static/netbsd/man8/man8.prep/Makefile b/static/netbsd/man8/man8.prep/Makefile new file mode 100644 index 00000000..5b657add --- /dev/null +++ b/static/netbsd/man8/man8.prep/Makefile @@ -0,0 +1,4 @@ +MAN = $(wildcard *.8) + +include ../../../mandoc.mk + diff --git a/static/netbsd/man8/man8.prep/boot.8 b/static/netbsd/man8/man8.prep/boot.8 new file mode 100644 index 00000000..d5c3d021 --- /dev/null +++ b/static/netbsd/man8/man8.prep/boot.8 @@ -0,0 +1,86 @@ +.\" $NetBSD: boot.8,v 1.4 2017/02/17 22:30:28 christos Exp $ +.\" Copyright (c) 2006 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Tim Rightnour +.\" +.\" 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 February 17, 2017 +.Dt BOOT 8 prep +.Os +.Sh NAME +.Nm boot +.Nd system bootstrapping procedures +.Sh SYNOPSIS +.Nm boot +.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 Cold starts +The prep architecture does not allow the direct booting of a kernel +from the hard drive. +Instead it requires a complete boot image to be loaded. +This boot image contains a +.Nx +kernel, which will then provide access to the devices on the machine. +The image can be placed on any device that the firmware considers +a bootable device. +Usually this is either a SCSI disk, tape, CD-ROM, or floppy drive. +.Ss Boot program options +The prep architecture and bootloader does not support any option +parsing at the boot prompt. +.Ss Boot partition +The prep port requires a special boot partition on the primary boot +device in order to load the kernel. +This partition consists of a PC-style i386 partition label, a small +bootloader, and a kernel image. +The prep firmware looks for a partition of type 0x41 (65) and +expects the bootloader, immediately followed by the kernel, to be +there. +The +.Xr prep/mkbootimage 8 +command needs to be used to generate this image. +.Sh FILES +.Bl -tag -width /usr/mdec/boot_com0xx -compact +.It Pa /netbsd +system code +.It Pa /usr/mdec/boot +system bootstrap +.It Pa /usr/mdec/boot_com0 +system bootstrap with serial console +.El +.Sh SEE ALSO +.Xr disklabel 8 , +.Xr fsck 8 , +.Xr halt 8 , +.Xr init 8 , +.Xr installboot 8 , +.Xr prep/mkbootimage 8 , +.Xr rc 8 , +.Xr shutdown 8 , +.Xr syslogd 8 diff --git a/static/netbsd/man8/man8.prep/mkbootimage.8 b/static/netbsd/man8/man8.prep/mkbootimage.8 new file mode 100644 index 00000000..c53d8bb8 --- /dev/null +++ b/static/netbsd/man8/man8.prep/mkbootimage.8 @@ -0,0 +1,153 @@ +.\" $NetBSD: mkbootimage.8,v 1.8 2017/02/18 21:47:11 wiz Exp $ +.\" Copyright (c) 2006 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Tim Rightnour +.\" +.\" 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 February 17, 2017 +.Dt MKBOOTIMAGE 8 prep +.Os +.Sh NAME +.Nm mkbootimage +.Nd create a prep boot image +.Sh SYNOPSIS +.Nm +.Op Fl lsv +.Op Fl b Ar bootfile +.Op Fl k Ar kernel +.Op Fl m Ar machine_arch +.Op Fl r Ar rawdev +.Ar boot-image +.Sh DESCRIPTION +.Nm +is the utility used to create a bootable kernel image on +.Nx +for prep, bebox or rs6000. +.Pp +The +.Nm +utility takes the boot-program, and the optional kernel, and creates a boot +image from them. +This image contains the boot code, kernel, and optionally +an i386 partition table. +The image can be written directly to a floppy or hard drive with +the +.Xr dd 1 +command, or it can be directly netbooted via +.Xr bootpd 8 . +.Pp +The following options are available: +.Bl -tag -width indent +.It Fl b +Specifies which bootloader to embed in the bootable image. +Defaults to +.Pa /usr/mdec/boot . +.It Fl k +Specifies which kernel binary to embed in the bootable image. +Defaults to +.Pa /netbsd . +.It Fl l +Creates a partition table for a 2.88MB floppy instead of a 1.44MB floppy. +This is primarily used for El-Torrito style CD images. +.It Fl m +Selects the machine architecture to build the image for. +Currently supports prep, rs6000 and bebox. +Defaults to the machine architecture you are currently running on. +This option is required if you are building an image for another machine, such +as building a prep boot image on i386. +.It Fl r +Specifies the raw device to read to gather the current partition table. +This is generally +.Pa /dev/rsd0c . +.It Fl s +Generates a standalone image with no partition table embedded. +.It Fl v +Generates verbose output, useful for debugging. +.El +.Pp +There are three primary ways to use +.Nm +to build a bootable image: +.Pp +The first method is to build an image suitable for a floppy or netboot. +This will create an image with an embedded partition table with a +single PReP boot partition of type 0x41(65). +The image can be directly netbooted, or if it +is small enough, written directly to a floppy with +.Xr dd 1 . +.Nm +will warn you if the generated image is too large to be written to a floppy. +.Pp +The second method is to build a standalone image with no partition table. +This should be written to the PReP boot partition on your hard drive with +.Xr dd 1 . +.Pp +The third method is for use in upgrading older systems that have +been built by writing the floppy image directly to the head of the +hard drive. +This method reads the existing partition table and embeds that in +the image. +This should prevent loss of your current partition layout. +This image should be written directly to the head of the disk with +.Xr dd 1 . +.Pp +The recommended setup for a PReP machine is to build a partition table with +.Xr fdisk 8 +that contains a PReP boot partition (type 65) as partition 0, marked active, +and a second partition for +.Nx +encompassing the remainder of the disk. +You should then create a disklabel on +that disk with a partition (such as e) pointing to the PReP boot partition. +Partition c should be the whole disk, and partition d can optionally be the +.Nx +portion of the disk. +You may then use the other partitions for your normal disk layout. +The PReP boot partition can be placed anywhere on the disk, but it is +recommended that it be placed at the beginning of the disk. +.Sh EXAMPLES +Create a floppy or netboot image for prep named +.Sq boot.fs : +.Dl Ic mkbootimage -m prep -b /usr/mdec/boot -k /netbsd boot.fs +Create a standalone bebox image for booting from a hard disk: +.Dl Ic mkbootimage -s -m bebox -b /usr/mdec/boot -k /netbsd boot.fs +Use the partition information on +.Sq sd0 +to create a new bootable image with com0 as the console: +.Dl Ic mkbootimage -b /usr/mdec/boot_com0 -k /netbsd -r /dev/rsd0c boot.fs +.Sh SEE ALSO +.Xr dd 1 , +.Xr bootpd 8 , +.Xr disklabel 8 , +.Xr fdisk 8 , +.Xr prep/boot 8 +.Sh HISTORY +.Nm +first appeared in +.Nx 1.5 . +.Sh AUTHORS +.Nm +was written by +.An NONAKA Kimihiro . |
