11/3/71                                                    AR (I)





NAME            ar -- archive



SYNOPSIS        ar key afile name  ...
                                 1


DESCRIPTION     ar maintains groups of files combined into a sin-

                gle 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, option-

                ally concatenated with v.  afile is the archive

                file.  The names are constituent files in the ar-

                chive 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 ar-

                chive 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 modi-

                fied 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/vtma, vtmb ...      temporary



SEE ALSO        ld



DIAGNOSTICS     "Bad usage", "afile -- not in archive format",

                "cannot open temp file", "name -- cannot open",

                "name -- phase error", "name -- cannot create",

                "no archive file", "cannot create archive file",

                "name -- not found".



BUGS            Option l (table with more information) should be

                implemented.



                There should be a way to specify the placement of

                a new file in an archive.  Currently, it is

                placed at the end.



OWNER           ken, dmr