diff options
Diffstat (limited to 'static/netbsd/man8/man8.amiga')
| -rw-r--r-- | static/netbsd/man8/man8.amiga/Makefile | 4 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.amiga/binpatch.8 | 93 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.amiga/boot.8 | 267 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.amiga/installboot.8 | 139 |
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. |