命令行手册

Man » cpio 手册在线 - cpio 手册页的详细在线文档

🌍
cpio - 将文件复制到归档中或从归档中复制出来

概要

cpio {-o|--create} [-0acvABLV] [-C 字节数] [-H 格式] [-M 消息] [-O [[用户@]主机:]归档] [-F
[[用户@]主机:]归档] [--file=[[用户@]主机:]归档] [--format=格式] [--message=消息] [--null] [--reset-access-time] [--verbose] [--dot] [--append] [--block-size=块] [--dereference] [--io-size=字节数] [--quiet] [--force-local] [--rsh-command=命令] < 文件名列表 [> 归档]

cpio {-i|--extract} [-bcdfmnrtsuvBSV] [-C 字节数] [-E 文件] [-H 格式] [-M 消息] [-R [用户][:].][组]] [-I [[用户@]主机:]归档] [-F [[用户@]主机:]归档] [--file=[[用户@]主机:]归档] [--make-directories] [--nonmatching] [--preserve-modification-time] [--numeric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] [--dot] [--unconditional] [--verbose] [--block-size=块] [--swap-halfwords] [--io-size=字节数] [--pattern-file=文件] [--format=格式] [--owner=[用户][:].][组]] [--no-preserve-owner] [--message=消息] [--force-local] [--no-absolute-filenames] [--sparse] [--only-verify-crc] [--to-stdout] [--quiet] [--rsh-command=命令] [模式...] [< 归档]

cpio {-p|--pass-through} [-0adlmuvLV] [-R [用户][:].][组]] [--null] [--reset-access-time] [--make-directories] [--link] [--quiet] [--preserve-modification-time] [--unconditional] [--verbose] [--dot] [--dereference] [--owner=[用户][:].][组]] [--no-preserve-owner] [--sparse] 目标目录 < 文件名列表

cpio {-?|--help|--usage|--version}

报告错误

请向 _ 报告 cpio 错误。

GNU cpio 主页:[http://www.gnu.org/software/cpio/]

使用 GNU 软件的一般帮助:[http://www.gnu.org/gethelp/]

向 [http://translationproject.org/team/] 报告 cpio 翻译错误。

参见

cpio(5)

描述

GNU cpio 在归档和目录之间复制文件。它支持以下归档格式:旧二进制 cpio、旧可移植 cpio、带有校验和和不带校验和的 SVR4 cpio、HP cpio 以及各种 tar 格式。

通过以下选项之一请求操作模式:

-o, --create

复制。从标准输入读取文件列表,并在标准输出(除非被 --file 选项覆盖)上创建一个包含这些文件的归档。

-i, --extract

提取。从标准输入(或通过 --file 选项提供的文件)读取归档,并从中提取文件,或者(如果给定了 -t 选项)将其内容列出到标准输出。如果提供了一个或多个模式,则仅读取或列出与这些模式匹配的文件。单独使用 -t 选项表示 -i。

-p, --pass-through

穿透。从标准输入读取文件列表,并将它们复制到指定的目录。


-?, --help
显示简短的帮助信息并退出。

--usage
打印简短的使用信息并退出。

--version
打印程序版本并退出。

报告错误

将 cpio 错误报告到 _

GNU cpio 主页:[http://www.gnu.org/software/cpio/]

使用 GNU 软件的一般帮助:[http://www.gnu.org/gethelp/]

将 cpio 翻译错误报告到 [http://translationproject.org/team/]

选项

在任何模式下都有效的操作修改器

--block-size=BLOCK-SIZE
将 I/O 块大小设置为 BLOCK-SIZE * 512 字节。

-B
将 I/O 块大小设置为 5120 字节。

-c
使用旧的、可移植的(ASCII)存档格式。 这与 -H odc 相同。

-C, --io-size=NUMBER
将 I/O 块大小设置为给定的 NUMBER 字节。

-D, --directory=DIR
更改为目录 DIR。

--force-local
存档文件是本地文件,即使其名称包含冒号。

-H, --format=FORMAT
使用给定的存档 FORMAT。 有效的格式是(括号中的数字表示单个存档成员的最大大小):

bin    过时的二进制格式。 (2147483647 字节)

odc    旧的(POSIX.1)可移植格式。 (8589934591 字节)

newc   新的(SVR4)可移植格式,支持具有多于 65536 个 inode 的文件系统。 (4294967295 字节)

crc    新的(SVR4)可移植格式,并添加了校验和。

tar    旧的 tar 格式。 (8589934591 字节)

ustar  POSIX.1 tar 格式。 它还识别 GNU tar 存档,后者类似但不相同。 (8589934591 字节)

hpbin  HPUX 的 cpio 使用的过时的二进制格式(以不同的方式存储设备文件)。

hpodc  HPUX 的 cpio 使用的可移植格式(以不同的方式存储设备文件)。

-R, --owner=[USER][:.][GROUP]
在“复制”和“复制传递”模式下,将所有创建的文件的所有权设置为指定的 USER 和/或 GROUP。 在“复制输出”模式下,将提供的所有者信息存储在存档中。

USER 和 GROUP 首先在系统用户和组数据库中查找。 如果未找到,cpio 会检查它们是否仅由十进制数字组成,如果是,则将它们视为数字 UID 和 GID。

为了避免查找并确保参数被视为数值,请在它们前面加上加号,例如:-R +0:+0。

--quiet
不要在运行结束时打印复制的块数。

--rsh-command=COMMAND
使用远程 COMMAND 代替 rsh。

-v, --verbose
详细列出处理的文件。

-V, --dot
为处理的每个文件打印一个“.”。

-W, --warning=FLAG
控制要显示的警告。 FLAG 是以下之一:none,用于禁用所有警告;all,用于启用所有警告;truncate,用于启用关于字段截断的警告;以及 no-truncate,用于禁用它们。

多个 -W 选项会累积。

在“复制”和“复制输出”模式下有效的操作修改器

-F, --file=[[USER@]HOST:]ARCHIVE-FILE
使用此 ARCHIVE-FILE 代替标准输入(在“复制”模式下)或标准输出(在“复制输出”模式下)。 可选的 USER 和 HOST 指定远程存档中的用户名和主机名。

-M, --message=STRING
当达到备份介质卷的末尾时,打印 STRING。

仅在复制入模式下有效的操作修饰符

-b, --swap

交换数据中单词的两个半字以及半字中的字节。等同于 -sS。

-f, --nonmatching

仅复制与给定模式不匹配的文件。

-n, --numeric-uid-gid

在详细的目录列表输出中,显示数值 UID 和 GID。

-r, --rename

交互式地重命名文件。

-s, --swap-bytes

交换文件中每个半字的字节。

-S, --swap-halfwords

交换文件中每个单词(4 个字节)的半字。

--to-stdout

将文件提取到标准输出。

-E, --pattern-file=FILE

从 FILE 读取额外的模式,用于指定要提取或列出的文件名。

--only-verify-crc

在读取 CRC 格式的存档时,仅验证存档中每个文件的 CRC 值,而不实际提取文件。

仅在复制出模式下有效的操作修饰符

-A, --append

追加到现有的存档。

--device-independent, --reproducible

创建可重现的存档。这等同于 --ignore-devno --ignore-dirnlink --renumber-inodes。

--ignore-devno

将存档中每个成员的设备号字段存储为 0,而不是实际的设备号。

--ignore-dirnlink

将存档中每个目录成员的 nlink 字段存储为 2,而不是实际的链接数。

-O [[USER@]HOST:]ARCHIVE-NAME

使用 ARCHIVE-NAME 代替标准输出。可选的 USER 和 HOST 指定用户和主机名,用于远程存档。

输出存档名称可以使用此选项或使用 -F (--file) 指定,但不能同时使用两者。

--renumber-inodes

在将它们存储到存档中时,重新编号 inodes。

仅在复制传递模式下有效的操作修饰符

-l, --link

在可能的情况下,链接文件而不是复制它们。

在复制入和复制出模式下有效的操作修饰符

--absolute-filenames

不从文件名中删除文件系统前缀组件。这是默认设置。

--no-absolute-filenames

将所有文件相对于当前目录创建。

在复制出和复制传递模式下有效的操作修饰符

-0, --null

列表中的文件名由空字符而不是换行符分隔。

-a, --reset-access-time

在读取文件后重置文件的访问时间。

-I [[USER@]HOST:]ARCHIVE-NAME

使用 ARCHIVE-NAME 代替标准输入。可选的 USER 和 HOST 指定用户和主机名,用于远程存档。

输入存档名称可以使用此选项或使用 -F (--file) 指定,但不能同时使用两者。

-L, --dereference

取消引用符号链接(复制它们指向的文件,而不是复制链接)。

在复制入和复制传递模式下有效的操作修饰符

-d, --make-directories

根据需要创建前导目录。

-m, --preserve-modification-time

在创建文件时保留先前的文件修改时间。

--no-preserve-owner

不要更改文件的所有权。

--sparse

将包含大型零块的文件写入稀疏文件。

-u, --unconditional

无条件地替换所有文件。


返回值

GNU cpio 在成功完成所请求的操作时,退出代码为 0。如果出现错误,则退出代码为 2。

参见

tar(1),rmt(8),mt(1)。

错误报告

请将错误报告发送至 <__>。

版权

版权所有 © 2014–2023 自由软件基金会。 许可证 GPLv3+:GNU GPL 第 3 版或更高版本 [http://gnu.org/licenses/gpl.html]。 这是一个自由软件:您可以自由修改和重新分发它。在法律允许的范围内,不提供任何形式的担保。