ar(1)
_________________________________________________________________
ar Command
archive and library maintainer for portable archives
_________________________________________________________________
SYNTAX
ar key [ posname ] afile [name] ...
DESCRIPTION
The ar command maintains groups of files combined into a single
archive file. Its main use is to create and update library files
for the link editor. It can be used, though, for any similar
purpose. The magic string and the file headers used by ar
consist of printable ASCII characters. If an archive is composed
of printable files, the entire archive is printable.
When ar creates an archive, it creates headers in a format that
are portable across all UNIX systems. The portable archive
format and structure is described in detail in ar(4). DG/UX does
not maintain symbol tables with ar.
Key is an optional -, followed by one character from the set
drqtpmx, optionally concatenated with one or more of the
characters vuaibcl. Posname is a filename in the archive that is
used as position when moving files indicates by name. Afile is
the archive file. The names are constituent files in the archive
file.
Key characters are:
d Delete the named files from the archive file.
r Replace the named files in the archive file. If the
optional character u is used with r, then only those files
with modification dates later than the archive files are
replaced. If an optional positioning character from the set
abi is used, then the posname argument must be present and
specifies that new files are to be placed after (a) or
before (b or i) posname. Otherwise, new files are placed at
the end.
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 needless scanning when
creating a large archive piece by piece.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
ar(1)
t Print a table of contents of the archive file. If no names
are given, all files in the archive are printed. If names
are given, only those files are printed.
p Print the contents of the named files in the archive.
m Move the named files to the end of the archive. If an
optional positioning character from the set abi is used,
then the posname argument must be present and specifies that
new files are to be placed after (a) or before (b or i)
posname.
x Extract into the current directory the named files from the
archive. If no names are given, all files in the archive
are extracted. In neither case does x alter the archive
file.
v Give 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, print each
file's name as it is extracted.
c Suppress the message that is produced by default when afile
is created.
l Place temporary files in the local current working
directory, rather than in the directory specified by the
environment variable TMPDIR or in the default directory
/tmp.
FILES
/tmp/ar* temporaries
SEE ALSO
ld(1), lorder(1), strip(1), tmpnam(3S), ar(4).
BUGS
If you use the same file twice in an argument list, it may be put
in the archive twice.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)