home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man1 / ar.1 next >
Encoding:
Text File  |  1975-06-26  |  2.1 KB  |  105 lines
  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. creates 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 are replaced by the modified version.
  51. .s3
  52. .bd x
  53. extracts 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.
  99. .s3
  100. For the same reason,
  101. only the first 8 characters of file names are significant.
  102. .s3
  103. If the same file is mentioned twice in an argument list,
  104. it may be put in the archive twice.
  105.