11/3/71 AR (I)
NAME ar -- archive
SYNOPSIS ar key afile name ...
1
DESCRIPTION ar maintains groups of files combined into a sin-
gle 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.
key is one character from the set drtux, option-
ally concatenated with v. afile is the archive
file. The names are constituent files in the ar-
chive file. The meanings of the key characters
are:
d means delete the named files from the archive
file.
r means replace the named files in the archive
file. If the archive file does not exist, r will
create it. If the named files are not in the ar-
chive file, they are appended.
t prints 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.
u is similar to r except that only those files
that have been modified are replaced. If no
names are given, all files in the archive that
have been modified will be replaced by the modi-
fied version.
x will extract the named files. If no names are
given, all files in the archive are extracted.
In neither case does x alter the archive file.
v means verbose. Under the verbose option, ar
gives a file-by-file description of the making of
a new archive file from the old archive and the
constituent files. The following abbreviations
are used:
c copy
a append
d delete
r replace
x extract
FILES /tmp/vtma, vtmb ... temporary
SEE ALSO ld
DIAGNOSTICS "Bad usage", "afile -- not in archive format",
"cannot open temp file", "name -- cannot open",
"name -- phase error", "name -- cannot create",
"no archive file", "cannot create archive file",
"name -- not found".
BUGS Option l (table with more information) should be
implemented.
There should be a way to specify the placement of
a new file in an archive. Currently, it is
placed at the end.
OWNER ken, dmr