Return to ar.1 CVS log

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

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

1.1       root        1: .pa 1
                      2: .he 'AR (I)'3/15/72'AR (I)'
                      3: .ti 0
                      4: NAME           ar -- archive
                      5: .sp
                      6: .ti 0
                      7: SYNOPSIS       ar__ key afile name918 ...
                      8: .sp
                      9: .ti 0
                     10: DESCRIPTION    ar__
                     11: maintains groups of files
                     12: combined into a single archive file.
                     13: Its main use
                     14: is to create and update library files as used by the loader.
                     15: It can be used, though, for any similar purpose.
                     16: .sp
                     17: key___ is one character from the set drtux_____,
                     18: optionally concatenated with v_.
                     19: afile_____ is the archive file.
                     20: The names_____ are constituent files in the archive file.
                     21: The meanings of the key___ characters are:
                     22: .sp
                     23: d_ means delete the named files from the archive file.
                     24: .sp
                     25: r_ means replace the named files in the archive file.
                     26: If the archive file does not exist, r_ will create it.
                     27: If the named files are not in the archive file, they are appended.
                     28: .sp
                     29: t_ prints a table of contents of the archive file.
                     30: If no names are given, all files in the archive are tabled.
                     31: If names are given, only those files are tabled.
                     32: .sp
                     33: u_ is similar to r_ except that only those
                     34: files that have been modified are replaced.
                     35: If no names are given, all files in the archive that
                     36: have been modified will be replaced by the modified version.
                     37: .sp
                     38: x_ will extract the named files.
                     39: If no names are given, all files in the archive are
                     40: extracted.
                     41: In neither case does x_ alter the archive file.
                     42: .sp
                     43: v_ means verbose.
                     44: Under the verbose option,
                     45: ar__ gives a file-by-file
                     46: description of the making of a
                     47: new archive file from the old archive and the constituent files.
                     48: The following abbreviations
                     49: are used:
                     50: .sp
                     51:    c_ copy
                     52:    a_ append
                     53:    d_ delete
                     54:    r_ replace
                     55:    x_ extract
                     56: .sp
                     57: .ti 0
                     58: FILES          /tmp/vtm?        temporary
                     59: .sp
                     60: .ti 0
                     61: SEE ALSO       ld(I), archive(V)
                     62: .sp
                     63: .ti 0
                     64: DIAGNOSTICS    "Bad usage",
                     65: "afile -- not in archive format",
                     66: "cannot open temp file",
                     67: "name -- cannot open",
                     68: "name -- phase error",
                     69: "name -- cannot create",
                     70: "no archive file",
                     71: "cannot create archive file",
                     72: "name -- not found".
                     73: .sp
                     74: .ti 0
                     75: BUGS           Option
                     76: vt__ should be implemented as a table with more information.
                     77: .sp
                     78: There should be a way to specify the placement
                     79: of a new file in an archive.
                     80: Currently, it is placed at the end.
                     81: 
                     82: "ar x" changes the modified-date of the current
                     83: directory to a random number.

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