diff options
Diffstat (limited to 'bin/pax/cpio.1')
-rw-r--r-- | bin/pax/cpio.1 | 307 |
1 files changed, 0 insertions, 307 deletions
diff --git a/bin/pax/cpio.1 b/bin/pax/cpio.1 deleted file mode 100644 index 45f5854..0000000 --- a/bin/pax/cpio.1 +++ /dev/null @@ -1,307 +0,0 @@ -.\" $NetBSD: cpio.1,v 1.15 2017/07/03 21:33:23 wiz Exp $ -.\" -.\" Copyright (c) 1997 SigmaSoft, Th. Lockert -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR -.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. -.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, -.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT -.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF -.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" -.\" OpenBSD: cpio.1,v 1.14 2000/11/10 17:52:02 aaron Exp -.\" -.Dd June 18, 2011 -.Dt CPIO 1 -.Os -.Sh NAME -.Nm cpio -.Nd copy file archives in and out -.Sh SYNOPSIS -.Nm cpio -.Fl o -.Op Fl AaBcLvZz -.Op Fl C Ar bytes -.Op Fl F Ar archive -.Op Fl H Ar format -.Op Fl O Ar archive -.Ar "< name-list" -.Op Ar "> archive" -.Nm cpio -.Fl i -.Op Fl 6BbcdfmrSstuvZz -.Op Fl C Ar bytes -.Op Fl E Ar file -.Op Fl F Ar archive -.Op Fl H Ar format -.Op Fl I Ar archive -.Op Ar "pattern ..." -.Op Ar "< archive" -.Nm cpio -.Fl p -.Op Fl adLlmuv -.Ar destination-directory -.Ar "< name-list" -.Sh DESCRIPTION -The -.Nm -command copies files to and from a -.Nm -archive. -If the archive is of the form: -.Ar [[user@]host:]file -then the archive will be processed using -.Xr rmt 8 . -.Pp -The options are as follows: -.Bl -tag -width Ds -.It Fl o , Fl Fl create -Create an archive. -Reads the list of files to store in the -archive from standard input, and writes the archive on standard -output. -.Bl -tag -width Ds -.It Fl a , Fl Fl reset-access-time -Reset the access times on files that have been copied to the -archive. -.It Fl A , Fl Fl append -Append to the specified archive. -.It Fl B -Set block size of output to 5120 bytes. -.It Fl c -Use ASCII format for -.Nm -header for portability. -.It Fl C Ar bytes -Set the block size of output to -.Ar bytes . -.It Fl F Ar archive -.It Fl O Ar archive -Use the specified file name as the archive to write to. -.It Fl H Ar format -Write the archive in the specified format. -Recognized formats are: -.Pp -.Bl -tag -width sv4cpio -compact -.It Ar bcpio -Old binary -.Nm -format. -.It Ar cpio -Old octal character -.Nm -format. -.It Ar sv4cpio -SVR4 hex -.Nm -format. -.It Ar tar -Old tar format. -.It Ar ustar -POSIX ustar format. -.El -.It Fl L -Follow symbolic links. -.It Fl v -Be verbose about operations. -List filenames as they are written to the archive. -.It Fl Fl xz -Compress/decompress archive using -.Xr xz 1 -format. -.It Fl Z -Compress archive using -.Xr compress 1 -format. -.It Fl z -Compress/decompress archive using -.Xr gzip 1 -format. -.El -.It Fl i , Fl Fl extract -Restore files from an archive. -Reads the archive file from -standard input and extracts files matching the -.Ar patterns -that were specified on the command line. -.Bl -tag -width Ds -.It Fl b -Do byte and word swapping after reading in data from the -archive, for restoring archives created on systems with -a different byte order. -.It Fl B -Set the block size of the archive being read to 5120 bytes. -.It Fl c -Expect the archive headers to be in ASCII format. -.It Fl C Ar bytes -Read archive written with a block size of -.Ar bytes . -.It Fl d , Fl Fl make-directories -Create any intermediate directories as needed during -restore. -.It Fl E Ar file , Fl Fl pattern-file Ar file -Read list of file name patterns to extract or list from -.Ar file . -.It Fl f , Fl Fl nonmatching -Restore all files except those matching the -.Ar patterns -given on the command line. -.It Fl F Ar archive , Fl Fl file Ar archive -.It Fl I Ar archive -Use the specified file as the input for the archive. -.It Fl H Ar format , Fl Fl format Ar format -Read an archive of the specified format. -Recognized formats are: -.Pp -.Bl -tag -width sv4cpio -compact -.It Ar bcpio -Old binary -.Nm -format. -.It Ar cpio -Old octal character -.Nm -format. -.It Ar sv4cpio -SVR4 hex -.Nm -format. -.It Ar tar -Old tar format. -.It Ar ustar -POSIX ustar format. -.El -.It Fl m -Restore modification times on files. -.It Fl r , Fl Fl rename -Rename restored files interactively. -.It Fl s -Swap bytes after reading data from the archive. -.It Fl S , Fl Fl swap-halfwords -Swap words after reading data from the archive. -.It Fl t , Fl Fl list -Only list the contents of the archive, no files or -directories will be created. -.It Fl u , Fl Fl unconditional -Overwrite files even when the file in the archive is -older than the one that will be overwritten. -.It Fl v , Fl Fl verbose -Be verbose about operations. -List filenames as they are copied in from the archive. -.It Fl z -Uncompress archive using -.Xr gzip 1 -format. -.It Fl Z -Uncompress archive using -.Xr compress 1 -format. -.It Fl 6 -Process old-style -.Nm -format archives. -.El -.It Fl p , Fl Fl pass-through -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 -.Ar directory -argument. -.Bl -tag -width Ds -.It Fl a -Reset the access times on files that have been copied. -.It Fl d -Create any intermediate directories as needed to write -the files at the new location. -.It Fl l , Fl Fl link -When possible, link files rather than creating an -extra copy. -.It Fl L , Fl Fl dereference -Follow symbolic links. -.It Fl m , Fl Fl preserve-modification-time -Restore modification times on files. -.It Fl u , Fl Fl unconditional -Overwrite files even when the original file being copied is -older than the one that will be overwritten. -.It Fl v , Fl Fl verbose -Be verbose about operations. -List filenames as they are copied. -.It Fl Fl force-local -Do not interpret filenames that contain a -.Sq \&: -as remote files. -.It Fl Fl insecure -Normally -.Nm -ignores filenames that contain -.Dq .. -as a path component. -With this option, files that contain -.Dq .. -can be processed. -.El -.El -.Sh EXIT STATUS -.Nm -will exit with one of the following values: -.Bl -tag -width 2n -.It 0 -All files were processed successfully. -.It 1 -An error occurred. -.El -.Pp -Whenever -.Nm -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 -.Fl p -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 -.Nm -cannot create a link to a file, -.Nm -will not create a second copy of the file. -.Pp -If the extraction of a file from an archive is prematurely terminated -by a signal or error, -.Nm -may have only partially extracted the file the user wanted. -Additionally, the file modes of extracted files and directories may -have incorrect file bits, and the modification and access times may -be wrong. -.Pp -If the creation of an archive is prematurely terminated by a signal -or error, -.Nm -may have only partially created the archive which may violate the -specific archive format specification. -.Sh SEE ALSO -.Xr pax 1 , -.Xr tar 1 -.Sh AUTHORS -.An Keith Muller -at the University of California, San Diego. -.Sh BUGS -The -.Fl s -and -.Fl S -options are currently not implemented. |