V7M/man/man8/boot.8

Compare this file to the similar file:
Show the results in this format:

.TH BOOT 8
.SH NAME
boot \- startup procedures
.SH DESCRIPTION
A PDP11 UNIX system is started by
a two-stage process.
The first is a primary bootstrap
which is able to read in relatively small stand-alone programs;
the second (called
.IR boot )
is used to read in the system itself.
.PP
The primary bootstrap must reside
in the otherwise unused block zero of the boot device.
It can be read in and started by the standard ROM
programs,
or if necessary by keying in a small startup routine.
This program is capable of loading type 407 executable
files (not shared, not separate I&D).
The user types on the system console
the name of the program wished, in this case
.IR boot ,
followed by a carriage return;
the named program is retrieved from the file system
that starts at block 0 of drive 0 of the boot device.
Successful loading of the primary bootstrap
is signaled by the `#' prompt on the console,
no diagnostic results if the file (/boot) cannot be found
, and no
provision is made for correcting typographical errors.
In case the `/boot' file does not function,
the `/boot.bu' file is provided as a backup copy
of the bootstrap.
.PP
The second step, called
.I boot,
actually brings in the system.
When read into location 0 and executed,
.I boot
sets up memory management, relocates itself into
high memory, and types
.br
.nf

	Boot
	:

.fi
on the console.
Then it
reads from the console
a device specification (see below) followed immediately by
a pathname.
.I Boot
finds the corresponding file on the given device,
loads that file into memory location zero,
sets up memory management as required,
and calls the program by executing a `trap' instruction.
Normal
line editing characters can be used.
.PP
Conventionally, the name of the secondary boot program
is `/boot' and the name of the current version of the system
is `/unix'.
Then, the recipe is:
.TP
1)
Load block 0 of the boot device by fiddling with the
console keys as appropriate for your hardware.
If you have no appropriate ROM, some programs suitable
for manual use are given below.
.TP
2)
Respond to the `#' prompt by typing  `boot' .
.bp
.TP
3)
When the `boot' prompt is given, type
one of the following:
.br
.nf

	hp(0,0)unix
	hm(0,0)unix
	hk(0,0)unix
	rp(0,0)unix
	rl(0,0)unix

.fi
depending on the type of disk you are loading from.
The first 0 indicates the physical unit number;
the second indicates
the block number of the beginning of the logical file
system to be searched.
(See below).
.PP
When the system is running, it types
.br
.nf

	unix/v7m 2.0

	mem = ######
	#

.fi
on the console.
The `mem =' message gives the amount of free
memory in bytes, available to user programs.
After setting the date
(date(8))
and doing any file system checks
a multi-user system is brought up by typing an EOT
(control-d)
in response to the `#' prompt.
.PP
.B Device specifications.
A device specification has the following form:
.IP " "
device(unit,offset)
.LP
where
.I device
is the type of the device to be searched,
.I unit
is the unit number of the device,
and 
.I offset
is the block offset of the file system on the device.
.I Device
is one of the following
.br
.nf

	hp	RM02/3 or RP04/5/6 on first RH11/70
	hm	RM02/3 or RP04/5/6 on second RH11/70
	hk	RK06/7
	rp	RP03
	rl	RL01/2
	rk	RK05

.fi
For example, the specification
.IP " "
rp(1,7000)
.LP
indicates an RP03 disk, unit 1, and the file system found
starting at block 7000 (cylinder 35).
.PP
The `hp' disks have the ability to deal with
interleaved file systems (see hp(4)).
Unit numbers 0 thru 3 refer to physical drives
0 thru 3 non-interleaved, and unit numbers
4 thru 7 refer to physical drives 0 thru 3
with interleaved file systems.
.PP
.SM
.B ROM
.B programs.
The following programs to call the primary bootstrap
may be installed in read-only memories
or manually keyed into main 
memory.
Each program is position-independent
but should be placed well above location 0
so it will not be overwritten.
Each reads a block from the
beginning of a device into core location
zero.
The octal words constituting the program are
listed on the left.
.PP
.ne 5
.nf
.if n .ta 3 11 15 23 38
.if t .ta .3i 1i 1.4i 2i 3.5i
RK (drive 0):
	012700		mov	$rkda,r0
	177412
	005040		clr	\-(r0)	/ rkda cleared by start
	010040		mov	r0,\-(r0)
	012740		mov	$5,\-(r0)
	000005
	105710	1:	tstb	(r0)
	002376		bge	1b
	005007		clr	pc
.PP
.ne 11
RP (drive 0)
	012700		mov	$rpmr,r0
	176726
	005040		clr	\-(r0)
	005040		clr	\-(r0)
	005040		clr	\-(r0)
	010040		mov	r0,\-(r0)
	012740		mov	$5,\-(r0)
	000005
	105710	1:	tstb	(r0)
	002376		bge	1b
	005007		clr	pc
.DT
.SH FILES
/unix \- system code
.br
/mdec/hpuboot
.br
/mdec/hkuboot
.br
/mdec/rpuboot
.br
/mdec/rluboot - copies of the prinmary bootstraps
.br
/boot \- second stage bootstrap
.br
/boot.bu \- backup copy of boot
.SH "SEE ALSO"
init(8)