AR(1) DOMAIN/IX SYS5 AR(1)
NAME
ar - archive and library maintainer for portable archives
USAGE
ar key [ posname ] afile [ name ] ...
DESCRIPTION
Ar maintains groups of files combined into a single archive
file. Although it is mainly used to create and update
library files needed by the link editor, ar can be used for
other similar purposes. The file headers used by ar are
printable ASCII characters. If an archive comprises print-
able files, the entire archive is printable.
When ar creates an archive, it produces headers in a format
portable across all machines. The portable archive format
and structure is described in detail in ar(4). The link
editor uses the archive symbol table to effect multiple
passes over libraries of object files in an efficient
manner. The link editor is further described under ld(1).
Ar creates and maintains an archive symbol table only when
there is at least one object file in the archive. The
archive symbol table is in a specially named file that is
always the first file in the archive. This file is never
mentioned or accessible to the user. Whenever ar creates or
updates the contents of such an archive, it also rebuilds
the symbol table.
Key is an optional dash (-), followed by one character from
the drqtpmx set, optionally concatenated with one or more
characters from the vuaibcls set. Posname is the name of an
optional positioning character. Afile is the archive file.
KEY CHARACTERS
c Suppress the message produced by default when
afile is created.
d Delete named files from the archive file.
l Place temporary files in the local current working
directory, not in the directory specified by the
environment variable TMPDIR or in the default
directory called /tmp.
m Move named files to the end of the archive. If a
positioning character is present, the posname
argument must be present to specify where the
files should be moved.
Printed 12/4/86 AR-1
AR(1) DOMAIN/IX SYS5 AR(1)
p Print named files in the archive.
q Quickly append named files to the end of the
archive file, without checking to see whether
added members already exist in the archive.
Optional positioning characters are invalid. This
option is useful only during piece-by-piece crea-
tion of a large archive.
r Replace named files in the archive file. If the
optional character u is also used, replace only
those files with modification dates later than the
archive files. If an optional positioning charac-
ter from the set abi is used, the posname argument
must be present to specify that new files are to
be placed after (a) or before (b or i) posname.
Otherwise, new files are placed at the end.
s Force the regeneration of the archive symbol
table, even if ar is not invoked with a command
that modifies the archive contents. This option is
useful after the strip(1) command has been exe-
cuted on the archive.
t Print a table of contents of the archive file. If
no names are given, table all files in the
archive. If names are given, table only those
files.
v Provide a verbose file-by-file description of the
making of a new archive file from the old archive
and the constituent files. When used with t, give
a long listing of all information about the files.
When used with x, precede each file with a name.
x Extract the named files. If no names are given,
extract all files in the archive. In neither case
does x alter the archive file.
u Update archive element if file is newer.
o Restore original file times when extracting from
the archive (this is ignored when used with Apollo
load libraries).
CAUTIONS
If the same file is mentioned twice in an argument list, it
may be put into the archive twice.
AR-2 Printed 12/4/86
AR(1) DOMAIN/IX SYS5 AR(1)
FILES
/tmp/ar* temporaries
RELATED INFORMATION
arcv(1), ld(1), lorder(1), strip(1), tmpnam(3S), ar(4).
Printed 12/4/86 AR-3