Research V7 development

Work on file usr/man/man1/ac.1m
Work on file usr/man/man1/ar.1
Work on file usr/man/man1/basename.1
Work on file usr/man/man1/at.1

Co-Authored-By: Dennis Ritchie <dmr@research.uucp>
Synthesized-from: v7

diff --git a/usr/man/man1/ac.1m b/usr/man/man1/ac.1m
new file mode 100644 (file)
index 0000000..73bf29a
--- /dev/null
+++ b/usr/man/man1/ac.1m
@@ -0,0 +1,58 @@
+.TH AC 1M 
+.SH NAME
+ac \- login accounting
+.SH SYNOPSIS
+.B ac
+[
+.B \-w
+wtmp ] [
+.B \-p
+] [
+.B \-d
+] [ people ] ...
+.SH DESCRIPTION
+.I Ac
+produces a printout giving
+connect time
+for each user who has logged in
+during the life of the current
+.I wtmp
+file.
+A total is also produced.
+.B \-w
+is used to specify an alternate
+.IR wtmp ""
+file.
+.B \-p
+prints individual totals; without this option,
+only totals are printed.
+.B \-d
+causes a printout for each midnight to midnight
+period.
+Any
+.I people
+will limit the
+printout to only the specified login names.
+If no
+.IR wtmp ""
+file is given,
+.I /usr/adm/wtmp
+is used.
+.PP
+The accounting file
+.I /usr/adm/wtmp
+is maintained by
+.I init
+and
+.I login.
+Neither of these programs creates the file,
+so if it does not exist
+no connect-time accounting is done.
+To start accounting, it should be created with length 0.
+On the other hand if the file is left undisturbed it will
+grow without bound, so periodically any information
+desired should be collected and the file truncated.
+.SH FILES
+/usr/adm/wtmp
+.SH "SEE ALSO"
+init(8), login(1), utmp(5).

diff --git a/usr/man/man1/ar.1 b/usr/man/man1/ar.1
new file mode 100644 (file)
index 0000000..fd1426f
--- /dev/null
+++ b/usr/man/man1/ar.1
@@ -0,0 +1,131 @@
+.TH AR 1 
+.SH NAME
+ar \- archive and library maintainer
+.SH SYNOPSIS
+.B ar
+key [ posname ] afile name ...
+.SH DESCRIPTION
+.I Ar
+maintains groups of files
+combined into a single archive file.
+Its main use
+is to create and update library files as used by the loader.
+It can be used, though, for any similar purpose.
+.PP
+.I Key
+is one character from the set
+.B drqtpmx,
+optionally concatenated with
+one or more of
+.B vuaibcl.
+.I Afile
+is the archive file.
+The
+.I names
+are constituent files in the archive file.
+The meanings of the
+.I key
+characters are:
+.TP
+.B d
+Delete the named files from the archive file.
+.TP
+.B r
+Replace the named files in the archive file.
+If the optional character
+.B u
+is used with
+.B r,
+then only those files with
+modified dates later than
+the archive files are replaced.
+If an optional positioning character from the set
+.B abi
+is used, then the
+.I posname
+argument must be present
+and specifies that new files are to be placed
+after
+.RB ( a )
+or before
+.RB ( b
+or
+.BR i )
+.IR posname .
+Otherwise
+new files are placed at the end.
+.TP
+.B q
+Quickly append the named files to the end of the archive file.
+Optional positioning characters are invalid.
+The command does not check whether the added members
+are already in the archive.
+Useful only to avoid quadratic behavior when creating a large
+archive piece-by-piece.
+.TP
+.B t
+Print a table of contents of the archive file.
+If no names are given, all files in the archive are tabled.
+If names are given, only those files are tabled.
+.TP
+.B p
+Print the named files in the archive.
+.TP
+.B m
+Move the named files to the end of the archive.
+If a positioning character is present,
+then the
+.I posname
+argument must be present and,
+as in
+.B r,
+specifies where the files are to be moved.
+.TP
+.B x
+Extract the named files.
+If no names are given, all files in the archive are
+extracted.
+In neither case does
+.B x
+alter the archive file.
+.TP
+.B v
+Verbose.
+Under the verbose option,
+.I ar
+gives a file-by-file
+description of the making of a
+new archive file from the old archive and the constituent files.
+When used with
+.B t,
+it gives a long listing of all information about the files.
+When used with
+.BR p ,
+it precedes each file with a name.
+.TP
+.B c
+Create.
+Normally
+.I ar
+will create
+.I afile
+when it needs to.
+The create option suppresses the
+normal message that is produced when
+.I afile
+is created.
+.TP
+.B l
+Local.
+Normally
+.I ar
+places its temporary files in the directory /tmp.
+This option causes them to be placed in the local directory.
+.SH FILES
+/tmp/v*        temporaries
+.SH "SEE ALSO"
+ld(1), ar(5),
+lorder(1)
+.SH BUGS
+If the same file is mentioned twice in an argument list,
+it may be put in the archive twice.

diff --git a/usr/man/man1/at.1 b/usr/man/man1/at.1
new file mode 100644 (file)
index 0000000..229068a
--- /dev/null
+++ b/usr/man/man1/at.1
@@ -0,0 +1,96 @@
+.TH AT 1 
+.SH NAME
+at \- execute commands at a later time
+.SH SYNOPSIS
+.B at
+time
+[
+day
+]
+[
+file
+]
+.SH DESCRIPTION
+.I At
+squirrels away a copy of the named
+.I file
+(standard input default)
+to be used as input to
+.IR sh (1)
+at a specified later time.
+A
+.IR cd (1)
+command to the current directory is inserted
+at the beginning,
+followed by assignments to all environment variables.
+When the script is run, it uses the user and group ID
+of the creator of the copy file.
+.PP
+The
+.I time
+is 1 to 4 digits, with an optional following
+`A', `P', `N' or `M' for
+AM, PM, noon or midnight.
+One and two digit numbers are taken to be hours, three and four digits
+to be hours and minutes.
+If no letters follow the digits, a 24 hour clock time is understood.
+.PP
+The optional
+.I day
+is either
+(1) a month name followed by a day number,
+or
+(2) a day of the week; if the word `week' follows
+invocation is moved seven days further off.
+Names of months and days may be recognizably truncated.
+Examples of legitimate commands are
+.IP
+at 8am jan 24
+.br
+at 1530 fr week
+.PP
+.I At
+programs are executed by periodic execution
+of the command
+.I /usr/lib/atrun
+from
+.IR cron (8).
+The granularity of
+.I at
+depends upon how often
+.I atrun
+is executed.
+.PP
+Standard output or error output is lost unless redirected.
+.SH FILES
+/usr/spool/at/yy.ddd.hhhh.uu
+.br
+activity to be performed at hour
+.I hhhh
+of year day
+.I ddd
+of year
+.IR yy .
+.I uu
+is a unique number.
+.br
+/usr/spool/at/lasttimedone contains
+.I hhhh
+for last hour of activity.
+.br
+/usr/spool/at/past directory of activities now in progress
+.br
+/usr/lib/atrun program that executes activities that
+are due
+.br
+pwd(1)
+.SH "SEE ALSO"
+calendar(1),
+cron(8)
+.SH DIAGNOSTICS
+Complains about various syntax errors and times out of range.
+.SH BUGS
+Due to the granularity of the execution of
+.I /usr/lib/atrun,
+there may be bugs in scheduling things almost
+exactly 24 hours into the future.

diff --git a/usr/man/man1/basename.1 b/usr/man/man1/basename.1
new file mode 100644 (file)
index 0000000..661f3c9
--- /dev/null
+++ b/usr/man/man1/basename.1
@@ -0,0 +1,29 @@
+.TH BASENAME 1 
+.SH NAME
+basename \- strip filename affixes
+.SH SYNOPSIS
+.B basename
+string [ suffix ]
+.SH DESCRIPTION
+.I Basename
+deletes any prefix ending in `/' and the
+.I suffix,
+if present in
+.I string,
+from
+.I string,
+and prints the result on the standard output.
+It is normally used inside substitution marks \`\ \`
+in shell procedures.
+.PP
+This shell procedure invoked with the argument
+.I /usr/src/cmd/cat.c
+compiles the named file and moves the output to
+.I cat
+in the current directory:
+.IP "" 15n
+cc $1
+.br
+mv a.out \`basename $1 .c\`
+.SH "SEE ALSO"
+sh(1)