tags 695717 + patch thanks Dear maintainer,
I've prepared an NMU for cpio (versioned as 2.11+dfsg-0.1) and uploaded it to DELAYED/2. Please feel free to tell me if I should delay it longer. Regards. David
diff -Nru cpio-2.11/debian/changelog cpio-2.11+dfsg/debian/changelog --- cpio-2.11/debian/changelog 2012-06-12 07:41:45.000000000 -0400 +++ cpio-2.11+dfsg/debian/changelog 2012-12-29 22:02:32.000000000 -0400 @@ -1,3 +1,12 @@ +cpio (2.11+dfsg-0.1) unstable; urgency=low + + * Non-maintainer upload. + * Remove non DFSG-compliant doc/cpio.info and doc/cpio.texi from source. + Closes: #695717 + * Do not build nor ship cpio.info because of the above. + + -- David Prévot <taf...@debian.org> Sat, 29 Dec 2012 22:02:30 -0400 + cpio (2.11-8) unstable; urgency=low * Enable hardened build flags diff -Nru cpio-2.11/debian/patches/695717-no-cpio.info.patch cpio-2.11+dfsg/debian/patches/695717-no-cpio.info.patch --- cpio-2.11/debian/patches/695717-no-cpio.info.patch 1969-12-31 20:00:00.000000000 -0400 +++ cpio-2.11+dfsg/debian/patches/695717-no-cpio.info.patch 2012-12-29 21:57:54.000000000 -0400 @@ -0,0 +1,17 @@ +Description: Do not build cpio.info anymore +Author: David Prévot <taf...@debian.org> +Bug-Debian: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=695717 +Applied-Upstream: not-needed +Last-Update: 2012-12-29 +--- +This patch header follows DEP-3: http://dep.debian.net/deps/dep3/ +--- a/doc/Makefile.in ++++ b/doc/Makefile.in +@@ -149,7 +149,6 @@ + am__v_at_0 = @ + SOURCES = + DIST_SOURCES = +-INFO_DEPS = $(srcdir)/cpio.info + TEXINFO_TEX = $(top_srcdir)/build-aux/texinfo.tex + am__TEXINFO_TEX_DIR = $(top_srcdir)/build-aux + DVIS = cpio.dvi diff -Nru cpio-2.11/debian/patches/series cpio-2.11+dfsg/debian/patches/series --- cpio-2.11/debian/patches/series 2012-06-12 07:30:10.000000000 -0400 +++ cpio-2.11+dfsg/debian/patches/series 2012-12-29 21:51:52.000000000 -0400 @@ -6,3 +6,4 @@ 218086-reporting-bugs.patch 588020-manpages-see-also.patch 627444-invalid-redefinition-of-stat.patch +695717-no-cpio.info.patch diff -Nru cpio-2.11/debian/rules cpio-2.11+dfsg/debian/rules --- cpio-2.11/debian/rules 2012-06-12 07:40:49.000000000 -0400 +++ cpio-2.11+dfsg/debian/rules 2012-12-29 22:28:56.000000000 -0400 @@ -123,8 +123,7 @@ debian/tmp/usr/share/doc/$(package)/changelog.Debian gzip -9v debian/tmp/usr/share/doc/$(package)/* gzip -9v debian/tmp/usr/share/man/*/* - gzip -9v debian/tmp/usr/share/info/* - rm -f debian/tmp/usr/share/info/dir.gz + rm -rf debian/tmp/usr/share/info install -m 644 debian/copyright debian/tmp/usr/share/doc/$(package)/. # Determine shared library dependencies dpkg-shlibdeps debian/tmp/bin/cpio debian/tmp/bin/mt-gnu diff -Nru cpio-2.11/doc/cpio.info cpio-2.11+dfsg/doc/cpio.info --- cpio-2.11/doc/cpio.info 2010-03-11 01:01:40.000000000 -0400 +++ cpio-2.11+dfsg/doc/cpio.info 1969-12-31 20:00:00.000000000 -0400 @@ -1,562 +0,0 @@ -This is cpio.info, produced by makeinfo version 4.13 from cpio.texi. - -INFO-DIR-SECTION Archiving -START-INFO-DIR-ENTRY -* Cpio: (cpio). Copy-in-copy-out archiver to tape or disk. -END-INFO-DIR-ENTRY - - This manual documents GNU cpio (version 2.11, 12 February 2010). - - Copyright (C) 1995, 2001, 2002, 2004, 2010 Free Software Foundation, -Inc. - - Permission is granted to copy, distribute and/or modify this - document under the terms of the GNU Free Documentation License, - Version 1.2 or any later version published by the Free Software - Foundation; with no Invariant Sections, with the Front-Cover texts - being "A GNU Manual", and with the Back-Cover Texts as in (a) - below. A copy of the license is included in the section entitled - "GNU Free Documentation License". - - (a) The FSF's Back-Cover Text is: "You have freedom to copy and - modify this GNU Manual, like GNU software. Copies published by - the Free Software Foundation raise funds for GNU development." - - -File: cpio.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir) - -cpio -**** - -GNU cpio is a tool for creating and extracting archives, or copying -files from one place to another. It handles a number of cpio formats as -well as reading and writing tar files. This is the first edition of the -GNU cpio documentation and is consistent with 2.11. - -* Menu: - -* Introduction:: -* Tutorial:: Getting started. -* Invoking cpio:: How to invoke `cpio'. -* Media:: Using tapes and other archive media. -* Reports:: Reporting bugs or suggestions -* Concept Index:: Concept index. - - --- The Detailed Node Listing --- - -Invoking cpio - -* Copy-out mode:: -* Copy-in mode:: -* Copy-pass mode:: -* Options:: - - -File: cpio.info, Node: Introduction, Next: Tutorial, Prev: Top, Up: Top - -1 Introduction -************** - -GNU cpio copies files into or out of a cpio or tar archive, The archive -can be another file on the disk, a magnetic tape, or a pipe. - - GNU cpio supports the following archive formats: binary, old ASCII, -new ASCII, crc, HPUX binary, HPUX old ASCII, old tar, and POSIX.1 tar. -The tar format is provided for compatibility with the tar program. By -default, cpio creates binary format archives, for compatibility with -older cpio programs. When extracting from archives, cpio automatically -recognizes which kind of archive it is reading and can read archives -created on machines with a different byte-order. - - -File: cpio.info, Node: Tutorial, Next: Invoking cpio, Prev: Introduction, Up: Top - -2 Tutorial -********** - -GNU cpio performs three primary functions. Copying files to an -archive, Extracting files from an archive, and passing files to another -directory tree. An archive can be a file on disk, one or more floppy -disks, or one or more tapes. - - When creating an archive, cpio takes the list of files to be -processed from the standard input, and then sends the archive to the -standard output, or to the device defined by the `-F' option. *Note -Copy-out mode::. Usually find or ls is used to provide this list to -the standard input. In the following example you can see the -possibilities for archiving the contents of a single directory. - - % ls | cpio -ov > directory.cpio - - The `-o' option creates the archive, and the `-v' option prints the -names of the files archived as they are added. Notice that the options -can be put together after a single `-' or can be placed separately on -the command line. The `>' redirects the cpio output to the file -`directory.cpio'. - - If you wanted to archive an entire directory tree, the find command -can provide the file list to cpio: - - % find . -print -depth | cpio -ov > tree.cpio - - This will take all the files in the current directory, the -directories below and place them in the archive tree.cpio. Again the -`-o' creates an archive, and the `-v' option shows you the name of the -files as they are archived. *Note Copy-out mode::. Using the `.' in -the find statement will give you more flexibility when doing restores, -as it will save file names with a relative path vice a hard wired, -absolute path. The `-depth' option forces `find' to print of the -entries in a directory before printing the directory itself. This -limits the effects of restrictive directory permissions by printing the -directory entries in a directory before the directory name itself. - - Extracting an archive requires a bit more thought because cpio will -not create directories by default. Another characteristic, is it will -not overwrite existing files unless you tell it to. - - % cpio -iv < directory.cpio - - This will retrieve the files archived in the file directory.cpio and -place them in the present directory. The `-i' option extracts the -archive and the `-v' shows the file names as they are extracted. If -you are dealing with an archived directory tree, you need to use the -`-d' option to create directories as necessary, something like: - - % cpio -idv < tree.cpio - - This will take the contents of the archive tree.cpio and extract it -to the current directory. If you try to extract the files on top of -files of the same name that already exist (and have the same or later -modification time) cpio will not extract the file unless told to do so -by the -u option. *Note Copy-in mode::. - - In copy-pass mode, cpio copies files from one directory tree to -another, combining the copy-out and copy-in steps without actually -using an archive. It reads the list of files to copy from the standard -input; the directory into which it will copy them is given as a -non-option argument. *Note Copy-pass mode::. - - % find . -depth -print0 | cpio --null -pvd new-dir - - The example shows copying the files of the present directory, and -sub-directories to a new directory called new-dir. Some new options are -the `-print0' available with GNU find, combined with the `--null' -option of cpio. These two options act together to send file names -between find and cpio, even if special characters are embedded in the -file names. Another is `-p', which tells cpio to pass the files it -finds to the directory `new-dir'. - - -File: cpio.info, Node: Invoking cpio, Next: Media, Prev: Tutorial, Up: Top - -3 Invoking cpio -*************** - -* Menu: - -* Copy-out mode:: -* Copy-in mode:: -* Copy-pass mode:: -* Options:: - - -File: cpio.info, Node: Copy-out mode, Next: Copy-in mode, Prev: Invoking cpio, Up: Invoking cpio - -3.1 Copy-out mode -================= - -In copy-out mode, cpio copies files into an archive. It reads a list -of filenames, one per line, on the standard input, and writes the -archive onto the standard output. A typical way to generate the list -of filenames is with the find command; you should give find the -depth -option to minimize problems with permissions on directories that are -unreadable. *Note Options::. - - cpio {-o|--create} [-0acvABLV] [-C bytes] [-H format] - [-M message] [-O [[user@]host:]archive] [-F [[user@]host:]archive] - [--file=[[user@]host:]archive] [--format=format] - [--message=message] [--null] [--reset-access-time] [--verbose] - [--dot] [--append] [--block-size=blocks] [--dereference] - [--io-size=bytes] [--rsh-command=command] [--help] [--version] - < name-list [> archive] - - -File: cpio.info, Node: Copy-in mode, Next: Copy-pass mode, Prev: Copy-out mode, Up: Invoking cpio - -3.2 Copy-in mode -================ - -In copy-in mode, cpio copies files out of an archive or lists the -archive contents. It reads the archive from the standard input. Any -non-option command line arguments are shell globbing patterns; only -files in the archive whose names match one or more of those patterns are -copied from the archive. Unlike in the shell, an initial `.' in a -filename does match a wildcard at the start of a pattern, and a `/' in a -filename can match wildcards. If no patterns are given, all files are -extracted. *Note Options::. - - cpio {-i|--extract} [-bcdfmnrtsuvBSV] [-C bytes] [-E file] - [-H format] [-M message] [-R [user][:.][group]] - [-I [[user@]host:]archive] [-F [[user@]host:]archive] - [--file=[[user@]host:]archive] [--make-directories] - [--nonmatching] [--preserve-modification-time] - [--numeric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] - [--dot] [--unconditional] [--verbose] [--block-size=blocks] - [--swap-halfwords] [--io-size=bytes] [--pattern-file=file] - [--format=format] [--owner=[user][:.][group]] - [--no-preserve-owner] [--message=message] [--help] [--version] - [--no-absolute-filenames] [--sparse] [-only-verify-crc] [--to-stdout] - [-quiet] [--rsh-command=command] [pattern...] [< archive] - - -File: cpio.info, Node: Copy-pass mode, Next: Options, Prev: Copy-in mode, Up: Invoking cpio - -3.3 Copy-pass mode -================== - -In copy-pass mode, cpio copies files from one directory tree to -another, combining the copy-out and copy-in steps without actually -using an archive. It reads the list of files to copy from the standard -input; the directory into which it will copy them is given as a -non-option argument. *Note Options::. - - cpio {-p|--pass-through} [-0adlmuvLV] [-R [user][:.][group]] - [--null] [--reset-access-time] [--make-directories] [--link] - [--preserve-modification-time] [--unconditional] [--verbose] - [--dot] [--dereference] [--owner=[user][:.][group]] [--sparse] - [--no-preserve-owner] [--help] [--version] destination-directory - < name-list - - -File: cpio.info, Node: Options, Prev: Copy-pass mode, Up: Invoking cpio - -3.4 Options -=========== - -`-0' -`--null' - Read a list of filenames terminated by a null character, instead - of a newline, so that files whose names contain newlines can be - archived. GNU find is one way to produce a list of - null-terminated filenames. This option may be used in copy-out - and copy-pass modes. - -`-a' -`--reset-access-time' - Reset the access times of files after reading them, so that it - does not look like they have just been read. - -`-A' -`--append' - Append to an existing archive. Only works in copy-out mode. The - archive must be a disk file specified with the `-O' or `-F' - (`--file') option. - -`-b' -`--swap' - Swap both halfwords of words and bytes of halfwords in the data. - Equivalent to -sS. This option may be used in copy-in mode. Use - this option to convert 32-bit integers between big-endian and - little-endian machines. - -`-B' - Set the I/O block size to 5120 bytes. Initially the block size is - 512 bytes. - -`--block-size=BLOCK-SIZE' - Set the I/O block size to BLOCK-SIZE * 512 bytes. - -`-c' - Use the old portable (ASCII) archive format. - -`-C IO-SIZE' -`--io-size=IO-SIZE' - Set the I/O block size to IO-SIZE bytes. - -`-d' -`--make-directories' - Create leading directories where needed. - -`-E FILE' -`--pattern-file=FILE' - Read additional patterns specifying filenames to extract or list - from FILE. The lines of FILE are treated as if they had been - non-option arguments to cpio. This option is used in copy-in mode, - -`-f' -`--nonmatching' - Only copy files that do not match any of the given patterns. - -`-F ARCHIVE' -`--file=ARCHIVE' - Archive filename to use instead of standard input or output. To - use a tape drive on another machine as the archive, use a filename - that starts with `HOSTNAME:', where HOSTNAME is the name or IP - address of the machine. The hostname can be preceded by a - username and an `@' to access the remote tape drive as that user, - if you have permission to do so (typically an entry in that user's - `~/.rhosts' file). - -`--force-local' - With `-F', `-I', or `-O', take the archive file name to be a local - file even if it contains a colon, which would ordinarily indicate - a remote host name. - -`-H FORMAT' -`--format=FORMAT' - Use archive format FORMAT. The valid formats are listed below - with file size limits for individual files in parentheses; the same - names are also recognized in all-caps. The default in copy-in - mode is to automatically detect the archive format, and in - copy-out mode is `bin'. - - `bin' - The obsolete binary format. (2147483647 bytes) - - `odc' - The old (POSIX.1) portable format. (8589934591 bytes) - - `newc' - The new (SVR4) portable format, which supports file systems - having more than 65536 i-nodes. (4294967295 bytes) - - `crc' - The new (SVR4) portable format with a checksum added. - - `tar' - The old tar format. (8589934591 bytes) - - `ustar' - The POSIX.1 tar format. Also recognizes GNU tar archives, - which are similar but not identical. (8589934591 bytes) - - `hpbin' - The obsolete binary format used by HPUX's cpio (which stores - device files differently). - - `hpodc' - The portable format used by HPUX's cpio (which stores device - files differently). - -`-i' -`--extract' - Run in copy-in mode. *Note Copy-in mode::. - -`-I ARCHIVE' - Archive filename to use instead of standard input. To use a tape - drive on another machine as the archive, use a filename that - starts with `HOSTNAME:', where HOSTNAME is the name or IP address - of the remote host. The hostname can be preceded by a username - and an `@' to access the remote tape drive as that user, if you - have permission to do so (typically an entry in that user's - `~/.rhosts' file). - -`-k' - Ignored; for compatibility with other versions of cpio. - -`-l' -`--link' - Link files instead of copying them, when possible. - -`-L' -`--dereference' - Copy the file that a symbolic link points to, rather than the - symbolic link itself. - -`-m' -`--preserve-modification-time' - Retain previous file modification times when creating files. - -`-M MESSAGE' -`--message=MESSAGE' - Print MESSAGE when the end of a volume of the backup media (such - as a tape or a floppy disk) is reached, to prompt the user to - insert a new volume. If MESSAGE contains the string `%d', it is - replaced by the current volume number (starting at 1). - -`-n' -`--numeric-uid-gid' - Show numeric UID and GID instead of translating them into names - when using the `--verbose' option. - -`--no-absolute-filenames' - Create all files relative to the current directory in copy-in - mode, even if they have an absolute file name in the archive. - -`--no-preserve-owner' - Do not change the ownership of the files; leave them owned by the - user extracting them. This is the default for non-root users, so - that users on System V don't inadvertantly give away files. This - option can be used in copy-in mode and copy-pass mode - -`-o' -`--create' - Run in copy-out mode. *Note Copy-out mode::. - -`-O ARCHIVE' - Archive filename to use instead of standard output. To use a tape - drive on another machine as the archive, use a filename that - starts with `HOSTNAME:', where HOSTNAME is the name or IP address - of the machine. The hostname can be preceded by a username and an - `@' to access the remote tape drive as that user, if you have - permission to do so (typically an entry in that user's `~/.rhosts' - file). - -`--only-verify-crc' - Verify the CRC's of each file in the archive, when reading a CRC - format archive. Don't actually extract the files. - -`-p' -`--pass-through' - Run in copy-pass mode. *Note Copy-pass mode::. - -`--quiet' - Do not print the number of blocks copied. - -`-r' -`--rename' - Interactively rename files. - -`-R OWNER' -`--owner OWNER' - In copy-in and copy-pass mode, set the ownership of all files - created to the specified OWNER (this operation is allowed only for - the super-user). In copy-out mode, store the supplied owner - information in the archive. - - The argument can be either the user name or the user name and - group name, separated by a dot or a colon, or the group name, - preceeded by a dot or a colon, as shown in the examples below: - - cpio --owner smith - cpio --owner smith: - cpio --owner smith:users - cpio --owner :users - - If the group is omitted but the `:' or `.' separator is given, as - in the second example. the given user's login group will be used. - -`--rsh-command=COMMAND' - Notifies cpio that is should use COMMAND to communicate with remote - devices. - -`-s' -`--swap-bytes' - Swap the bytes of each halfword (pair of bytes) in the files. This - option can be used in copy-in mode. - -`-S' -`--swap-halfwords' - Swap the halfwords of each word (4 bytes) in the files. This - option may be used in copy-in mode. - -`--sparse' - Write files with large blocks of zeros as sparse files. This - option is used in copy-in and copy-pass modes. - -`-t' -`--list' - Print a table of contents of the input. - -`--to-stdout' - Extract files to standard output. This option may be used in - copy-in mode. - -`-u' -`--unconditional' - Replace all files, without asking whether to replace existing - newer files with older files. - -`-v' -`--verbose' - List the files processed, or with `-t', give an `ls -l' style - table of contents listing. In a verbose table of contents of a - ustar archive, user and group names in the archive that do not - exist on the local system are replaced by the names that - correspond locally to the numeric UID and GID stored in the - archive. - -`-V' -`--dot' - Print a `.' for each file processed. - -`--version' - Print the cpio program version number and exit. - - -File: cpio.info, Node: Media, Next: Reports, Prev: Invoking cpio, Up: Top - -4 Magnetic Media -**************** - -Archives are usually written on removable media-tape cartridges, mag -tapes, or floppy disks. - - The amount of data a tape or disk holds depends not only on its size, -but also on how it is formatted. A 2400 foot long reel of mag tape -holds 40 megabytes of data when formated at 1600 bits per inch. The -physically smaller EXABYTE tape cartridge holds 2.3 gigabytes. - - Magnetic media are re-usable-once the archive on a tape is no longer -needed, the archive can be erased and the tape or disk used over. Media -quality does deteriorate with use, however. Most tapes or disks should -be disgarded when they begin to produce data errors. - - Magnetic media are written and erased using magnetic fields, and -should be protected from such fields to avoid damage to stored data. -Sticking a floppy disk to a filing cabinet using a magnet is probably -not a good idea. - - -File: cpio.info, Node: Reports, Next: Concept Index, Prev: Media, Up: Top - -5 Reporting bugs or suggestions -******************************* - -It is possible you will encounter a bug in `cpio'. If this happens, we -would like to hear about it. As the purpose of bug reporting is to -improve software, please be sure to include maximum information when -reporting a bug. The information needed is: - - * Version of the package you are using. - - * Compilation options used when configuring the package. - - * Conditions under which the bug appears. - - Send your report to <bug-c...@gnu.org>. Allow us a couple of days to -answer. - - -File: cpio.info, Node: Concept Index, Prev: Reports, Up: Top - -Concept Index -************* - - [index ] -* Menu: - -* command line options: Invoking cpio. (line 6) -* copying directory structures: Tutorial. (line 6) -* creating a cpio archive: Tutorial. (line 6) -* extracting a cpio archive: Tutorial. (line 6) -* invoking cpio: Invoking cpio. (line 6) -* magnetic media: Media. (line 6) -* passing directory structures: Tutorial. (line 6) - - - -Tag Table: -Node: Top1021 -Node: Introduction1803 -Node: Tutorial2519 -Node: Invoking cpio6190 -Node: Copy-out mode6381 -Node: Copy-in mode7312 -Node: Copy-pass mode8711 -Node: Options9510 -Node: Media17631 -Node: Reports18610 -Node: Concept Index19241 - -End Tag Table diff -Nru cpio-2.11/doc/cpio.texi cpio-2.11+dfsg/doc/cpio.texi --- cpio-2.11/doc/cpio.texi 2010-03-11 01:01:40.000000000 -0400 +++ cpio-2.11+dfsg/doc/cpio.texi 1969-12-31 20:00:00.000000000 -0400 @@ -1,607 +0,0 @@ -\input texinfo @c -*-texinfo-*- -@c %**start of header -@setfilename cpio.info -@settitle cpio -@setchapternewpage off -@c %**end of header - -@dircategory Archiving -@direntry -* Cpio: (cpio). Copy-in-copy-out archiver to tape or disk. -@end direntry - -@include version.texi - -@copying -This manual documents GNU cpio (version @value{VERSION}, @value{UPDATED}). - -Copyright @copyright{} 1995, 2001, 2002, 2004, 2010 Free Software -Foundation, Inc. -@sp 1 -@quotation -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.2 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with the Front-Cover texts being ``A GNU Manual'', -and with the Back-Cover Texts as in (a) below. A copy of the license -is included in the section entitled ``GNU Free Documentation License''. - -(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify -this GNU Manual, like GNU software. Copies published by the Free -Software Foundation raise funds for GNU development.'' -@end quotation -@end copying - -@titlepage -@title GNU CPIO -@subtitle @value{VERSION} @value{UPDATED} -@author by Robert Carleton -@c copyright page -@page -@vskip 0pt plus 1filll -@insertcopying -@sp 2 -Published by the Free Software Foundation @* -51 Franklin Street, Fifth Floor, @* -Boston, MA 02110-1301, USA @* -@end titlepage - -@node Top, Introduction, (dir), (dir) -@comment node-name, next, previous, up - -@ifinfo -@top - -GNU cpio is a tool for creating and extracting archives, or copying -files from one place to another. It handles a number of cpio formats as -well as reading and writing tar files. This is the first edition of the -GNU cpio documentation and is consistent with @value{VERSION}. - -@end ifinfo - -@menu -* Introduction:: -* Tutorial:: Getting started. -* Invoking cpio:: How to invoke @command{cpio}. -* Media:: Using tapes and other archive media. -* Reports:: Reporting bugs or suggestions -* Concept Index:: Concept index. - -@detailmenu - --- The Detailed Node Listing --- - -Invoking cpio - -* Copy-out mode:: -* Copy-in mode:: -* Copy-pass mode:: -* Options:: - -@end detailmenu -@end menu - -@node Introduction, Tutorial, Top, Top -@comment node-name, next, previous, up -@chapter Introduction - -GNU cpio copies files into or out of a cpio or tar archive, The archive -can be another file on the disk, a magnetic tape, or a pipe. - -GNU cpio supports the following archive formats: binary, old ASCII, new -ASCII, crc, HPUX binary, HPUX old ASCII, old tar, and POSIX.1 tar. The -tar format is provided for compatibility with the tar program. By -default, cpio creates binary format archives, for compatibility with -older cpio programs. When extracting from archives, cpio automatically -recognizes which kind of archive it is reading and can read archives -created on machines with a different byte-order. - -@node Tutorial, Invoking cpio, Introduction, Top -@comment node-name, next, previous, up -@chapter Tutorial -@cindex creating a cpio archive -@cindex extracting a cpio archive -@cindex copying directory structures -@cindex passing directory structures - - -GNU cpio performs three primary functions. Copying files to an -archive, Extracting files from an archive, and passing files to another -directory tree. An archive can be a file on disk, one or more floppy -disks, or one or more tapes. - -When creating an archive, cpio takes the list of files to be processed -from the standard input, and then sends the archive to the standard -output, or to the device defined by the @option{-F} option. -@xref{Copy-out mode}. Usually find or ls is used to provide this list -to the standard input. In the following example you can see the -possibilities for archiving the contents of a single directory. - - -@example -@cartouche -% ls | cpio -ov > directory.cpio -@end cartouche -@end example - -The @option{-o} option creates the archive, and the @option{-v} option -prints the names of the files archived as they are added. Notice that -the options can be put together after a single @option{-} or can be placed -separately on the command line. The @samp{>} redirects the cpio output -to the file @samp{directory.cpio}. - - -If you wanted to archive an entire directory tree, the find command can -provide the file list to cpio: - - -@example -@cartouche -% find . -print -depth | cpio -ov > tree.cpio -@end cartouche -@end example - - -This will take all the files in the current directory, the directories -below and place them in the archive tree.cpio. Again the @option{-o} -creates an archive, and the @option{-v} option shows you the name of the -files as they are archived. @xref{Copy-out mode}. Using the @samp{.} in the -find statement will give you more flexibility when doing restores, as it -will save file names with a relative path vice a hard wired, absolute -path. The @option{-depth} option forces @samp{find} to print of the -entries in a directory before printing the directory itself. This -limits the effects of restrictive directory permissions by printing the -directory entries in a directory before the directory name itself. - - - - -Extracting an archive requires a bit more thought because cpio will not -create directories by default. Another characteristic, is it will not -overwrite existing files unless you tell it to. - - -@example -@cartouche -% cpio -iv < directory.cpio -@end cartouche -@end example - -This will retrieve the files archived in the file directory.cpio and -place them in the present directory. The @option{-i} option extracts the -archive and the @option{-v} shows the file names as they are extracted. -If you are dealing with an archived directory tree, you need to use the -@option{-d} option to create directories as necessary, something like: - -@example -@cartouche -% cpio -idv < tree.cpio -@end cartouche -@end example - -This will take the contents of the archive tree.cpio and extract it to -the current directory. If you try to extract the files on top of files -of the same name that already exist (and have the same or later -modification time) cpio will not extract the file unless told to do so -by the -u option. @xref{Copy-in mode}. - - -In copy-pass mode, cpio copies files from one directory tree to another, -combining the copy-out and copy-in steps without actually using an -archive. It reads the list of files to copy from the standard input; -the directory into which it will copy them is given as a non-option -argument. @xref{Copy-pass mode}. - -@example -@cartouche -% find . -depth -print0 | cpio --null -pvd new-dir -@end cartouche -@end example - - -The example shows copying the files of the present directory, and -sub-directories to a new directory called new-dir. Some new options are -the @option{-print0} available with GNU find, combined with the -@option{--null} option of cpio. These two options act together to send -file names between find and cpio, even if special characters are -embedded in the file names. Another is @option{-p}, which tells cpio to -pass the files it finds to the directory @samp{new-dir}. - -@node Invoking cpio, Media, Tutorial, Top -@comment node-name, next, previous, up -@chapter Invoking cpio -@cindex invoking cpio -@cindex command line options - -@menu -* Copy-out mode:: -* Copy-in mode:: -* Copy-pass mode:: -* Options:: -@end menu - -@node Copy-out mode, Copy-in mode, Invoking cpio, Invoking cpio -@comment node-name, next, previous, up -@section Copy-out mode - -In copy-out mode, cpio copies files into an archive. It reads a list -of filenames, one per line, on the standard input, and writes the -archive onto the standard output. A typical way to generate the list -of filenames is with the find command; you should give find the -depth -option to minimize problems with permissions on directories that are -unreadable. -@xref{Options}. - -@example -cpio @{-o|--create@} [-0acvABLV] [-C bytes] [-H format] -[-M message] [-O [[user@@]host:]archive] [-F [[user@@]host:]archive] -[--file=[[user@@]host:]archive] [--format=format] -[--message=message] [--null] [--reset-access-time] [--verbose] -[--dot] [--append] [--block-size=blocks] [--dereference] -[--io-size=bytes] [--rsh-command=command] [--help] [--version] -< name-list [> archive] -@end example - -@node Copy-in mode, Copy-pass mode, Copy-out mode, Invoking cpio -@comment node-name, next, previous, up -@section Copy-in mode - -In copy-in mode, cpio copies files out of an archive or lists the -archive contents. It reads the archive from the standard input. Any -non-option command line arguments are shell globbing patterns; only -files in the archive whose names match one or more of those patterns are -copied from the archive. Unlike in the shell, an initial @samp{.} in a -filename does match a wildcard at the start of a pattern, and a @samp{/} in a -filename can match wildcards. If no patterns are given, all files are -extracted. @xref{Options}. - -@example -cpio @{-i|--extract@} [-bcdfmnrtsuvBSV] [-C bytes] [-E file] -[-H format] [-M message] [-R [user][:.][group]] -[-I [[user@@]host:]archive] [-F [[user@@]host:]archive] -[--file=[[user@@]host:]archive] [--make-directories] -[--nonmatching] [--preserve-modification-time] -[--numeric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] -[--dot] [--unconditional] [--verbose] [--block-size=blocks] -[--swap-halfwords] [--io-size=bytes] [--pattern-file=file] -[--format=format] [--owner=[user][:.][group]] -[--no-preserve-owner] [--message=message] [--help] [--version] -[--no-absolute-filenames] [--sparse] [-only-verify-crc] [--to-stdout] -[-quiet] [--rsh-command=command] [pattern...] [< archive] -@end example - -@node Copy-pass mode, Options, Copy-in mode, Invoking cpio -@comment node-name, next, previous, up -@section Copy-pass mode - -In copy-pass mode, cpio copies files from one directory tree to -another, combining the copy-out and copy-in steps without actually -using an archive. It reads the list of files to copy from the -standard input; the directory into which it will copy them is given as -a non-option argument. -@xref{Options}. - -@example -cpio @{-p|--pass-through@} [-0adlmuvLV] [-R [user][:.][group]] -[--null] [--reset-access-time] [--make-directories] [--link] -[--preserve-modification-time] [--unconditional] [--verbose] -[--dot] [--dereference] [--owner=[user][:.][group]] [--sparse] -[--no-preserve-owner] [--help] [--version] destination-directory -< name-list -@end example - - - -@node Options, , Copy-pass mode, Invoking cpio -@comment node-name, next, previous, up -@section Options - - -@table @code - - -@item -0 -@itemx --null -Read a list of filenames terminated by a null character, instead of a -newline, so that files whose names contain newlines can be archived. -GNU find is one way to produce a list of null-terminated filenames. -This option may be used in copy-out and copy-pass modes. - -@item -a -@itemx --reset-access-time -Reset the access times of files after reading them, so -that it does not look like they have just been read. - -@item -A -@itemx --append -Append to an existing archive. Only works in copy-out -mode. The archive must be a disk file specified with -the @option{-O} or @option{-F} (@option{--file}) option. - -@item -b -@itemx --swap -Swap both halfwords of words and bytes of halfwords in the data. -Equivalent to -sS. This option may be used in copy-in mode. Use this -option to convert 32-bit integers between big-endian and little-endian -machines. - -@item -B -Set the I/O block size to 5120 bytes. Initially the -block size is 512 bytes. - -@item --block-size=@var{block-size} -Set the I/O block size to @var{block-size} * 512 bytes. - -@item -c -Use the old portable (ASCII) archive format. - -@item -C @var{io-size} -@itemx --io-size=@var{io-size} -Set the I/O block size to @var{io-size} bytes. - -@item -d -@itemx --make-directories -Create leading directories where needed. - -@item -E @var{file} -@itemx --pattern-file=@var{file} -Read additional patterns specifying filenames to extract or list from -@var{file}. The lines of @var{file} are treated as if they had been non-option -arguments to cpio. This option is used in copy-in mode, - -@item -f -@itemx --nonmatching -Only copy files that do not match any of the given -patterns. - -@item -F @var{archive} -@itemx --file=@var{archive} -Archive filename to use instead of standard input or output. To use a -tape drive on another machine as the archive, use a filename that starts -with @samp{@var{hostname}:}, where @var{hostname} is the name or IP -address of the machine. The hostname can be preceded by a username and an -@samp{@@} to access the remote tape drive as that user, if you have -permission to do so (typically an entry in that user's @file{~/.rhosts} -file). - -@item --force-local -With @option{-F}, @option{-I}, or @option{-O}, take the archive file name to be a -local file even if it contains a colon, which would -ordinarily indicate a remote host name. - -@item -H @var{format} -@itemx --format=@var{format} -Use archive format @var{format}. The valid formats are listed below -with file size limits for individual files in parentheses; the same -names are also recognized in all-caps. The default in copy-in mode is -to automatically detect the archive format, and in copy-out mode is -@samp{bin}. - -@table @samp -@item bin -The obsolete binary format. (2147483647 bytes) - -@item odc -The old (POSIX.1) portable format. (8589934591 bytes) - -@item newc -The new (SVR4) portable format, which supports file systems having more -than 65536 i-nodes. (4294967295 bytes) - -@item crc -The new (SVR4) portable format with a checksum added. - -@item tar -The old tar format. (8589934591 bytes) - -@item ustar -The POSIX.1 tar format. Also recognizes GNU tar archives, which are -similar but not identical. (8589934591 bytes) - -@item hpbin -The obsolete binary format used by HPUX's cpio (which stores device -files differently). - -@item hpodc -The portable format used by HPUX's cpio (which stores device files -differently). -@end table - -@item -i -@itemx --extract -Run in copy-in mode. -@xref{Copy-in mode}. - -@item -I @var{archive} -Archive filename to use instead of standard input. To use a tape drive -on another machine as the archive, use a filename that starts with -@samp{@var{hostname}:}, where @var{hostname} is the name or IP address -of the remote host. The hostname can be preceded by a username and an @samp{@@} to -access the remote tape drive as that user, if you have permission to do -so (typically an entry in that user's @file{~/.rhosts} file). - -@item -k -Ignored; for compatibility with other versions of cpio. - -@item -l -@itemx --link -Link files instead of copying them, when possible. - -@item -L -@itemx --dereference -Copy the file that a symbolic link points to, rather than the symbolic -link itself. - -@item -m -@itemx --preserve-modification-time -Retain previous file modification times when creating files. - -@item -M @var{message} -@itemx --message=@var{message} -Print @var{message} when the end of a volume of the backup media (such as a -tape or a floppy disk) is reached, to prompt the user to insert a new -volume. If @var{message} contains the string @samp{%d}, it is replaced by the -current volume number (starting at 1). - -@item -n -@itemx --numeric-uid-gid -Show numeric UID and GID instead of translating them into names when using the -@option{--verbose} option. - -@item --no-absolute-filenames -Create all files relative to the current directory in copy-in mode, even -if they have an absolute file name in the archive. - -@item --no-preserve-owner -Do not change the ownership of the files; leave them owned by the user -extracting them. This is the default for non-root users, so that users -on System V don't inadvertantly give away files. This option can be -used in copy-in mode and copy-pass mode - -@item -o -@itemx --create -Run in copy-out mode. -@xref{Copy-out mode}. - -@item -O @var{archive} -Archive filename to use instead of standard output. To use a tape drive -on another machine as the archive, use a filename that starts with -@samp{@var{hostname}:}, where @var{hostname} is the name or IP address -of the machine. The hostname can be preceded by a username and an @samp{@@} to -access the remote tape drive as that user, if you have permission to do -so (typically an entry in that user's @file{~/.rhosts} file). - -@item --only-verify-crc -Verify the CRC's of each file in the archive, when reading a CRC format -archive. Don't actually extract the files. - -@item -p -@itemx --pass-through -Run in copy-pass mode. -@xref{Copy-pass mode}. - -@item --quiet -Do not print the number of blocks copied. - -@item -r -@itemx --rename -Interactively rename files. - -@item -R @var{owner} -@itemx --owner @var{owner} - -In copy-in and copy-pass mode, set the ownership of all files created -to the specified @var{owner} (this operation is allowed only for the -super-user). In copy-out mode, store the supplied owner information in -the archive. - -The argument can be either the user name or the user name -and group name, separated by a dot or a colon, or the group name, -preceeded by a dot or a colon, as shown in the examples below: - -@smallexample -@group -cpio --owner smith -cpio --owner smith: -cpio --owner smith:users -cpio --owner :users -@end group -@end smallexample - -@noindent -If the group is omitted but the @samp{:} or @samp{.} separator is -given, as in the second example. the given user's login group will be -used. - -@item --rsh-command=@var{command} -Notifies cpio that is should use @var{command} to communicate with remote -devices. - -@item -s -@itemx --swap-bytes -Swap the bytes of each halfword (pair of bytes) in the files. This option -can be used in copy-in mode. - -@item -S -@itemx --swap-halfwords -Swap the halfwords of each word (4 bytes) in the files. This option may -be used in copy-in mode. - -@item --sparse -Write files with large blocks of zeros as sparse files. This option is -used in copy-in and copy-pass modes. - -@item -t -@itemx --list -Print a table of contents of the input. - -@item --to-stdout -Extract files to standard output. This option may be used in copy-in mode. - -@item -u -@itemx --unconditional -Replace all files, without asking whether to replace -existing newer files with older files. - -@item -v -@itemx --verbose -List the files processed, or with @option{-t}, give an @samp{ls -l} style -table of contents listing. In a verbose table of contents of a ustar -archive, user and group names in the archive that do not exist on the -local system are replaced by the names that correspond locally to the -numeric UID and GID stored in the archive. - -@item -V -@itemx --dot -Print a @samp{.} for each file processed. - -@item --version -Print the cpio program version number and exit. -@end table - - -@node Media, Reports, Invoking cpio, Top -@comment node-name, next, previous, up -@chapter Magnetic Media -@cindex magnetic media - -Archives are usually written on removable media--tape cartridges, mag -tapes, or floppy disks. - -The amount of data a tape or disk holds depends not only on its size, -but also on how it is formatted. A 2400 foot long reel of mag tape -holds 40 megabytes of data when formated at 1600 bits per inch. The -physically smaller EXABYTE tape cartridge holds 2.3 gigabytes. - -Magnetic media are re-usable--once the archive on a tape is no longer -needed, the archive can be erased and the tape or disk used over. Media -quality does deteriorate with use, however. Most tapes or disks should -be disgarded when they begin to produce data errors. - -Magnetic media are written and erased using magnetic fields, and should -be protected from such fields to avoid damage to stored data. Sticking -a floppy disk to a filing cabinet using a magnet is probably not a good -idea. - -@node Reports, Concept Index, Media, Top -@chapter Reporting bugs or suggestions - -It is possible you will encounter a bug in @command{cpio}. -If this happens, we would like to hear about it. As the purpose of bug -reporting is to improve software, please be sure to include maximum -information when reporting a bug. The information needed is: - -@itemize @bullet -@item Version of the package you are using. -@item Compilation options used when configuring the package. -@item Conditions under which the bug appears. -@end itemize - -Send your report to <bug-cpio@@gnu.org>. Allow us a couple of -days to answer. - -@node Concept Index, , Reports, Top -@comment node-name, next, previous, up -@unnumbered Concept Index -@printindex cp -@contents -@bye
signature.asc
Description: Digital signature
