I've converted all the man pages so far into roff format.
This commit is contained in:
Warren Toomey
+35
-23
@@ -1,26 +1,38 @@
|
|||||||
11/3/70 CHRM (I)
|
.oh '11/3/70''CHRM(I)'
|
||||||
|
.ta 18 21
|
||||||
|
|
||||||
NAME chrm -- remove (unlink) files
|
NAME chrm -- remove (unlink) files
|
||||||
|
.sp
|
||||||
SYNOPSIS chrm directory name1 ...
|
SYNOPSIS
|
||||||
|
.ul
|
||||||
DESCRIPTION chrm removes the entries for one or more files from the
|
chrm
|
||||||
named directory. If an entry was the last link to the file,
|
directory name1 ...
|
||||||
the file is destroyed. Removal of a file requires write
|
.sp
|
||||||
permission in its directory, but neither read nor write
|
DESCRIPTION
|
||||||
|
.ul
|
||||||
|
chrm
|
||||||
|
removes the entries for one or more files
|
||||||
|
from the named directory. If an entry was the
|
||||||
|
last link to the file, the file is destroyed.
|
||||||
|
Removal of a file requires write permission in
|
||||||
|
its directory, but neither read nor write
|
||||||
permission on the file itself.
|
permission on the file itself.
|
||||||
|
.sp
|
||||||
Directories cannot be removed by rm; cf. rmdir.
|
Directories cannot be removed by
|
||||||
|
.ul
|
||||||
FILES none.
|
chrm.
|
||||||
|
.sp
|
||||||
SEE ALSO rmdir, for removing directories.
|
FILES --
|
||||||
|
.sp
|
||||||
DIAGNOSTICS If the file cannot be removed or does not exist, the name
|
SEE ALSO --
|
||||||
of the file followed by a question mark is typed.
|
.sp
|
||||||
|
DIAGNOSTICS If the file cannot be removed or does not exist,
|
||||||
BUGS rm probably should ask whether a read-only file is really
|
the name of the file followed by a question mark
|
||||||
to be removed.
|
is typed.
|
||||||
|
.sp
|
||||||
|
BUGS
|
||||||
|
.ul
|
||||||
|
chrm
|
||||||
|
probably should ask whether a read-only
|
||||||
|
file is really to be removed.
|
||||||
|
.sp
|
||||||
OWNER ken, dmr
|
OWNER ken, dmr
|
||||||
|
|||||||
@@ -1,23 +1,25 @@
|
|||||||
11/3/70 CP (I)
|
.oh '11/3/70''CP(I)'
|
||||||
|
.ta 18 21
|
||||||
|
|
||||||
NAME cp -- copy
|
NAME cp -- copy
|
||||||
|
.sp
|
||||||
SYNOPSIS cp file11 file12 file21 file22 ...
|
SYNOPSIS
|
||||||
|
.ul
|
||||||
DESCRIPTION Files are taken in pairs; the first is opened for reading,
|
cp
|
||||||
the second created mode 17. Then the first is copied into
|
file11 file12 file21 file22 ...
|
||||||
the second.
|
.sp
|
||||||
|
DESCRIPTION Files are taken in pairs; the first is opened
|
||||||
FILES
|
for reading, the second created mode 17. Then
|
||||||
|
the first is copied into the second.
|
||||||
|
.sp
|
||||||
|
FILES --
|
||||||
|
.sp
|
||||||
SEE ALSO cat, pr
|
SEE ALSO cat, pr
|
||||||
|
.sp
|
||||||
DIAGNOSTICS Error returns are checked at every system call, and
|
DIAGNOSTICS Error returns are checked at every system call,
|
||||||
appropriate diagnostics are produced.
|
and appropriate diagnostics are produced.
|
||||||
|
.sp
|
||||||
BUGS The second file should be created in the mode of the first.
|
BUGS The second file should be created in the mode of
|
||||||
|
the first. A directory convention as used in mv
|
||||||
A directory convention as used in mv should be adopted to cp.
|
should be adopted to cp.
|
||||||
|
.sp
|
||||||
OWNER ken, dmr
|
OWNER ken, dmr
|
||||||
|
|||||||
+16
-15
@@ -1,19 +1,20 @@
|
|||||||
11/3/70 DATE (I)
|
.oh '11/3/70''DATE(I)'
|
||||||
|
.ta 18 21
|
||||||
|
|
||||||
NAME date - print the date
|
NAME date - print the date
|
||||||
|
.sp
|
||||||
SYNOPSIS date
|
SYNOPSIS
|
||||||
|
.ul
|
||||||
|
date
|
||||||
|
.sp
|
||||||
DESCRIPTION The current date is printed to the second.
|
DESCRIPTION The current date is printed to the second.
|
||||||
|
.sp
|
||||||
FILES
|
FILES --
|
||||||
|
.sp
|
||||||
SEE ALSO
|
SEE ALSO --
|
||||||
|
.sp
|
||||||
DIAGNOSTICS It is always 1970.
|
DIAGNOSTICS --
|
||||||
|
.sp
|
||||||
BUGS
|
BUGS It is always 1970.
|
||||||
|
.sp
|
||||||
OWNER wkt
|
OWNER wkt
|
||||||
|
|
||||||
|
|||||||
@@ -1,34 +1,36 @@
|
|||||||
11/3/70 DIRECTORY (V)
|
.oh '11/3/70''DIRECTORY(I)'
|
||||||
|
.ta 18 21
|
||||||
|
|
||||||
NAME format of directories
|
NAME format of directories
|
||||||
|
.sp
|
||||||
SYNOPSIS
|
SYNOPSIS --
|
||||||
|
.sp
|
||||||
DESCRIPTION A directory behaves exactly like an ordinary file, save
|
DESCRIPTION A directory behaves exactly like an ordinary
|
||||||
that no user may write into a directory. The fact that a
|
file, save that no user may write into a
|
||||||
file is a directory is indicated by a bit in the flag word
|
directory. The fact that a file is a directory
|
||||||
of its i-node entry.
|
is indicated by a bit in the flag word of its
|
||||||
|
i-node entry.
|
||||||
Directory entries are 8 words long. The first word is the
|
.sp
|
||||||
i-node of the file represented by the entry, if non-zero;
|
Directory entries are 8 words long. The first
|
||||||
if zero, the entry is empty.
|
word is the i-node of the file represented by
|
||||||
|
the entry, if non-zero; if zero, the entry is
|
||||||
Words 1-4 represent the (8-character) file name, space
|
empty.
|
||||||
padded on the right. These words are not necessarily
|
.sp
|
||||||
cleared for empty slots.
|
Words 1-4 represent the (8-character) file name,
|
||||||
|
space padded on the right. These words are not
|
||||||
By convention, the first entry in each directory is
|
necessarily cleared for empty slots.
|
||||||
for "dd", which is the "directory directory" that holds
|
.sp
|
||||||
all the users' home directories and the "system" directory.
|
By convention, the first entry in each directory
|
||||||
The "system" directory contains "init" and "sh".
|
is for "dd", which is the "directory directory"
|
||||||
|
that holds all the users' home directories and
|
||||||
FILES
|
the "system" directory. The "system" directory
|
||||||
|
contains "init" and "sh".
|
||||||
|
.sp
|
||||||
|
FILES --
|
||||||
|
.sp
|
||||||
SEE ALSO file system format
|
SEE ALSO file system format
|
||||||
|
.sp
|
||||||
DIAGNOSTICS
|
DIAGNOSTICS --
|
||||||
|
.sp
|
||||||
BUGS
|
BUGS --
|
||||||
|
.sp
|
||||||
OWNER ken, dmr
|
OWNER ken, dmr
|
||||||
|
|||||||
+89
-74
@@ -1,51 +1,60 @@
|
|||||||
11/3/70 FILE SYSTEM (V)
|
.oh '11/3/70''FILE SYSTEM(V)'
|
||||||
|
.ta 18 21 24
|
||||||
|
|
||||||
NAME format of file system
|
NAME format of file system
|
||||||
|
.sp
|
||||||
SYNOPSIS
|
SYNOPSIS --
|
||||||
|
.sp
|
||||||
DESCRIPTION The RB09 fixed head disk has 8,000 64-word blocks on
|
DESCRIPTION The RB09 fixed head disk has 8,000 64-word
|
||||||
each of its two surfaces. Unix uses the second surface
|
blocks on each of its two surfaces. Unix uses
|
||||||
(physical blocks 8,000 to 15,999) and numbers them
|
the second surface (physical blocks 8,000 to
|
||||||
from logical block 0 to logical block 7,999. The following
|
15,999) and numbers them from logical block 0 to
|
||||||
discussion refers to logical blocks.
|
logical block 7,999. The following discussion
|
||||||
|
refers to logical blocks.
|
||||||
The Unix filesystem is divided into 8,000 blocks of 64 words
|
.sp
|
||||||
per block. Block 0 is the "sysdata" block. The first word
|
The Unix filesystem is divided into 8,000 blocks
|
||||||
points to the first block of the free-storage map. Each block
|
of 64 words per block. Block 0 is the "sysdata"
|
||||||
in the free-storage map is structured as follows: the first
|
block. The first word points to the first block
|
||||||
word is the block number of the next block in the free-storage
|
of the free-storage map. Each block in the
|
||||||
map, or zero if this is the end of the free-storage map. The
|
free-storage map is structured as follows: the
|
||||||
next nine words hold free block numbers, or zero (no block number).
|
first word is the block number of the next block
|
||||||
|
in the free-storage map, or zero if this is the
|
||||||
|
end of the free-storage map. The next nine words
|
||||||
|
hold free block numbers, or zero (no block
|
||||||
|
number).
|
||||||
|
.sp
|
||||||
Block 1 on the filesystem is unused. (?)
|
Block 1 on the filesystem is unused. (?)
|
||||||
|
.sp
|
||||||
I-numbers begin at 1, and the storage for i-nodes begins at
|
I-numbers begin at 1, and the storage for
|
||||||
block 2. Blocks 2 to 711 contain the i-nodes, with five
|
i-nodes begins at block 2. Blocks 2 to 711
|
||||||
consecutive i-nodes per block. Certain i-nodes are reserved for
|
contain the i-nodes, with five consecutive
|
||||||
special files, directories and devices:
|
i-nodes per block. Certain i-nodes are reserved
|
||||||
|
for special files, directories and devices:
|
||||||
1 The core file written by "sys save" or a bad system call
|
.sp
|
||||||
|
1 The core file written by "sys save" or a
|
||||||
|
bad system call
|
||||||
2 The "dd" directory directory
|
2 The "dd" directory directory
|
||||||
3 The "system" directory
|
3 The "system" directory
|
||||||
6 The "ttyin" special file
|
6 The "ttyin" special file
|
||||||
7 The "keyboard" (graphic-2) special file
|
7 The "keyboard" (graphic-2) special file
|
||||||
8 The "pptin" (paper tape reader) special file
|
8 The "pptin" (paper tape reader) special
|
||||||
|
file
|
||||||
10 The "ttyout" special file
|
10 The "ttyout" special file
|
||||||
11 The "display" (graphic-2) special file
|
11 The "display" (graphic-2) special file
|
||||||
12 The "pptout" (paper tape punch) special file
|
12 The "pptout" (paper tape punch) special
|
||||||
|
file
|
||||||
|
.sp
|
||||||
There is only one file system which is always mounted;
|
There is only one file system which is always
|
||||||
it resides on the RB disk. This device is also used for
|
mounted; it resides on the RB disk. This device
|
||||||
swapping. The swap areas are at the high blocks on this device:
|
is also used for swapping. The swap areas are at
|
||||||
blocks 6,400 to 7,999. These blocks do not appear in the free list.
|
the high blocks on this device: blocks 6,400 to
|
||||||
|
7,999. These blocks do not appear in the free
|
||||||
|
list.
|
||||||
|
.sp
|
||||||
Each i-node represents one file. The format of
|
Each i-node represents one file. The format of
|
||||||
an i-node is as follows, where the left column represents
|
an i-node is as follows, where the left column
|
||||||
the offset in words from the beginning of the i-node:
|
represents the offset in words from the
|
||||||
|
beginning of the i-node:
|
||||||
|
.sp
|
||||||
0 flags (see below)
|
0 flags (see below)
|
||||||
1 first indirect block or contents block
|
1 first indirect block or contents block
|
||||||
...
|
...
|
||||||
@@ -54,9 +63,9 @@ DESCRIPTION The RB09 fixed head disk has 8,000 64-word blocks on
|
|||||||
9 link count
|
9 link count
|
||||||
10 size in words
|
10 size in words
|
||||||
11 unique value assigned at creation
|
11 unique value assigned at creation
|
||||||
|
.sp
|
||||||
The flags are as follows:
|
The flags are as follows:
|
||||||
|
.sp
|
||||||
400000 i-node is allocated
|
400000 i-node is allocated
|
||||||
200000 large file
|
200000 large file
|
||||||
?????? allocated bit (always on)
|
?????? allocated bit (always on)
|
||||||
@@ -66,39 +75,45 @@ DESCRIPTION The RB09 fixed head disk has 8,000 64-word blocks on
|
|||||||
000004 write, owner
|
000004 write, owner
|
||||||
000002 read, non-owner
|
000002 read, non-owner
|
||||||
000001 write, non-owner
|
000001 write, non-owner
|
||||||
|
.sp
|
||||||
The allocated bit (flag ??????) is believed even if the i-node
|
The allocated bit (flag ??????) is believed even
|
||||||
map says the i-node is free; thus corruption of the map may
|
if the i-node map says the i-node is free; thus
|
||||||
cause i-nodes to become unallocatable, but will not cause active
|
corruption of the map may cause i-nodes to
|
||||||
|
become unallocatable, but will not cause active
|
||||||
nodes to be reused.
|
nodes to be reused.
|
||||||
|
.sp
|
||||||
Word number n of a file is accessed as follows: n is
|
Word number n of a file is accessed as follows:
|
||||||
divided by 64 to find its logical block number (say b) in
|
n is divided by 64 to find its logical block
|
||||||
the file. If the file is small (flag 200000 is 0), then b
|
number (say b) in the file. If the file is small
|
||||||
must be less than 7, and the physical block number corresponding
|
(flag 200000 is 0), then b must be less than 7,
|
||||||
to b is the bth entry in the address portion of the i-node.
|
and the physical block number corresponding to b
|
||||||
|
is the bth entry in the address portion of the
|
||||||
If the file is large, b is divided by 64 to yield a number
|
i-node.
|
||||||
which must be less than 8 (or the file is too large for
|
.sp
|
||||||
UNIX to handle). The corresponding slot in the i-node
|
If the file is large, b is divided by 64 to
|
||||||
address portion gives the physical block number of an
|
yield a number which must be less than 8 (or
|
||||||
indirect block. The residue mod 64 gives a word offset
|
the file is too large for UNIX to handle).
|
||||||
in the indirect block, and the word found there is the
|
The corresponding slot in the i-node address
|
||||||
physical address of the block corresponding to b.
|
portion gives the physical block number of an
|
||||||
|
indirect block. The residue mod 64 gives a
|
||||||
If block b in a file exists, it is not necessary that all
|
word offset in the indirect block, and the
|
||||||
blocks less than b exist. A zero block number either in the
|
word found there is the physical address of
|
||||||
address words of the i-node or in an indirect block
|
the block corresponding to b.
|
||||||
indicates that the corresponding block has never been
|
.sp
|
||||||
allocated. Such a missing block reads as if it contained
|
If block b in a file exists, it is not necessary
|
||||||
|
that all blocks less than b exist. A zero block
|
||||||
|
number either in the address words of the i-node
|
||||||
|
or in an indirect block indicates that the
|
||||||
|
corresponding block has never been allocated.
|
||||||
|
Such a missing block reads as if it contained
|
||||||
all zero words.
|
all zero words.
|
||||||
|
.sp
|
||||||
FILES
|
FILES --
|
||||||
|
.sp
|
||||||
SEE ALSO format of directories
|
SEE ALSO format of directories
|
||||||
|
.sp
|
||||||
DIAGNOSTICS
|
DIAGNOSTICS --
|
||||||
|
.sp
|
||||||
BUGS
|
BUGS --
|
||||||
|
.sp
|
||||||
OWNER
|
OWNER ken
|
||||||
|
|||||||
@@ -1,19 +1,21 @@
|
|||||||
11/3/70 LN (I)
|
.oh '11/3/70''LN(I)'
|
||||||
|
.ta 18 30
|
||||||
|
|
||||||
NAME ln -- link to a file
|
NAME ln -- link to a file
|
||||||
|
.sp
|
||||||
SYNOPSIS ln name1 name2
|
SYNOPSIS
|
||||||
|
.ul
|
||||||
|
ln
|
||||||
|
name1 name2
|
||||||
|
.sp
|
||||||
DESCRIPTION ln adds another filename to the first filename
|
DESCRIPTION ln adds another filename to the first filename
|
||||||
|
.sp
|
||||||
FILES
|
FILES --
|
||||||
|
.sp
|
||||||
SEE ALSO
|
SEE ALSO --
|
||||||
|
.sp
|
||||||
DIAGNOSTICS "twofiles" - please provide two filenames
|
DIAGNOSTICS "twofiles" - please provide two filenames
|
||||||
"? file" - unable to make the link
|
"? file" - unable to make the link
|
||||||
|
.sp
|
||||||
BUGS
|
BUGS --
|
||||||
|
.sp
|
||||||
OWNER wkt
|
OWNER wkt
|
||||||
|
|||||||
@@ -1,19 +1,26 @@
|
|||||||
11/3/70 MV (I)
|
.oh '11/3/70''MV(I)'
|
||||||
|
.ta 18 31
|
||||||
|
|
||||||
NAME mv -- move or rename a file
|
NAME mv -- move or rename a file
|
||||||
|
.sp
|
||||||
SYNOPSIS mv name1 name2
|
SYNOPSIS
|
||||||
|
.ul
|
||||||
DESCRIPTION mv changes the name of name with the rename system call.
|
mv
|
||||||
|
name1 name2
|
||||||
FILES
|
.sp
|
||||||
|
DESCRIPTION
|
||||||
SEE ALSO
|
.ul
|
||||||
|
mv
|
||||||
|
changes the name of name with the rename
|
||||||
|
system call.
|
||||||
|
.sp
|
||||||
|
FILES --
|
||||||
|
.sp
|
||||||
|
SEE ALSO --
|
||||||
|
.sp
|
||||||
DIAGNOSTICS "twofiles" - please provide two filenames
|
DIAGNOSTICS "twofiles" - please provide two filenames
|
||||||
"? file" - either unable to remove or create a file
|
"? file" - either unable to remove or create
|
||||||
|
a file
|
||||||
|
.sp
|
||||||
BUGS The second diagnostic is ambiguous.
|
BUGS The second diagnostic is ambiguous.
|
||||||
|
.sp
|
||||||
OWNER wkt
|
OWNER wkt
|
||||||
|
|||||||
+38
-30
@@ -1,50 +1,58 @@
|
|||||||
11/3/70 STAT (I)
|
.oh '11/3/70''STAT(I)'
|
||||||
|
.ta 18 21
|
||||||
|
|
||||||
NAME stat - get file status
|
NAME stat - get file status
|
||||||
|
.sp
|
||||||
SYNOPSIS stat name
|
SYNOPSIS
|
||||||
|
.ul
|
||||||
DESCRIPTION stat gives several kinds of information about one file:
|
stat
|
||||||
files:
|
name
|
||||||
|
.sp
|
||||||
|
DESCRIPTION stat gives several kinds of information about
|
||||||
|
one file:
|
||||||
|
.sp
|
||||||
access mode
|
access mode
|
||||||
number of links
|
number of links
|
||||||
owner
|
owner
|
||||||
size in words
|
size in words
|
||||||
name
|
name
|
||||||
|
.sp
|
||||||
All information is self-explanatory except the mode. The
|
All information is self-explanatory except the
|
||||||
mode is a five-character string whose characters mean the
|
mode. The mode is a five-character string whose
|
||||||
following:
|
characters mean the following:
|
||||||
|
.sp
|
||||||
1 s: file is small (smaller than 4096 words)
|
1 s: file is small (smaller than 4096 words)
|
||||||
l: file is large
|
l: file is large
|
||||||
d: file is a directory
|
d: file is a directory
|
||||||
|
.sp
|
||||||
2 r: owner can read
|
2 r: owner can read
|
||||||
-: owner cannot read
|
-: owner cannot read
|
||||||
|
.sp
|
||||||
3 w: owner can write
|
3 w: owner can write
|
||||||
-: owner cannot write
|
-: owner cannot write
|
||||||
|
.sp
|
||||||
4 r: non-owner can read
|
4 r: non-owner can read
|
||||||
-: non-owner cannot read
|
-: non-owner cannot read
|
||||||
|
.sp
|
||||||
5 w: non-owner can write
|
5 w: non-owner can write
|
||||||
-: non-owner cannot write
|
-: non-owner cannot write
|
||||||
|
.sp
|
||||||
All numeric values are printed in octal
|
All numeric values are printed in octal.
|
||||||
if he cannot be found in "/etc/uids" a number is given.
|
.sp
|
||||||
|
|
||||||
|
|
||||||
FILES
|
FILES
|
||||||
|
.sp
|
||||||
SEE ALSO ls with the -l option gives the same information as stat,
|
SEE ALSO
|
||||||
except that it also shows the i-node number for each file.
|
.ul
|
||||||
|
ls
|
||||||
DIAGNOSTICS "name ?" for any error. "nofiles" if no file name is given.
|
with the -l option gives the same information
|
||||||
|
as
|
||||||
|
.ul
|
||||||
|
stat,
|
||||||
|
except that it also shows the i-node
|
||||||
|
number for each file.
|
||||||
|
.sp
|
||||||
|
DIAGNOSTICS "name ?" for any error.
|
||||||
|
"nofiles" if no file name is given.
|
||||||
|
.sp
|
||||||
BUGS none
|
BUGS none
|
||||||
|
.sp
|
||||||
OWNER wkt
|
OWNER wkt
|
||||||
|
|||||||
@@ -43,6 +43,7 @@ int o_ll = 65, o_ad = 1, o_po = 0, o_ls = 1, o_ig = 0, o_fi = 1;
|
|||||||
int o_pl = 66, o_ro = 0, o_hx = 0, o_sp = 0, o_sk = 0;
|
int o_pl = 66, o_ro = 0, o_hx = 0, o_sp = 0, o_sk = 0;
|
||||||
int o_ce = 0, o_ul = 0;
|
int o_ce = 0, o_ul = 0;
|
||||||
int o_li = 0, o_bp = -1, o_hy = 1;
|
int o_li = 0, o_bp = -1, o_hy = 1;
|
||||||
|
int o_m2 = 1;
|
||||||
int o_nn = 0; /* #LINES TO SUPPRESS NUMBERING */
|
int o_nn = 0; /* #LINES TO SUPPRESS NUMBERING */
|
||||||
int o_ti = -1; /* TEMPORARY INDENT */
|
int o_ti = -1; /* TEMPORARY INDENT */
|
||||||
int page_no = -1;
|
int page_no = -1;
|
||||||
@@ -779,6 +780,7 @@ void beginpage()
|
|||||||
{
|
{
|
||||||
int i;
|
int i;
|
||||||
writetitle(page_no & 1 ? ohead : ehead);
|
writetitle(page_no & 1 ? ohead : ehead);
|
||||||
|
for (i = 0; i < o_m2; i++) spit('\n');
|
||||||
line_no = 0;
|
line_no = 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user