2a3bb6a8a4
For more info see ./man/README file, it is done this way because it is very easy to miss some new option to be documented. Version: 2.12-2
216 lines
5.9 KiB
Plaintext
216 lines
5.9 KiB
Plaintext
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.1.
|
|
.TH CPIO "1" "September 2015" "cpio 2.12" "User Commands"
|
|
.SH NAME
|
|
cpio \- manual page for cpio 2.12
|
|
.SH SYNOPSIS
|
|
.B cpio
|
|
[\fI\,OPTION\/\fR...] [\fI\,destination-directory\/\fR]
|
|
.SH DESCRIPTION
|
|
.SS "Main operation mode:"
|
|
.TP
|
|
\fB\-i\fR, \fB\-\-extract\fR
|
|
Extract files from an archive (run in copy\-in
|
|
mode)
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-create\fR
|
|
Create the archive (run in copy\-out mode)
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-pass\-through\fR
|
|
Run in copy\-pass mode
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-list\fR
|
|
Print a table of contents of the input
|
|
.SS "Operation modifiers valid in any mode:"
|
|
.TP
|
|
\fB\-\-block\-size\fR=\fI\,BLOCK\-SIZE\/\fR
|
|
Set the I/O block size to BLOCK\-SIZE * 512
|
|
bytes
|
|
.TP
|
|
\fB\-B\fR
|
|
Set the I/O block size to 5120 bytes
|
|
.TP
|
|
\fB\-c\fR
|
|
Identical to "\-H newc", use the new (SVR4)
|
|
portable format. If you wish the old portable
|
|
(ASCII) archive format, use "\-H odc" instead.
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-io\-size\fR=\fI\,NUMBER\/\fR
|
|
Set the I/O block size to the given NUMBER of
|
|
bytes
|
|
.TP
|
|
\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
|
|
Change to directory DIR
|
|
.TP
|
|
\fB\-\-force\-local\fR
|
|
Archive file is local, even if its name contains
|
|
colons
|
|
.TP
|
|
\fB\-H\fR, \fB\-\-format\fR=\fI\,FORMAT\/\fR
|
|
Use given archive FORMAT
|
|
.TP
|
|
\fB\-\-quiet\fR
|
|
Do not print the number of blocks copied
|
|
.TP
|
|
\fB\-R\fR, \fB\-\-owner\fR=\fI\,[USER][\/\fR:.][GROUP]
|
|
Set the ownership of all files created to the
|
|
specified USER and/or GROUP
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
Verbosely list the files processed
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-dot\fR
|
|
Print a "." for each file processed
|
|
.TP
|
|
\fB\-W\fR, \fB\-\-warning\fR=\fI\,FLAG\/\fR
|
|
Control warning display. Currently FLAG is one of
|
|
\&'none', 'truncate', 'all'. Multiple options
|
|
accumulate.
|
|
.SS "Operation modifiers valid in copy-in and copy-out modes:"
|
|
.TP
|
|
\fB\-F\fR, \fB\-\-file\fR=\fI\,[[USER\/\fR@]HOST:]FILE\-NAME
|
|
Use this FILE\-NAME instead of standard input or
|
|
output. Optional USER and HOST specify the user
|
|
and host names in case of a remote archive
|
|
.TP
|
|
\fB\-M\fR, \fB\-\-message\fR=\fI\,STRING\/\fR
|
|
Print STRING when the end of a volume of the
|
|
backup media is reached
|
|
.TP
|
|
\fB\-\-rsh\-command\fR=\fI\,COMMAND\/\fR
|
|
Use COMMAND instead of rsh
|
|
.SS "Operation modifiers valid only in copy-in mode:"
|
|
.TP
|
|
\fB\-b\fR, \fB\-\-swap\fR
|
|
Swap both halfwords of words and bytes of
|
|
halfwords in the data. Equivalent to \fB\-sS\fR
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-nonmatching\fR
|
|
Only copy files that do not match any of the given
|
|
patterns
|
|
.TP
|
|
\fB\-I\fR [[USER@]HOST:]FILE\-NAME Archive filename to use instead of standard input.
|
|
Optional USER and HOST specify the user and host
|
|
names in case of a remote archive
|
|
.TP
|
|
\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
|
|
In the verbose table of contents listing, show
|
|
numeric UID and GID
|
|
.TP
|
|
\fB\-r\fR, \fB\-\-rename\fR
|
|
Interactively rename files
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-swap\-bytes\fR
|
|
Swap the bytes of each halfword in the files
|
|
.TP
|
|
\fB\-S\fR, \fB\-\-swap\-halfwords\fR
|
|
Swap the halfwords of each word (4 bytes) in the
|
|
files
|
|
.TP
|
|
\fB\-\-to\-stdout\fR
|
|
Extract files to standard output
|
|
.TP
|
|
\fB\-E\fR, \fB\-\-pattern\-file\fR=\fI\,FILE\/\fR
|
|
Read additional patterns specifying filenames to
|
|
extract or list from FILE
|
|
.TP
|
|
\fB\-\-only\-verify\-crc\fR
|
|
When reading a CRC format archive, only verify the
|
|
checksum of each file in the archive, don't
|
|
actually extract the files
|
|
.SS "Operation modifiers valid only in copy-out mode:"
|
|
.TP
|
|
\fB\-A\fR, \fB\-\-append\fR
|
|
Append to an existing archive.
|
|
.TP
|
|
\fB\-\-device\-independent\fR, \fB\-\-reproducible\fR
|
|
Create device\-independent (reproducible) archives
|
|
.TP
|
|
\fB\-\-ignore\-devno\fR
|
|
Don't store device numbers
|
|
.TP
|
|
\fB\-O\fR [[USER@]HOST:]FILE\-NAME Archive filename to use instead of standard
|
|
output. Optional USER and HOST specify the user
|
|
and host names in case of a remote archive
|
|
.TP
|
|
\fB\-\-renumber\-inodes\fR
|
|
Renumber inodes
|
|
.SS "Operation modifiers valid only in copy-pass mode:"
|
|
.TP
|
|
\fB\-l\fR, \fB\-\-link\fR
|
|
Link files instead of copying them, when
|
|
possible
|
|
.SS "Operation modifiers valid in copy-in and copy-out modes:"
|
|
.TP
|
|
\fB\-\-absolute\-filenames\fR
|
|
Do not strip file system prefix components from
|
|
the file names
|
|
.TP
|
|
\fB\-\-no\-absolute\-filenames\fR
|
|
Create all files relative to the current
|
|
directory
|
|
.SS "Operation modifiers valid in copy-out and copy-pass modes:"
|
|
.TP
|
|
\fB\-0\fR, \fB\-\-null\fR
|
|
Filenames in the list are delimited by null
|
|
characters instead of newlines
|
|
.TP
|
|
\fB\-a\fR, \fB\-\-reset\-access\-time\fR
|
|
Reset the access times of files after reading them
|
|
.TP
|
|
\fB\-L\fR, \fB\-\-dereference\fR
|
|
Dereference symbolic links (copy the files
|
|
that they point to instead of copying the links).
|
|
.SS "Operation modifiers valid in copy-in and copy-pass modes:"
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-make\-directories\fR
|
|
Create leading directories where needed
|
|
.TP
|
|
\fB\-m\fR, \fB\-\-preserve\-modification\-time\fR
|
|
Retain previous file modification times when
|
|
creating files
|
|
.TP
|
|
\fB\-\-no\-preserve\-owner\fR
|
|
Do not change the ownership of the files
|
|
.TP
|
|
\fB\-\-sparse\fR
|
|
Write files with large blocks of zeros as sparse
|
|
files
|
|
.TP
|
|
\fB\-u\fR, \fB\-\-unconditional\fR
|
|
Replace all files unconditionally
|
|
.TP
|
|
\-?, \fB\-\-help\fR
|
|
give this help list
|
|
.TP
|
|
\fB\-\-usage\fR
|
|
give a short usage message
|
|
.TP
|
|
\fB\-\-version\fR
|
|
print program version
|
|
.PP
|
|
Mandatory or optional arguments to long options are also mandatory or optional
|
|
for any corresponding short options.
|
|
.SH AUTHOR
|
|
Written by Phil Nelson, David MacKenzie, John Oleynick,
|
|
and Sergey Poznyakoff.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to <bug\-cpio@gnu.org>.
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2015 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
.SH "SEE ALSO"
|
|
The full documentation for
|
|
.B cpio
|
|
is maintained as a Texinfo manual. If the
|
|
.B info
|
|
and
|
|
.B cpio
|
|
programs are properly installed at your site, the command
|
|
.IP
|
|
.B info cpio
|
|
.PP
|
|
should give you access to the complete manual.
|