Bell 32V development
authorTom London <tbl@research.uucp>
Mon, 6 Nov 1978 03:57:20 +0000 (22:57 -0500)
committerTom London <tbl@research.uucp>
Mon, 6 Nov 1978 03:57:20 +0000 (22:57 -0500)
Work on file usr/man/man5/core.5
Work on file usr/man/man5/dir.5
Work on file usr/man/man5/acct.5
Work on file usr/man/man5/dump.5
Work on file usr/man/man5/ar.5
Work on file usr/man/man5/passwd.5
Work on file usr/man/man5/environ.5
Work on file usr/man/man5/tp.5
Work on file usr/man/man5/plot.5
Work on file usr/man/man5/utmp.5
Work on file usr/man/man5/types.5
Work on file usr/man/man5/mtab.5
Work on file usr/man/man5/group.5
Work on file usr/man/man5/wtmp.5

Co-Authored-By: John Reiser <jfr@research.uucp>
Synthesized-from: 32v

14 files changed:
usr/man/man5/acct.5 [new file with mode: 0644]
usr/man/man5/ar.5 [new file with mode: 0644]
usr/man/man5/core.5 [new file with mode: 0644]
usr/man/man5/dir.5 [new file with mode: 0644]
usr/man/man5/dump.5 [new file with mode: 0644]
usr/man/man5/environ.5 [new file with mode: 0644]
usr/man/man5/group.5 [new file with mode: 0644]
usr/man/man5/mtab.5 [new file with mode: 0644]
usr/man/man5/passwd.5 [new file with mode: 0644]
usr/man/man5/plot.5 [new file with mode: 0644]
usr/man/man5/tp.5 [new file with mode: 0644]
usr/man/man5/types.5 [new file with mode: 0644]
usr/man/man5/utmp.5 [new file with mode: 0644]
usr/man/man5/wtmp.5 [new file with mode: 0644]

diff --git a/usr/man/man5/acct.5 b/usr/man/man5/acct.5
new file mode 100644 (file)
index 0000000..200e8a0
--- /dev/null
@@ -0,0 +1,28 @@
+.TH ACCT 5
+.SH NAME
+acct \- execution accounting file
+.SH SYNOPSIS
+.B #include <sys/acct.h>
+.SH DESCRIPTION
+.IR Acct (2)
+causes entries to be made into an accounting file
+for each process that terminates.
+The accounting file is a sequence of entries whose layout,
+as defined by the include file
+is:
+.PP
+.nf
+.ta \w'typedef 'u +\w'comp_t  'u +\w'ac_comm[10]; 'u
+.so /usr/include/sys/acct.h
+.fi
+.PP
+If the process does an
+.IR exec (2),
+the first 10 characters of the filename appear in
+.I ac_comm.
+The accounting flag contains bits indicating whether
+.IR exec (2)
+was ever accomplished, and whether the
+process ever had super-user privileges.
+.SH SEE ALSO
+acct(2), sa(1)
diff --git a/usr/man/man5/ar.5 b/usr/man/man5/ar.5
new file mode 100644 (file)
index 0000000..bee6b35
--- /dev/null
@@ -0,0 +1,47 @@
+.TH AR 5 
+.SH NAME
+ar \- archive (library) file format
+.SH SYNOPSIS
+.B #include <ar.h>
+.SH DESCRIPTION
+The archive command
+.I ar
+is used to combine several files into
+one.
+Archives are used mainly as libraries to be searched
+by the link-editor
+.I ld.
+.PP
+A file produced by
+.I ar
+has a magic number at the start,
+followed by the constituent files, each preceded by a file header.
+The magic number and header layout as described in the
+include file are:
+.RS
+.PP
+.nf
+.ta \w'#define 'u +\w'ARMAG 'u
+.so /usr/include/ar.h
+.fi
+.RE
+.LP
+The name is a null-terminated string; the date is in the
+form of
+.IR time (2);
+the user ID and group ID are numbers; the mode is a bit pattern
+per
+.IR chmod (2);
+the size is counted in bytes.
+.PP
+Each file begins on a word boundary;
+a null byte is inserted between files if necessary.
+Nevertheless the size given reflects the
+actual size of the file exclusive of padding.
+.PP
+Notice there is no provision for empty areas in an archive
+file.
+.SH "SEE ALSO"
+ar(1), ld(1), nm(1)
+.SH BUGS
+Coding user and group IDs as characters is a botch.
diff --git a/usr/man/man5/core.5 b/usr/man/man5/core.5
new file mode 100644 (file)
index 0000000..e762f75
--- /dev/null
@@ -0,0 +1,22 @@
+.TH CORE 5 
+.SH NAME
+core \- format of memory image file
+.SH DESCRIPTION
+UNIX
+writes out a memory image of a terminated
+process when any of various errors occur.
+See
+.IR signal (2)
+for the list of reasons;
+the most common are memory violations, illegal
+instructions, bus errors, and user-generated
+quit signals.
+The memory image is called `core' and is written in the process's
+working directory (provided it can be; normal
+access controls apply).
+.PP
+In general the debugger
+.IR adb (1)
+is sufficient to deal with core images.
+.SH "SEE ALSO"
+adb(1), signal(2)
diff --git a/usr/man/man5/dir.5 b/usr/man/man5/dir.5
new file mode 100644 (file)
index 0000000..d87bd0e
--- /dev/null
@@ -0,0 +1,38 @@
+.TH DIR 5 
+.SH NAME
+dir \- format of directories
+.SH SYNOPSIS
+.B #include <sys/types.h>
+.br
+.B #include <sys/dir.h>
+.SH DESCRIPTION
+A directory
+behaves exactly like an ordinary file, save that no
+user may write into a directory.
+The fact that a file is a directory is indicated by
+a bit in the flag word of its i-node entry
+see,
+.IR filsys (5).
+The structure of a directory entry as given in the
+include file is:
+.RS
+.ta 8n +10n
+.PP
+.nf
+.so /usr/include/sys/dir.h
+.fi
+.RE
+.PP
+By convention, the first two entries in each directory
+are for `\fB.\fR' and `\fB..\fR'.  The first is an entry for the
+directory itself.  The second is for the parent
+directory.
+The meaning of `\fB..\fR' is modified for the root directory
+of the master file system and for the root directories of removable
+file systems.
+In the first case, there is no parent, and in the second,
+the system does not permit off-device references.
+Therefore in both cases `\fB..\fR' has the
+same meaning as `\fB.\fR'.
+.SH "SEE ALSO"
+filsys(5)
diff --git a/usr/man/man5/dump.5 b/usr/man/man5/dump.5
new file mode 100644 (file)
index 0000000..d3639e7
--- /dev/null
@@ -0,0 +1,176 @@
+.TH DUMP 5 
+.SH NAME
+dump, ddate \- incremental dump format
+.SH SYNOPSIS
+.B #include <sys/types.h>
+.br
+.B #include <sys/ino.h>
+.br
+.B # include <dumprestor.h>
+.SH DESCRIPTION
+Tapes used by
+.I dump
+and
+.IR restor (1)
+contain:
+.nf
+.IP ""
+a header record
+two groups of bit map records
+a group of records describing directories
+a group of records describing files
+.fi
+.PP
+The format of the header record and of the first
+record of each description as given in the
+include file
+.I <dumprestor.h>
+is:
+.PP
+.nf
+.ta .5i \w'#define\ TS_INODE\ 'u
+.so /usr/include/dumprestor.h
+.fi
+.PP
+.I NTREC
+is the number of 512 byte records in a physical
+tape block.
+.I MLEN
+is the number of bits in a bit map word.
+.I MSIZ 
+is the number of bit map words.
+.PP
+The
+.I TS_
+entries are used in the
+.I c_type
+field to indicate what sort of header
+this is.
+The types and their meanings are as follows:
+.TP \w'CHECKSUM\|'u
+TS_TAPE
+Tape volume label
+.PD 0
+.TP
+TS_INODE
+A file or directory follows.
+The
+.I c_dinode
+field is a copy of the disk inode and contains
+bits telling what sort of file this is.
+.TP
+TS_BITS
+A bit map follows.
+This bit map has a one bit
+for each inode that was dumped.
+.TP
+TS_ADDR
+A subrecord of a file description.
+See
+.I c_addr
+below.
+.TP
+TS_END
+End of tape record.
+.TP
+TS_CLRI
+A bit map follows.
+This bit map contains a zero bit for
+all inodes that were empty on the file system when dumped.
+.TP
+MAGIC
+All header records have this number in
+.I c_magic.
+.TP
+CHECKSUM
+Header records checksum to this value.
+.PD
+.PP
+The fields of the header structure are as follows:
+.TP \w'TS_INODE\ 'u
+c_type
+The type of the header.
+.PD 0
+.TP
+c_date
+The date the dump was taken.
+.TP
+c_ddate
+The date the file system was dumped from.
+.TP
+c_volume
+The current volume number of the dump.
+.TP
+c_tapea
+The current number of this (512-byte) record.
+.TP
+c_inumber
+The number of the inode being dumped if this
+is of type
+.I TS_INODE.
+.TP
+c_magic
+This contains the value
+.I MAGIC
+above, truncated as needed.
+.TP
+c_checksum
+This contains whatever value is needed to
+make the record sum to 
+.I CHECKSUM.
+.TP
+c_dinode
+This is a copy of the inode as it appears on the
+file system; see
+.IR filsys (5).
+.TP
+c_count
+The count of characters in
+.I c_addr.
+.TP
+c_addr
+An array of characters describing the blocks of the
+dumped file.
+A character is zero if the block associated with that character was not
+present on the file system, otherwise the character is non-zero.
+If the block was not present on the file system, no block was dumped;
+the block will be restored as a hole in the file.
+If there is not sufficient space in this record to describe
+all of the blocks in a file,
+.I TS_ADDR
+records will be scattered through the file, each one
+picking up where the last left off.
+.PD
+.PP
+Each volume except the last ends with a tapemark (read as an end
+of file).
+The last volume ends with a
+.I TS_END
+record and then the tapemark.
+.PP
+The structure
+.I idates
+describes an entry of the file
+.I /etc/ddate
+where dump history is kept.
+The fields of the structure are:
+.TP \w'TS_INODE\ 'u
+id_name
+The dumped filesystem is
+.RI `/dev/ id_nam'.
+.PD 0
+.TP
+id_incno
+The level number of the dump tape;
+see
+.IR dump (1).
+.TP
+id_ddate
+The date of the incremental dump in system format
+see
+.IR types (5).
+.PD
+.SH FILES
+/etc/ddate
+.SH "SEE ALSO"
+dump(1), dumpdir(1), restor(1), filsys(5), types(5)
diff --git a/usr/man/man5/environ.5 b/usr/man/man5/environ.5
new file mode 100644 (file)
index 0000000..baf7c53
--- /dev/null
@@ -0,0 +1,54 @@
+.TH ENVIRON 5
+.SH NAME
+environ \- user environment
+.SH SYNOPSIS
+.B extern char **environ;
+.SH DESCRIPTION
+An array of strings called the `environment' is
+made available by
+.IR exec (2)
+when a process begins.
+By convention these strings have the form
+`name=value'.
+The following names are used by various commands:
+.TP
+PATH
+The sequence of directory prefixes that
+.I sh, time,
+.IR nice (1),
+etc.,
+apply in searching for a file known by an incomplete path name.
+The prefixes are separated by `:'.
+.IR Login (1)
+sets PATH=:/bin:/usr/bin.
+.TP
+HOME
+A user's login directory, set by
+.IR login (1)
+from the password file
+.IR passwd (5).
+.TP
+TERM
+The kind of terminal for which output is to be prepared.
+This information is used by commands, such as
+.I nroff
+or
+.IR plot (1),
+which may exploit special terminal capabilities.
+See
+.IR term (7)
+for a list of terminal types.
+.PP
+Further names may be placed in the environment by
+the
+.I export
+command and `name=value' arguments in
+.IR sh (1),
+or by 
+.IR exec (2).
+It is unwise to conflict with
+certain Shell variables that are frequently exported by
+`.profile' files:
+MAIL, PS1, PS2, IFS.
+.SH SEE ALSO
+exec(2), sh(1), term(7), login(1)
diff --git a/usr/man/man5/group.5 b/usr/man/man5/group.5
new file mode 100644 (file)
index 0000000..8a05f33
--- /dev/null
@@ -0,0 +1,37 @@
+.TH GROUP 5 
+.SH NAME
+group \- group file
+.SH DESCRIPTION
+.I Group
+contains for each group the
+following information:
+.HP 10
+group name
+.br
+.ns
+.HP 10
+encrypted password
+.br
+.ns
+.HP 10
+numerical group ID
+.br
+.ns
+.HP 10
+a comma separated list of all users allowed in the group
+.PP
+This is an ASCII file.
+The fields are separated
+by colons;
+Each group is separated from the next by a new-line.
+If the password field is null, no password is demanded.
+.PP
+This file resides in directory /etc.
+Because of the encrypted
+passwords, it can and does have general read
+permission and can be used, for example,
+to map numerical group ID's to names.
+.SH FILES
+/etc/group
+.SH "SEE ALSO"
+newgrp(1), crypt(3), passwd(1), passwd(5)
diff --git a/usr/man/man5/mtab.5 b/usr/man/man5/mtab.5
new file mode 100644 (file)
index 0000000..2055d71
--- /dev/null
@@ -0,0 +1,34 @@
+.TH MTAB 5 
+.SH NAME
+mtab \- mounted file system table
+.SH DESCRIPTION
+.I Mtab
+resides in directory
+.I /etc
+and contains a table of devices mounted by the
+.I mount
+command.
+.I Umount
+removes entries.
+.PP
+Each entry is 64 bytes long;
+the first 32 are the null-padded name of the
+place where the special file is mounted;
+the second 32 are the null-padded name of the special
+file.
+The special file has all its directories
+stripped away;
+that is, everything through the last `/' is thrown
+away.
+.PP
+This table is present only so people can look at it.
+It does not matter to
+.I mount
+if there are duplicated entries nor
+to
+.I umount
+if a name cannot be found.
+.SH FILES
+/etc/mtab
+.SH "SEE ALSO"
+mount(1)
diff --git a/usr/man/man5/passwd.5 b/usr/man/man5/passwd.5
new file mode 100644 (file)
index 0000000..c418b2e
--- /dev/null
@@ -0,0 +1,53 @@
+.TH PASSWD 5 
+.SH NAME
+passwd \- password file
+.SH DESCRIPTION
+.I Passwd
+contains for each user the
+following information:
+.HP 10
+name (login name, contains no upper case)
+.br
+.ns
+.HP 10
+encrypted password
+.br
+.ns
+.HP 10
+numerical user ID
+.br
+.ns
+.HP 10
+numerical group ID
+.br
+.ns
+.HP 10
+GCOS job number, box number, optional GCOS user-id
+.br
+.ns
+.HP 10
+initial working directory
+.br
+.ns
+.HP 10
+program to use as Shell
+.PP
+This is an ASCII file.  Each field within each user's entry
+is separated from the next by a colon.
+The GCOS field is used only when communicating with that
+system, and in other installations can contain
+any desired information.
+Each user is separated from the next by a new-line.
+If the password field is null, no password is demanded;
+if the Shell field is null, the Shell itself
+is used.
+.PP
+This file resides in directory /etc.
+Because of the encrypted
+passwords, it can and does have general read
+permission and can be used, for example,
+to map numerical user ID's to names.
+.SH FILES
+/etc/passwd
+.SH "SEE ALSO"
+getpwent(3), login(1), crypt(3), passwd(1), group(5)
diff --git a/usr/man/man5/plot.5 b/usr/man/man5/plot.5
new file mode 100644 (file)
index 0000000..040c536
--- /dev/null
@@ -0,0 +1,118 @@
+.TH PLOT 5 
+.SH NAME
+plot \- graphics interface
+.SH DESCRIPTION
+Files of this format are produced by routines
+described in 
+.IR  plot (3),
+and are interpreted for various devices
+by commands described in
+.IR  plot (1).
+A graphics file is a stream of plotting instructions.
+Each instruction consists of an ASCII letter
+usually followed by bytes of binary information.
+The instructions are executed in order.
+A point is designated by
+four bytes representing
+the
+x and y
+values;
+each value
+is a signed integer.
+The last designated point in an
+.B "l, m, n,"
+or
+.B p
+instruction becomes the `current point'
+for the next instruction.
+.PP
+Each of the following descriptions begins with the name
+of the corresponding routine in
+.IR  plot (3).
+.TP 3
+.B  m
+move: The next four bytes give a new current point.
+.TP 3
+.B  n
+cont: Draw a line from the current point to
+the point given by the next four bytes.
+See
+.IR  plot (1).
+.TP 3
+.B  p
+point: Plot the point given by the next four bytes.
+.TP 3
+.B  l
+line: Draw a line from the point given by the next
+four bytes to the point given by the following four bytes.
+.TP 3
+.B  t
+label: Place the following ASCII string so that its
+first character falls on the current point.
+The string is terminated by a newline.
+.TP 3
+.B  a
+arc:
+The first four bytes give the center, the next four give the
+starting point,
+and the last four give the end point of a circular arc.
+The least significant coordinate of the end point is
+used only to determine the quadrant.
+The arc is drawn counter-clockwise.
+.TP 3
+.B  c
+circle:
+The first four bytes give the center of the circle,
+the next two the radius.
+.TP 3
+.B  e
+erase: Start another frame of output.
+.TP 3
+.B  f
+linemod: Take the following string, up to a newline,
+as the style for drawing further lines.
+The styles are
+`dotted,'
+`solid,' `longdashed,' `shortdashed,' and `dotdashed.'
+Effective only in 
+.I plot 4014
+and
+.I plot ver.
+.TP 3
+.B  s
+space: The next four bytes give
+the lower left corner of the plotting area;
+the following four give the upper right corner.
+The plot will be magnified or reduced to fit
+the device as closely as possible.
+.IP
+Space settings that exactly fill the plotting area
+with unity scaling appear below for
+devices supported by the filters of
+.IR  plot (1).
+The upper limit is just outside the plotting area.
+In every case the plotting area is taken to be square;
+points outside may be displayable on
+devices whose face isn't square.
+.RS
+.TP 10n
+4014
+space(0, 0, 3120, 3120);
+.br
+.ns
+.TP 
+ver
+space(0, 0, 2048, 2048);
+.br
+.ns
+.TP 
+300, 300s
+space(0, 0, 4096, 4096);
+.br
+.ns
+.TP 
+450
+space(0, 0, 4096, 4096);
+.RE
+.SH "SEE ALSO"
+plot(1), plot(3), graph(1)
diff --git a/usr/man/man5/tp.5 b/usr/man/man5/tp.5
new file mode 100644 (file)
index 0000000..0c22ebc
--- /dev/null
@@ -0,0 +1,70 @@
+.TH TP 5 
+.SH NAME
+tp \- DEC/mag tape formats
+.SH DESCRIPTION
+The
+command
+.I tp
+dumps files to and extracts files from
+DECtape and magtape.
+The formats of these tapes are the same except
+that magtapes have larger directories.
+.PP
+Block zero contains a
+copy of a stand-alone bootstrap program.
+See
+.IR bproc (8).
+.PP
+Blocks 1 through 24
+for DECtape (1 through 62 for magtape)
+contain a directory of the tape.
+There are 192 (resp. 496) entries in the directory;
+8 entries per block;
+64 bytes per entry.
+Each entry has the following format:
+.nf
+.IP ""
+struct {
+       char    pathname[32];
+       unsigned short  mode;
+       char    uid;
+       char    gid;
+       char    unused1;
+       char    size[3];
+       long    modtime;
+       unsigned short  tapeaddr;
+       char    unused2[16];
+       unsigned short  checksum;
+};
+.fi
+.PP
+The path name entry is the path name of the
+file when put on the tape.
+If the pathname starts with a zero word,
+the entry is empty.
+It is at most 32 bytes long and ends in a null byte.
+Mode, uid, gid, size and time modified
+are the same as described under i-nodes 
+(see file system
+.IR filsys (5)).
+The tape address is the tape block number of the start of
+the contents of the file.
+Every file
+starts on a block boundary.
+The file occupies (size+511)/512 blocks
+of continuous tape.
+The checksum entry has a value such that
+the sum of the 32 words of the directory entry is zero.
+.PP
+Blocks above 25 (resp. 63) are available for file storage.
+.PP
+A fake entry
+has a size of zero.
+.SH "SEE ALSO"
+filsys(5), tp(1)
+.SH BUGS
+The
+.I pathname, uid, gid,
+and
+.I size
+fields are too small.
diff --git a/usr/man/man5/types.5 b/usr/man/man5/types.5
new file mode 100644 (file)
index 0000000..f0884f3
--- /dev/null
@@ -0,0 +1,30 @@
+.TH TYPES 5
+.SH NAME
+types \- primitive system data types
+.SH SYNOPSIS
+.B #include <sys/types.h>
+.SH DESCRIPTION
+The data types defined in the include file
+are used in UNIX system code;
+some data of these types are accessible to user code:
+.PP
+.nf
+.so /usr/include/sys/types.h
+.fi
+.PP
+The form
+.I daddr_t
+is used for disk addresses except in an
+i-node on disk, see
+.IR filsys (5).
+Times are encoded in seconds since 00:00:00 GMT, January 1, 1970.
+The major and minor parts of a device code
+specify kind and unit number of a device
+and are installation-dependent.
+Offsets are measured in bytes from the beginning of a file.
+The
+.I label_t
+variables are used to save the processor state
+while another process is running.
+.SH SEE ALSO
+filsys(5), time(2), lseek(2), adb(1)
diff --git a/usr/man/man5/utmp.5 b/usr/man/man5/utmp.5
new file mode 100644 (file)
index 0000000..9468a3e
--- /dev/null
@@ -0,0 +1,55 @@
+.TH UTMP 5 
+.SH NAME
+utmp, wtmp \- login records
+.SH SYNOPSIS
+.B #include <utmp.h>
+.SH DESCRIPTION
+The
+.I utmp
+file allows one to discover information about who is currently
+using UNIX.
+The file is a sequence of entries with the following
+structure declared in the include file:
+.RS
+.PP
+.nf
+.so /usr/include/utmp.h
+.fi
+.RE
+.PP
+This structure gives the name of the special file
+associated with the user's terminal, the user's login name,
+and the time of the login in the form of
+.IR time (2).
+.PP
+The
+.I wtmp
+file records all logins and logouts.
+Its format is exactly like
+.I utmp
+except that
+a null user name indicates a logout on the associated
+terminal.
+Furthermore, the terminal name `~' indicates that the
+system was rebooted at the indicated time;
+the adjacent pair of entries with terminal names
+`\^|\^' and `}' indicate the system-maintained time
+just before and just after a
+.I date
+command has changed the system's idea of the time.
+.PP
+.I Wtmp
+is maintained by
+.IR login (1)
+and
+.IR init (8).
+Neither of these programs creates the file,
+so if it is removed record-keeping is turned off.
+It is summarized by
+.IR ac (1).
+.SH FILES
+/etc/utmp
+.br
+/usr/adm/wtmp
+.SH "SEE ALSO"
+login(1), init(8), who(1), ac(1)
diff --git a/usr/man/man5/wtmp.5 b/usr/man/man5/wtmp.5
new file mode 100644 (file)
index 0000000..d53e456
--- /dev/null
@@ -0,0 +1,32 @@
+.TH WTMP 5 
+.SH NAME
+wtmp \- user login history
+.SH DESCRIPTION
+This
+file records all logins and logouts.
+Its format is exactly like
+.IR utmp (5)
+except that
+a null user name indicates a logout on the associated
+typewriter.
+Furthermore, the typewriter name `~' indicates that the
+system was rebooted at the indicated time;
+the adjacent pair of entries with typewriter names
+`|' and `}' indicate the system-maintained time
+just before and just after a
+.I date
+command has changed the system's idea of the time.
+.PP
+.I Wtmp
+is maintained by
+.IR login (1)
+and
+.IR init (8).
+Neither of these programs creates the file,
+so if it is removed record-keeping is turned off.
+It is summarized by
+.IR ac (1).
+.SH FILES
+/usr/adm/wtmp
+.SH "SEE ALSO"
+utmp(5), login(1), init(8), ac(1), who(1)