summaryrefslogtreecommitdiff
path: root/archivers/pax/files/cpio.cat1
blob: 4300cf5f04ad5bf8ff2a5217a6d562ac87fe730a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
CPIO(1)                 NetBSD General Commands Manual                 CPIO(1)

NNAAMMEE
     ccppiioo - copy file archives in and out

SSYYNNOOPPSSIISS
     ccppiioo --oo [--aaAABBccLLvvzzZZ] [--CC _b_y_t_e_s] [--FF _a_r_c_h_i_v_e] [--HH _f_o_r_m_a_t] [--OO _a_r_c_h_i_v_e] _<
          _n_a_m_e_-_l_i_s_t [_> _a_r_c_h_i_v_e]
     ccppiioo --ii [--bbBBccddffmmrrssSSttuuvvzzZZ66] [--CC _b_y_t_e_s] [--EE _f_i_l_e] [--FF _a_r_c_h_i_v_e] [--HH _f_o_r_m_a_t]
          [--II _a_r_c_h_i_v_e] [_p_a_t_t_e_r_n _._._.] [_< _a_r_c_h_i_v_e]
     ccppiioo --pp [--aaddllLLmmuuvv] _d_e_s_t_i_n_a_t_i_o_n_-_d_i_r_e_c_t_o_r_y _< _n_a_m_e_-_l_i_s_t

DDEESSCCRRIIPPTTIIOONN
     The ccppiioo command copies files to and from a ccppiioo archive.  If the archive
     is of the form: _[_[_u_s_e_r_@_]_h_o_s_t_:_]_f_i_l_e then the archive will be processed
     using rmt(8).

     The options are as follows:

     --oo, ----ccrreeaattee
             Create an archive.  Reads the list of files to store in the ar-
             chive from standard input, and writes the archive on standard
             output.

             --aa, ----rreesseett--aacccceessss--ttiimmee
                     Reset the access times on files that have been copied to
                     the archive.

             --AA, ----aappppeenndd
                     Append to the specified archive.

             --BB      Set block size of output to 5120 bytes.

             --cc      Use ASCII format for ccppiioo header for portability.

             --CC _b_y_t_e_s
                     Set the block size of output to _b_y_t_e_s.

             --FF _a_r_c_h_i_v_e

             --OO _a_r_c_h_i_v_e
                     Use the specified file name as the archive to write to.

             --HH _f_o_r_m_a_t
                     Write the archive in the specified format.  Recognized
                     formats are:

                     _b_c_p_i_o    Old binary ccppiioo format.
                     _c_p_i_o     Old octal character ccppiioo format.
                     _s_v_4_c_p_i_o  SVR4 hex ccppiioo format.
                     _t_a_r      Old tar format.
                     _u_s_t_a_r    POSIX ustar format.

             --LL      Follow symbolic links.

             --vv      Be verbose about operations.  List filenames as they are
                     written to the archive.

             --zz      Compress archive using gzip(1) format.

             --ZZ      Compress archive using compress(1) format.

     --ii, ----eexxttrraacctt
             Restore files from an archive.  Reads the archive file from stan-
             dard input and extracts files matching the _p_a_t_t_e_r_n_s that were
             specified on the command line.

             --bb      Do byte and word swapping after reading in data from the
                     archive, for restoring archives created on systems with a
                     different byte order.

             --BB      Set the block size of the archive being read to 5120
                     bytes.

             --cc      Expect the archive headers to be in ASCII format.

             --CC _b_y_t_e_s
                     Read archive written with a block size of _b_y_t_e_s.

             --dd, ----mmaakkee--ddiirreeccttoorriieess
                     Create any intermediate directories as needed during
                     restore.

             --EE _f_i_l_e, ----ppaatttteerrnn--ffiillee _f_i_l_e
                     Read list of file name patterns to extract or list from
                     _f_i_l_e.

             --ff, ----nnoonnmmaatthhiinngg
                     Restore all files except those matching the _p_a_t_t_e_r_n_s
                     given on the command line.

             --FF _a_r_c_h_i_v_e, ----ffiillee _a_r_c_h_i_v_e

             --II _a_r_c_h_i_v_e
                     Use the specified file as the input for the archive.

             --HH _f_o_r_m_a_t, ----ffoorrmmaatt _f_o_r_m_a_t
                     Read an archive of the specified format.  Recognized for-
                     mats are:

                     _b_c_p_i_o    Old binary ccppiioo format.
                     _c_p_i_o     Old octal character ccppiioo format.
                     _s_v_4_c_p_i_o  SVR4 hex ccppiioo format.
                     _t_a_r      Old tar format.
                     _u_s_t_a_r    POSIX ustar format.

             --mm      Restore modification times on files.

             --rr, ----rreennaammee
                     Rename restored files interactively.

             --ss      Swap bytes after reading data from the archive.

             --SS, ----sswwaapp--hhaallffwwoorrddss
                     Swap words after reading data from the archive.

             --tt, ----lliisstt
                     Only list the contents of the archive, no files or direc-
                     tories will be created.

             --uu, ----uunnccoonnddiittiioonnaall
                     Overwrite files even when the file in the archive is
                     older than the one that will be overwritten.

             --vv, ----vveerrbboossee
                     Be verbose about operations.  List filenames as they are
                     copied in from the archive.

             --zz      Uncompress archive using gzip(1) format.

             --ZZ      Uncompress archive using compress(1) format.

             --66      Process old-style ccppiioo format archives.

     --pp, ----ppaassss--tthhrroouugghh
             Copy files from one location to another in a single pass.  The
             list of files to copy are read from standard input and written
             out to a directory relative to the specified _d_i_r_e_c_t_o_r_y argument.

             --aa      Reset the access times on files that have been copied.

             --dd      Create any intermediate directories as needed to write
                     the files at the new location.

             --ll, ----lliinnkk
                     When possible, link files rather than creating an extra
                     copy.

             --LL, ----ddeerreeffeerreennccee
                     Follow symbolic links.

             --mm, ----pprreesseerrvvee--mmooddiiffiiccaattiioonn--ttiimmee
                     Restore modification times on files.

             --uu, ----uunnccoonnddiittiioonnaall
                     Overwrite files even when the original file being copied
                     is older than the one that will be overwritten.

             --vv, ----vveerrbboossee
                     Be verbose about operations.  List filenames as they are
                     copied.

             ----ffoorrccee--llooccaall
                     Do not interpret filenames that contain a `:' as remote
                     files.

             ----iinnsseeccuurree
                     Normally ccppiioo ignores filenames that contain `..' as a
                     path component. With this option, files that contain `..'
                     can be processed.

EERRRROORRSS
     ccppiioo will exit with one of the following values:

     0   All files were processed successfully.

     1   An error occurred.

     Whenever ccppiioo cannot create a file or a link when extracting an archive
     or cannot find a file while writing an archive, or cannot preserve the
     user ID, group ID, file mode, or access and modification times when the
     --pp option is specified, a diagnostic message is written to standard error
     and a non-zero exit value will be returned, but processing will continue.
     In the case where ccppiioo cannot create a link to a file, ccppiioo will not cre-
     ate a second copy of the file.

     If the extraction of a file from an archive is prematurely terminated by
     a signal or error, ccppiioo may have only partially extracted the file the
     user wanted.  Additionally, the file modes of extracted files and direc-
     tories may have incorrect file bits, and the modification and access
     times may be wrong.

     If the creation of an archive is prematurely terminated by a signal or
     error, ccppiioo may have only partially created the archive which may violate
     the specific archive format specification.

SSEEEE AALLSSOO
     pax(1), tar(1)

AAUUTTHHOORRSS
     Keith Muller at the University of California, San Diego.

BBUUGGSS
     The --ss and --SS options are currently not implemented.

NetBSD 1.6                     February 16, 1997                    NetBSD 1.6