NAME

ar − archive and library maintainer

USAGE

ar key [ posname ] afile name ... 

DESCRIPTION

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, however, be used for any similar purpose. 

This version of ar creates AEGIS LBR libraries that can be used by the loader if named files are object files.  If the files are not object files, then it creates an ASCII format archive that is portable among the various machines running UNIX.  ASCII format archives cannot be used by the loader. 

Key is one character from the drqtpmx set, optionally concatenated with one or more characters from the vuaibclo set.  Afile is the archive file.  The names are constituent files in the archive file. 

KEY CHARACTERS

c Create afile. Suppress the normal message produced when afile is created. 

d Delete the named files from the archive file. 

l Place temporary files in the local directory instead of /tmp. 

m Move the named files to the end of the archive.  If a positioning character is present, then the posname argument must be present to specify where the files are to be moved. 

p Print the named files in the archive. 

q Quickly append the named files in the archive file.  Do not check to see whether the added members are already in the archive.  Optional positioning characters are invalid. 

r Replace the named files in the archive file.  If an optional positioning character from the set abi is used, then 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. When used with a u option, replace only those named files with “last modified" dates later than that of the archive files. 

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 named. 

v Provide a file-by-file description of the making of a new archive file from the old archive and the constituent files.  When used with a t option, provide a long listing of all information about the files.  When used with an x option, precede each named file with the listing. 

x Extract all files in the archive, or only those that are named.  Do not alter the archive file itself.  Normally, the “last modified" date of each extracted file is the date that it was extracted.  If you also specify an o option, however, and you own the extracted file or you are the super-user, the “last modified" date is reset to the date recorded in the archive. 

CAUTIONS

Ar complains and does not allow the introduction of non-object files into LBR libraries. 

If the same file is mentioned in an argument list, it may be put in the archive twice. 

The move and print keys are no-ops for LBR libraries. 

The verbose listing format lists the module’s timestamps rather than the file ownership/time information when listing LBR libraries. 

FILES

/tmp/v*temporaries

RELATED INFORMATION

ld (1), lorder (1), ranlib (1), ar (5), arcv (8). 

DOMAIN System Command Reference (for information on the AEGIS LBR command).