    AR(I)                        3/15/72                        AR(I)

    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  following
         abbreviations are used:

            c copy
            a append
            d delete
            r replace
            x extract

    FILES
         /tmp/vtm? temporary

    SEE ALSO
         ld(I), archive(V)

                                  - 1 -

    AR(I)                        3/15/72                        AR(I)

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

         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 -