Add NetBSD/acorn32 boot manpage
This commit is contained in:
parent
d3516aeed5
commit
de7e86e2c5
|
@ -1,4 +1,4 @@
|
||||||
# $NetBSD: Makefile,v 1.71 2004/01/30 15:14:10 christos Exp $
|
# $NetBSD: Makefile,v 1.72 2004/02/23 17:03:28 reinoud Exp $
|
||||||
# @(#)Makefile 8.1 (Berkeley) 6/5/93
|
# @(#)Makefile 8.1 (Berkeley) 6/5/93
|
||||||
|
|
||||||
MAN= MAKEDEV.8 afterboot.8 \
|
MAN= MAKEDEV.8 afterboot.8 \
|
||||||
|
@ -17,7 +17,7 @@ MLINKS+=compat_netbsd32.8 netbsd32.8
|
||||||
MLINKS+=yp.8 nis.8
|
MLINKS+=yp.8 nis.8
|
||||||
MLINKS+=rc.8 rc.d.8
|
MLINKS+=rc.8 rc.d.8
|
||||||
MLINKS+=rc.8 rc.shutdown.8
|
MLINKS+=rc.8 rc.shutdown.8
|
||||||
SUBDIR= man8.acorn26 man8.alpha man8.amiga man8.atari man8.dreamcast \
|
SUBDIR= man8.acorn26 man8.acorn32 man8.alpha man8.amiga man8.atari man8.dreamcast \
|
||||||
man8.hp300 man8.hpcmips man8.i386 man8.mac68k man8.macppc \
|
man8.hp300 man8.hpcmips man8.i386 man8.mac68k man8.macppc \
|
||||||
man8.mvme68k man8.next68k man8.pmax man8.pmppc man8.sparc man8.sparc64 \
|
man8.mvme68k man8.next68k man8.pmax man8.pmppc man8.sparc man8.sparc64 \
|
||||||
man8.sun2 man8.sun3 man8.vax man8.x68k man8.cobalt
|
man8.sun2 man8.sun3 man8.vax man8.x68k man8.cobalt
|
||||||
|
|
|
@ -0,0 +1,7 @@
|
||||||
|
# $NetBSD: Makefile,v 1.3 2004/02/23 17:03:28 reinoud Exp $
|
||||||
|
|
||||||
|
MAN= boot32.8
|
||||||
|
MLINKS= boot32.8 boot.8
|
||||||
|
MANSUBDIR=/acorn32
|
||||||
|
|
||||||
|
.include <bsd.man.mk>
|
|
@ -0,0 +1,152 @@
|
||||||
|
.\" $NetBSD: boot32.8,v 1.1 2004/02/23 17:03:28 reinoud 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 February 23, 2004
|
||||||
|
.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 (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 RB_QUIET
|
||||||
|
Cause the kernel to emit fewer messages than normal while starting up.
|
||||||
|
.It Fl v
|
||||||
|
.Pq Dv RB_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
|
||||||
|
.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.
|
Loading…
Reference in New Issue