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

     concatenated  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 will create 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  will  be

     replaced by the modified version.



     x will extract 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)



BUGS

     Option tv  should  be  implemented  as  a  table  with  more

     information.



     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.