summaryrefslogtreecommitdiff
path: root/libarchive/libarchive-2.4.17/doc/text/bsdcpio.1
diff options
context:
space:
mode:
authorTomas Bzatek <tbzatek@users.sourceforge.net>2008-08-21 20:11:09 +0200
committerTomas Bzatek <tbzatek@users.sourceforge.net>2008-08-21 20:11:09 +0200
commit3d051722dea893c1b813db8bbeae1430b9eddd52 (patch)
tree6ffdcc7574ed7d5fcfe44aa910dc38b8482fffdb /libarchive/libarchive-2.4.17/doc/text/bsdcpio.1
parent91d8a99387576216086c74b34b64efe468c2cd7b (diff)
downloadtuxcmd-modules-3d051722dea893c1b813db8bbeae1430b9eddd52.tar.xz
Update libarchive to v2.5.5
Diffstat (limited to 'libarchive/libarchive-2.4.17/doc/text/bsdcpio.1')
-rw-r--r--libarchive/libarchive-2.4.17/doc/text/bsdcpio.1187
1 files changed, 0 insertions, 187 deletions
diff --git a/libarchive/libarchive-2.4.17/doc/text/bsdcpio.1 b/libarchive/libarchive-2.4.17/doc/text/bsdcpio.1
deleted file mode 100644
index d8f7102..0000000
--- a/libarchive/libarchive-2.4.17/doc/text/bsdcpio.1
+++ /dev/null
@@ -1,187 +0,0 @@
-BSDCPIO(1) FreeBSD General Commands Manual BSDCPIO(1)
-
-NAME
- cpio -- copy files to and from archives
-
-SYNOPSIS
- cpio {-i} [options] [pattern ...] [< archive]
- cpio {-o} [options] < name-list [> archive]
- cpio {-p} [options] dest-dir < name-list
-
-DESCRIPTION
- cpio copies files between archives and directories. This implementation
- can extract from tar, pax, cpio, zip, jar, ar, and ISO 9660 cdrom images
- and can create tar, pax, cpio, ar, and shar archives.
-
- The first option to cpio is a mode indicator from the following list:
- -i Input. Read an archive from standard input and extract the con-
- tents to disk or (if the -t option is specified) list the con-
- tents to standard output. If one or more file patterns are spec-
- ified, only files matching one of the patterns will be extracted.
- -o Output. Read a list of filenames from standard input and produce
- a new archive on standard output containing the specified items.
- -p Pass-through. Read a list of filenames from standard input and
- copy the files to the specified directory.
-
-OPTIONS
- Unless specifically stated otherwise, options are applicable in all oper-
- ating modes.
-
- -a (o and p modes) Reset access times on files after they are read.
-
- -B (o mode only) Block output to records of 5120 bytes.
-
- -c (o mode only) Use the old POSIX portable character format.
- Equivalent to --format odc.
-
- -d (i and p modes) Create directories as necessary.
-
- -f pattern
- (i mode only) Ignore files that match pattern.
-
- --format format
- (o mode only) Produce the output archive in the specified format.
- Supported formats include:
-
- cpio Synonym for odc.
- newc The SVR4 portable cpio format.
- odc The old POSIX.1 portable octet-oriented cpio format.
- pax The POSIX.1 pax format, an extension of the ustar for-
- mat.
- ustar The POSIX.1 tar format.
-
- The default format is odc. See libarchive_formats(5) for more
- complete information about the formats currently supported by the
- underlying libarchive(3) library.
-
- -i Input mode. See above for description.
-
- -L (o and p modes) All symbolic links will be followed. Normally,
- symbolic links are archived and copied as symbolic links. With
- this option, the target of the link will be archived or copied
- instead.
-
- -l (p mode only) Create links from the target directory to the orig-
- inal files, instead of copying.
-
- -m (i and p modes) Set file modification time on created files to
- match those in the source.
-
- -o Output mode. See above for description.
-
- -p Pass-through mode. See above for description.
-
- --quiet
- Suppress unnecessary messages.
-
- -R [user][:][group]
- Set the owner and/or group on files in the output. If group is
- specified with no user (for example, -R :wheel) then the group
- will be set but not the user. If the user is specified with a
- trailing colon and no group (for example, -R root:) then the
- group will be set to the user's default group. If the user is
- specified with no trailing colon, then the user will be set but
- not the group. In -i and -p modes, this option can only be used
- by the super-user. (For compatibility, a period can be used in
- place of the colon.)
-
- -r (All modes.) Rename files interactively. For each file, a
- prompt is written to /dev/tty containing the name of the file and
- a line is read from /dev/tty. If the line read is blank, the
- file is skipped. If the line contains a single period, the file
- is processed normally. Otherwise, the line is taken to be the
- new name of the file.
-
- -t (i mode only) List the contents of the archive to stdout; do not
- restore the contents to disk.
-
- -u (i and p modes) Unconditionally overwrite existing files. Ordi-
- narily, an older file will not overwrite a newer file on disk.
-
- -v Print the name of each file to stderr as it is processed. With
- -t, provide a detailed listing of each file.
-
- --version
- Print the program version information and exit.
-
- -y (o mode only) Compress the archive with bzip2-compatible compres-
- sion before writing to stdout. In input mode, this option is
- ignored; bzip2 compression is recognized automatically on input.
-
- -z (o mode only) Compress the archive with gzip-compatible compres-
- sion before writing it to stdout. In input mode, this option is
- ignored; gzip compression is recognized automatically on input.
-
-ENVIRONMENT
- The following environment variables affect the execution of cpio:
-
- LANG The locale to use. See environ(7) for more information.
-
- TZ The timezone to use when displaying dates. See environ(7) for
- more information.
-
-EXIT STATUS
- The cpio utility exits 0 on success, and >0 if an error occurs.
-
-EXAMPLES
- The cpio command is traditionally used to copy file heirarchies in con-
- junction with the find(1) command. The first example here simply copies
- all files from src to dest:
- find src | cpio -pmud dest
-
- By carefully selecting options to the find(1) command and combining it
- with other standard utilities, it is possible to exercise very fine con-
- trol over which files are copied. This next example copies files from
- src to dest that are more than 2 days old and whose names match a partic-
- ular pattern:
- find src -mtime +2 | grep foo[bar] | cpio -pdmu dest
-
- This example copies files from src to dest that are more than 2 days old
- and which contain the word ``foobar'':
- find src -mtime +2 | xargs grep -l foobar | cpio -pdmu dest
-
-COMPATIBILITY
- The mode options i, o, and p and the options a, B, c, d, f, l, m, r, t,
- u, and v comply with SUSv2.
-
- The old POSIX.1 standard specified that only -i, -o, and -p were inter-
- preted as command-line options. Each took a single argument of a list of
- modifier characters. For example, the standard syntax allows -imu but
- does not support -miu or -i -m -u, since m and u are only modifiers to
- -i, they are not command-line options in their own right. The syntax
- supported by this implementation is backwards-compatible with the stan-
- dard. For best compatibility, scripts should limit themselves to the
- standard syntax.
-
-SEE ALSO
- bzip2(1), tar(1), gzip(1), mt(1), pax(1), libarchive(3), cpio(5),
- libarchive-formats(5), tar(5)
-
-STANDARDS
- There is no current POSIX standard for the cpio command; it appeared in
- ISO/IEC 9945-1:1996 (``POSIX.1'') but was dropped from IEEE Std
- 1003.1-2001 (``POSIX.1'').
-
- The cpio, ustar, and pax interchange file formats are defined by IEEE Std
- 1003.1-2001 (``POSIX.1'') for the pax command.
-
-HISTORY
- The original cpio and find utilities were written by Dick Haight while
- working in AT&T's Unix Support Group. They first appeared in 1977 in
- PWB/UNIX 1.0, the ``Programmer's Work Bench'' system developed for use
- within AT&T. They were first released outside of AT&T as part of System
- III Unix in 1981. As a result, cpio actually predates tar, even though
- it was not well-known outside of AT&T until some time later.
-
- This is a complete re-implementation based on the libarchive(3) library.
-
-BUGS
- The cpio archive format has several basic limitations: It does not store
- user and group names, only numbers. As a result, it cannot be reliably
- used to transfer files between systems with dissimilar user and group
- numbering. Older cpio formats limit the user and group numbers to 16 or
- 18 bits, which is insufficient for modern systems. The cpio archive for-
- mats cannot support files over 4 gigabytes, except for the ``odc'' vari-
- ant, which can support files up to 8 gigabytes.
-
-FreeBSD 6.0 December 21, 2007 FreeBSD 6.0