1 03/12/84  archive, ac
  2 
  3 Syntax:  ac operation archive_path paths
  4 
  5 
  6 Function:  combines an arbitrary number of separate segments into one
  7 single segment.
  8 
  9 
 10 Arguments:
 11 operation
 12    is one of the functions listed below under "List of operations."
 13 archive_path
 14    is the pathname of the archive segment to be created or used.  The
 15    archive suffix is added if you do not supply it.  The star
 16    convention can be used with extraction and table of contents
 17    operations.
 18 paths
 19    are the components to be operated on by table of contents and delete
 20    operations.  The star and equal conventions cannot be used.
 21 
 22 
 23 List of table of contents operations:
 24 t
 25    prints the entire table of contents if no components are named by
 26    the path arguments; otherwise prints information about the named
 27    components only.  Title and column headings are printed at the top.
 28 tl
 29    prints the table of contents in long form; operates like t, printing
 30    more information for each component.
 31 tb
 32    prints the table of contents, briefly; operates like t, except that
 33    the title and column headings are suppressed.
 34 tlb
 35    operates like tl, but suppresses the column headings and the time
 36    portion of dates.
 37 
 38 
 39 List of append operations:
 40 a
 41    appends named components to the archive segment.  If a named
 42    component is already in the archive, a diagnostic is issued and
 43    the component is not replaced.  At least one component must be
 44    named by the path arguments.
 45 ad
 46    appends and deletes; operates like a and then deletes all segments
 47    that have been appended to the archive.
 48 adf
 49    appends and forces deletion; operates like a and then forces
 50    deletion of all segments that have been appended to the archive.
 51 
 52 
 53 ca
 54    copies and appends; operates like a, appending components to a copy
 55    of the new archive segment created in your working directory.
 56 cad
 57    copies, appends, and deletes; operates like ad, appending components
 58    to a copy of the archive segment and deleting the appended segments.
 59 cadf
 60    copies, appends, and forces deletion; operates like adf, appending
 61    components to a copy of the archive segment and forcibly deleting
 62    the segments requested for appending.
 63 
 64 
 65 List of replace operations:
 66 r
 67    replaces components in or adds components to the archive segment.
 68    When no components are named in the command line, all components of
 69    the archive for which segments by the same name are found in your
 70    working directory are replaced.  When a component is named, it is
 71    either replaced or added.
 72 rd
 73    replaces and deletes; operates like r, replacing or adding
 74    components, then deletes all segments that have been replaced or
 75    added.
 76 rdf
 77    replaces and forces deletion; operates like r and forces deletion of
 78    all replaced or added segments.
 79 
 80 
 81 cr
 82    copies and replaces; operates like r, placing an updated copy of the
 83    archive segment in your working directory instead of changing the
 84    original archive segment.
 85 crd
 86    copies, replaces and deletes; operates like rd, placing an updated
 87    copy of the archive segment in your working directory.
 88 crdf
 89    copies, replaces, and forces deletion; operates like rdf, placing an
 90    updated copy of the archive segment in your working directory.
 91 
 92 
 93 List of update operations:
 94 u
 95    updates; operates like r except that it replaces only those
 96    components for which the corresponding segment has a
 97    date-time-modified later than that associated with the component in
 98    the archive.
 99 ud
100    updates and deletes; operates like u and deletes all updated
101    segments after the archive has been updated.
102 udf
103    updates and forces deletion; operates like u and forces deletion of
104    all updated segments.
105 cu
106    copies and updates; operates like u, placing an updated copy of the
107    archive segment in your working directory.
108 
109 
110 cud
111    copies, update, and deletes; operates like ud, placing an updated
112    copy of the archive segment in your working directory.
113 cudf
114    copies, updates, and forces deletion; operates like udf, placing an
115    updated copy of the archive segment in your working directory.
116 
117 
118 List of delete operations:
119 d
120    deletes from the archive those components named by the path
121    arguments.
122 cd
123    copies and deletes; operates like d, placing an updated copy of the
124    archive segment in the working directory.
125 
126 
127 List of extract operations:
128 x
129    extracts from the archive those components named by the path
130    arguments, placing them in segments in the storage system.  The
131    directory where a segment is placed is the directory portion of the
132    path argument.  The access mode stored with the archive component is
133    placed on the segment for you.  If no component names are given, all
134    components are extracted and placed in segments in the working
135    directory.  The archive segment is not modified.
136 xd
137    operates like x but deletes the component from the archive if it
138    is extracted successfully.
139 
140 
141 xf
142    extracts and forces deletion; operates like x, forcing deletion of
143    any duplicate names or segments found where the new segment is to be
144    created.
145 xdf
146    operates like xd, forcing deletion of any duplicate names or
147    segments found where the new segment is to be created.
148 
149 
150 Notes: The table of contents and extract operations use the existing
151 contents of an archive segment; the other operations change the
152 contents of an archive segment.  A new archive segment can be created
153 with either the append or replace operation.  In each of the
154 operations that add to or replace components of the archive, the
155 original segment is copied and the copy is written into the archive,
156 leaving the original segment untouched unless deletion is specified as
157 part of the operation.
158 
159 The star convention can be used in the archive segment pathname during
160 extract and table of contents operations; it cannot be used during
161 append, replace, update, and delete operations.
162 
163 
164 Each component of an archive segment retains certain attributes of
165 the segment from which it was copied.  These consist of one name, the
166 effective mode of the user who placed the component in the archive,
167 the date-time last modified, the bit count, and the date-time placed
168 in the archive.