summaryrefslogtreecommitdiff
path: root/static/netbsd/man8/man8.atari/boot.8
diff options
context:
space:
mode:
Diffstat (limited to 'static/netbsd/man8/man8.atari/boot.8')
-rw-r--r--static/netbsd/man8/man8.atari/boot.8217
1 files changed, 217 insertions, 0 deletions
diff --git a/static/netbsd/man8/man8.atari/boot.8 b/static/netbsd/man8/man8.atari/boot.8
new file mode 100644
index 00000000..918159f1
--- /dev/null
+++ b/static/netbsd/man8/man8.atari/boot.8
@@ -0,0 +1,217 @@
+.\" $NetBSD: boot.8,v 1.14 2017/02/17 22:30:28 christos 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 17, 2017
+.Dt BOOT 8 atari
+.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
+.Xr atari/installboot 8
+and the boot-preference bit in the NVRAM is either invalid or set to
+.Nx
+, the Atari BIOS will automatically start the
+.Nx
+bootloader.
+By default it will load the kernel image
+.Pa /netbsd
+and attempts to boot it into multi-user mode.
+This behaviour can be changed by either keeping the
+.Pa Alternate
+or the
+.Pa Right-Shift
+key pressed during the boot.
+When the
+.Pa Alternate
+key is pressed, the bootstrap is aborted, causing the BIOS
+to continue scanning the disks for a bootable partition (this is compatible
+with AHDI 3.0).
+Pressing the
+.Pa Right-Shift
+key during the boot, causes the boot loader to enter the interactive mode.
+In interactive mode, the command line looks like:
+.Bd -ragged -offset indent
+.Pp
+.Op Ar OS-type
+.Op Ar boot-path
+.Op Ar boot-options
+.Ed
+.Pp
+Each component of the command can be omitted in which case the defaults
+indicated will be used.
+.Bl -tag -width boot-options
+.It OS-type :
+.Bl -tag -compact -width ".netbsd (default)"
+.It .netbsd (the default)
+.It .linux
+.It .asv
+.It .tos
+.El
+.Pp
+If something other than
+.Pa .netbsd
+is specified, control is returned to the BIOS with the boot preference set to
+the selected type.
+Due to limitations of the BIOS however, the search for
+bootblocks is continued rather than restarted.
+.It boot-path
+This gives you the opportunity to boot another kernel, say:
+.Pa /netbsd.old .
+The default is
+.Pa /netbsd
+.It boot-options
+These options are a subset of the
+.Xr loadbsd 8
+options.
+.Bl -tag -width flag -compact
+.It Fl a
+Boot into multi-user mode (the 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 d
+Enter the kernel debugger
+.It Fl q
+Boot in quiet mode
+.It Fl v
+Boot in verbose mode
+.El
+.El
+.Ss Booting using the loadbsd program
+When you want (or have to) start
+.Nx
+from GEM, you have to use the
+.Xr loadbsd 8
+program that is supplied on the kernel-floppy.
+The loadbsd command line specification is:
+.Bd -ragged -offset indent
+.Nm loadbsd
+.Op Fl abdhqstvwDV
+.Op Fl S Ar amount
+.Op Fl T Ar amount
+.Ar kernel-path
+.Ed
+.Pp
+Description of options:
+.Bl -tag -width flag
+.It Fl a
+Boot automatically 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 d
+Enter the kernel debugger after booting.
+.It Fl h
+Print a help screen that tries to explain the same options as mentioned
+here.
+.It Fl o Ar outputfile
+Write all output to the file
+.Ar outputfile .
+.It Fl q
+Boot in quiet mode.
+.It Fl s
+Tell
+.Nx
+only to use ST compatible RAM.
+.It Fl t
+Test loading of the kernel but don't start
+.Nx .
+.It Fl v
+Boot in verbose mode.
+.It Fl w
+Wait for a keypress before exiting loadbsd.
+This is useful when starting this program under GEM.
+.It Fl D
+Show debugging output while booting the kernel.
+.It Fl S Ar amount
+Set the amount of available ST compatible RAM in bytes.
+Normally this
+value is set automatically from the values initialized by the BIOS.
+.It Fl T Ar amount
+Set the amount of available TT compatible RAM in bytes.
+Normally this
+value is set automatically from the values initialized by the BIOS.
+.It Fl V
+Print the version of
+.Xr loadbsd 8
+that you are using.
+.It Ar kernel-path
+This is a GEMDOS path specification of the kernel to boot.
+.El
+.Pp
+Note: Because the loadbsd program can only read kernels from a GEMDOS
+filesystem, the file
+.Ar /netbsd
+is usually not the same as the actual kernel booted.
+This can cause some programs to fail.
+.Sh FILES
+.Bl -tag -width /netbsd -compact
+.It Pa /netbsd
+system kernel
+.El
+.Sh SEE ALSO
+.Xr ddb 4 ,
+.Xr savecore 8 ,
+.Xr shutdown 8