/sys/doc/ Documentation archive



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 -