Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document the bootblock split into std and milan directories.

Browse Source
This commit is contained in:
jdc 2004-03-09 20:15:45 +00:00
parent bfd698dc3d
commit 4f556b5450
1 changed files with 57 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

77
share/man/man8/man8.atari/installboot.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: installboot.8,v 1.10 2001/12/26 01:29:10 wiz Exp $
.\" $NetBSD: installboot.8,v 1.11 2004/03/09 20:15:45 jdc Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -34,7 +34,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd September 29, 1995
.Dd March 9, 2004
.Dt INSTALLBOOT 8 atari
.Os
.Sh NAME
@ -42,64 +42,101 @@
.Nd install a bootstrap on an FFS filesystem partition
.Sh SYNOPSIS
.Nm /usr/mdec/installboot
.Op Fl Ntuv
.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
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
LABELOFFSET bytes. A disk pack label should be created
.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 two parts: a small first-stage program
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. ,
and a second-stage program that immediately follows the first-stage
program. The first-stage program is loaded into memory by the ROM.
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
disk label.
The second-stage boot program uses the stand-alone
filesystem code in
.Dq libsa.a
to load the kernel from the root-filesystem on the device. The
prototype code for the first-stage boot program can be found in
.Pa /usr/mdec/fdboot
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/sdboot
.Pa /usr/mdec/std/sdboot
.Pq SCSI disk code
and
.Pa /usr/mdec/wdboot
.Pa /usr/mdec/std/wdboot
.Pq IDE disk code .
The second-stage boot program is stored in
.Pa /usr/mdec/bootxx .
.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/xxboot.ahdi .
.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,
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/sdb00t.ahdi
.Pa /usr/mdec/std/sdb00t.ahdi
and
.Pa /usr/mdec/wdb00t.ahdi .
.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.
.Pp
.
.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