BOOT PROCEDURES(VIII) 2/11/75 BOOT PROCEDURES(VIII)
NAME
boot procedures - UNIX startup
DESCRIPTION
How to start UNIX. UNIX is started by placing it in core at
location zero and transferring to zero. Since the system is
not reenterable, it is necessary to read it in from disk or
tape.
The tp command places a bootstrap program on the otherwise
unused block zero of the tape. The DECtape version of this
program is called tboot, the magtape version mboot. If
tboot or mboot is read into location zero and executed
there, it will type `=' on the console, read in a tp entry
name, load that entry into core, and transfer to zero. Thus
one way to run UNIX is to maintain the system code on a tape
using tp. Caution: the file /usr/mdec/tboot (DECtape) or
/usr/mdec/mboot (magtape) must be present when the tape is
made! When a boot is required, execute (somehow) a program
which reads in and jumps to the first block of the tape. In
response to the `=' prompt, type the entry name of the sys-
tem on the tape (we use plain `unix'). It is strongly rec-
ommended that a current version of the system be maintained
in this way, even if it is usually booted from disk.
The standard DEC ROM which loads DECtape is sufficient to
read in tboot, but the magtape ROM loads block one, not ze-
ro. If no suitable ROM is available, magtape and DECtape
programs are presented below which may be manually placed in
core and executed.
The system can also be booted from a disk file with the aid
of the uboot program. When read into location 0 and execut-
ed, uboot reads a single character (either p or k for RP or
RK, both drive 0) to specify which device is to be searched.
Then it reads a UNIX pathname from the console, finds the
corresponding file on the given device, loads that file into
core location zero, and transfers to it. Uboot operates un-
der very severe space constraints. It supplies no prompts,
except that it echoes a carriage return and line feed after
the p or k. No diagnostic is provided if the indicated file
cannot be found, nor is there any means of correcting typo-
graphical errors in the file name except to start the pro-
gram over. If it fails to find the file, however, it jumps
back to its start, so another try can be attempted, starting
again with the p or k. Notice that uboot will only load a
file from drive 0, and the file system it searches must
start at the beginning of the disk. Uboot itself usually
resides in the otherwise unused block 0 of the disk, so it
can be loaded by ROM program; mkfs can be used to put it
there when the file system is created. It can also be load-
ed from a tp tape as described above.
The switches. The console switches play an important role in
the use and especially the booting of UNIX. During opera-
- 1 -
BOOT PROCEDURES(VIII) 2/11/75 BOOT PROCEDURES(VIII)
tion, the console switches are examined 60 times per second,
and the contents of the address specified by the switches
are displayed in the display register. (This is not true on
the 11/40 since there is no display register on that ma-
chine.) If the switch address is even, the address is in-
terpreted in kernel (system) space; if odd, the rounded-down
address is interpreted in the current user space.
If any diagnostics are produced by the system, they are
printed on the console only if the switches are non-zero.
Thus it is wise to have a non-zero value in the switches at
all times.
During the startup of the system, the init program(VIII)
reads the switches and will come up single-user if the
switches are set to 173030.
It is unwise to have a non-existent address in the switches.
This causes a bus error in the system (displayed as 177777)
at the rate of 60 times per second. If there is a transfer
of more than 16ms duration on a device with a data rate
faster than the bus error timeout (about 10us) then a perma-
nent disk non-existent-memory error will occur.
ROM programs. Here are some programs which are suitable for
installing in read-only memories, or for manual keying into
core if no ROM is present. Each program is position-inde-
pendent but should be placed well above location 0 so it
will not be overwritten. Each reads a block from the begin-
ning of a device into core location zero. The octal words
constituting the program are listed on the left.
DECtape (drive 0) from endzone:
012700 mov $tcba,r0
177346
010040 mov r0,-(r0) / use tc addr for wc
012710 mov $3,(r0) / read bn forward
000003
105710 1: tstb (r0) / wait for ready
002376 bge 1b
112710 movb $5,(r0) / read (forward)
000005
000777 br . / loop; now halt and start at 0
DECtape (drive 0) with search:
012700 1: mov $tcba,r0
177346
010040 mov r0,-(r0) / use tc addr for wc
012740 mov $4003,-(r0) / read bn reverse
004003
005710 2: tst (r0)
002376 bge 2b / wait for error
005760 tst -2(r0) / loop if not end zone
177776
002365 bge 1b
012710 mov $3,(r0) / read bn forward
- 2 -
BOOT PROCEDURES(VIII) 2/11/75 BOOT PROCEDURES(VIII)
000003
105710 2: tstb (r0) / wait for ready
002376 bge 2b
112710 movb $5,(r0) / read (forward)
000005
105710 2: tstb (r0) / wait for ready
002376 bge 2b
005007 clr pc / transfer to zero
Caution: both of these DECtape programs will (literally)
blow a fuse if 2 drives are dialed to zero.
Magtape from load point:
012700 mov $mtcma,r0
172526
010040 mov r0,-(r0) / usr mt addr for wc
012740 mov $60003,-(r0) / read 9-track
060003
000777 br . / loop; now halt and start at 0
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
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
FILES
/unix - UNIX code
/usr/mdec/mboot - tp magtape bootstrap
/usr/mdec/tboot - tp DECtape bootstrap
/usr/mdec/uboot - file system bootstrap
SEE ALSO
tp(I), init(VIII)
- 3 -