{
"content": [
{
"type": "text",
"text": "# cpio(1) (man)\n\n## TLDR\n\n> Copy files in and out of archives.\n\n- Take a list of file names from `stdin` and add them onto an archive (copy-[o]ut) in cpio's binary forma:\n `echo \"{{path/to/file1 path/to/file2 ...}}\" | cpio {{-o|--create}} > {{archive.cpio}}`\n- Copy all files and directories in a directory and add them onto an archive (copy-[o]ut), in verbose mode:\n `find {{path/to/directory}} | cpio {{-ov|--create --verbose}} > {{archive.cpio}}`\n- Pick all files from an archive (copy-[i]n), generating directories where needed, in verbose mode:\n `cpio < {{archive.cpio}} {{-idv|--extract --make-directories --verbose}}`\n\n*Source: tldr-pages*\n\n---\n\n**Summary:** cpio - copy files to and from archives\n\n**Synopsis:** cpio {-o|--create} [-0acvABLV] [-C BYTES] [-H FORMAT] [-M MESSAGE] [-O [[USER@]HOST:]ARCHIVE]\n[-F [[USER@]HOST:]ARCHIVE] [--file=[[USER@]HOST:]ARCHIVE] [--format=FORMAT] [--message=MES‐\nSAGE] [--null] [--reset-access-time] [--verbose] [--dot] [--append] [--block-size=blocks]\n[--dereference] [--io-size=BYTES] [--quiet] [--force-local] [--rsh-command=COMMAND] < name-\nlist [> archive]\ncpio {-i|--extract} [-bcdfmnrtsuvBSV] [-C BYTES] [-E FILE] [-H FORMAT] [-M MESSAGE] [-R\n[USER][:.][GROUP]] [-I [[USER@]HOST:]ARCHIVE] [-F [[USER@]HOST:]ARCHIVE]\n[--file=[[USER@]HOST:]ARCHIVE] [--make-directories] [--nonmatching] [--preserve-modifica‐‐\ntion-time] [--numeric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] [--dot] [--uncon‐‐\nditional] [--verbose] [--block-size=BLOCKS] [--swap-halfwords] [--io-size=BYTES] [--pat‐‐\ntern-file=FILE] [--format=FORMAT] [--owner=[USER][:.][GROUP]] [--no-preserve-owner] [--mes‐‐\nsage=MESSAGE] [--force-local] [--no-absolute-filenames] [--sparse] [--only-verify-crc]\n[--to-stdout] [--quiet] [--rsh-command=COMMAND] [pattern...] [< archive]\ncpio {-p|--pass-through} [-0adlmuvLV] [-R [USER][:.][GROUP]] [--null] [--reset-access-time]\n[--make-directories] [--link] [--quiet] [--preserve-modification-time] [--unconditional]\n[--verbose] [--dot] [--dereference] [--owner=[USER][:.][GROUP]] [--no-preserve-owner]\n[--sparse] destination-directory < name-list\ncpio {-?|--help|--usage|--version}\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -B | — | — | |\n| -H | — | — | |\n| -C | — | — | Set the I/O block size to the given NUMBER of bytes. |\n| -D | — | — | Change to directory DIR. |\n| — | --force-local | — | Archive file is local, even if its name contains colons. |\n| -H | — | — | Use given archive FORMAT. Valid formats are (the number in parentheses gives maximum size for individual archive member) |\n| -R | — | — | In copy-in and copy-pass mode, set the ownership of all files created to the specified USER and/or GROUP. In copy-out mo |\n| — | --quiet | — | Do not print the number of blocks copied at the end of the run. --rsh-command=COMMAND Use remote COMMAND instead of rsh. |\n| -v | --verbose | — | Verbosely list the files processed. |\n| -V | --dot | — | Print a \".\" for each file processed. |\n| -W | — | — | Controlsи warning display. The FLAG is one of none, to disable all warnings, all to enable them, truncate, to enable war |\n| -F | — | — | Use this ARCHIVE-FILE instead of standard input (in copy-in mode) or standard output (in copy-out mode). Optional USER a |\n| -M | — | — | Print STRING when the end of a volume of the backup media is reached. |\n| -b | --swap | — | Swap both halfwords of words and bytes of halfwords in the data. Equivalent to -sS. |\n| -f | --nonmatching | — | Only copy files that do not match any of the given patterns. |\n| -n | --numeric-uid-gid | — | In the verbose table of contents listing, show numeric UID and GID. |\n| -r | --rename | — | Interactively rename files. |\n| -s | --swap-bytes | — | Swap the bytes of each halfword in the files. |\n| -S | --swap-halfwords | — | Swap the halfwords of each word (4 bytes) in the files. |\n| — | --to-stdout | — | Extract files to standard output. |\n| -E | — | — | Read additional patterns specifying filenames to extract or list from FILE. |\n| — | --only-verify-crc | — | When reading a CRC format archive, only verify the CRC's of each file in the archive, without actually extracting the fi |\n| -A | --append | — | Append to an existing archive. --device-independent, --reproducible Create reproducible archives. This is equivalent to |\n| — | --ignore-devno | — | Store 0 in the device number field of each archive member, instead of the actual de‐ vice number. |\n| -O | — | — | Use ARCHIVE-NAME instead of standard output. Optional USER and HOST specify the user and host names in case of a remote |\n| — | --renumber-inodes | — | Renumber inodes when storing them in the archive. |\n| -l | --link | — | Link files instead of copying them, when possible. |\n| — | --absolute-filenames | — | Do not strip file system prefix components from the file names. This is the default. |\n| — | --no-absolute-filenames | — | Create all files relative to the current directory. |\n| -0 | --null | — | Filenames in the list are delimited by null characters instead of newlines. |\n| -a | --reset-access-time | — | Reset the access times of files after reading them. |\n| -I | — | — | Use ARCHIVE-NAME instead of standard input. Optional USER and HOST specify the user and host names in case of a remote a |\n| -L | --dereference | — | Dereference symbolic links (copy the files that they point to instead of copying the links). |\n| -d | --make-directories | — | Create leading directories where needed. |\n| -m | --preserve-modification-time | — | Retain previous file modification times when creating files. |\n| — | --no-preserve-owner | — | Do not change the ownership of the files. |\n| — | --sparse | — | Write files with large blocks of zeros as sparse files. |\n| -u | --unconditional | — | Replace all files unconditionally. |\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (22 lines)\n- **REPORTING BUGS** (8 lines)\n- **SEE ALSO** (2 lines)\n- **DESCRIPTION** (6 lines) — 5 subsections\n - -o --create (4 lines)\n - -i --extract (5 lines)\n - -p --pass-through (6 lines)\n - --usage (2 lines)\n - --version (2 lines)\n- **OPTIONS** (1 lines) — 46 subsections\n - Operation modifiers valid in any mode (3 lines)\n - -B (1 lines)\n - -c -H (1 lines)\n - -C --io-size= (2 lines)\n - -D --directory= (2 lines)\n - --force-local (2 lines)\n - -H --format= (23 lines)\n - -R --owner= (11 lines)\n - --quiet (5 lines)\n - -v --verbose (2 lines)\n - -V --dot (2 lines)\n - -W --warning= (6 lines)\n - Operation modifiers valid in copy-in and copy-out modes (1 lines)\n - -F --file= (4 lines)\n - -M --message= (2 lines)\n - Operation modifiers valid only in copy-in mode (1 lines)\n - -b --swap (2 lines)\n - -f --nonmatching (2 lines)\n - -n --numeric-uid-gid (2 lines)\n - -r --rename (2 lines)\n - -s --swap-bytes (2 lines)\n - -S --swap-halfwords (2 lines)\n - --to-stdout (2 lines)\n - -E --pattern-file= (2 lines)\n - --only-verify-crc (3 lines)\n - Operation modifiers valid only in copy-out mode (1 lines)\n - -A --append (5 lines)\n - --ignore-devno (3 lines)\n - -O (6 lines)\n - --renumber-inodes (2 lines)\n - Operation modifiers valid only in copy-pass mode (1 lines)\n - -l --link (2 lines)\n - Operation modifiers valid in copy-in and copy-out modes (1 lines)\n - --absolute-filenames (2 lines)\n - --no-absolute-filenames (2 lines)\n - Operation modifiers valid in copy-out and copy-pass modes (1 lines)\n - -0 --null (2 lines)\n - -a --reset-access-time (2 lines)\n - -I (6 lines)\n - -L --dereference (3 lines)\n - Operation modifiers valid in copy-in and copy-pass modes (1 lines)\n - -d --make-directories (2 lines)\n - -m --preserve-modification-time (2 lines)\n - --no-preserve-owner (2 lines)\n - --sparse (2 lines)\n - -u --unconditional (2 lines)\n- **RETURN VALUE** (3 lines)\n- **BUG REPORTS** (2 lines)\n- **COPYRIGHT** (9 lines)\n\n## Full Content\n\n### NAME\n\ncpio - copy files to and from archives\n\n### SYNOPSIS\n\ncpio {-o|--create} [-0acvABLV] [-C BYTES] [-H FORMAT] [-M MESSAGE] [-O [[USER@]HOST:]ARCHIVE]\n[-F [[USER@]HOST:]ARCHIVE] [--file=[[USER@]HOST:]ARCHIVE] [--format=FORMAT] [--message=MES‐\nSAGE] [--null] [--reset-access-time] [--verbose] [--dot] [--append] [--block-size=blocks]\n[--dereference] [--io-size=BYTES] [--quiet] [--force-local] [--rsh-command=COMMAND] < name-\nlist [> archive]\n\ncpio {-i|--extract} [-bcdfmnrtsuvBSV] [-C BYTES] [-E FILE] [-H FORMAT] [-M MESSAGE] [-R\n[USER][:.][GROUP]] [-I [[USER@]HOST:]ARCHIVE] [-F [[USER@]HOST:]ARCHIVE]\n[--file=[[USER@]HOST:]ARCHIVE] [--make-directories] [--nonmatching] [--preserve-modifica‐‐\ntion-time] [--numeric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] [--dot] [--uncon‐‐\nditional] [--verbose] [--block-size=BLOCKS] [--swap-halfwords] [--io-size=BYTES] [--pat‐‐\ntern-file=FILE] [--format=FORMAT] [--owner=[USER][:.][GROUP]] [--no-preserve-owner] [--mes‐‐\nsage=MESSAGE] [--force-local] [--no-absolute-filenames] [--sparse] [--only-verify-crc]\n[--to-stdout] [--quiet] [--rsh-command=COMMAND] [pattern...] [< archive]\n\ncpio {-p|--pass-through} [-0adlmuvLV] [-R [USER][:.][GROUP]] [--null] [--reset-access-time]\n[--make-directories] [--link] [--quiet] [--preserve-modification-time] [--unconditional]\n[--verbose] [--dot] [--dereference] [--owner=[USER][:.][GROUP]] [--no-preserve-owner]\n[--sparse] destination-directory < name-list\n\ncpio {-?|--help|--usage|--version}\n\n### REPORTING BUGS\n\nReport cpio bugs to bug-cpio@gnu.org\n\nGNU cpio home page: \n\nGeneral help using GNU software: \n\nReport cpio translation bugs to \n\n### SEE ALSO\n\ntar(1), rmt(8), mt(1).\n\n### DESCRIPTION\n\nGNU cpio copies files between archives and directories. It supports the following archive\nformats: old binary cpio, old portable cpio, SVR4 cpio with and without checksum, HP cpio,\nand various tar formats.\n\nThe operation mode is requested by one of the following options:\n\n#### -o --create\n\nCopy-out. Read a list of file names from the standard input and create on the stan‐\ndard output (unless overridden by the --file option) an archive containing these\nfiles.\n\n#### -i --extract\n\nCopy-in. Read the archive from standard input (or from the file supplied with the\n--file option) and extract files from it, or (if the -t option is given) list its con‐\ntents to the standard output. If one or more patterns are supplied, read or list only\nfiles matching these patterns. The -t option alone implies -i.\n\n#### -p --pass-through\n\nPass-through. Read a list of file names from the standard input and copy them to the\nspecified directory.\n\n-?, --help\nGive a short help summary and exit.\n\n#### --usage\n\nPrint a short usage message and exit.\n\n#### --version\n\nPrint program version and exit.\n\n### OPTIONS\n\n#### Operation modifiers valid in any mode\n\n--block-size=BLOCK-SIZE\nSet the I/O block size to BLOCK-SIZE * 512 bytes.\n\n#### -B\n\n#### -c -H\n\n#### -C --io-size=\n\nSet the I/O block size to the given NUMBER of bytes.\n\n#### -D --directory=\n\nChange to directory DIR.\n\n#### --force-local\n\nArchive file is local, even if its name contains colons.\n\n#### -H --format=\n\nUse given archive FORMAT. Valid formats are (the number in parentheses gives maximum\nsize for individual archive member):\n\nbin The obsolete binary format. (2147483647 bytes)\n\nodc The old (POSIX.1) portable format. (8589934591 bytes)\n\nnewc The new (SVR4) portable format, which supports file systems having more than\n65536 i-nodes. (4294967295 bytes)\n\ncrc The new (SVR4) portable format with a checksum added.\n\ntar The old tar format. (8589934591 bytes)\n\nustar The POSIX.1 tar format. Also recognizes GNU tar archives, which are similar\nbut not identical. (8589934591 bytes)\n\nhpbin The obsolete binary format used by HPUX's cpio (which stores device files dif‐\nferently).\n\nhpodc The portable format used by HPUX's cpio (which stores device files differ‐\nently).\n\n#### -R --owner=\n\nIn copy-in and copy-pass mode, set the ownership of all files created to the specified\nUSER and/or GROUP. In copy-out mode, store the supplied owner information in the ar‐\nchive.\n\nUSER and GROUP are first looked up in the system user and group databases. If not\nfound, cpio checks if they consist of decimal digits only and, if so, treats them as\nnumeric UID and GID, correspondingly.\n\nTo avoid the lookup and ensure that arguments are treated as numeric values, prefix\nthem with a plus sign, e.g.: -R +0:+0.\n\n#### --quiet\n\nDo not print the number of blocks copied at the end of the run.\n\n--rsh-command=COMMAND\nUse remote COMMAND instead of rsh.\n\n#### -v --verbose\n\nVerbosely list the files processed.\n\n#### -V --dot\n\nPrint a \".\" for each file processed.\n\n#### -W --warning=\n\nControlsи warning display. The FLAG is one of none, to disable all warnings, all to\nenable them, truncate, to enable warnings about field truncation, and no-truncate, to\ndisable them.\n\nMultiple -W options accumulate.\n\n#### Operation modifiers valid in copy-in and copy-out modes\n\n#### -F --file=\n\nUse this ARCHIVE-FILE instead of standard input (in copy-in mode) or standard output\n(in copy-out mode). Optional USER and HOST specify the user and host names in case of\na remote archive.\n\n#### -M --message=\n\nPrint STRING when the end of a volume of the backup media is reached.\n\n#### Operation modifiers valid only in copy-in mode\n\n#### -b --swap\n\nSwap both halfwords of words and bytes of halfwords in the data. Equivalent to -sS.\n\n#### -f --nonmatching\n\nOnly copy files that do not match any of the given patterns.\n\n#### -n --numeric-uid-gid\n\nIn the verbose table of contents listing, show numeric UID and GID.\n\n#### -r --rename\n\nInteractively rename files.\n\n#### -s --swap-bytes\n\nSwap the bytes of each halfword in the files.\n\n#### -S --swap-halfwords\n\nSwap the halfwords of each word (4 bytes) in the files.\n\n#### --to-stdout\n\nExtract files to standard output.\n\n#### -E --pattern-file=\n\nRead additional patterns specifying filenames to extract or list from FILE.\n\n#### --only-verify-crc\n\nWhen reading a CRC format archive, only verify the CRC's of each file in the archive,\nwithout actually extracting the files.\n\n#### Operation modifiers valid only in copy-out mode\n\n#### -A --append\n\nAppend to an existing archive.\n\n--device-independent, --reproducible\nCreate reproducible archives. This is equivalent to --ignore-devno --renumber-inodes.\n\n#### --ignore-devno\n\nStore 0 in the device number field of each archive member, instead of the actual de‐\nvice number.\n\n#### -O\n\nUse ARCHIVE-NAME instead of standard output. Optional USER and HOST specify the user\nand host names in case of a remote archive.\n\nThe output archive name can be specified wither using this option, or using -F\n(--file), but not both.\n\n#### --renumber-inodes\n\nRenumber inodes when storing them in the archive.\n\n#### Operation modifiers valid only in copy-pass mode\n\n#### -l --link\n\nLink files instead of copying them, when possible.\n\n#### Operation modifiers valid in copy-in and copy-out modes\n\n#### --absolute-filenames\n\nDo not strip file system prefix components from the file names. This is the default.\n\n#### --no-absolute-filenames\n\nCreate all files relative to the current directory.\n\n#### Operation modifiers valid in copy-out and copy-pass modes\n\n#### -0 --null\n\nFilenames in the list are delimited by null characters instead of newlines.\n\n#### -a --reset-access-time\n\nReset the access times of files after reading them.\n\n#### -I\n\nUse ARCHIVE-NAME instead of standard input. Optional USER and HOST specify the user\nand host names in case of a remote archive.\n\nThe input archive name can be specified wither using this option, or using -F\n(--file), but not both.\n\n#### -L --dereference\n\nDereference symbolic links (copy the files that they point to instead of copying the\nlinks).\n\n#### Operation modifiers valid in copy-in and copy-pass modes\n\n#### -d --make-directories\n\nCreate leading directories where needed.\n\n#### -m --preserve-modification-time\n\nRetain previous file modification times when creating files.\n\n#### --no-preserve-owner\n\nDo not change the ownership of the files.\n\n#### --sparse\n\nWrite files with large blocks of zeros as sparse files.\n\n#### -u --unconditional\n\nReplace all files unconditionally.\n\n### RETURN VALUE\n\nGNU cpio exits with code 0 if it was able to successfully complete the requested operation.\nOn errors, it exits with code 2.\n\n### BUG REPORTS\n\nReport bugs to .\n\n### COPYRIGHT\n\nCopyright © 2014 Free Software Foundation, Inc.\nLicense GPLv3+: GNU GPL version 3 or later \nThis is free software: you are free to change and redistribute it. There is NO WARRANTY, to\nthe extent permitted by law.\n\n\n\n\nCPIO June 21, 2018 CPIO(1)\n\n"
}
],
"structuredContent": {
"command": "cpio",
"section": "1",
"mode": "man",
"summary": "cpio - copy files to and from archives",
"synopsis": "cpio {-o|--create} [-0acvABLV] [-C BYTES] [-H FORMAT] [-M MESSAGE] [-O [[USER@]HOST:]ARCHIVE]\n[-F [[USER@]HOST:]ARCHIVE] [--file=[[USER@]HOST:]ARCHIVE] [--format=FORMAT] [--message=MES‐\nSAGE] [--null] [--reset-access-time] [--verbose] [--dot] [--append] [--block-size=blocks]\n[--dereference] [--io-size=BYTES] [--quiet] [--force-local] [--rsh-command=COMMAND] < name-\nlist [> archive]\ncpio {-i|--extract} [-bcdfmnrtsuvBSV] [-C BYTES] [-E FILE] [-H FORMAT] [-M MESSAGE] [-R\n[USER][:.][GROUP]] [-I [[USER@]HOST:]ARCHIVE] [-F [[USER@]HOST:]ARCHIVE]\n[--file=[[USER@]HOST:]ARCHIVE] [--make-directories] [--nonmatching] [--preserve-modifica‐‐\ntion-time] [--numeric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] [--dot] [--uncon‐‐\nditional] [--verbose] [--block-size=BLOCKS] [--swap-halfwords] [--io-size=BYTES] [--pat‐‐\ntern-file=FILE] [--format=FORMAT] [--owner=[USER][:.][GROUP]] [--no-preserve-owner] [--mes‐‐\nsage=MESSAGE] [--force-local] [--no-absolute-filenames] [--sparse] [--only-verify-crc]\n[--to-stdout] [--quiet] [--rsh-command=COMMAND] [pattern...] [< archive]\ncpio {-p|--pass-through} [-0adlmuvLV] [-R [USER][:.][GROUP]] [--null] [--reset-access-time]\n[--make-directories] [--link] [--quiet] [--preserve-modification-time] [--unconditional]\n[--verbose] [--dot] [--dereference] [--owner=[USER][:.][GROUP]] [--no-preserve-owner]\n[--sparse] destination-directory < name-list\ncpio {-?|--help|--usage|--version}",
"tldr_summary": "Copy files in and out of archives.",
"tldr_examples": [
{
"description": "Take a list of file names from `stdin` and add them onto an archive (copy-[o]ut) in cpio's binary forma",
"command": "echo \"{{path/to/file1 path/to/file2 ...}}\" | cpio {{-o|--create}} > {{archive.cpio}}"
},
{
"description": "Copy all files and directories in a directory and add them onto an archive (copy-[o]ut), in verbose mode",
"command": "find {{path/to/directory}} | cpio {{-ov|--create --verbose}} > {{archive.cpio}}"
},
{
"description": "Pick all files from an archive (copy-[i]n), generating directories where needed, in verbose mode",
"command": "cpio < {{archive.cpio}} {{-idv|--extract --make-directories --verbose}}"
}
],
"tldr_source": "official",
"flags": [
{
"flag": "-B",
"long": null,
"arg": null,
"description": ""
},
{
"flag": "-H",
"long": null,
"arg": null,
"description": ""
},
{
"flag": "-C",
"long": null,
"arg": null,
"description": "Set the I/O block size to the given NUMBER of bytes."
},
{
"flag": "-D",
"long": null,
"arg": null,
"description": "Change to directory DIR."
},
{
"flag": "",
"long": "--force-local",
"arg": null,
"description": "Archive file is local, even if its name contains colons."
},
{
"flag": "-H",
"long": null,
"arg": null,
"description": "Use given archive FORMAT. Valid formats are (the number in parentheses gives maximum size for individual archive member): 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 dif‐ ferently). hpodc The portable format used by HPUX's cpio (which stores device files differ‐ ently)."
},
{
"flag": "-R",
"long": null,
"arg": null,
"description": "In copy-in and copy-pass mode, set the ownership of all files created to the specified USER and/or GROUP. In copy-out mode, store the supplied owner information in the ar‐ chive. USER and GROUP are first looked up in the system user and group databases. If not found, cpio checks if they consist of decimal digits only and, if so, treats them as numeric UID and GID, correspondingly. To avoid the lookup and ensure that arguments are treated as numeric values, prefix them with a plus sign, e.g.: -R +0:+0."
},
{
"flag": "",
"long": "--quiet",
"arg": null,
"description": "Do not print the number of blocks copied at the end of the run. --rsh-command=COMMAND Use remote COMMAND instead of rsh."
},
{
"flag": "-v",
"long": "--verbose",
"arg": null,
"description": "Verbosely list the files processed."
},
{
"flag": "-V",
"long": "--dot",
"arg": null,
"description": "Print a \".\" for each file processed."
},
{
"flag": "-W",
"long": null,
"arg": null,
"description": "Controlsи warning display. The FLAG is one of none, to disable all warnings, all to enable them, truncate, to enable warnings about field truncation, and no-truncate, to disable them. Multiple -W options accumulate."
},
{
"flag": "-F",
"long": null,
"arg": null,
"description": "Use this ARCHIVE-FILE instead of standard input (in copy-in mode) or standard output (in copy-out mode). Optional USER and HOST specify the user and host names in case of a remote archive."
},
{
"flag": "-M",
"long": null,
"arg": null,
"description": "Print STRING when the end of a volume of the backup media is reached."
},
{
"flag": "-b",
"long": "--swap",
"arg": null,
"description": "Swap both halfwords of words and bytes of halfwords in the data. Equivalent to -sS."
},
{
"flag": "-f",
"long": "--nonmatching",
"arg": null,
"description": "Only copy files that do not match any of the given patterns."
},
{
"flag": "-n",
"long": "--numeric-uid-gid",
"arg": null,
"description": "In the verbose table of contents listing, show numeric UID and GID."
},
{
"flag": "-r",
"long": "--rename",
"arg": null,
"description": "Interactively rename files."
},
{
"flag": "-s",
"long": "--swap-bytes",
"arg": null,
"description": "Swap the bytes of each halfword in the files."
},
{
"flag": "-S",
"long": "--swap-halfwords",
"arg": null,
"description": "Swap the halfwords of each word (4 bytes) in the files."
},
{
"flag": "",
"long": "--to-stdout",
"arg": null,
"description": "Extract files to standard output."
},
{
"flag": "-E",
"long": null,
"arg": null,
"description": "Read additional patterns specifying filenames to extract or list from FILE."
},
{
"flag": "",
"long": "--only-verify-crc",
"arg": null,
"description": "When reading a CRC format archive, only verify the CRC's of each file in the archive, without actually extracting the files."
},
{
"flag": "-A",
"long": "--append",
"arg": null,
"description": "Append to an existing archive. --device-independent, --reproducible Create reproducible archives. This is equivalent to --ignore-devno --renumber-inodes."
},
{
"flag": "",
"long": "--ignore-devno",
"arg": null,
"description": "Store 0 in the device number field of each archive member, instead of the actual de‐ vice number."
},
{
"flag": "-O",
"long": null,
"arg": null,
"description": "Use ARCHIVE-NAME instead of standard output. Optional USER and HOST specify the user and host names in case of a remote archive. The output archive name can be specified wither using this option, or using -F (--file), but not both."
},
{
"flag": "",
"long": "--renumber-inodes",
"arg": null,
"description": "Renumber inodes when storing them in the archive."
},
{
"flag": "-l",
"long": "--link",
"arg": null,
"description": "Link files instead of copying them, when possible."
},
{
"flag": "",
"long": "--absolute-filenames",
"arg": null,
"description": "Do not strip file system prefix components from the file names. This is the default."
},
{
"flag": "",
"long": "--no-absolute-filenames",
"arg": null,
"description": "Create all files relative to the current directory."
},
{
"flag": "-0",
"long": "--null",
"arg": null,
"description": "Filenames in the list are delimited by null characters instead of newlines."
},
{
"flag": "-a",
"long": "--reset-access-time",
"arg": null,
"description": "Reset the access times of files after reading them."
},
{
"flag": "-I",
"long": null,
"arg": null,
"description": "Use ARCHIVE-NAME instead of standard input. Optional USER and HOST specify the user and host names in case of a remote archive. The input archive name can be specified wither using this option, or using -F (--file), but not both."
},
{
"flag": "-L",
"long": "--dereference",
"arg": null,
"description": "Dereference symbolic links (copy the files that they point to instead of copying the links)."
},
{
"flag": "-d",
"long": "--make-directories",
"arg": null,
"description": "Create leading directories where needed."
},
{
"flag": "-m",
"long": "--preserve-modification-time",
"arg": null,
"description": "Retain previous file modification times when creating files."
},
{
"flag": "",
"long": "--no-preserve-owner",
"arg": null,
"description": "Do not change the ownership of the files."
},
{
"flag": "",
"long": "--sparse",
"arg": null,
"description": "Write files with large blocks of zeros as sparse files."
},
{
"flag": "-u",
"long": "--unconditional",
"arg": null,
"description": "Replace all files unconditionally."
}
],
"examples": [],
"see_also": [],
"section_outline": [
{
"name": "NAME",
"lines": 2,
"subsections": []
},
{
"name": "SYNOPSIS",
"lines": 22,
"subsections": []
},
{
"name": "REPORTING BUGS",
"lines": 8,
"subsections": []
},
{
"name": "SEE ALSO",
"lines": 2,
"subsections": []
},
{
"name": "DESCRIPTION",
"lines": 6,
"subsections": [
{
"name": "-o --create",
"lines": 4,
"flag": "-o",
"long": "--create"
},
{
"name": "-i --extract",
"lines": 5,
"flag": "-i",
"long": "--extract"
},
{
"name": "-p --pass-through",
"lines": 6,
"flag": "-p",
"long": "--pass-through"
},
{
"name": "--usage",
"lines": 2,
"long": "--usage"
},
{
"name": "--version",
"lines": 2,
"long": "--version"
}
]
},
{
"name": "OPTIONS",
"lines": 1,
"subsections": [
{
"name": "Operation modifiers valid in any mode",
"lines": 3
},
{
"name": "-B",
"lines": 1,
"flag": "-B"
},
{
"name": "-c -H",
"lines": 1,
"flag": "-H"
},
{
"name": "-C --io-size=",
"lines": 2,
"flag": "-C"
},
{
"name": "-D --directory=",
"lines": 2,
"flag": "-D"
},
{
"name": "--force-local",
"lines": 2,
"long": "--force-local"
},
{
"name": "-H --format=",
"lines": 23,
"flag": "-H"
},
{
"name": "-R --owner=",
"lines": 11,
"flag": "-R"
},
{
"name": "--quiet",
"lines": 5,
"long": "--quiet"
},
{
"name": "-v --verbose",
"lines": 2,
"flag": "-v",
"long": "--verbose"
},
{
"name": "-V --dot",
"lines": 2,
"flag": "-V",
"long": "--dot"
},
{
"name": "-W --warning=",
"lines": 6,
"flag": "-W"
},
{
"name": "Operation modifiers valid in copy-in and copy-out modes",
"lines": 1
},
{
"name": "-F --file=",
"lines": 4,
"flag": "-F"
},
{
"name": "-M --message=",
"lines": 2,
"flag": "-M"
},
{
"name": "Operation modifiers valid only in copy-in mode",
"lines": 1
},
{
"name": "-b --swap",
"lines": 2,
"flag": "-b",
"long": "--swap"
},
{
"name": "-f --nonmatching",
"lines": 2,
"flag": "-f",
"long": "--nonmatching"
},
{
"name": "-n --numeric-uid-gid",
"lines": 2,
"flag": "-n",
"long": "--numeric-uid-gid"
},
{
"name": "-r --rename",
"lines": 2,
"flag": "-r",
"long": "--rename"
},
{
"name": "-s --swap-bytes",
"lines": 2,
"flag": "-s",
"long": "--swap-bytes"
},
{
"name": "-S --swap-halfwords",
"lines": 2,
"flag": "-S",
"long": "--swap-halfwords"
},
{
"name": "--to-stdout",
"lines": 2,
"long": "--to-stdout"
},
{
"name": "-E --pattern-file=",
"lines": 2,
"flag": "-E"
},
{
"name": "--only-verify-crc",
"lines": 3,
"long": "--only-verify-crc"
},
{
"name": "Operation modifiers valid only in copy-out mode",
"lines": 1
},
{
"name": "-A --append",
"lines": 5,
"flag": "-A",
"long": "--append"
},
{
"name": "--ignore-devno",
"lines": 3,
"long": "--ignore-devno"
},
{
"name": "-O",
"lines": 6,
"flag": "-O"
},
{
"name": "--renumber-inodes",
"lines": 2,
"long": "--renumber-inodes"
},
{
"name": "Operation modifiers valid only in copy-pass mode",
"lines": 1
},
{
"name": "-l --link",
"lines": 2,
"flag": "-l",
"long": "--link"
},
{
"name": "Operation modifiers valid in copy-in and copy-out modes",
"lines": 1
},
{
"name": "--absolute-filenames",
"lines": 2,
"long": "--absolute-filenames"
},
{
"name": "--no-absolute-filenames",
"lines": 2,
"long": "--no-absolute-filenames"
},
{
"name": "Operation modifiers valid in copy-out and copy-pass modes",
"lines": 1
},
{
"name": "-0 --null",
"lines": 2,
"flag": "-0",
"long": "--null"
},
{
"name": "-a --reset-access-time",
"lines": 2,
"flag": "-a",
"long": "--reset-access-time"
},
{
"name": "-I",
"lines": 6,
"flag": "-I"
},
{
"name": "-L --dereference",
"lines": 3,
"flag": "-L",
"long": "--dereference"
},
{
"name": "Operation modifiers valid in copy-in and copy-pass modes",
"lines": 1
},
{
"name": "-d --make-directories",
"lines": 2,
"flag": "-d",
"long": "--make-directories"
},
{
"name": "-m --preserve-modification-time",
"lines": 2,
"flag": "-m",
"long": "--preserve-modification-time"
},
{
"name": "--no-preserve-owner",
"lines": 2,
"long": "--no-preserve-owner"
},
{
"name": "--sparse",
"lines": 2,
"long": "--sparse"
},
{
"name": "-u --unconditional",
"lines": 2,
"flag": "-u",
"long": "--unconditional"
}
]
},
{
"name": "RETURN VALUE",
"lines": 3,
"subsections": []
},
{
"name": "BUG REPORTS",
"lines": 2,
"subsections": []
},
{
"name": "COPYRIGHT",
"lines": 9,
"subsections": []
}
]
}
}