feat: Added NetBSD man pages

4 files changed, 503 insertions, 0 deletions

diff --git a/static/netbsd/man8/man8.amiga/Makefile b/static/netbsd/man8/man8.amiga/Makefile
new file mode 100644
index 00000000..5b657add
--- /dev/null
+++ b/static/netbsd/man8/man8.amiga/Makefile
@@ -0,0 +1,4 @@
+MAN = $(wildcard *.8)
+
+include ../../../mandoc.mk
+
diff --git a/static/netbsd/man8/man8.amiga/binpatch.8 b/static/netbsd/man8/man8.amiga/binpatch.8
new file mode 100644
index 00000000..ae21473c
--- /dev/null
+++ b/static/netbsd/man8/man8.amiga/binpatch.8
@@ -0,0 +1,93 @@
+.\"	$NetBSD: binpatch.8,v 1.7 2001/11/26 00:06:40 wiz Exp $
+.\"
+.\" Copyright (c) 1994 Christian E. Hopps
+.\" 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 Christian E. Hopps.
+.\" 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.
+.\"
+.Dd February 2, 1994
+.Dt BINPATCH 8 amiga
+.Os
+.Sh NAME
+.Nm binpatch
+.Nd "examine and or modify initialized data in a binary file"
+.Sh SYNOPSIS
+.Nm binpatch
+.Op Fl b | Fl w | Fl l
+.Op Fl o Ar offset
+.Fl s Ar symname
+.Op Fl r Ar value
+.Ar binfile
+.Nm binpatch
+.Op Fl b | Fl w | Fl l
+.Op Fl o Ar offset
+.Fl a Ar addr
+.Op Fl r Ar value
+.Ar binfile
+.Sh DESCRIPTION
+.Nm
+is used to modify or examine the data associated with a symbol in a binary
+file
+.Ar binfile .
+The flags
+.Fl b ,
+.Fl w
+and
+.Fl l
+specify the size of the data to be modified or examined
+(byte, word and long respectively.)  The
+.Ar binfile
+is scanned in search of the symbol
+.Ar symname
+(specified with the
+.Fl s
+flag)
+If the symbol is found the current data and address are printed.  Next if the
+.Fl r
+flag has been given, the current data is replaced with that of
+.Ar value .
+.Pp
+If the second form is used the address
+.Ar addr
+specified with the
+.Fl a
+flag is used as a direct address into the data section of the binary and
+no symbol search is performed.
+.Pp
+The
+.Fl o
+flag specifies an offset in byte, word or long
+.Fl ( b ,
+.Fl w ,
+or
+.Fl l )
+units from the given locator
+.Fl ( s
+or
+.Fl a )
+for
+.Nm
+to perform its described actions.
diff --git a/static/netbsd/man8/man8.amiga/boot.8 b/static/netbsd/man8/man8.amiga/boot.8
new file mode 100644
index 00000000..846cfc5d
--- /dev/null
+++ b/static/netbsd/man8/man8.amiga/boot.8
@@ -0,0 +1,267 @@
+.\"	$NetBSD: boot.8,v 1.18 2021/02/26 10:44:31 wiz Exp $
+.\"
+.\" Copyright (c) 1990, 1991 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to Berkeley by
+.\" the Systems Programming Group of the University of Utah Computer
+.\" Science Department.
+.\"
+.\" 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. Neither the name of the University 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 REGENTS 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 REGENTS 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.
+.\"
+.\"	From:
+.\"	@(#)boot_hp300.8	8.2 (Berkeley) 4/19/94
+.\"
+.Dd February 25, 2021
+.Dt BOOT 8 amiga
+.Os
+.Sh NAME
+.Nm boot
+.Nd
+system bootstrapping procedures
+.Sh DESCRIPTION
+.Ss Power fail and crash recovery
+When the
+.Nx
+kernel is booted normally (using one of the two methods discussed below),
+it initializes itself and proceeds to boot the system.
+An automatic consistency check of the file systems takes place,
+and unless this fails, the system comes up to multi-user operations.
+The proper way to shut the system down is with the
+.Xr shutdown 8
+command.
+.Pp
+If the system crashes, it will enter the kernel debugger,
+.Xr ddb 4 ,
+if it is configured in the kernel.
+If the debugger is not present,
+or the debugger is exited, the system will attempt a dump to the
+configured dump device (which will be automatically recovered with
+.Xr savecore 8
+during the next boot cycle).
+After the dump is complete (successful
+or not), the system will attempt a reboot.
+.Ss Booting NetBSD using the bootloader
+When a bootable
+.Nx
+partition is created by means of HDTOOLBOX or another RDB editing program
+and a bootblock has been copied there by
+.Xr amiga/installboot 8
+and the boot priority of the
+.Nx
+partition is either the highest or the
+.Nx
+partition is selected by means of the boot menu,
+the Amiga ROM will automatically start the
+.Nx
+bootloader.
+By default it will, after a short timeout, load the kernel image
+.Pa /netbsd
+and attempt to boot it into multi-user mode.
+This behaviour can be changed by
+typing in an alternate command sequence.
+The command line looks like:
+.Bd -ragged -offset indent
+.Ar kernel-path
+.Op Fl abkpqsvACDS
+.Op Fl c Ar model
+.Op Fl m Ar memsize
+.Op Fl n Ar memsegments
+.Op Fl I Ar mask
+.Ed
+.Bl -tag -width flag
+.It kernel-path
+This gives you the opportunity to boot another kernel, say:
+.Pa /netbsd.old .
+The default is
+.Pa /netbsd .
+.It Fl a
+Autoboot into multi-user mode (default).
+.It Fl b
+Prompt for the root file system device, the system crash dump
+device, and the path to
+.Xr init 8 .
+.It Fl c Ar model
+force machine
+.Ar model .
+Use 32000+(Qlogic chip revision) for the DraCo.
+.It Fl k
+Reserve the first 4M of fastmem.
+.It Fl m Ar memsize
+Force fastmem size to be
+.Ar memsize
+kBytes.
+.It Fl n
+maximum number of
+.Ar segments
+of memory to use, encoded as follows: 0 (default): 1 segment, 1:
+2 segments, 2: 3 or more segments.
+.It Fl p
+Select kernel load segment by priority instead of size.
+.It Fl q
+Boot in quiet mode.
+.It Fl s
+Boot into single-user mode.
+.It Fl v
+Boot in verbose mode.
+.It Fl A
+Enable AGA display modes.
+.It Fl C
+Use the serial port as console.
+.It Fl D
+Enter the kernel debugger (best used with
+.Fl S ) .
+.It Fl I Ar mask
+inhibit sync negotiation as follows: The
+.Ar mask
+is a bitmap expressed in C notation (e.g., 0xff)
+with 4*8bits, each bit, if set to 1, disabling sync negotiation for
+the corresponding target.
+Note that this only applies to (some of the)
+real SCSI busses, but not, e.g., to internal IDE.
+The bytes are used up
+from right to left by SCSI bus drivers using this convention.
+.It Fl S
+include kernel debug symbols (for use by
+.Fl D ) .
+.El
+.Ss Booting NetBSD using the loadbsd program
+When you want (or have to) start
+.Nx
+from AmigaOS, you have to use the
+.Ic loadbsd
+program that is supplied in the utils directory of the distribution.
+The loadbsd command line specification is:
+.Bd -ragged -offset indent
+.Nm loadbsd
+.Op Fl abkpqstvACDSZ
+.Op Fl c Ar model
+.Op Fl m Ar memsize
+.Op Fl n Ar memsegments
+.Op Fl I Ar mask
+.Ar kernel-path
+.Ed
+.Pp
+Description of options:
+.Bl -tag -width flag
+.It Fl a
+Autoboot into multi-user mode.
+.It Fl b
+Prompt for the root file system device, the system crash dump
+device, and the path to
+.Xr init 8 .
+.It Fl c
+force machine model.
+.It Fl k
+Reserve the first 4M of fastmem.
+.It Fl m
+Force fastmem size to be
+.Ar memsize
+kBytes.
+.It Fl n
+maximum number of
+.Ar segments
+of memory to use, encoded as follows: 0 (default): 1 segment, 1:
+2 segments, 2: 3 or more segments.
+.It Fl p
+Select kernel load segment by priority instead of size.
+.It Fl q
+Boot in quiet mode.
+.It Fl s
+Boot into single-user mode.
+.It Fl t
+Test loading of the kernel but don't start
+.Nx .
+.It Fl v
+Boot in verbose mode.
+.It Fl A
+enable AGA display modes.
+.It Fl C
+Use the serial port as console
+.It Fl D
+Enter the kernel debugger (best used with
+.Fl S ) .
+.It Fl I Ar mask
+inhibit sync negotiation as follows: The
+.Ar mask
+is a bitmap expressed in hexadecimal (e.g., ff)
+with 4*8bits, each bit, if set to 1, disabling sync negotiation for
+the corresponding target.
+Note that this only applies to (some of the)
+real SCSI busses, but not, e.g., to internal IDE.
+The bytes are used up
+from right to left by SCSI bus drivers using this convention.
+.It Fl S
+include kernel debug symbols (for use by
+.Fl D ) .
+.It Fl Z
+Force load via chip memory.
+Won't work if kernel is larger than the chip memory size or on the
+DraCo.
+.El
+.Pp
+Note: Because the loadbsd program can only read kernels from a AmigaOS
+filesystem, the file
+.Ar /netbsd
+is often not the same as the actual kernel booted.
+This can cause some programs to fail.
+However, note that you can use third-party Berkeley
+filesystems such as bffs to access the
+.Nx
+root partition from AmigaOS.
+.Sh FILES
+.Bl -tag -width /usr/mdec/bootxx_ffsv1 -compact
+.It Pa /netbsd
+system kernel
+.It Pa /usr/mdec/bootxx_ffsv1
+RDB device primary boot block for FFSv1 (and ustarfs)
+.It Pa /usr/mdec/bootxx_ffsv2
+RDB device primary boot block for FFSv2
+.It Pa /usr/mdec/bootxx_fd
+floppy disk primary boot block
+.It Pa /usr/mdec/boot.amiga
+secondary bootstrap
+.It Pa /boot.amiga
+secondary bootstrap (installed)
+.El
+.Sh SEE ALSO
+.Xr ddb 4 ,
+.Xr amiga/installboot 8 ,
+.Xr fsck_ffs 8 ,
+.Xr newfs 8 ,
+.Xr savecore 8 ,
+.Xr shutdown 8
+.Sh BUGS
+Due to code size restrictions, you can't currently use an old-style file
+system (created with
+.Xr newfs 8
+-O
+or with
+.Nx 0.9 )
+with the boot block.
+You can use
+.Ic loadbsd
+to boot from AmigaOS, or upgrade the file system with
+.Ar fsck_ffs -c 2 .
diff --git a/static/netbsd/man8/man8.amiga/installboot.8 b/static/netbsd/man8/man8.amiga/installboot.8
new file mode 100644
index 00000000..d6fb5fe1
--- /dev/null
+++ b/static/netbsd/man8/man8.amiga/installboot.8
@@ -0,0 +1,139 @@
+.\"	$NetBSD: installboot.8,v 1.25 2021/02/26 10:44:31 wiz 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.
+.\"
+.\" 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 25, 2021
+.Dt INSTALLBOOT 8 amiga
+.Os
+.Sh NAME
+.Nm installboot
+.Nd install a bootstrap on an FFS filesystem partition
+.Sh SYNOPSIS
+.Nm /usr/mdec/installboot
+.Op Fl l Ar newcommandline
+.Ar bootblock
+.Ar device
+.Sh DESCRIPTION
+.Nm installboot
+copies the bootblock to a bootable partition.
+The
+bootstrap is written into the bootblock area on the partition, right
+in front of the superblock, and hence limited in size to
+8192 bytes.
+.Pp
+The bootstrap resides in the first few blocks on the partition
+.Pq as specified by Commodore-Amiga Inc.
+The bootstrap is loaded into memory by the ROM from bootable devices:
+RDB devices, where the partition is marked as bootable, or (not on the
+DraCo) floppy disks in Amiga format (880K/1760k).
+.Pp
+In the presence of more than one bootable partition/floppy disk, the partition
+is chosen by the bootpriority (from the RDB), which can be overridden by
+the operator from the boot menu (on Amiga machines, hold down the outer
+mouse buttons during boot; on DraCo machines, press the left mouse button
+when prompted).
+.Pp
+On RDB devices, the whole bootblock is loaded by the ROM.
+The number of
+boot blocks in the RDB partition entry must be correct.
+.Pp
+On floppy disks, the ROM always loads the first two blocks (1024 bytes),
+and the bootblock allocates memory and loads the whole bootblock on startup.
+.Pp
+After receiving control, the bootblock uses the stand-alone
+filesystem code in
+.Dq libsa.a
+to load the kernel from the filesystem on the partition it was started from.
+The code for the boot program can be found in
+.Pa /usr/mdec/bootxx_fd
+.Pq floppy disk code ,
+.Pa /usr/mdec/bootxx_ffsv1
+.Pq generic RDB disk code for FFSv1 ,
+or
+.Pa /usr/mdec/bootxx_ffsv2
+.Pq generic RDB disk code for FFSv2 .
+.Pp
+The arguments are:
+.Bl -tag -width bootblock
+.It Fl l Ar newcommandline
+Specify a different command line to replace the default.
+.It Ar bootblock
+The file containing the bootblock (normally /usr/mdec/bootxx_ffsv1 or
+bootxx_ffsv2 for RDB devices).
+.It Ar device
+The name of the character special device specifying the partition on which the
+bootstrap is to be installed.
+.El
+.Sh EXAMPLES
+The following command will install the
+boot program for FFSv1 in the bootblock area on
+.Dq sd0a :
+.Bd -literal -offset indent
+installboot /usr/mdec/bootxx_ffsv1 /dev/rsd0a
+.Ed
+.Sh SEE ALSO
+.Xr dd 1 ,
+.Xr amiga/boot 8
+.Sh HISTORY
+The
+.Nm
+command first appeared in
+.Nx 1.3 .
+.Sh BUGS
+If
+.Nm
+is accidentally used on the whole disk partition, the RDB will be overwritten,
+making your system unusable after the next reboot.
+.Pp
+Some third-party accelerator boards are not autoconfiguring.
+You won't be able to use their memory when booting from the bootblock
+after a cold start.
+.Pp
+Some third-party disk controllers don't support bootblock booting.
+.Pp
+DraCo ROMs don't support bootblock booting from floppy disks.
+.Pp
+Most 68060 boards, unlike the DraCo, don't set the SysBase->AttnFlags
+bit for the 68060 CPU (a patch program which is called during
+AmigaOS startup does this).
+You need to add
+.Cd options BB060STUPIDROM
+to your kernel to boot on such a machine.
+.Pp
+There is currently no easy way to edit the RDB from within
+.Nx .
+Therefore, you have to use HDTOOLBOX or a similar tool to
+set the partition to bootable, "use custom bootblocks" and the number
+of bootblocks to 16 (for bootxx_ffsv1 or bootxx_ffsv2) or 2 (for bootxx_fd),
+at least the first time you install the bootblock.
+.Pp
+As normal
+.Xr dd 1
+is used to install the bootblock, you can only install onto
+your currently used root (or any other mounted) partition from single-user
+mode, or while otherwise running in insecure mode.