projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| a0e1f54c KT |
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\b\b__ key afile name\e91\e8 ... | |
| 8 | .sp | |
| 9 | .ti 0 | |
| 10 | DESCRIPTION ar\b\b__ | |
| 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\b\b\b___ is one character from the set drtux\b\b\b\b\b_____, | |
| 18 | optionally concatenated with v\b_. | |
| 19 | afile\b\b\b\b\b_____ is the archive file. | |
| 20 | The names\b\b\b\b\b_____ are constituent files in the archive file. | |
| 21 | The meanings of the key\b\b\b___ characters are: | |
| 22 | .sp | |
| 23 | d\b_ means delete the named files from the archive file. | |
| 24 | .sp | |
| 25 | r\b_ means replace the named files in the archive file. | |
| 26 | If the archive file does not exist, r\b_ will create it. | |
| 27 | If the named files are not in the archive file, they are appended. | |
| 28 | .sp | |
| 29 | t\b_ 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\b_ is similar to r\b_ 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\b_ 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\b_ alter the archive file. | |
| 42 | .sp | |
| 43 | v\b_ means verbose. | |
| 44 | Under the verbose option, | |
| 45 | ar\b\b__ 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\b_ copy | |
| 52 | a\b_ append | |
| 53 | d\b_ delete | |
| 54 | r\b_ replace | |
| 55 | x\b_ 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\b\b__ 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. |