home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Distributions / ucb / 2bsd.tar.gz / 2bsd.tar / misc / ar.1 < prev    next >
Text File  |  1979-04-21  |  2KB  |  106 lines
  1. .th AR I 7/14/75
  2. .sh NAME
  3. ar \*- archive and library maintainer
  4. .sh SYNOPSIS
  5. .bd ar
  6. key [ posname ] 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 drtpmx,
  18. optionally concatenated with
  19. .bd vuai.
  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 optional character
  35. .bd u
  36. is used with
  37. .bd r,
  38. then only those files with
  39. modified dates later than
  40. the archive files are replaced.
  41. If the optional positioning character
  42. .bd a
  43. (also
  44. .bd i
  45. )
  46. is used, then the
  47. .it posname
  48. argument must be present
  49. and specifies a file in the archive
  50. after (before for
  51. .bd i
  52. )
  53. which new files are placed.
  54. Without
  55. .bd a
  56. or
  57. .bd i,
  58. new files are placed at the end.
  59. .s3
  60. .bd t
  61. prints a table of contents of the archive file.
  62. If no names are given, all files in the archive are tabled.
  63. If names are given, only those files are tabled.
  64. .s3
  65. .bd p
  66. prints the named files in the archive.
  67. .s3
  68. .bd m
  69. moves the named files to the end of the archive.
  70. If the options
  71. .bd i
  72. or
  73. .bd b
  74. are used, then the
  75. .it posname
  76. argument must be present and,
  77. as in
  78. .bd r,
  79. specifies where the files are to be moved
  80. .s3
  81. .bd x
  82. extracts the named files.
  83. If no names are given, all files in the archive are
  84. extracted.
  85. In neither case does
  86. .bd x
  87. alter the archive file.
  88. .s3
  89. .bd v
  90. means verbose.
  91. Under the verbose option,
  92. .it ar
  93. gives a file-by-file
  94. description of the making of a
  95. new archive file from the old archive and the constituent files.
  96. When used with
  97. .bd t,
  98. it gives a long listing of all information about the files.
  99. .sh FILES
  100. /tmp/vtm?    temporary
  101. .sh "SEE ALSO"
  102. ld (I), archive (V)
  103. .sh BUGS
  104. If the same file is mentioned twice in an argument list,
  105. it may be put in the archive twice.
  106.