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.acorn32/boot32.8 | |
| parent | a59214f344567c037d5776879bcfc5fcc1d4d5f6 (diff) | |
feat: Added NetBSD man pages
Diffstat (limited to 'static/netbsd/man8/man8.acorn32/boot32.8')
| -rw-r--r-- | static/netbsd/man8/man8.acorn32/boot32.8 | 156 |
1 files changed, 156 insertions, 0 deletions
diff --git a/static/netbsd/man8/man8.acorn32/boot32.8 b/static/netbsd/man8/man8.acorn32/boot32.8 new file mode 100644 index 00000000..d0ec07ff --- /dev/null +++ b/static/netbsd/man8/man8.acorn32/boot32.8 @@ -0,0 +1,156 @@ +.\" $NetBSD: boot32.8,v 1.4 2016/04/30 14:32:22 jakllsch Exp $ +.\" +.\" Copyright (c) 2000, 2001 Ben Harris +.\" Copyright (c) 2004 Reinoud Zandijk +.\" 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. 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 September 4, 2009 +.Dt BOOT32 8 acorn32 +.Os +.Sh NAME +.Nm boot32 +.Nd Bootloader for +.Nx Ns /acorn32 +.Sh SYNOPSIS +.Nm *boot32 +.Op Fl acdqsv +.Op Ar root=rootdir +.Op Ar file +.Sh DESCRIPTION +.Nm +is a program that runs under +.Tn RISC OS +and launches the +.Nx Ns /acorn32 +kernel. +It needs to be installed in a RISC OS filesystem and given file +type FFA (Module). +The kernel it is to load also needs to be stored in a +.Tn RISC OS +filesystem. +.Pp +It takes the following standard +.Nx +options, which set flags in the +.Va boothowto +variable in the booted kernel (see +.Xr boothowto 9 ) . +Not all flags may be effective. +.Bl -tag -width Fl +.It Fl a +.Pq Dv RB_ASKNAME +Cause the kernel to prompt the user for the name of the device containing the +root filesystem. +This also causes +.Nm +to prompt for the name of the kernel to be loaded. +.It Fl s +.Pq Dv RB_SINGLE +Cause the kernel to ask +.Nm init +to boot into single-user mode. +.It Fl d +.Pq Dv RB_KDB +Cause the kernel to enter the kernel debugger as soon as possible. +.It Fl c +.Pq Dv RB_USERCONF +Enter the in-kernel device configuration manager before attaching any +devices. +.It Fl q +.Pq Dv AB_QUIET +Cause the kernel to emit fewer messages than normal while starting up. +.It Fl v +.Pq Dv AB_VERBOSE +Cause the kernel to emit more messages than normal while starting up. +.El +.Pp +.Nm +attempts to load the kernel from the RISC OS file specified as +.Ar file , +or from +.Pa netbsd +if +.Ar file +is not specified. +The file must be an ELF image, and may have been compressed using +.Xr gzip 1 . +.Ss Use as a module +.Nm +is implemented as a RISC OS relocatable module. +It can be loaded into memory by running +.Ql *RMLoad boot32 . +After this, +.Nx +can be booted by running +.Ql *boot32 +as usual, but the command will be handled by the module. +.Pp +It should also be possible to arrange for +.Nm +to be loaded from ROM (e.g., from the ROM on an expansion card), in which case +.Nx +could be made to boot automatically by making +.Nm +the configured language using +.Ql *Configure Language . +.Ss Screen display +When it starts up, +.Nm +displays the number of 4 kilobyte memory pages it has been delegated by RISC-OS +and gives a summary about the memory map as reported by RISC-OS followed by a +table of physical memory ranges available to the bootloader. +All this information is mainly for bughunting booting problems. +.Pp +It then checks its internal structures and kicks out RISC-OS, relocates all +memory pages loaded in to their final destinations and kickstarts +.Nm . +.Sh FILES +.Bl -tag -width Pa +.It Pa /usr/mdec/boot32,ffa +The location of +.Nm +in the +.Nx +filesystem. +.El +.Sh SEE ALSO +.Xr gzip 1 , +.Xr reboot 2 , +.Xr ddb 4 , +.Xr userconf 4 , +.Xr init 8 , +.Xr boothowto 9 +.Sh HISTORY +.Nm +was introduced in +.Nx 1.6 +as a replacement for the original +.Nx Ns /arm32 +bootloader, which was written in BBC BASIC. +.Sh BUGS +.Nm +cannot load kernels from a +.Nx +filesystem. |
