1 files changed, 155 insertions, 0 deletions
diff --git a/sys/arch/amiga/stand/loadbsd/loadbsd.8 b/sys/arch/amiga/stand/loadbsd/loadbsd.8
new file mode 100644
index 00000000000..19cd2f7acb0
--- /dev/null
+++ b/sys/arch/amiga/stand/loadbsd/loadbsd.8
@@ -0,0 +1,155 @@
+.\"	$OpenBSD: loadbsd.8,v 1.1 1999/09/09 21:25:13 espie Exp $
+.\" Copyright (c) 1999 Marc Espie
+.\"
+.\" 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.
+.Dd September 9, 1999
+.Dt LOADBSD 1
+.Os
+.Sh NAME
+.Nm loadbsd
+.Nd load OpenBSD from AmigaOS
+.Sh SYNOPSIS
+.Nm
+.Op Fl abchkpstADSVZ
+.Op Fl C Ar machine
+.Op Fl m Ar mem
+.Op Fl n Ar flags
+.Op Fl I Ar sync-inhibit
+.Ar file
+.Sh DESCRIPTION
+The
+.Nm
+utility loads the
+.Os 
+kernel from
+.Ar file 
+under AmigaOS, and starts 
+.Ox .
+.Nm 
+only runs under AmigaOS 2.0 or better,
+but it no longer needs ixemul.
+.Pp
+.Nm 
+supports multiple root devices. By default,
+.Nm
+boots to single-user mode, without symbols.
+.Pp
+Options are as follows:
+.Bl -tag -width Ds
+.It Fl a
+Boot up to multiuser mode.
+.It Fl A
+Use AGA display mode, if available.
+.It Fl b
+Prompt for root device.
+.It Fl C Ar machine
+Explicitly set machine type (e.g., 3000). Set
+.Ar machine 
+to 32000+N for DraCo revision N.
+Normally,
+.Nm
+guesses the machine type itself, but there are some cases
+where it guesses wrong, thanks to AmigaOS lame design.
+.It Fl c
+User configuration mode.
+.It Fl D
+Enter ddb on startup.
+.It Fl h
+Display help.
+.It Fl I Ar sync-inhibit
+Inhibit sync-negotiation. 
+.Ar sync-inhibit
+is bit-encoded targets.
+.It Fl k
+Reserve the first 4M of fast mem.
+.\" Try to find out what this is used for.
+.It Fl m Ar mem
+Tweak available memory to find the minimum amount necessary to use a
+kernel. Set fastmem size to
+.Ar mem 
+in Kbytes.
+.It Fl n Ar flags
+Multiple non-contiguous memory mode.
+Disable if
+.Ar flags 
+is 0. Set to two segments if
+.Ar flags
+is 1. Set to all avail segments if
+.Ar flags
+is 2.
+.\" Check what 3 means (same as 2 ?)
+.It Fl p
+Use highest priority fastmem segement instead of the largest
+segment. The higher priority segment is usually faster
+(i.e. 32 bit memory), but some people have smaller amounts
+of 32 bit memory.
+.It Fl s
+Boot up in single user mode.
+.It Fl S
+Include kernel symbol table.
+.It Fl t
+Test configuration.  Check the machine, and loads the kernel,
+but stop without actually starting 
+.Os .
+.It Fl V
+Print version.
+.It Fl Z
+Force kernel to chipmem.
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "cpu not supported"
+.Nm
+doesn't run without a MMU, nor with a 68851. So 68000, 68010 and 68020 don't
+work.
+.It "failed malloc"
+.Nm
+couldn't find a contiguous chunk of memory large enough for the kernel.
+The required size is displayed in bytes.
+If you have enough memory, reboot to remove fragmentation problems.
+.It "lseek for symbols"
+You asked for symbols with
+.Fl S
+but
+.Nm 
+doesn't find any. Probably a striped kernel.
+.It "newer loadbsd required"
+.Nm
+can't load all kernels, because it needs to pass parameters to the
+kernel at startup, and the interface may change.
+.It "unable to read kernel image"
+The
+.Ar file
+is not a valid a.out executable. The header matches, but the contents
+are wrong.  Might come from a transfert problem, or an attempt to cross-compile
+kernels on a different endian machines. The toolchain doesn't support cross-endianess
+up to 
+.Ox 2.5
+included.
+.It "unknown binary"
+The file
+.Ar file
+is not a kernel image. Note that
+.Nm 
+currently cannot read gzipped kernels.
+.\" Not all diagnostics are documented, 
+.\" but the remaining ones come from arcane options,
+.\" so the user is expected to refer to the source.
+.El
+.Sh SEE ALSO
+.Xr ddb 4
+.Sh HISTORY
+.Nm
+was originally developped for
+.Nx .
+ixemul requirement removal and poolmem recognition features
+were added for
+.Ox 
+by Marc Espie.