diff options
Diffstat (limited to 'static/netbsd/man8/man8.atari')
| -rw-r--r-- | static/netbsd/man8/man8.atari/Makefile | 4 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.atari/ahdilabel.8 | 178 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.atari/binpatch.8 | 145 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.atari/boot.8 | 217 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.atari/bootpref.8 | 197 | ||||
| -rw-r--r-- | static/netbsd/man8/man8.atari/installboot.8 | 174 |
6 files changed, 915 insertions, 0 deletions
diff --git a/static/netbsd/man8/man8.atari/Makefile b/static/netbsd/man8/man8.atari/Makefile new file mode 100644 index 00000000..5b657add --- /dev/null +++ b/static/netbsd/man8/man8.atari/Makefile @@ -0,0 +1,4 @@ +MAN = $(wildcard *.8) + +include ../../../mandoc.mk + diff --git a/static/netbsd/man8/man8.atari/ahdilabel.8 b/static/netbsd/man8/man8.atari/ahdilabel.8 new file mode 100644 index 00000000..379f723f --- /dev/null +++ b/static/netbsd/man8/man8.atari/ahdilabel.8 @@ -0,0 +1,178 @@ +.\" $NetBSD: ahdilabel.8,v 1.14 2017/07/03 21:31:00 wiz Exp $ +.\" +.\" +.\" Copyright (c) 1999 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Julian Coleman and Leo Weppelman. +.\" +.\" 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 17, 2017 +.Dt AHDILABEL 8 atari +.Os +.Sh NAME +.Nm ahdilabel +.Nd modify AHDI partitions +.Sh SYNOPSIS +.Nm +.Ar disk +.Sh DESCRIPTION +.Nm +allows you to modify the AHDI partition table on a disk partitioned with +AHDI or an AHDI compatible formatter. The AHDI partition format is usually +only present on disks shared between +.Nx +and some other OS. The partition identifiers are used by +.Nx +as a guideline to emulate a disklabel on such a disk. +.Pp +.Nm +supports the following options: +.Pp +.Bl -tag -width disk +.It Ar disk +The name of the disk you want to edit. +.Nm +will first try to open a disk of this name. If this cannot +be opened, it will attempt to open +.Ar r Ns <disk> Ns Ar c . +Finally, if this also cannot be opened, it will attempt to open +.Ar /dev/r Ns <disk> Ns Ar c . +.El +.Pp +.Nm +will display information about the number of sectors, tracks +and sectors on the disk, as well as the current AHDI partition information. +It will then prompt for input. The input choices are: +.Pp +.Bl -tag -width a-p +.It Ar a-p +Modify a partition. You will be prompted for a partition id, root, start +and size. +.Nx +recognises the following partition id's: +.Pp +.Bl -tag -width "GEM or BGM" -compact +.It NBD +Partition is reserved for +.Nx . +This can be either a root or an user partition. The first NBD +partition on a disk will be mapped to +.Nx +partition letter +.Em a . +The following NBD partitions will be mapped from letter +.Em d +up. +The filesystem type is ffs by default. +.It SWP +The first SWP partition is mapped to partition +.Em b . +.It GEM or BGM +These partitions are mapped from +.Em d +up. The filesystem type is msdos. +.El +.Pp +The root, start and size parameters can be entered using sector, +cylinder/track/sector or megabyte notations. Whole numbers of cylinders can +be entered using the shorthand <cylinder>/. Likewise, whole numbers of tracks +can be entered using the shorthand <cylinder>/<track>/. Megabytes are entered +using the suffix +.Em M . +.Pp +The following can also be used to enter partition parameters: +.Pp +.Bl -tag -width "-N (start)" -compact +.It \-N (root) +Position the root sector for this partition immediately after partition N. +.It \-N (start) +Make this partition start after partition N (leaving a gap of 1 sector for a +root sector, if necessary). +.It \-N (size) +Make this partition end immediately before partition N. +.It -1 (size) +Make this partition extend to the end of the disk. +.El +.Pp +The sector holding the primary AHDI partition table only has space for four +partitions. Thus, if a disk has more than four partitions, the extra +partition information is held in auxiliary root sectors. There is one +auxiliary root for each additional partition (and also for the fourth +partition, if the disk has more than four partitions). +.It Ar r +Recalculate the root sectors. This will automatically assign auxiliary +root sectors if the disk has more than 4 partitions. The auxiliary root +sectors will be positioned in a default location preceding the relevant +partition. +.It Ar s +Show the current partition information. +.It Ar u +Toggle the unit display between sector and cylinder/track/sector notation. +.It Ar w +Write the AHDI partition table to the disk. +.It Ar z +Options for zero'ing the boot sector and bad sector lists. The default is to +preserve them both. +.It Ar q +Quit +.El +.Sh EXAMPLES +.Dl ahdilabel sd0 +Edit the AHDI label for disk sd0. +.Sh SEE ALSO +.Xr atari/bootpref 8 , +.Xr atari/installboot 8 , +.Xr disklabel 8 +.Sh HISTORY +The +.Nm +command first appeared in +.Nx 1.5 . +.Sh BUGS +The changes made to the AHDI partitions will become active on the next +.Em first open +of the disk. You are advised to use +.Nm +only on a disk without any mounted or otherwise active partitions. This +is not enforced by +.Nm . +.Pp +Because of way +.Nx +interprets AHDI partition tables to create the +.Nx +disklabel, the +.Nx +partition ordering may change if partitions labelled NBD are created or +removed. +.Pp +Creating an AHDI partition table on a disk that previously did not have +one will almost certainly overwrite any existing partition information +and/or data on that disk. This is especially the case if auxiliary root +sectors are needed for the AHDI partition table. +.Pp +As soon as a disk contains at least one NBD partition, you are allowed to +write +.Nx +disklabels and install bootstraps. diff --git a/static/netbsd/man8/man8.atari/binpatch.8 b/static/netbsd/man8/man8.atari/binpatch.8 new file mode 100644 index 00000000..4cf9b06b --- /dev/null +++ b/static/netbsd/man8/man8.atari/binpatch.8 @@ -0,0 +1,145 @@ +.\" $NetBSD: binpatch.8,v 1.8 2009/08/24 12:55:16 tsutsui 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 August 20, 2009 +.Dt BINPATCH 8 atari +.Os +.Sh NAME +.Nm binpatch +.Nd "examine and or modify initialized data in an executable binary" +.Sh SYNOPSIS +.Nm binpatch +.Op Fl b | Fl w | Fl l | Fl d +.Op Fl o Ar offset +.Op Fl T Ar saddr +.Fl s Ar symname +.Op Fl r Ar value +.Ar binfile +.Nm binpatch +.Op Fl b | Fl w | Fl l | Fl d +.Op Fl o Ar offset +.Op Fl T Ar saddr +.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 . +.Pp +The flags +.Fl b , +.Fl w , +.Fl l , +and +.Fl d +specify the size of the data to be modified or examined. +.Fl b +is for 8bit +.Pq Li int8_t , +.Fl w +is for 16bit +.Pq Li int16_t , +.Fl l +is for 32bit +.Pq Li int32_t , +and +.Fl d +is for 64bit +.Pq Li int64_t +variables. +.Pp +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. +.Pp +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 +.Li int8_t , +.Li int16_t , +.Li int32_t , +and +.Li int64_t +.Fl ( b , +.Fl w , +.Fl l , +or +.Fl d ) +units from the given locator +.Fl ( s +or +.Fl a ) +for +.Nm +to perform its described actions. +This might be useful to patch a member of array or structure. +.Pp +The +.Fl T +flag is used to specify the starting address of a.out binary text segment. +Ignored for other binary executable formats. +.Sh SEE ALSO +.Xr gdb 1 , +.Xr mdsetimage 8 +.Sh BUGS +The +.Nm +command doesn't check if size of specified symbol is the same as the +specified size by +.Fl b , +.Fl w , +.Fl l , +or +.Fl d +flag. +.Pp +The +.Nm +command doesn't check if specified address or symbol is a patchable variable +and it might corrupt the specified executable binary. 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 diff --git a/static/netbsd/man8/man8.atari/bootpref.8 b/static/netbsd/man8/man8.atari/bootpref.8 new file mode 100644 index 00000000..ab6b1368 --- /dev/null +++ b/static/netbsd/man8/man8.atari/bootpref.8 @@ -0,0 +1,197 @@ +.\" $NetBSD: bootpref.8,v 1.13 2017/02/17 22:30:28 christos Exp $ +.\" +.\" Copyright (c) 1998 The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" This code is derived from software contributed to The NetBSD Foundation +.\" by Julian Coleman. +.\" +.\" 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 17, 2017 +.Dt BOOTPREF 8 atari +.Os +.Sh NAME +.Nm bootpref +.Nd set NVRAM boot preference +.Sh SYNOPSIS +.Nm bootpref +.Op -v +.Op -b os +.Op -d delay +.Op -l lang +.Op -k kbd +.Op -s id +.Op -f fmt +.Op -1 +.Op -2 +.Op -e sep +.Op -c colours +.Op -n +.Op -p +.Op -t +.Op -v +.Op -4 +.Op -8 +.Op -o +.Op -O +.Op -x +.Op -X +.Op -i +.Op -I +.Sh DESCRIPTION +.Nm bootpref +views and sets the NVRAM boot preferences. +.Pp +The program options are: +.Bl -tag -width Ar +.It Fl V +verbose output (when setting preferences) +.It Fl b Ar netbsd +set the boot OS to +.Nx +.It Fl b Ar tos +set the boot OS to TOS +.It Fl b Ar linux +set the boot OS to Linux +.It Fl b Ar systemv +set the boot OS to System V +.It Fl b Ar none +set the boot OS to none +.It Fl d Ar delay +set the boot delay to +.Ar delay +seconds, where +.Ar delay +is a value between 0 and 255 +.It Fl l Ar english +set the language to English +.It Fl l Ar german +set the language to German +.It Fl l Ar french +set the language to French +.It Fl l Ar spanish +set the language to Spanish +.It Fl l Ar italian +set the language to Italian +.It Fl k Ar american +set the keyboard layout to American +.It Fl k Ar german +set the keyboard layout to German +.It Fl k Ar french +set the keyboard layout to French +.It Fl k Ar british +set the keyboard layout to British +.It Fl k Ar spanish +set the keyboard layout to Spanish +.It Fl k Ar italian +set the keyboard layout to Italian +.It Fl k Ar sw f +.It Fl k Ar swiss french +set the keyboard layout to Swiss (French) +.It Fl k Ar sw g +.It Fl k Ar swiss german +set the keyboard layout to Swiss (German) +.It Fl s Ar id +set the SCSI id to +.Ar id , +where +.Ar id +is a value between 0 and 7 +.It Fl f Ar mmddyy +.It Fl f Ar ddmmyy +.It Fl f Ar yymmdd +.It Fl f Ar yyddmm +set the date format +.It Fl 1 +set the date format to 12 hour clock +.It Fl 2 +set the date format to 24 hour clock +.It Fl e Ar sep +set the date format separator to +.Ar sep +.It Fl c Ar colours +set the number of +.Ar colours +- 2, 4, 16, 256 or 65535 +.It Fl n +set the video mode to +.Ar NTSC +.It Fl p +set the video mode to +.Ar PAL +.It Fl t +set the video mode to +.Ar TV +.It Fl v +set the video mode to +.Ar VGA +.It Fl 4 +set the video mode to +.Ar 40 columns +.It Fl 8 +set the video mode to +.Ar 80 columns +.It Fl o +set the video mode to +.Ar overscan +.It Fl O +set the video mode to +.Ar no overscan +.It Fl x +set the video mode to +.Ar ST compatibility +.It Fl X +set the video mode to +.Ar no ST compatibility +.It Fl i +set the video mode to +.Ar interlace +(TV), +.Ar double line +(VGA) +.It Fl I +set the video mode to +.Ar no interlace/double line +.El +.Pp +All strings can be specified by their shortest abbreviation +.Pp +If no parameters are specified, +.Nm bootpref +shows the current boot preferences. +.Sh SEE ALSO +.Xr atari/installboot 8 +.Sh HISTORY +The +.Nm +command first appeared in +.Nx 1.4 . +.Sh AUTHORS +.An Julian Coleman +.Sh BUGS +Setting the boot OS to +.Ar none +will cause the machine not to boot from the hard disk. +.Pp +The majority of the parameters are not used under +.Nx . diff --git a/static/netbsd/man8/man8.atari/installboot.8 b/static/netbsd/man8/man8.atari/installboot.8 new file mode 100644 index 00000000..6ed6c5ea --- /dev/null +++ b/static/netbsd/man8/man8.atari/installboot.8 @@ -0,0 +1,174 @@ +.\" $NetBSD: installboot.8,v 1.14 2017/02/17 22:30:28 christos 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 17, 2017 +.Dt INSTALLBOOT 8 atari +.Os +.Sh NAME +.Nm installboot +.Nd install a bootstrap on an FFS filesystem partition +.Sh SYNOPSIS +.Nm /usr/mdec/installboot +.Op Fl Nmtuv +.Ar device +.Sh DESCRIPTION +.Nm +prepares the +.Pq physically +first partition on a device for boot-strapping from the TOS-ROM. +The bootstrap is written into the bootblock area on the partition, right +in front of the disk pack label, and hence limited in size to +.Dv LABELOFFSET +bytes. +A disk pack label should be created +.Po +see +.Xr disklabel 8 +.Pc +before installing the bootstrap. +.Pp +The bootstrap is split into three parts: a small first-stage program +that resides in the +.Pq physically +first 512 bytes on the device +.Pq as specified by Atari Corp. , +a second-stage program that immediately follows the first-stage +program, and a third-stage program that resides on the root filesystem. +The first-stage program is loaded into memory by the ROM. +After receiving control, it loads the second-stage program and the +disk label. +The second-stage boot program uses the stand-alone +filesystem code in +.Dq libsa.a +to load the third-stage boot program from the root-filesystem on the device. +The third-stage boot program then loads the kernel. +The prototype code for the first-stage boot program can be found in +.Pa /usr/mdec/std/fdboot +.Pq floppy disk code , +.Pa /usr/mdec/std/sdboot +.Pq SCSI disk code +and +.Pa /usr/mdec/std/wdboot +.Pq IDE disk code . +The second-stage boot program is stored in +.Pa /usr/mdec/std/bootxx . +and the third-stage boot program is stored in +.Pa /usr/mdec/std/boot.atari . +The boot code for Milan machines is different from the other machines and +the files for the Milan can be found in the directory +.Pa /usr/mdec/milan . +Note that the Milan uses the SCSI disk code for both SCSI and IDE disks. +.Pp +For backwards compatibility with the vendor specific AHDI disk +label, a\ special first-stage boot program is provided in +.Pa /usr/mdec/std/xxboot.ahdi . +Together with the general second-stage boot program, it is installed +in the AHDI partition where the +.Nx +disk label lives. +Furthermore, +the AHDI specifications require an additional bootstrap, which is +written into the AHDI root sector +.Pq disk block zero . +The prototype code for this AHDI compliant bootstrap can be found in +.Pa /usr/mdec/std/sdb00t.ahdi +and +.Pa /usr/mdec/std/wdb00t.ahdi , +or the equivalents in +.Pa /usr/mdec/milan . +.Pp +Perform the following steps to make a file system bootable: +.Bl -enum +.It +Copy the secondary bootstrap (either +.Pa /usr/mdec/std/boot.atari +or +.Pa /usr/mdec/milan/boot.atari ) +to the root directory of the target file system. +.It +Use +.Nm +to install the primary and secondary bootstrap programs +(from +.Pa /usr/mdec/std +or +.Pa /usr/mdec/milan ) +into the +.Ar filesystem . +.El +.Pp +The options are as follows: +.Bl -tag -width flag +.It Fl N +Do not actually write anything on the disk. +.It Fl m +Use Milan boot code. +.It Fl t +Number of tracks per cylinder (IDE disk). +.It Fl u +Number of sectors per track (IDE disk). +.It Fl v +Verbose mode. +.El +.Pp +The arguments are: +.Bl -tag -width device +.It Ar device +The name of the device on which the bootstrap is to be installed. +.El +.Sh EXAMPLES +The following command will install the first-stage and second-stage +boot programs in the bootblock area on +.Dq sd0c : +.Bd -literal -offset indent +installboot sd0 +.Ed +.Sh SEE ALSO +.Xr atari/bootpref 8 , +.Xr disklabel 8 +.Sh HISTORY +The +.Nm +command first appeared in +.Nx 1.1 +.Sh BUGS +.Nm +knows too much about kernel internal details, forcing it to +check the running kernel's release and revision. +.Pp +Because neither the floppy disk driver nor +.Xr disklabel 8 +are capable of creating a disk pack label on a floppy disk, +.Nm +has to create a\ fictitious label, that is not used by the kernel. +.Pp +Except for installation of the bootcode on floppy, +.Nm +automatically sets the boot preference in NVRAM to +.Nx . |