arch.1 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
  1. .\" $Header$
  2. .TH ARCH 1
  3. .SH NAME
  4. arch \- archive and library maintainer
  5. .SH SYNOPSIS
  6. .B arch
  7. key [ posname ] afile name ...
  8. .SH DESCRIPTION
  9. .I Arch
  10. maintains groups of files
  11. combined into a single archive file.
  12. Its main use
  13. is to create and update library files as used by a linker.
  14. It can be used, though, for any similar purpose.
  15. The Amsterdam compiler kit provides its own archiver with a
  16. fixed, machine-independent format, much like the UNIX-V7
  17. archive format.
  18. EM programs using libraries assume archives in EM format.
  19. .PP
  20. .I Key
  21. is one character from the set
  22. .B drqtpmx,
  23. optionally concatenated with
  24. one or more of
  25. .B vuaibcl.
  26. .I Afile
  27. is the archive file.
  28. The
  29. .I names
  30. are constituent files in the archive file.
  31. The meanings of the
  32. .I key
  33. characters are:
  34. .TP
  35. .B d
  36. Delete the named files from the archive file.
  37. .TP
  38. .B r
  39. Replace the named files in the archive file.
  40. If the optional character
  41. .B u
  42. is used with
  43. .B r,
  44. then only those files with
  45. modified dates later than
  46. the archive files are replaced.
  47. If an optional positioning character from the set
  48. .B abi
  49. is used, then the
  50. .I posname
  51. argument must be present
  52. and specifies that new files are to be placed
  53. after
  54. .RB ( a )
  55. or before
  56. .RB ( b
  57. or
  58. .BR i )
  59. .IR posname .
  60. Otherwise
  61. new files are placed at the end.
  62. .TP
  63. .B q
  64. Quickly append the named files to the end of the archive file.
  65. Optional positioning characters are invalid.
  66. The command does not check whether the added members
  67. are already in the archive.
  68. Useful only to avoid quadratic behavior when creating a large
  69. archive piece-by-piece.
  70. .TP
  71. .B t
  72. Print a table of contents of the archive file.
  73. If no names are given, all files in the archive are tabled.
  74. If names are given, only those files are tabled.
  75. .TP
  76. .B p
  77. Print the named files in the archive.
  78. .TP
  79. .B m
  80. Move the named files to the end of the archive.
  81. If a positioning character is present,
  82. then the
  83. .I posname
  84. argument must be present and,
  85. as in
  86. .B r,
  87. specifies where the files are to be moved.
  88. .TP
  89. .B x
  90. Extract the named files.
  91. If no names are given, all files in the archive are
  92. extracted.
  93. In neither case does
  94. .B x
  95. alter the archive file.
  96. .TP
  97. .B v
  98. Verbose.
  99. Under the verbose option,
  100. .I arch
  101. gives a file-by-file
  102. description of the making of a
  103. new archive file from the old archive and the constituent files.
  104. When used with
  105. .B t,
  106. it gives a long listing of all information about the files.
  107. When used with
  108. .BR p ,
  109. it precedes each file with a name.
  110. .TP
  111. .B c
  112. Create.
  113. Normally
  114. .I arch
  115. will create
  116. .I afile
  117. when it needs to.
  118. The create option suppresses the
  119. normal message that is produced when
  120. .I afile
  121. is created.
  122. .TP
  123. .B l
  124. Local.
  125. Normally
  126. .I arch
  127. places its temporary files in the directory /tmp.
  128. This option causes them to be placed in the local directory.
  129. .SH FILES
  130. /tmp/v* temporaries
  131. .SH "SEE ALSO"
  132. em_ass(I), arch(V),
  133. .SH BUGS
  134. If the same file is mentioned twice in an argument list,
  135. it may be put in the archive twice.