← Back to branch summary

~ubuntu-branches/ubuntu/quantal/libarchive/quantal

« back to all changes in this revision

Viewing changes to cpio/bsdcpio.1

  • Committer: Package Import Robot
  • Author(s): Andres Mejia
  • Date: 2012-02-23 19:29:24 UTC
  • mfrom: (8.1.10 sid)
  • Revision ID: package-import@ubuntu.com-20120223192924-73n4iedok5fwgsyr
Tags: 3.0.3-5
* Detect if locales or locales-all is installed for use with test suite.
* Bump Standards-Version to 3.9.3.

Show diffs side-by-side

added added

removed removed

Lines of Context:
cpio/bsdcpio.1
25
25
.\" $FreeBSD$
26
26
.\"
27
27
.Dd December 21, 2007
28
 
.Dt BSDCPIO 1
 
28
.Dt CPIO 1
29
29
.Os
30
30
.Sh NAME
31
31
.Nm cpio
59
59
.Bl -tag -compact -width indent
60
60
.It Fl i
61
61
Input.
62
 
Read an archive from standard input (unless overriden) and extract the
 
62
Read an archive from standard input (unless overridden) and extract the
63
63
contents to disk or (if the
64
64
.Fl t
65
65
option is specified)
69
69
.It Fl o
70
70
Output.
71
71
Read a list of filenames from standard input and produce a new archive
72
 
on standard output (unless overriden) containing the specified items.
 
72
on standard output (unless overridden) containing the specified items.
73
73
.It Fl p
74
74
Pass-through.
75
75
Read a list of filenames from standard input and copy the files to the
80
80
Unless specifically stated otherwise, options are applicable in
81
81
all operating modes.
82
82
.Bl -tag -width indent
83
 
.It Fl 0
 
83
.It Fl 0 , Fl Fl null
84
84
Read filenames separated by NUL characters instead of newlines.
85
85
This is necessary if any of the filenames being read might contain newlines.
86
86
.It Fl A
102
102
(o mode only)
103
103
Use the old POSIX portable character format.
104
104
Equivalent to
105
 
.Fl -format Ar odc .
106
 
.It Fl d
 
105
.Fl Fl format Ar odc .
 
106
.It Fl d , Fl Fl make-directories
107
107
(i and p modes)
108
108
Create directories as necessary.
109
109
.It Fl E Ar file
111
111
Read list of file name patterns from
112
112
.Ar file
113
113
to list and extract.
114
 
.It Fl F Ar file
 
114
.It Fl F Ar file , Fl Fl file Ar file
115
115
Read archive from or write archive to
116
116
.Ar file .
117
117
.It Fl f Ar pattern
118
118
(i mode only)
119
119
Ignore files that match
120
120
.Ar pattern .
121
 
.It Fl -format Ar format
 
121
.It Fl H Ar format , Fl Fl format Ar format
122
122
(o mode only)
123
123
Produce the output archive in the specified format.
124
124
Supported formats include:
140
140
The default format is
141
141
.Ar odc .
142
142
See
143
 
.Xr libarchive_formats 5
 
143
.Xr libarchive-formats 5
144
144
for more complete information about the
145
145
formats currently supported by the underlying
146
146
.Xr libarchive 3
147
147
library.
148
 
.It Fl H Ar format
149
 
Synonym for
150
 
.Fl -format .
151
 
.It Fl h , Fl -help
 
148
.It Fl h , Fl Fl help
152
149
Print usage information.
153
150
.It Fl I Ar file
154
151
Read archive from
155
152
.Ar file .
156
 
.It Fl i
 
153
.It Fl i , Fl Fl extract
157
154
Input mode.
158
155
See above for description.
159
 
.It Fl -insecure
 
156
.It Fl Fl insecure
160
157
(i and p mode only)
161
158
Disable security checks during extraction or copying.
162
159
This allows extraction via symbolic links and path names containing
163
160
.Sq ..
164
161
in the name.
165
 
.It Fl J
 
162
.It Fl J , Fl Fl xz
166
163
(o mode only)
167
164
Compress the file with xz-compatible compression before writing it.
168
165
In input mode, this option is ignored; xz compression is recognized
175
172
All symbolic links will be followed.
176
173
Normally, symbolic links are archived and copied as symbolic links.
177
174
With this option, the target of the link will be archived or copied instead.
178
 
.It Fl l
 
175
.It Fl l , Fl Fl link
179
176
(p mode only)
180
177
Create links from the target directory to the original files,
181
178
instead of copying.
182
 
.It Fl lzma
 
179
.It Fl Fl lzma
183
180
(o mode only)
184
181
Compress the file with lzma-compatible compression before writing it.
185
182
In input mode, this option is ignored; lzma compression is recognized
186
183
automatically on input.
187
 
.It Fl m
 
184
.It Fl m , Fl Fl preserve-modification-time
188
185
(i and p modes)
189
186
Set file modification time on created files to match
190
187
those in the source.
191
 
.It Fl n
 
188
.It Fl n , Fl Fl numeric-uid-gid
192
189
(i mode, only with
193
190
.Fl t )
194
191
Display numeric uid and gid.
197
194
displays the user and group names when they are provided in the
198
195
archive, or looks up the user and group names in the system
199
196
password database.
200
 
.It Fl no-preserve-owner
 
197
.It Fl Fl no-preserve-owner
201
198
(i mode only)
202
199
Do not attempt to restore file ownership.
203
200
This is the default when run by non-root users.
204
201
.It Fl O Ar file
205
202
Write archive to
206
203
.Ar file .
207
 
.It Fl o
 
204
.It Fl o , Fl Fl create
208
205
Output mode.
209
206
See above for description.
210
 
.It Fl p
 
207
.It Fl p , Fl Fl pass-through
211
208
Pass-through mode.
212
209
See above for description.
213
 
.It Fl preserve-owner
 
210
.It Fl Fl preserve-owner
214
211
(i mode only)
215
212
Restore file ownership.
216
213
This is the default when run by the root user.
217
 
.It Fl -quiet
 
214
.It Fl Fl quiet
218
215
Suppress unnecessary messages.
219
 
.It Fl R Oo user Oc Ns Oo : Oc Ns Oo group Oc
 
216
.It Fl R Oo user Oc Ns Oo : Oc Ns Oo group Oc , Fl Fl owner Oo user Oc Ns Oo : Oc Ns Oo group Oc
220
217
Set the owner and/or group on files in the output.
221
218
If group is specified with no user
222
219
(for example,
244
241
If the line read is blank, the file is skipped.
245
242
If the line contains a single period, the file is processed normally.
246
243
Otherwise, the line is taken to be the new name of the file.
247
 
.It Fl t
 
244
.It Fl t , Fl Fl list
248
245
(i mode only)
249
246
List the contents of the archive to stdout;
250
247
do not restore the contents to disk.
251
 
.It Fl u
 
248
.It Fl u , Fl Fl unconditional
252
249
(i and p modes)
253
250
Unconditionally overwrite existing files.
254
251
Ordinarily, an older file will not overwrite a newer file on disk.
255
 
.It Fl v
 
252
.It Fl V , Fl Fl dot
 
253
Print a dot to stderr for each file as it is processed.
 
254
Superseded by
 
255
.Fl v .
 
256
.It Fl v , Fl Fl verbose
256
257
Print the name of each file to stderr as it is processed.
257
258
With
258
259
.Fl t ,
259
260
provide a detailed listing of each file.
260
 
.It Fl -version
 
261
.It Fl Fl version
261
262
Print the program version information and exit.
262
263
.It Fl y
263
264
(o mode only)
275
276
In input mode, this option is ignored;
276
277
gzip compression is recognized automatically on input.
277
278
.El
 
279
.Sh EXIT STATUS
 
280
.Ex -std
278
281
.Sh ENVIRONMENT
279
282
The following environment variables affect the execution of
280
283
.Nm :
290
293
.Xr environ 7
291
294
for more information.
292
295
.El
293
 
.Sh EXIT STATUS
294
 
.Ex -std
295
296
.Sh EXAMPLES
296
297
The
297
298
.Nm
298
 
command is traditionally used to copy file heirarchies in conjunction
 
299
command is traditionally used to copy file hierarchies in conjunction
299
300
with the
300
301
.Xr find 1
301
302
command.