summaryrefslogtreecommitdiff
path: root/static/netbsd/man8/man8.prep
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
commit5cb84ec742fd33f78c8022863fadaa8d0d93e176 (patch)
tree1a81ca3665e6153923e40db7b0d988f8573ab59c /static/netbsd/man8/man8.prep
parenta59214f344567c037d5776879bcfc5fcc1d4d5f6 (diff)
feat: Added NetBSD man pages
Diffstat (limited to 'static/netbsd/man8/man8.prep')
-rw-r--r--static/netbsd/man8/man8.prep/Makefile4
-rw-r--r--static/netbsd/man8/man8.prep/boot.886
-rw-r--r--static/netbsd/man8/man8.prep/mkbootimage.8153
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 .