cp(1)

cp — 复制文件

名称

cp

概要

cp [-R [-H | -L | -P]] [-f | -i | -n] [-alNpsvx] source_file target_file

cp [-R [-H | -L | -P]] [-f | -i | -n] [-alNpsvx] source_file ... target_directory

cp [-f | -i | -n] [-alNPpsvx] source_file target_file

cp [-f | -i | -n] [-alNPpsvx] source_file ... target_directory

描述

在第一种概要形式中，cp 实用程序将 source_file 的内容复制到 target_file。在第二种概要形式中，每个指定的 source_file 的内容被复制到目标 target_directory。文件本身的名称不会改变。如果 cp 检测到试图将文件复制到自身的操作，复制将失败。

以下选项可用：

-H 如果指定了 -R 选项，则跟随命令行上的符号链接。（遍历目录树时遇到的符号链接不被跟随。）

-L, --dereference 如果指定了 -R 选项，则跟随所有符号链接。

-P, --no-dereference 不跟随任何符号链接。如果指定了 -R 选项，这是默认行为。

-R, --recursive 如果 source_file 指定的是一个目录，cp 将复制该目录以及连接在该处的整个子树。如果 source_file 以 / 结尾，则复制目录的内容而非目录本身。此选项还使得符号链接被复制而非通过间接引用，且 cp 会创建特殊文件而非将其作为普通文件复制。创建的目录与相应源目录具有相同的模式，不受进程 umask 修改。注意，cp 将硬链接文件作为独立文件复制。如果需要保留硬链接，请考虑改用 tar(1)、cpio(1) 或 pax(1)。

-a, --archive 归档模式。等同于 -RpP。

-f, --force 对于每个已存在的目标路径名，移除它并创建一个新文件，无论其权限如何都不提示确认。（-f 选项覆盖任何先前指定的 -i 或 -n 选项。）

-i, --interactive 在复制会覆盖现有文件之前，向标准错误输出写入提示。如果来自标准输入的响应以字符 ‘y’ 或 ‘Y’ 开头，则尝试复制文件。（-i 选项覆盖任何先前指定的 -f 或 -n 选项。）

-l, --link 在层次结构中创建到常规文件的硬链接而非复制。

-N 与 -p 一起使用时，禁止复制文件标志。

-n, --no-clobber 不覆盖现有文件。（-n 选项覆盖任何先前指定的 -f 或 -i 选项。）

-p 在副本中保留每个源文件的以下属性（在权限允许的情况下）：修改时间、访问时间、文件标志、文件模式、ACL、用户 ID 和组 ID。如果用户 ID 和组 ID 无法保留，不会显示错误消息，退出值也不改变。如果源文件的 set-user-ID 位开启且用户 ID 无法保留，则副本的权限中不保留 set-user-ID 位。如果源文件的 set-group-ID 位开启且组 ID 无法保留，则副本的权限中不保留 set-group-ID 位。如果源文件的 set-user-ID 和 set-group-ID 位都开启，且用户 ID 或组 ID 中任一无法保留，则副本的权限中 set-user-ID 和 set-group-ID 位均不保留。

--sort 以（非本地化的）字典顺序访问和遍历源。通常，cp 按源在命令行上列出的顺序访问，如果递归，则按内核返回的顺序遍历其内容，这可能是创建顺序、字典顺序或其他顺序。使用 --sort 时，源按字典顺序访问和遍历。这主要用于测试。

-s, --symbolic-link 在层次结构中创建到常规文件的符号链接而非复制。

-v, --verbose 详细输出，显示每个文件复制时的源路径和目标路径。

-x, --one-file-system 不遍历文件系统挂载点。

对于每个已存在的目标文件，如果权限允许，其内容将被覆盖。除非指定了 -p 选项，否则其模式、用户 ID 和组 ID 保持不变。

在第二种概要形式中，target_directory 必须存在，除非只有一个指定的 source_file 且它是目录并指定了 -R 标志。

如果目标文件不存在，则使用源文件的模式，并按文件模式创建掩码（umask，参见 csh(1)）修改。如果源文件的 set-user-ID 位开启，则该位被移除，除非源文件和目标文件由同一用户拥有。如果源文件的 set-group-ID 位开启，则该位被移除，除非源文件和目标文件属于同一组且用户是该组成员。如果 set-user-ID 和 set-group-ID 位都设置，则必须满足上述所有条件，否则两个位都被移除。

文件创建或覆盖需要适当的权限。

符号链接总是被跟随，除非设置了 -R 标志，此时默认不跟随符号链接。-H 或 -L 标志（与 -R 标志结合使用）会使符号链接按上述方式被跟随。除非指定了 -R 选项，否则 -H 和 -L 选项被忽略。-P 选项可与 -R 一起使用也可不一起使用。这些选项相互覆盖，命令的行为由最后指定的选项决定。

如果 cp 收到 SIGINFO 信号（参见 stty(1) 的 status 参数），当前输入和输出文件以及完成百分比将被写入标准输出。

退出状态

cp 实用程序成功时退出值为 0，发生错误时大于 0。

实例

复制文件 foo 为 bar：

$ cp foo bar

将一组文件复制到 /tmp 目录：

$ cp *.txt /tmp

将目录 junk 及其所有内容（包括任何子目录）复制到 /tmp 目录：

$ cp -R junk /tmp

兼容性

历史版本的 cp 实用程序有 -r 选项。本实现支持该选项，但其行为与历史 FreeBSD 行为不同。强烈建议不要使用此选项，因为其行为依赖于实现。在 FreeBSD 中，-r 是 -RL 的同义词，除非被其他标志修改，否则工作方式相同。-r 的历史实现有所不同，它们在重建层次结构时将特殊文件作为普通文件复制。

-a、-l、-N、-n、-s、-v 和 -x 选项是非标准的，不建议在脚本中使用。

参见

mv(1), umask(2), fts(3), symlink(7)

标准

cp 命令预期与 IEEE Std 1003.2 ("POSIX.2") 兼容。

历史

cp 命令首次出现于 Version 1 AT&T UNIX。