NAME
     ar - archive and library maintainer

SYNOPSIS
     ar key 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 be used, though, for any similar
     purpose.

     Key is one character from the set drtux, optionally concate-
     nated with v.  Afile is the archive file.  The names are
     constituent files in the archive 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 creates it.  If the named
     files are not in the archive 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 are replaced by
     the modified version.

     x extracts 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 follow-
     ing abbreviations are used:

        c copy    a append    d delete    r replace    x extract

FILES
     /tmp/vtm?       temporary

SEE ALSO
     ld (I), archive (V)

BUGS
     Option tv should be implemented as a table with more infor-
     mation.

 1

     There should be a way to specify the placement of a new file
     in an archive.  Currently, it is placed at the end.

     Since ar has not been rewritten to deal properly with the
     new file system modes, extracted files have mode 666.

     For the same reason, only the first 8 characters of file
     names are significant.

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

 2