Return to ar.1 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v4 / man1

Annotation of researchv10dc/dist/man/v4/man1/ar.1, revision 1.1.1.1

1.1       root        1: .th AR I 3/15/72
                      2: .sh NAME
                      3: ar \*- archive and library maintainer
                      4: .sh SYNOPSIS
                      5: .bd ar
                      6: key afile name ...
                      7: .sh DESCRIPTION
                      8: .it Ar
                      9: maintains groups of files
                     10: combined into a single archive file.
                     11: Its main use
                     12: is to create and update library files as used by the loader.
                     13: It can be used, though, for any similar purpose.
                     14: .s3
                     15: .it Key
                     16: is one character from the set
                     17: .bd drtux,
                     18: optionally concatenated with
                     19: .bd v.
                     20: .it Afile
                     21: is the archive file.
                     22: The
                     23: .it names
                     24: are constituent files in the archive file.
                     25: The meanings of the
                     26: .it key
                     27: characters are:
                     28: .s3
                     29: .bd d
                     30: means delete the named files from the archive file.
                     31: .s3
                     32: .bd r
                     33: means replace the named files in the archive file.
                     34: If the archive file does not exist,
                     35: .bd r
                     36: will create it.
                     37: If the named files are not in the archive file, they are appended.
                     38: .s3
                     39: .bd t
                     40: prints a table of contents of the archive file.
                     41: If no names are given, all files in the archive are tabled.
                     42: If names are given, only those files are tabled.
                     43: .s3
                     44: .bd u
                     45: is similar to
                     46: .bd r
                     47: except that only those
                     48: files that have been modified are replaced.
                     49: If no names are given, all files in the archive that
                     50: have been modified will be replaced by the modified version.
                     51: .s3
                     52: .bd x
                     53: will extract the named files.
                     54: If no names are given, all files in the archive are
                     55: extracted.
                     56: In neither case does
                     57: .bd x
                     58: alter the archive file.
                     59: .s3
                     60: .bd v
                     61: means verbose.
                     62: Under the verbose option,
                     63: .it ar
                     64: gives a file-by-file
                     65: description of the making of a
                     66: new archive file from the old archive and the constituent files.
                     67: The following abbreviations
                     68: are used:
                     69: .s3
                     70: .bd "   c"
                     71: copy
                     72: .bd "   a"
                     73: append
                     74: .bd "   d"
                     75: delete
                     76: .bd "   r"
                     77: replace
                     78: .bd "   x"
                     79: extract
                     80: .sh FILES
                     81: /tmp/vtm?      temporary
                     82: .sh "SEE ALSO"
                     83: ld(I), archive(V)
                     84: .sh BUGS
                     85: Option
                     86: .bd tv
                     87: should be implemented as a table with more information.
                     88: .s3
                     89: There should be a way to specify the placement
                     90: of a new file in an archive.
                     91: Currently, it is placed at the end.
                     92: .s3
                     93: Since
                     94: .it ar
                     95: has not been rewritten to
                     96: deal properly with the new file system
                     97: modes,
                     98: extracted files have mode 666.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.