Setting up UNIX - Sixth Edition
From Computer History Wiki
I just generated this from a Unix V6 image, by simply running:
# nroff -ms /usr/doc/start/start > /dev/lp0
And the removing the embedded page breaks.
SETTING
_______ UP
__ UNIX
____ - Sixth
_____ Edition
_______
Enclosed are:
1. `UNIX Programmer's Manual,' Sixth Edition.
2. Documents with the following titles:
Setting Up UNIX - Sixth Edition
The UNIX Time-Sharing System
C Reference Manual
Programming in C - A Tutorial
UNIX Assembler Reference Manual
A Tutorial Introduction to the ED Text Editor
UNIX for Beginners
RATFOR - A Preprocessor for a Rational Fortran
YACC - Yet Another Compiler-Compiler
NROFF Users' Manual
The UNIX I/O System
A Manual for the Tmg Compiler-writing Language
On the Security of UNIX
The M6 Macro Processor
A System for Typesetting Mathematics
DC - An Interactive Desk Calculator
BC - An Arbitrary Precision Desk-Calculator Language
The Portable C Library (on UNIX)
UNIX Summary
3. The UNIX software on magtape or disk pack.
If you are set up to do it, it might be a good idea im-
mediately to make a copy of the disk or tape to guard
against disaster. The tape contains 12100 512-byte records
followed by a single file mark; only the first 4000 512-byte
blocks on the disk are significant.
The system as distributed corresponds to three fairly
full RK packs. The first contains the binary version of all
programs, and the source for the operating system itself;
the second contains all remaining source programs; the third
contains manuals intended to be printed using the formatting
programs roff or nroff. The `binary' disk is enough to run
the system, but you will almost certainly want to modify
some source programs.
October 10, 1975
- 2 -
Making
______ a
_ Disk
____ From
____ Tape
____
If your system is on magtape, perform the following
bootstrap procedure to obtain a disk with the binaries.
1. Mount magtape on drive 0 at load point.
2. Mount formatted disk pack on drive 0.
3. Key in and execute at 100000
TU10 TU16
012700 (to be added)
172526
010040
012740
060003
000777
The tape should move and the CPU loop. (The TU10 code
is not
___ the DEC bulk ROM for tape; it reads block 0, not
block 1.)
4. Halt and restart the CPU at 0. The tape should rewind.
The console should type `='.
5. Copy the magtape to disk by the following. This as-
sumes TU10 and RK05; see 6 below for other devices.
The machine's printouts are shown in italic (the `='
signs should be considered italic). Terminate each
line you type by carriage return or line-feed.
= tmrk
disk
____ offset
______
0
tape
____ offset
______
100 (See 6 below)
count
_____
1 (The tape should move)
= tmrk
disk
____ offset
______
1
tape
____ offset
______
101 (See 7 below)
count
_____
3999 (The tape moves lots more)
=
To explain: the tmrk
____ program copies tape to disk with
the given offsets and counts. Its first use copies a
bootstrap program to disk block 0; the second use
copies the file system itself onto the disk. You may
get back to `=' level by starting at 137000.
October 10, 1975
- 3 -
6. If you have TU16 tape say `htrk' instead of `tmrk' in
the above example. If you have an RP03 disk, say
`tmrp' or `htrp', and use a 99 instead of 100 tape
offset. If you have an RP04 disk, use `tmhp' or `hthp'
instead or `tmrk', and use a 98 instead of 100 tape
offset. The different offsets load bootstrap programs
appropriate to the disk they will live on.
7. This procedure generates the `binary' disk; the
`source' disk may be generated on another RK pack by
using a tape offset of 4101 instead of 101. The `docu-
ment' disk is at offset 8101 instead of 101. Unless
you have only a single RK drive, it is probably wise to
wait on generating these disks. Better tools are
available using UNIX itself.
Booting
_______ UNIX
____
Once the UNIX `binary' disk is obtained, the system is
booted by keying in and executing one of the following pro-
grams at 100000. These programs correspond to the DEC bulk
ROMs for disks, since they read in and execute block 0 at
location 0.
RK05 RP03 RP04
012700 012700 (to be added)
177414 176726
005040 005040
005040 005040
010040 005040
012740 010040
000005 012740
105710 000005
002376 105710
005007 002376
005007
Now follow the indicated dialog, where `@' and `#' are
prompts:
@ rkunix (or `rpunix' or `hpunix')
mem
___ = xxx
___
login
_____: root
____
#
The mem
___ message gives the memory available to user programs
in .1K units. Most of the UNIX software will run with 120
(for 12K words), but some things require much more.
UNIX is now running, and the `UNIX Programmer's manual'
applies; references below of the form X-Y mean the subsec-
tion named X in section Y of the manual. The `#' is the
prompt from the UNIX Shell, and indicates you are logged in
as the super-user. The only valid user names are `root' and
October 10, 1975
- 4 -
`bin'. The root is the super-user and bin is the owner of
nearly every file in the file system.
Before UNIX is turned up completely, a few configura-
tion dependent exercises must be performed. At this point,
it would be wise to read all of the manuals and to augment
this reading with hand to hand combat. It might be instruc-
tive to examine the Shell run files mentioned below.
Reconfiguration
_______________
The UNIX system running is configured to run on an
11/40 with the given disk, TU10 magtape and TU56 DECtape.
This is almost certainly not the correct configuration.
Print (cat-I) the file /usr/sys/run. This file is a set of
Shell commands that will completely recompile the system
source, install it in the correct libraries and build the
three configurations for rk, rp and hp.
Using the Shell file as a guide, compile (cc-I) and
rename (mv-I) the configuration program `mkconf'. Run the
configuration program and type into it a list of the con-
trollers on your system. Choose from:
pc (PC11)
lp (LP11)
rf (RS11)
hs (RS03/RS04)
tc (TU56)
rk (RK03/RK05)
tm (TU10)
rp (RP03)
hp (RP04)
ht (TU16)
dc* (DC11)
kl* (KL11/DL11-ABC)
dl* (DL11-E)
dp (DP11)
dn (DN11)
dh (DH11)
dhdm (DM11-BB)
The devices marked with * should be preceded by a number
specifying how many. (The console typewriter is automati-
cally included; don't count it in the kl specification.)
Mkconf will generate the two files l.s (trap vectors) and
c.c (configuration table). Take a careful look at l.s to
make sure that all the devices that you have are assembled
in the correct interrupt vectors. If your configuration is
non-standard, you will have to modify l.s to fit your confi-
guration.
In the run Shell file, the 11/45 code is commented out.
If you have an 11/45 you must also edit (ed-I) the file
October 10, 1975
- 5 -
/usr/sys/conf/m45.s to set the assembly flag fpp to reflect
if you have the FP11-B floating point unit. The main
difference between an 11/40 and an 11/45 (or 11/70) system
is that in the former instruction restart after a segmenta-
tion violation caused by overflowing a user stack must be
handled by software, while in the latter machines there is
hardware help. As mentioned above, the 11/45 and 11/70 sys-
tems include conditionally-enabled code to save the status
of the floating point unit when switching users. The source
for such things is in one of the two files m40.s and m45.s.
Another difference is that in 11/45 and 11/70 systems
the instruction and data spaces are separated inside UNIX
itself. Since the layout of addresses in the system is
somewhat peculiar, and not directly supported by the link-
editor ld
__, the sysfix
______ program has to be run before the load-
ed output file can be booted.
There are certain magic numbers and configuration
parameters imbedded in various device drivers that you may
want to change. The device addresses of each device are de-
fined in each driver. In case you have any non-standard
device addresses, just change the address and recompile.
(The device drivers are in the directory /usr/sys/dmr.)
The DC11 driver is set to run 14 lines. This can be
changed in dc.c.
The DH11 driver will only handle a single DH with a
full complement of 16 lines. If you have less, you may want
to edit dh.c.
The DN11 driver will handle 3 DN's. Edit dn.c.
The DP11 driver can only handle a single DP. This can-
not be easily changed.
The KL/DL driver is set up to run a single DL11-A, -B,
or -C (the console) and no DL11-E's. To change this, edit
kl.c to have NKL11 reflect the total number of DL11-ABC's
and NDL11 to reflect the number of DL11-E's. So far as the
driver is concerned, the difference between the devices is
their addresses.
The line printer driver is set up to print the 96 char-
acter set on 80 column paper (LP11-H) with indenting. Edit
lp.c.
All of the disk and tape drivers (rf.c, rk.c, rp.c,
tm.c, tc.c, hs.c, hp.c, ht.c) are set up to run 8 drives and
should not need to be changed. The big disk drivers (rp.c
and hp.c) have partition tables in them which you may want
to experiment with.
October 10, 1975
- 6 -
After all the corrections have been made, use
/usr/sys/run as a guide to recompile the changed drivers,
install them in /usr/sys/lib2 and to assemble the trap vec-
tors (l.s), configuration table (c.c) and machine language
assist (m40.s or m45.s). After all this, link edit the ob-
jects (ld-I) and if you have an 11/45, sysfix the result.
The final object file (a.out) should be renamed /unix and
booted. See Boot Procedures-VIII for a discussion of boot-
ing. (Note: remember, before booting, always perform a
sync-VIII to force delayed output to the disk.)
Special
_______ Files
_____
Next you must put in all of the special files in the
directory /dev using mknod-VIII. Print the configuration
file c.c created above. This is the major device switch of
each device class (block and character). There is one line
for each device configured in your system and a null line
for place holding for those devices not configured. The
block special devices are put in first by executing the fol-
lowing generic command for each disk or tape drive. (Note
that some of these files already exist in the directory
/dev. Examine each file with ls-I with -l flag to see if
the file should be removed.)
/etc/mknod /dev/NAME b MAJOR MINOR
The NAME is selected from the following list:
c.c NAME device
rf rf0 RS fixed head disk
tc tap0 TU56 DECtape
rk rk0 RK03 RK05 moving head disk
tm mt0 TU10 TU16 magtape
rp rp0 RP moving head disk
hs hs0 RS03 RS04 fixed head disk
hp hp0 RP04 moving head disk
The major device number is selected by counting the line
number (from zero) of the device's entry in the block confi-
guration table. Thus the first entry in the table bdevsw
would be major device zero.
The minor device is the drive number, unit number or
partition as described under each device in section IV. The
last digit of the name (all given as 0 in the table above)
should reflect the minor device number. For tapes where the
unit is dial selectable, a special file may be made for each
possible selection.
The same goes for the character devices. Here the
names are arbitrary except that devices meant to be used for
teletype access should be named /dev/ttyX, where X is any
character. The files tty8 (console), mem, kmem, null are
October 10, 1975
- 7 -
already correctly configured.
The disk and magtape drivers provide a `raw' interface
to the device which provides direct transmission between the
user's core and the device and allows reading or writing
large records. The raw device counts as a character device,
and should have the name of the corresponding standard block
special file with `r' prepended. Thus the raw magtape files
would be called /dev/rmtX.
When all the special files have been created, care
should be taken to change the access modes (chmod-I) on
these files to appropriate values.
The
___ Source
______ Disk
____
You should now extract the source disk. This can be
done as described above or the UNIX command dd-I may be
used. The disk image begins at block 4100 on the tape, so
the command
dd if=/dev/mt0 of=/dev/rk1 count=4000 skip=4100
might be used to extract the disk to RK drive 1.
This disk should be mounted (mount-VIII) on
/usr/source; it contains directories of source code. In
each directory is a Shell file run that will recompile all
the source in the directory. These run files should be con-
sulted whenever you need to recompile.
Floating
________ Point
_____
UNIX only supports the 11/45 FP11-B floating point un-
it. For machines without this hardware, there is a user
subroutine available that will catch illegal instruction
traps and interpret floating point operations. (See
fptrap-III.) The system as delivered has this code included
in all commands that have floating point. This code is nev-
er used if the FP hardware is available and therefore does
not need to be changed. The penalty is a little bit of disk
space and loading time for the few floating commands.
The C compiler in /usr/source/c probably should be
changed if floating point is available. The fpp flag in
c0t.s should be set and C should be recompiled and reloaded
and installed. This allows floating point C programs to be
compiled without the -f flag and prevents the floating point
interpreter from getting into new floating programs. (See
/usr/source/c/run.)
October 10, 1975
- 8 -
Time
____ Conversion
__________
If your machine is not in the Eastern time zone, you
must edit (ed-I) the subroutine /usr/source/s4/ctime.c to
reflect your local time. The variable `timezone' should be
changed to reflect the time difference between local time
and GMT. For EST, this is 5*60*60; for PST it would be
8*60*60. This routine also contains the names of the stan-
dard and Daylight Savings time zone; so `EST' and `EDT'
might be changed to `PST' and `PDT' respectively. Notice
that these two names are in upper case and escapes may be
needed (tty-IV). Finally, there is a `daylight' flag; when
it is 1 it causes the time to shift to Daylight Savings au-
tomatically between the last Sundays in April and October
(or other algorithms in 1974 and 1975). Normally this will
not have to be reset. After ctime.c has been edited it
should be compiled and installed in its library. (See
/usr/source/s4/run.) Then you should (at your leisure)
recompile and reinstall all programs performing time conver-
sion. These include: (in s1) date, dump, ls, cron, (in s2)
mail, pr, restor, who, sa and tp.
Disk
____ Layout
______
If there are to be more file systems mounted than just
the root, use mkfs-VIII to create the new file system and
put its mounting in the file /etc/rc (see init-VIII and
mount-VIII). (You might look at /etc/rc anyway to see what
has been provided for you.)
There are two considerations in deciding how to adjust
the arrangement of things on your disks: the most important
is making sure there is adequate space for what is required;
secondarily, throughput should be maximized. The RK disk
(or its image) as distributed has 4000 blocks for file
storage, and the remainder of the disk (872 blocks) is set
aside for swap space. In our own system, which allows 14
simultaneous users, this amount of swap space is not quite
enough, so we use 1872 blocks for this purpose; it is large
enough so running out of swap space never occurs.
Many common system programs (C, the editor, the assem-
bler etc.) create intermediate files in the /tmp directory,
so the file system where this is stored also should be made
large enough to accommodate most high-water marks. In an
idle state, we have about 900 free blocks on the file system
where /tmp resides, and hit the bottom every few days or so.
(This causes a momentary disruption, but not a crash, as
swap-space runout does.) All the programs that create files
in /tmp try to take care to delete them, but most are not
immune to events like being hung up upon, and can leave
dregs. The directory should be examined every so often and
the old files deleted.
October 10, 1975
- 9 -
Exhaustion of user-file space is certain to occur now
and then; the only mechanisms for controlling this
phenomenon are occasional use of du-I and threatening mes-
sages of the day and personal letters.
The efficiency with which UNIX is able to use the CPU
is largely dictated by the configuration of disk controll-
ers. For general time-sharing applications, the best stra-
tegy is to try to split user files, the root directory (in-
cluding the /tmp directory) and the swap area among three
controllers. In our own system, for example, we have user
files on an RP, the root on an RF fixed-head disk, and swap
on an RK. This is best for us since the RK has a faster
transfer rate than the rather slow RF, and in swapping the
transfer rate rather than access time is the dominant influ-
ence on throughput.
Once you have decided how to make best use of your
hardware, the question is how to initialize it. If you have
the equipment, the best way to move a file system is to dump
it (dump-VIII) to magtape, use mkfs-VIII to create the new
file system, and restore the tape. If you don't have
magtape, dump accepts an argument telling where to put the
dump; you might use another disk or DECtape. Sometimes a
file system has to be increased in logical size without
copying. The super-block of the device has a word giving
the highest address which can be allocated. For relatively
small increases, this word can be patched using the debugger
(db-I) and the free list reconstructed using icheck-VIII.
The size should not be increased very greatly by this tech-
nique, however, since although the allocatable space will
increase the maximum number of files will not (that is, the
i-list size can't be changed). Read and understand the
description given in file system-VI before playing around in
this way.
If you have only an RP disk, see section rp-IV for some
suggestions on how to lay out the information on it. The
file systems distributed on tape, containing the binary, the
source, and the manuals, are each only 4000 blocks long.
Perhaps the simplest way to integrate the latter two into a
large file system is to extract the tape into the upper part
of the RP, dump it, and restore it into an empty, non-
overlapping file system structure. If you have to merge a
file system into another, existing one, the best bet is to
use ncheck-VIII to get a list of names, then edit this list
into a sequence of mkdir and cp commands which will serve as
input to the Shell. (But notice that owner information is
lost.)
October 10, 1975
- 10 -
New
___ Users
_____
Install new users by editing the password file
/etc/passwd (passwd-V). You'll have to make current direc-
tories for the new users and change their owners to the new-
ly installed name. Login as each user to make sure the
password file is correctly edited. For example:
ed /etc/passwd
$a
joe::10:1::/usr/joe:
.
w
q
mkdir /usr/joe
chown joe /usr/joe
login joe
ls -la
login root
This will make a new login entry for joe. His default
current directory is /usr/joe which has been created. The
delivered password file has the user ken
___ in it to be used as
a prototype.
Multiple
________ Users
_____
If UNIX is to support simultaneous access from more
than just the console teletype, the file /etc/ttys (ttys-V)
has to be edited. For some historical reason tty8 is the
name of the console typewriter. To add new typewriters be
sure the device is configured and the special file exists,
then set the first character of the appropriate line of
/etc/ttys to 1 (or add a new line). Note that init.c will
have to be recompiled if there are to be more than 20 type-
writers. Also note that if the special file is inaccessible
when init tries to create a process for it, the system will
thrash trying and retrying to open it.
File
____ System
______ Health
______
Periodically (say every day or so) and always after a
crash, you should check all the file systems for consistency
(icheck, dcheck-VIII). It is quite important to execute
sync (VIII) before rebooting or taking the machine down.
This is done automatically every 30 seconds by the update
program (VIII) when a multiple-user system is running, but
you should do it anyway to make sure.
Dumping of the file system should be done regularly,
since once the system is going it is very easy to become
complacent. Just remember that our RP controller has failed
three times, each time in such a way that all information on
the disk was wiped out without any error status from the
October 10, 1975
- 11 -
controller. Complete and incremental dumps are easily done
with the dump command (VIII) but restoration of individual
files is painful. Dumping of files by name is best done by
tp (I) but the number of files is limited. Finally if there
are enough drives entire disks can be copied using cp-I, or
preferably with dd-I using the raw special files and an ap-
propriate block size. Note that there is no stand-alone
program with UNIX that will restore any of these formats.
Unless some action has been taken to prevent destruction of
a running version of UNIX, you can find yourself stranded
even though you have backup.
October 10, 1975
- 12 -
Odds
____ and
___ Ends
____
The programs dump, icheck, dcheck, ncheck, and df
(source in /usr/source/s1 and /usr/source/s2) should be
changed to reflect your default mounted file system devices.
Print the first few lines of these programs and the changes
will be obvious.
If you would like to share any UNIX compatible software
with others, please let us know about it. If you find bugs
in the software or the documentation, again let us know.
Lastly, there is a UNIX users' group forming. To get
on their mailing list, send your name(s) and address to:
Prof. Melvin Ferentz
Physics Dept.
Brooklyn College of CUNY
Brooklyn, N.Y. 11210
Good luck.
Ken Thompson
Dennis Ritchie
October 10, 1975
