机器翻译，仅供参考。若有不对，提交 PR。

译者：冰 ice

在线阅读地址：https://man.bsdcn.org/

CHKEY(1)

CHKEY(1)

FreeBSD General Commands Manual

CHKEY(1)

名称

chkey —

更改您的加密密钥

chkey

chkey 实用程序提示用户输入登录密码，并使用它为用户加密一个新的加密密钥，以便存储在 publickey(5) 数据库中。

keylogin(1), publickey(5), keyserv(8), newkey(8)

July 5, 1989

FreeBSD 13.1-RELEASE

APPLY(1)

APPLY(1)

FreeBSD General Commands Manual

APPLY(1)

名称

apply —

将命令应用于一组参数

apply [-a c] [-d] [-#] command argument ...

apply 实用程序依次对每个参数 argument 运行 command 命令。

command 中 “%d” 形式的字符序列，其中 ‘d’ 是从 1 到 9 的数字，被后面的第 d 个未使用的 argument 替换。 在这种情况下，每次执行 command 都会丢弃最大位数的参数。

选项如下：

通常，论点是单独提出的；可选数字 -# 指定要传递给 command 的参数数量。 如果数字为零，则对每个 argument 运行一次 command ，不带参数。

如果 command 中出现任何 “%d” 序列，则忽略 -# 选项。

c

使用 -a 选项可以更改使用字符 ‘%’ 作为魔术字符。

显示本应执行但不实际执行的命令。

以下环境变量影响 apply 的执行：

要使用的 shell 的路径名。 如果未定义此变量，则使用 Bourne shell。

/bin/sh

默认 shell

类似于 ls(1);

比较 `a' 文件和 `b' 文件；

运行 who(1) 5 次；

将当前目录中的所有文件链接到目录 /usr/joe 。

apply 命令出现在 4.2BSD 中。

Rob Pike

command 中的 shell 元字符可能会产生奇怪的效果；最好将复杂的命令用单引号 ('') 括起来。

apply 实用程序无法识别多字节字符。

December 13, 2006

FreeBSD 13.1-RELEASE

BSDCAT(1)

BSDCAT(1)

FreeBSD General Commands Manual

BSDCAT(1)

名称

bsdcat —

扩展文件到标准输出

bsdcat [options] [files]

bsdcat 将文件扩展为标准输出。

bsdcat 通常将文件名作为参数或在管道中使用时读取标准输入。在这两种情况下，它都将解压缩的数据写入标准输出。

解压文件：

bsdcat example.txt.gz > example.txt

在管道中解压缩标准输入：

cat example.txt.gz | bsdcat > example.txt

这两个示例都实现了相同的结果——通过重定向输出来解压缩文件。

bzcat(1) 、 uncompress(1) 、 xzcat(1) 、 zcat(1) 、 libarchive-formats(5)

March 1, 2014

FreeBSD 13.1-RELEASE

ENIGMA(1)

ENIGMA(1)

FreeBSD General Commands Manual

ENIGMA(1)

名称

enigma, crypt —

非常简单的文件加密

enigma [-s] [-k] [password] crypt [-s] [-k] [password]

enigma 实用程序，也称为 crypt 是一个 非常 简单的加密程序，在 “secret-key” 基础上工作。 它作为过滤器运行，即，它加密或解密来自标准输入的数据流，并将结果写入标准输出。 由于它的操作是完全对称的，通过引擎再次输入加密数据流（使用相同的密钥）将对其进行解密。

有几种方法可以为程序提供密钥。 默认情况下，程序会使用 getpass(3) 在控制终端上提示用户输入密钥。 这是提供它的唯一安全方式。

或者，可以在启动程序时将密钥作为唯一的命令行参数 password 提供。 显然，通过这种方式，其他运行 ps(1) 的用户很容易发现密钥。 作为另一种选择，可以为 enigma 提供选项 -k, 它将从环境变量 CrYpTkEy 中获取密钥。 虽然乍一看这似乎比前一个选项更安全，但实际上并非如此，因为环境变量也可以使用 ps(1) 检查。 因此，提供此选项主要是为了与 enigma 的其他实现兼容。

当指定选项 -s 时， enigma 会修改加密引擎，使其更安全一些，但与其他实现不兼容。

enigma 的密码价值相当小。 此处提供此程序只是为了与也提供实现的其他操作系统兼容（通常在此处称为 crypt(1) ）。 对于真正的加密，请参阅 openssl(1) 或 gpg(1) (security/gnupg1) 。

用于在给出选项 -k 时获取密钥

man enigma | enigma > encrypted Enter key: (XXX — key not echoed)

这将创建此手册页的加密形式，并将其存储在 encrypted 的文件中。

enigma XXX < encrypted

这将在终端上显示先前创建的文件。

gpg(1), openssl(1), ps(1), getpass(3)

crypt 的实现在 UNIX 操作系统中非常普遍。- 此实现取自公共领域的 Cryptbreakers Workbench 。

May 8, 2018

FreeBSD 13.1-RELEASE

COLUMN(1)

COLUMN(1)

FreeBSD General Commands Manual

COLUMN(1)

column —

BTSOCKSTAT(1)

BTSOCKSTAT(1)

FreeBSD General Commands Manual

BTSOCKSTAT(1)

btsockstat —

FSYNC(1)

FSYNC(1)

FreeBSD General Commands Manual

FSYNC(1)

fsync —

COLRM(1)

COLRM(1)

FreeBSD General Commands Manual

COLRM(1)

名称

colrm —

从文件中删除列

colrm [start [stop]]

colrm 实用程序从文件的行中删除选定的列。 列定义为一行中的单个字符。 从标准输入读取输入。 输出被写入标准输出。

如果只指定了 start 列，则将写入编号小于 start 列的列。 如果同时指定了 start 列和 stop 列，则将写入编号小于 start 列或大于 stop 列的列。 列编号从一开始，而不是零。

制表符将列计数增加到下一个八的倍数。 退格字符将列计数减一。

LANG 、 LC_ALL 和 LC_CTYPE 环境变量会影响 colrm 的执行，如 environ(7) 中所述。

The colrm utility exits 0 on success, and >0 if an error occurs.

显示低于 3 (c) 和高于 5 (e) 的列：

$ echo -e "abcdefgh\n12345678" | colrm 3 5 abfgh 12678

允许指定大于文件中列数的起始列并显示所有列：

$ echo "abcdefgh" | colrm 100 abcdefgh

使用 1 作为开始列将不显示任何内容：

$ echo "abcdefgh" | colrm 1

awk(1), column(1), cut(1), paste(1)

colrm 实用程序首先出现在 1BSD 中。

Jeff Schriebman 于 1974 年 11 月编写了 colrm 的原始版本。

June 23, 2020

FreeBSD 13.1-RELEASE

ENIGMA(1)

ENIGMA(1)

FreeBSD General Commands Manual

ENIGMA(1)

名称

enigma, crypt —

非常简单的文件加密

enigma [-s] [-k] [password] crypt [-s] [-k] [password]

enigma 实用程序，也称为 crypt 是一个 非常 简单的加密程序，在 “secret-key” 基础上工作。 它作为过滤器运行，即，它加密或解密来自标准输入的数据流，并将结果写入标准输出。 由于它的操作是完全对称的，通过引擎再次输入加密数据流（使用相同的密钥）将对其进行解密。

有几种方法可以为程序提供密钥。 默认情况下，程序会使用 getpass(3) 在控制终端上提示用户输入密钥。 这是提供它的唯一安全方式。

或者，可以在启动程序时将密钥作为唯一的命令行参数 password 提供。 显然，通过这种方式，其他运行 ps(1) 的用户很容易发现密钥。 作为另一种选择，可以为 enigma 提供选项 -k, 它将从环境变量 CrYpTkEy 中获取密钥。 虽然乍一看这似乎比前一个选项更安全，但实际上并非如此，因为环境变量也可以使用 ps(1) 检查。 因此，提供此选项主要是为了与 enigma 的其他实现兼容。

当指定选项 -s 时， enigma 会修改加密引擎，使其更安全一些，但与其他实现不兼容。

enigma 的密码价值相当小。 此处提供此程序只是为了与也提供实现的其他操作系统兼容（通常在此处称为 crypt(1) ）。 对于真正的加密，请参阅 openssl(1) 或 gpg(1) (security/gnupg1) 。

用于在给出选项 -k 时获取密钥

man enigma | enigma > encrypted Enter key: (XXX — key not echoed)

这将创建此手册页的加密形式，并将其存储在 encrypted 的文件中。

enigma XXX < encrypted

这将在终端上显示先前创建的文件。

gpg(1), openssl(1), ps(1), getpass(3)

crypt 的实现在 UNIX 操作系统中非常普遍。- 此实现取自公共领域的 Cryptbreakers Workbench 。

May 8, 2018

FreeBSD 13.1-RELEASE

GROUPS(1)

GROUPS(1)

FreeBSD General Commands Manual

GROUPS(1)

名称

groups —

show group memberships

groups [user]

The groups- 实用程序已被 id(1) 实用程序淘汰，相当于 “id -Gn [user]” 。 建议将命令 “id -p” 用于正常的交互使用。

groups 实用程序显示您（或可选指定的用户）所属的组。

The groups utility exits 0 on success, and >0 if an error occurs.

显示 root 用户所属的组：

$ groups root wheel operator

id(1)

June 6, 1993

FreeBSD 13.1-RELEASE

BASENAME(1)

BASENAME(1)

FreeBSD General Commands Manual

BASENAME(1)

名称

basename, dirname —

返回路径名的文件名或目录部分

basename string [suffix] basename [-a] [-s suffix] string [...] dirname string [...]

basename 实用程序删除任何以 string 中存在的最后一个斜杠 ‘/’ 字符结尾的前缀（在第一次去除尾随斜杠之后）和 suffix 如果给定的话。 如果 suffix 与 string 中的其余字符相同，则不会去除后缀。 结果文件名被写入标准输出。 不存在的后缀将被忽略。 如果指定了 -a ，则每个参数都被视为一个 string ，就好像只使用一个参数调用了 basename 。 如果指定了 -s ，则将 suffix 作为其参数，并将所有其他参数视为 string 。

dirname 实用程序删除文件名部分，从最后一个斜杠 ‘/’ 字符开始到 string 的末尾（在第一次去除尾部斜杠之后），并将结果写入标准输出。

The basename and dirname utilities exit 0 on success, and >0 if an error occurs.

以下行将 shell 变量 FOO 设置为 /usr/bin 。

FOO=`dirname /usr/bin/trail`

csh(1), sh(1), basename(3), dirname(3)

basename 和 dirname 实用程序应与 IEEE Std 1003.2 (“POSIX.2”) 兼容。

basename 和 dirname 实用程序首先出现在 4.4BSD 中。

May 26, 2020

FreeBSD 13.1-RELEASE

CKSUM(1)

CKSUM(1)

FreeBSD General Commands Manual

CKSUM(1)

名称

cksum, sum —

显示文件校验和和块计数

cksum [-o 1 | 2 | 3] [file ...] sum [file ...]

cksum 实用程序将每个输入文件的三个空格分隔字段写入标准输出。 这些字段是校验和 CRC 、文件中的八位字节总数和文件名。 如果未指定文件名，则使用标准输入并且不写入文件名。

sum 实用程序与 cksum 实用程序相同，只是它默认使用历史算法 1，如下所述。 它只是为了兼容性而提供的。

选项如下：

使用历史算法而不是（高级）默认算法。

算法 1 是历史 BSD 系统用作 sum(1) 算法和历史 AT&T System V UNIX 系统在使用 -r 选项时用作 sum(1) 算法的算法。 这是一个 16 位的校验和，每次加法前都有一个右旋转；溢出被丢弃。

算法 2 是历史上 AT&T System V UNIX 系统用作默认 sum(1) 算法的算法。 这是一个 32 位校验和，定义如下：

s = sum of all bytes; r = s % 2^16 + (s % 2^32) / 2^16; cksum = (r % 2^16) + r / 2^16;

算法 3 就是通常所说的 ‘32 位 CRC’ 算法。 这是一个 32 位校验和。

算法 1 和 2 都向标准输出写入与默认算法相同的字段，只是文件大小（以字节为单位）被替换为文件的大小（以块为单位）。 由于历史原因，算法 1 的块大小为 1024，算法 2 的块大小为 512。 部分区块被四舍五入。

使用的默认 CRC 基于网络标准 ISO 8802-3: 1989 中用于 CRC 错误检查的多项式。 CRC 校验和编码由生成多项式定义：

G(x) = x^32 + x^26 + x^23 + x^22 + x^16 + x^12 + x^11 + x^10 + x^8 + x^7 + x^5 + x^4 + x^2 + x + 1

在数学上，与给定文件对应的 CRC 值由以下过程定义：

要评估的 n 位被认为是 n-1 次的 mod 2 多项式 M(x) 的系数。 这 n 位是文件中的位，最高有效位是文件第一个八位字节的最高有效位，最后一位是最后一个八位字节的最低有效位，用零位（如果需要）填充以获得整数个八位位组，后跟一个或多个八位位组，将文件的长度表示为二进制值，最低有效八位位组在前。 使用能够表示该整数的最少八位字节数。

M(x) 乘以 x^32（即左移 32 位）并使用 mod 2 除法除以 G(x)，产生度数 <= 31 的余数 R(x)。

R(x) 的系数被认为是一个 32 位序列。

对位序列进行补码，结果为 CRC。

The cksum and sum utilities exit 0 on success, and >0 if an error occurs.

md5(1)

默认计算与以下 ACM 文章中的伪代码中给出的计算相同。 Dilip V. Sarwate, Computation of Cyclic Redundancy Checks Via Table Lookup, Communications of the Tn ACM, August 1988.

cksum 实用程序应符合 IEEE Std 1003.2-1992 (“POSIX.2”) 。

cksum 实用程序出现在 4.4BSD 中。

April 28, 1995

FreeBSD 13.1-RELEASE

ADDR2LINE(1)

ADDR2LINE(1)

FreeBSD General Commands Manual

ADDR2LINE(1)

addr2line —

CUT(1)

CUT(1)

FreeBSD General Commands Manual

CUT(1)

cut —

CAT(1)

CAT(1)

FreeBSD General Commands Manual

CAT(1)

名称

cat —

连接并打印文件

cat [-belnstuv] [file ...]

cat 实用程序按顺序读取文件，并将它们写入标准输出。 file 操作数按命令行顺序处理。 如果 file 是单个破折号 (‘-’) 或不存在，则 cat 从标准输入读取。 如果 file 是 UNIX 域套接字，则 cat 连接到它，然后读取它直到 EOF 。 这补充了 inetd(8) 中可用的 UNIX 域绑定功能。

选项如下：

对非空白输出行编号，从 1 开始。

显示非打印字符（参见 -v 选项），并在每行的末尾显示一个美元符号 (‘$’) 。

在标准输出文件描述符上设置排他咨询锁。 这个锁是使用 fcntl(2) 和 F_SETLKW 命令设置的。 如果输出文件已经被锁定， cat 将阻塞直到获得锁定。

对输出行编号，从 1 开始。

挤压多个相邻的空行，导致输出为单行距。

显示非打印字符（参见 -v 选项），并将制表符显示为 ‘^I’ 。

禁用输出缓冲。

显示非打印字符，使其可见。 对于 control-X，控制字符打印为 ‘^X’ ；删除字符（八进制 0177）打印为 ‘^?’ 。 Non-ASCII 非 ASCII 字符（设置了高位）打印为 ‘M-’ （用于元），后跟低 7 位的字符。

The cat utility exits 0 on success, and >0 if an error occurs.

命令：

cat file1

将 file1 的内容打印到标准输出。

命令：

cat file1 file2 > file3

将依次将 file1 和 file2 的内容打印到文件 file3, 如果 file3 已经存在则截断它。 有关重定向的更多信息，请参见您的 shell（例如 sh(1) ）的手册页。

命令：

cat file1 - file2 - file3

将打印 file1 的内容，打印从标准输入接收到的数据，直到收到 EOF (‘^D’) 字符，打印 file2 的内容，再次读取并输出标准输入的内容，最后输出 file3 。 请注意，如果标准输入引用了一个文件，那么命令行上的第二个破折号将不起作用，因为当 cat 遇到第一个 ‘-’ 操作数时，文件的全部内容已经被读取并打印了。

head(1), more(1), pr(1), sh(1), tail(1), vis(1), zcat(1), fcntl(2), setbuf(3) Rob Pike, UNIX Style, or cat -v Considered Harmful, USENIX Summer Conference Proceedings, 1983.

cat 实用程序符合 IEEE Std 1003.2-1992 (“POSIX.2”) 规范。

标志 [-belnstv] 是规范的扩展。

cat 实用程序出现在 Version 1 AT&T UNIX 中。 Dennis Ritchie 设计并编写了第一个手册页。 似乎是为了 cat 。

由于用于执行输出重定向的 shell 语言机制，命令 “cat file1 file2 > file1” 将导致 file1 中的原始数据被破坏！

当 -t 或 -v 选项生效时， cat 实用程序无法识别多字节字符。

January 29, 2013

FreeBSD 13.1-RELEASE

FUSER(1)

FUSER(1)

FreeBSD General Commands Manual

FUSER(1)

名称

fuser —

列出打开一个或多个文件的所有进程的 ID

fuser [-cfkmu] [-M core] [-N system] [-s signal] file ...

fuser 实用程序将打开一个或多个命名文件的进程的 PID 写入标准输出。 对于块和字符特殊设备，列出了使用该设备上文件的所有进程。 如果文件被显式打开，则认为文件被进程打开，它是工作目录、根目录、jail 根目录、活动的可执行文本、内核跟踪文件或进程的控制终端。 如果指定了 -m 选项，则 fuser 实用程序还将查看映射文件。

可以使用以下选项：

将文件视为挂载点并报告文件系统中打开的任何文件。

报告必须仅用于命名文件。

向报告的进程发送信号，默认为 (SIGKILL) 。

core

从指定的核心而不是默认的 /dev/kmem 中提取与名称列表关联的值。

也可以搜索映射文件。

system

从指定系统中提取名称列表，而不是从默认系统中引导的内核映像。

signal

使用给定的信号名称而不是默认的 SIGKILL 。

将每个进程关联的用户名写入stderr。

写入 stderr 的以下符号将指示文件的使用方式：

a

该文件仅作为附加打开，指定了 (O_APPEND) 。

c

该文件是进程的当前工作目录。

d

该进程在写入此文件时绕过 fs 缓存，指定了 (O_DIRECT) 。

e

排他锁处于保持状态。

j

该文件是该进程的 jail 根目录。

m

该文件已映射。

r

该文件是进程的根目录。

s

共享锁被持有。

t

该文件是进程的内核跟踪文件。

w

该文件已打开以供写入。

x

该文件是进程的可执行文本。

y

该进程使用此文件作为其控制 tty。

The fuser utility exits 0 on success, and >0 if an error occurs.

命令 ‘fuser -fu .’ 将使用当前目录的进程的进程 ID 写入标准输出，并将这些进程如何使用目录的指示以及与使用该目录的进程关联的用户名写入 stderr。

fstat(1), ps(1), systat(1), iostat(8), pstat(8), vmstat(8)

fuser 实用程序应符合 IEEE Std 1003.1-2004 (“POSIX.1”) 。

fuser 实用程序出现在 FreeBSD 9.0 中。

fuser 实用程序和本手册页由 Stanislav Sedov <> 编写。

由于 fuser 会拍摄系统快照，因此它只在很短的时间内正确。 当通过 kvm(3) 接口工作时，报告将仅限于 fuser 实用程序知道的文件系统（目前只有 cd9660、devfs、nfs、ntfs、nwfs、udf、ufs 和 zfs）。

June 18, 2020

FreeBSD 13.1-RELEASE

ELFDUMP(1)

ELFDUMP(1)

FreeBSD General Commands Manual

ELFDUMP(1)

名称

elfdump —

显示有关 ELF 文件的信息

elfdump -a | -E | -cdeGhinprs [-w file] file

elfdump 实用程序转储有关指定 ELF 文件的各种信息。

选项如下：

转储所有信息。

转储节标题。

转储动态符号。

转储 ELF 标头。

如果 file 是 ELF 文件则返回成功，否则返回失败。 此选项与其他选项互斥。

转储 GOT。

转储散列值。

转储动态解释器。

转储笔记部分。

转储程序头。

转储重定位。

转储符号表。

file

将输出写 file 而不是标准输出。

The elfdump utility exits 0 on success, and >0 if an error occurs.

以下是 elfdump 命令的典型用法示例：

elfdump -a -w output /bin/ls

objdump(1), readelf(1)

AT&T Unix 系统实验室, System V 应用程序二进制接口, .

elfdump 实用程序首次出现在 FreeBSD 5.0 中。

elfdump 实用程序 Jake Burkholder <> 编写。 本手册页由 David O'Brien <> 编写。

没有完全实现 ELF gABI。

November 5, 2018

FreeBSD 13.1-RELEASE

CMP(1)

CMP(1)

FreeBSD General Commands Manual

CMP(1)

名称

cmp —

compare two files

cmp [-l | -s | -x] [-hz] file1 file2 [skip1 [skip2]]

cmp 实用程序比较任何类型的两个文件并将结果写入标准输出。默认情况下，如果文件相同，则 cmp 是静默的；如果它们不同，则报告出现第一个差异的字节和行号。

字节和行从一开始编号。

可以使用以下选项：

不要跟随符号链接。

, --verbose

打印每个差异的字节数（十进制）和不同的字节值（八进制）。

, --silent, --quiet

不打印不同文件；仅返回退出状态。

与 -l 类似，但以十六进制打印并使用零作为文件中第一个字节的索引。

对于常规文件，首先比较文件大小，如果不相等则比较失败。

可选参数 skip1 和 skip2 分别是从 file1 和 file2 开始的字节偏移量，比较将从这里开始。 默认情况下，偏移量是十进制的，但可以通过在其前面加上前导 “0x” 或 “0” 来表示为十六进制或八进制值。

cmp 实用程序以下列值之一退出：

0

这些文件是相同的。

1

文件不同；这包括一个文件与另一个文件的第一部分相同的情况。 在后一种情况下，如果未指定 -s 选项，则 cmp 将写入标准错误，即在较短的文件中已达到 EOF（在发现任何差异之前）。

>1

发生错误。

假设一个名为 example.txt 的文件具有以下内容：

a b c

将标准输入与 example.txt 进行比较：

$ echo -e "a\nb\nc" | cmp - example.txt

与上述相同，但在 stdin 的第三个字节中引入了更改。 显示字节数（十进制）和不同的字节（八进制）：

$ echo -e "a\nR\nc" | cmp -l - example.txt 3 122 142

比较 example.txt 和 /boot/loader.conf 的文件大小，如果不相等则返回 1。 请注意， -z 只能用于常规文件：

$ cmp -z example.txt /boot/loader.conf example.txt /boot/loader.conf differ: size

比较 stdin 和 example.txt ，省略 stdin 的前 4 个字节和 example.txt 的前 2 个字节：

$ echo -e "a\nR\nb\nc" | cmp - example.txt 4 2

diff(1), diff3(1)

cmp 实用程序应与 IEEE Std 1003.2 (“POSIX.2”) 兼容。 -h -、 -x 和 -z 选项是标准的扩展。

在 Version 1 AT&T UNIX 中出现了 cmp 命令。

June 20, 2020

FreeBSD 13.1-RELEASE

AT(1)

AT(1)

FreeBSD General Commands Manual

AT(1)

at, batch,

CP(1)

CP(1)

FreeBSD General Commands Manual

CP(1)

名称

cp —

复制文件

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

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

可以使用以下选项：

如果指定了 -R 选项，则遵循命令行上的符号链接。 （不遵循树遍历中遇到的符号链接。）

如果指定了 -R 选项，则遵循所有符号链接。

如果指定了 -R 选项，则不遵循符号链接。 这是默认设置。

如果 source_file 指定一个目录，则 cp 复制该目录和在该点连接的整个子树。 如果 source_file 以 / 结尾，则复制目录的内容而不是目录本身。 此选项还导致复制符号链接，而不是间接通过，并让 cp 创建特殊文件而不是将它们复制为普通文件。 创建的目录与对应的源目录具有相同的模式，不被进程的umask修改。

请注意， cp 将硬链接文件复制为单独的文件。 如果您需要保留硬链接，请考虑使用 tar(1) 、 cpio(1) 或 pax(1) 。

存档模式。与 -RpP 相同。

对于每个现有的目标路径名，将其删除并创建一个新文件，无论其权限如何，都不会提示确认。 （ -f 选项覆盖任何以前的 -i 或 -n 选项。）

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

在层次结构中创建指向常规文件的硬链接，而不是复制。

不要覆盖现有文件。 （ -n 选项覆盖任何以前的 -f 或 -i 选项。）

使 cp 保留副本中每个源文件的以下属性：修改时间、访问时间、文件标志、文件模式、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 位都不会保留在副本的权限。

在层次结构中创建指向常规文件的符号链接，而不是复制。

使 cp 变得冗长，在复制文件时显示文件。

不遍历文件系统挂载点。

对于每个已经存在的目标文件，如果权限允许，其内容将被覆盖。 除非指定了 -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 选项将被忽略。 此外，这些选项相互覆盖，命令的操作由最后一个指定的操作决定。

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

The cp utility exits 0 on success, and >0 if an error occurs.

制作名为 bar 的文件 foo 的副本：

$ cp foo bar

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

$ cp *.txt /tmp

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

$ cp -R junk /tmp

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

-l, -s, -v, -x 和 -n 选项是非标准选项，不建议在脚本中使用它们。

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

cp 命令预计与 IEEE Std 1003.2 (“POSIX.2”) 兼容。

cp 命令出现在 Version 1 AT&T UNIX 中。

June 6, 2015

FreeBSD 13.1-RELEASE

BASENAME(1)

BASENAME(1)

FreeBSD General Commands Manual

BASENAME(1)

名称

basename, dirname —

返回路径名的文件名或目录部分

basename string [suffix] basename [-a] [-s suffix] string [...] dirname string [...]

basename 实用程序删除任何以 string 中存在的最后一个斜杠 ‘/’ 字符结尾的前缀（在第一次去除尾随斜杠之后）和 suffix 如果给定的话。 如果 suffix 与 string 中的其余字符相同，则不会去除后缀。 结果文件名被写入标准输出。 不存在的后缀将被忽略。 如果指定了 -a ，则每个参数都被视为一个 string ，就好像只使用一个参数调用了 basename 。 如果指定了 -s ，则将 suffix 作为其参数，并将所有其他参数视为 string 。

dirname 实用程序删除文件名部分，从最后一个斜杠 ‘/’ 字符开始到 string 的末尾（在第一次去除尾部斜杠之后），并将结果写入标准输出。

The basename and dirname utilities exit 0 on success, and >0 if an error occurs.

以下行将 shell 变量 FOO 设置为 /usr/bin 。

FOO=`dirname /usr/bin/trail`

csh(1), sh(1), basename(3), dirname(3)

basename 和 dirname 实用程序应与 IEEE Std 1003.2 (“POSIX.2”) 兼容。

basename 和 dirname 实用程序首先出现在 4.4BSD 中。

May 26, 2020

FreeBSD 13.1-RELEASE

DU(1)

DU(1)

FreeBSD General Commands Manual

DU(1)

du —

AT(1)

AT(1)

FreeBSD General Commands Manual

AT(1)

名称

at, batch, atq, atrm —

排队、检查或删除作业以供以后执行

at [-q queue] [-f file] [-mldbv] time at [-q queue] [-f file] [-mldbv] -t [[CC]YY]MMDDhhmm[.SS] at -c job [job ...] at -l [job ...] at

atq [-q queue] [-v]

atrm job [job ...]

batch [-q queue] [-f file] [-mv] [time]

at 和 batch 实用程序使用 sh(1) 从标准输入或指定文件中读取命令，这些命令将在以后执行。

at

在指定时间执行命令；

atq

列出用户的待处理作业，除非用户是超级用户；在这种情况下，每个人的工作都会被列出；

atrm

删除工作；

batch

在系统负载水平允许时执行命令；换句话说，当负载平均下降到低于活动 CPU 数量的 1.5 倍时，或者在调用 atrun 时指定的值。

at 实用程序允许一些中等复杂的 time 规范。 它接受 HHMM 或 HH:MM 形式的时间以在一天中的特定时间运行作业。 （如果该时间已经过去，则假定为第二天。） 作为替代方案，可以指定以下关键字: midnight, noon 或 teatime (4pm) 并且时间可以以 AM 或 PM 为后缀以在早上或晚上运行。 作业运行的日期也可以通过以 month-name day 的形式给出日期和可选的 year 来指定，或者以 DD.MM.YYYY, DD.MM.YY, MM/DD/YYYY, MM/DD/YY, MMDDYYYY 或 MMDDYY 。 日期的指定必须遵循时间的指定。 时间也可以指定为： [now] + count time-units ，其中时间单位可以是 minutes, hours, days, weeks, months 或 years ，并且可以通过在 time 后面加上 today 来告诉 at 今天运行作业并通过在 tomorrow 后缀时间来运行明天的工作。

例如，要在三天之后的下午4点运行一个作业，使用 at 4pm + 3 days ，要在7月31日上午10点运行一个作业，使用 at 10am Jul 31 ，要在明天凌晨1点运行一个作业，使用 at 1am tomorrow 。

at 实用程序还支持 POSIX 时间格式（请参阅 -t 选项）。

对于 at 和 batch ，从标准输入或使用 -f 选项指定的文件读取命令并执行。 工作目录、环境（变量 TERM, TERMCAP, DISPLAY 和 _ 除外）和 umask 从调用时起保留。 从 su(1) shell 调用的 at 或 batch 命令将保留当前用户 ID。 如果有的话，用户将收到来自他的命令的标准错误和标准输出。 邮件将使用命令 sendmail(8) 发送。 如果从 su(1) shell 执行 at ，登录 shell 的所有者将收到邮件。

超级用户在任何情况下都可以使用这些命令。 对于其他用户，使用 at 的权限由文件 /var/at/at.allow 和 /var/at/at.deny 确定。

如果文件 /var/at/at.allow 存在，则只允许其中提到的用户名使用 at 。 在这两个文件中，仅当用户名在其行之前没有空格或其他字符并且在名称之后紧跟换行符时，即使在文件末尾，用户才被认为是列出的。 其他行被忽略，可用于注释。

如果 /var/at/at.allow 不存在，则检查 /var/at/at.deny ，然后允许其中未提及的每个用户名使用 at 。

如果两者都不存在，则只允许超级用户使用 at 。 这是默认配置。

请注意， at 是通过 cron(8) 守护进程通过每五分钟调用一次 atrun(8) 来实现的。 这意味着 at 的粒度可能并非对每个部署都是最佳的。 如果需要更精细的粒度，可以编辑 /etc/cron.d/at 文件，并将由系统 crontab 读取， SHELL 和 PATH 环境变量从该文件继承。

queue

使用指定的队列。 队列名称由单个字母组成；有效的队列名称范围从 a 到 z 和 A 到 Z 。 c 队列是 at 的默认队列， E 队列是 batch 的默认队列。 具有更高字母的队列运行得更好。 如果将作业提交到以大写字母指定的队列，则将其视为当时已提交到批处理。 如果给 atq 一个特定的队列，它将只显示该队列中待处理的作业。

即使没有输出，也可以在作业完成后向用户发送邮件。

file

从 file 而不是标准输入中读取作业。

不带参数，列出调用用户的所有作业。 如果给出了一个或多个工作编号，请仅列出这些工作。

是 atrm 的别名（此选项已弃用；请改用 -r )。

是 batch 的别名。

对于 atq, 显示队列中已完成但尚未删除的作业；否则显示作业将执行的时间。

将命令行上列出的作业分类到标准输出。

删除指定的作业。

使用 POSIX 时间格式指定作业时间。 参数应采用 [[CC]YY]MMDDhhmm[.SS] 形式，其中每对字母代表以下内容：

CC

年份的前两位数字（世纪）。

YY

年份的后两位数。

MM

一年中的月份，从 1 到 12。

DD

一个月中的第几天，从 1 到 31。

hh

一天中的小时，从 0 到 23。

mm

小时的分钟，从 0 到 59。

SS

分钟的秒数，从 0 到 60。

如果未指定 CC 和 YY 字母对，则默认值为当前年份。 如果未指定 SS 字母对，则该值默认为 0。

/var/at/jobs

包含作业文件的目录

/var/at/spool

包含输出假脱机文件的目录

/var/run/utx.active

登录记录

/var/at/at.allow

允许权限控制

/var/at/at.deny

拒绝权限控制

/var/at/jobs/.lockfile

创造工作锁定文件

nice(1), sh(1), umask(2), atrun(8), cron(8), sendmail(8)

At 主要由 Thomas Koenig <> 编写。 时间解析例程由 David Parsons <> 编写， Joe Halpin <> 进行了小幅改进。

如果文件 /var/run/utx.active 不可用或损坏，或者如果在调用 at 时用户未登录，则邮件将发送到在环境变量 LOGNAME 中找到的用户 ID。 如果未定义或为空，则假定为当前用户 ID。

当前实现的 at 和 batch 实用程序不适用于用户竞争资源时。 如果是这种情况，另一个批处理系统（例如 nqs ）可能更合适。

指定超过 2038 年的日期可能不适用于某些系统。

August 11, 2018

FreeBSD 13.1-RELEASE

AT(1)

AT(1)

FreeBSD General Commands Manual

AT(1)

名称

at, batch, atq, atrm —

排队、检查或删除作业以供以后执行

at [-q queue] [-f file] [-mldbv] time at [-q queue] [-f file] [-mldbv] -t [[CC]YY]MMDDhhmm[.SS] at -c job [job ...] at -l [job ...] at

atq [-q queue] [-v]

atrm job [job ...]

batch [-q queue] [-f file] [-mv] [time]

at 和 batch 实用程序使用 sh(1) 从标准输入或指定文件中读取命令，这些命令将在以后执行。

at

在指定时间执行命令；

atq

列出用户的待处理作业，除非用户是超级用户；在这种情况下，每个人的工作都会被列出；

atrm

删除工作；

batch

在系统负载水平允许时执行命令；换句话说，当负载平均下降到低于活动 CPU 数量的 1.5 倍时，或者在调用 atrun 时指定的值。

at 实用程序允许一些中等复杂的 time 规范。 它接受 HHMM 或 HH:MM 形式的时间以在一天中的特定时间运行作业。 （如果该时间已经过去，则假定为第二天。） 作为替代方案，可以指定以下关键字: midnight, noon 或 teatime (4pm) 并且时间可以以 AM 或 PM 为后缀以在早上或晚上运行。 作业运行的日期也可以通过以 month-name day 的形式给出日期和可选的 year 来指定，或者以 DD.MM.YYYY, DD.MM.YY, MM/DD/YYYY, MM/DD/YY, MMDDYYYY 或 MMDDYY 。 日期的指定必须遵循时间的指定。 时间也可以指定为： [now] + count time-units ，其中时间单位可以是 minutes, hours, days, weeks, months 或 years ，并且可以通过在 time 后面加上 today 来告诉 at 今天运行作业并通过在 tomorrow 后缀时间来运行明天的工作。

例如，要在三天之后的下午4点运行一个作业，使用 at 4pm + 3 days ，要在7月31日上午10点运行一个作业，使用 at 10am Jul 31 ，要在明天凌晨1点运行一个作业，使用 at 1am tomorrow 。

at 实用程序还支持 POSIX 时间格式（请参阅 -t 选项）。

对于 at 和 batch ，从标准输入或使用 -f 选项指定的文件读取命令并执行。 工作目录、环境（变量 TERM, TERMCAP, DISPLAY 和 _ 除外）和 umask 从调用时起保留。 从 su(1) shell 调用的 at 或 batch 命令将保留当前用户 ID。 如果有的话，用户将收到来自他的命令的标准错误和标准输出。 邮件将使用命令 sendmail(8) 发送。 如果从 su(1) shell 执行 at ，登录 shell 的所有者将收到邮件。

超级用户在任何情况下都可以使用这些命令。 对于其他用户，使用 at 的权限由文件 /var/at/at.allow 和 /var/at/at.deny 确定。

如果文件 /var/at/at.allow 存在，则只允许其中提到的用户名使用 at 。 在这两个文件中，仅当用户名在其行之前没有空格或其他字符并且在名称之后紧跟换行符时，即使在文件末尾，用户才被认为是列出的。 其他行被忽略，可用于注释。

如果 /var/at/at.allow 不存在，则检查 /var/at/at.deny ，然后允许其中未提及的每个用户名使用 at 。

如果两者都不存在，则只允许超级用户使用 at 。 这是默认配置。

请注意， at 是通过 cron(8) 守护进程通过每五分钟调用一次 atrun(8) 来实现的。 这意味着 at 的粒度可能并非对每个部署都是最佳的。 如果需要更精细的粒度，可以编辑 /etc/cron.d/at 文件，并将由系统 crontab 读取， SHELL 和 PATH 环境变量从该文件继承。

queue

使用指定的队列。 队列名称由单个字母组成；有效的队列名称范围从 a 到 z 和 A 到 Z 。 c 队列是 at 的默认队列， E 队列是 batch 的默认队列。 具有更高字母的队列运行得更好。 如果将作业提交到以大写字母指定的队列，则将其视为当时已提交到批处理。 如果给 atq 一个特定的队列，它将只显示该队列中待处理的作业。

即使没有输出，也可以在作业完成后向用户发送邮件。

file

从 file 而不是标准输入中读取作业。

不带参数，列出调用用户的所有作业。 如果给出了一个或多个工作编号，请仅列出这些工作。

是 atrm 的别名（此选项已弃用；请改用 -r )。

是 batch 的别名。

对于 atq, 显示队列中已完成但尚未删除的作业；否则显示作业将执行的时间。

将命令行上列出的作业分类到标准输出。

删除指定的作业。

使用 POSIX 时间格式指定作业时间。 参数应采用 [[CC]YY]MMDDhhmm[.SS] 形式，其中每对字母代表以下内容：

CC

年份的前两位数字（世纪）。

YY

年份的后两位数。

MM

一年中的月份，从 1 到 12。

DD

一个月中的第几天，从 1 到 31。

hh

一天中的小时，从 0 到 23。

mm

小时的分钟，从 0 到 59。

SS

分钟的秒数，从 0 到 60。

如果未指定 CC 和 YY 字母对，则默认值为当前年份。 如果未指定 SS 字母对，则该值默认为 0。

/var/at/jobs

包含作业文件的目录

/var/at/spool

包含输出假脱机文件的目录

/var/run/utx.active

登录记录

/var/at/at.allow

允许权限控制

/var/at/at.deny

拒绝权限控制

/var/at/jobs/.lockfile

创造工作锁定文件

nice(1), sh(1), umask(2), atrun(8), cron(8), sendmail(8)

At 主要由 Thomas Koenig <> 编写。 时间解析例程由 David Parsons <> 编写， Joe Halpin <> 进行了小幅改进。

如果文件 /var/run/utx.active 不可用或损坏，或者如果在调用 at 时用户未登录，则邮件将发送到在环境变量 LOGNAME 中找到的用户 ID。 如果未定义或为空，则假定为当前用户 ID。

当前实现的 at 和 batch 实用程序不适用于用户竞争资源时。 如果是这种情况，另一个批处理系统（例如 nqs ）可能更合适。

指定超过 2038 年的日期可能不适用于某些系统。

August 11, 2018

FreeBSD 13.1-RELEASE

GZIP(1)

GZIP(1)

FreeBSD General Commands Manual

GZIP(1)

名称

gzip, gunzip, zcat —

使用 Lempel-Ziv 编码 (LZ77) 的压缩/解压缩工具

gzip [-cdfhkLlNnqrtVv] [-S suffix] file [file [...]] gunzip [-cfhkLNqrtVv] [-S suffix] file [file [...]] zcat [-fhV] file [file [...]]

gzip 程序使用 Lempel-Ziv 编码 (LZ77) 压缩和解压缩文件。 如果没有指定 files , gzip 将从标准输入压缩，或解压缩到标准输出。 在压缩模式下，如果可能，每个 file 都将替换为另一个带有后缀的文件，该后缀由 -S suffix 选项设置，如果可能的话。

在解压模式下，每个 file 都会被检查是否存在，添加后缀的文件也会被检查。 每个 file 参数必须包含一个单独的完整存档；当指示多个 files 时，依次解压每个文件。

在 gzcat 的情况下，结果数据然后以 cat(1) 的方式连接。

如果作为 gunzip 调用，则启用 -d 选项。 如果作为 zcat 或 gzcat 调用，则启用 -c 和 -d 选项。

此版本的 gzip 还能够解压缩使用 compress(1), bzip2(1), lzip 或 xz(1) 压缩的文件。

可以使用以下选项：

, -``-fast

, -3, -4, -5, -6, -7, -8

, -``-best

这些选项更改使用的压缩级别， -1 选项最快，压缩较少， -9 选项最慢，压缩最佳。默认压缩级别为 6。

, -``-stdout, - -to-stdout

此选项指定输出将转到标准输出流，使文件保持不变。

, -``-decompress, -``-uncompress

此选项选择解压缩而不是压缩。

, -``-force

此选项打开强制模式。 这允许具有多个链接的文件、到常规文件的符号链接、覆盖预先存在的文件、读取或写入终端，以及与 -c 选项结合使用时，允许未压缩的数据原封不动地通过。

, -``-help

此选项打印使用摘要并退出。

, -``-keep

此选项可防止 gzip 在（解）压缩后删除输入文件。

, --license

此选项打印 gzip 许可证。

, -``-list

此选项显示有关文件的压缩和未压缩大小、比率、未压缩名称的信息。 使用 -v 选项，它还显示文件中嵌入的压缩方法、CRC、日期和时间。

, -``-name

此选项使输入文件中存储的文件名用作输出文件。

, -``-no-name

此选项停止将文件名和时间戳存储在输出文件中。

, -``-quiet

使用此选项，不会打印任何警告或错误。

, -``-recursive

此选项用于使用 fts(3) 库单独 gzip 目录树中的文件。

suffix, -``-suffix suffix

此选项将默认后缀从 .gz 更改为 suffix 。

, -``-test

此选项将测试压缩文件的完整性。

, -``-version

此选项打印 gzip 程序的版本。

, -``-verbose

此选项打开详细模式，打印每个压缩文件的压缩率。

如果设置了环境变量 GZIP ，它将被解析为在命令行上的任何选项之前处理的以空格分隔的选项列表。 命令行上的选项将覆盖 GZIP 中的任何内容。

gzip 实用程序在成功时退出 0，在错误时退出 1，如果出现警告则退出 2。

gzip 响应以下信号：

向标准错误报告进度。

bzip2(1), compress(1), xz(1), fts(3), zlib(3)

gzip 程序最初由 Jean-loup Gailly 编写，获得 GNU Public License 许可。 Matthew R.Green 基于可自由再分发的 zlib 库为 NetBSD 1.3 分发媒体编写了一个简单的前端。 它被增强为与 NetBSD 2.0 的原始 GNU gzip 程序大部分功能兼容。

这个 gzip 的实现是基于 NetBSD gzip 版本 20181111 移植的，并且首次出现在 FreeBSD 7.0 中。

这个 gzip 的实现由 Matthew R. Green <> 编写，解压支持由 Xin LI <> 编写。

根据 RFC 1952，记录的文件大小以 32 位整数存储，因此不能表示大于 4GB 的文件。 此限制也适用于 gzip 实用程序的 -l 选项。

January 7, 2019

FreeBSD 13.1-RELEASE

ECHO(1)

ECHO(1)

FreeBSD General Commands Manual

ECHO(1)

名称

echo —

将参数写入标准输出

echo [-n] [string ...]

echo 实用程序将任何指定的操作数写入标准输出，由单个空白 (‘’) 字符分隔并后跟换行符 (‘’) 字符。

以下选项可用：

不打印尾随换行符。

选项结束标记 -``- 无法识别并按字面书写。

换行符也可以通过在字符串末尾附加 ‘\c’ 来抑制，正如 iBCS2 兼容系统所做的那样。 请注意， -n 选项以及 ‘\c’ 的效果是在 IEEE Std 1003.1-2001 (“POSIX.1”) 中实现定义的，由 Cor. 1-2002 修正。 为了可移植性，只有当第一个参数不以连字符 (‘-’) 开头并且不包含任何反斜杠 (‘\’) 时，才应使用 echo 。 如果这还不够，应该使用 printf(1) 。

大多数 shell 提供了一个内置的 echo 命令，该命令在处理选项和反斜杠方面往往与此实用程序不同。 请参阅 builtin(1) 手册页。

The echo utility exits 0 on success, and >0 if an error occurs.

builtin(1), csh(1), printf(1), sh(1)

echo 实用程序符合经 1-2002 修订的 IEEE Std 1003.1-2001 (“POSIX.1”) 。

echo 命令出现在 Version 2 AT&T UNIX 中。

October 5, 2016

FreeBSD 13.1-RELEASE

CTFDUMP(1)

CTFDUMP(1)

FreeBSD General Commands Manual

CTFDUMP(1)

名称

ctfdump —

转储 ELF 文件的 SUNW_ctf 部分

ctfdump [-dfhlsSt] -u file file

ctfdump 实用程序转储 ELF 二进制文件中存在的 CTF 数据段 (SUNW_ctf) 的内容。 此部分之前是使用 ctfconvert(1) 或 ctfmerge(1) 创建的。

可以使用以下选项：

显示数据对象部分。

显示函数部分。

显示标题。

显示标签部分。

显示字符串表。

显示统计信息。

显示类型部分。

ufile

将未压缩的 CTF 数据写入名为 ufile 的原始 CTF 文件。

The ctfdump utility exits 0 on success, and >0 if an error occurs.

ctfconvert(1), ctfmerge(1)

ctfdump 实用程序首次出现在 FreeBSD 7.0 中。

CTF 实用程序来自 OpenSolaris。

July 7, 2010

FreeBSD 13.1-RELEASE

DATE(1)

DATE(1)

FreeBSD General Commands Manual

DATE(1)

date —

ENV(1)

ENV(1)

FreeBSD General Commands Manual

ENV(1)

名称

env —

设置环境并执行命令，或打印环境

env [-0iv] [-L|-U user[/class]] [-u name] [name=value ...] env [-iv] [-L|-U user[/class]] [-P altpath] [-S string] [-u name] [name=value ...] utility [argument ...]

env 实用程序在修改命令行中指定的环境后执行另一个 utility 。 每个 name=value 选项指定环境变量 name 的设置，其值为 value 。 所有这些环境变量都是在 utility 执行之前设置的。

选项如下：

以 NUL 结束每个输出行，而不是换行符。

仅使用 name=value 选项指定的那些环境变量执行该 utility 。 env 继承的环境被完全忽略。

| user[/class]

在处理任何 -i 或 -u 选项之后，但在处理任何 name=value 选项之前，将指定用户和登录类的 login.conf(5) 中的环境变量定义添加到环境中。 如果使用 -L ，则只读取系统范围的 /etc/login.conf.db 文件；如果使用 -U ，则指定用户的 ~/.login_conf 也会被读取。 用户可以由名称或 uid 指定。如果给出了用户名 ‘-’ ，则不会进行用户查找，如果没有明确给出，登录类将默认为 ‘default’ ，并且不会对值进行替换。

altpath

搜索由 altpath 指定的目录集以定位指定的 utility ，而不是使用 PATH 环境变量的值。

string

将给定的 string 拆分为多个字符串，并将每个结果字符串作为 env 实用程序的单独参数进行处理。 -S 选项识别一些特殊的字符转义序列并且还支持环境变量替换，如下所述。

name

如果环境变量 name 在环境中，则在处理其余选项之前将其删除。 这类似于 sh(1) 中的 unset 命令。 name 的值不能包含 ‘=’ 字符。

打印 env 实用程序完成的每个处理步骤的详细信息。 如果多次指定 -v ，将打印附加信息。

仅当在任何 name=value 选项之前指定上述选项时，它们才会被识别。

如果未指定 utility ，则 env 会打印出环境中变量的名称和值。 除非指定了 -0 否则每个名称/值对由新行分隔，在这种情况下，名称/值对由 NUL 分隔。 -0 和 utility 不能一起指定。

-S 选项的处理将根据在 string 中找到的任何空格或 字符将给定 string 拆分为单独的参数。 然后，这些新参数中的每一个都将被视为已在原始 env 命令中指定为单独的参数。

空格和制表符可以通过使用单引号 (“'”) 或双引号 (‘"’)- 或反斜杠 (‘\’) 嵌入其中一个新参数中。 单引号将转义所有非单引号字符，直到匹配的单引号。 双引号将转义所有非双引号字符，直到匹配的双引号。 如果在匹配的引号字符之前到达 string 的结尾，则这是一个错误。

如果 -S 将创建一个以 ‘#’ 字符开头的新参数，则该参数和 string 的其余部分将被忽略。 当您希望新参数以 ‘#’ 字符开头时，可以使用 ‘\#’ 序列，而不会导致 string 的其余部分被跳过。

在处理 string 值时， -S 处理会将某些字符组合视为转义序列，表示要采取的某些操作。 字符转义序列采用反斜杠表示法。 字符及其含义如下：

忽略 string 中的剩余字符。 这不能出现在双引号字符串中。

替换为 字符。

替换为 字符。

替换为 <回车> 字符。

替换为 字符。

替换为 字符。

替换为 ‘#’ 字符。 当您需要一个 ‘#’ 作为通过拆分给定 string 创建的一个参数中的第一个字符时，这将很有用。

替换为 ‘$’ 字符。

如果在双引号字符串中找到它，则将其替换为单个空格。 如果在带引号的字符串之外找到它，则将其视为原始 string 中新参数之间的分隔符。

替换为 <双引号> 字符。

替换为 <单引号> 字符。

替换为反斜杠字符。

和反斜杠的序列是唯一在单引号字符串中被识别的序列。 其他序列在单引号字符串中没有特殊含义。 所有转义序列都在双引号字符串中被识别。 如果单个 ‘\’ 字符后跟上面列出的字符以外的字符，则会出错。

-S 的处理还支持从环境变量中替换值。 为此，环境变量的名称必须在 ‘${}’ 之内，例如： ${SOMEVAR} 。 不支持 $SOMEVAR 的通用 shell 语法。 所有替换的值都将是环境变量的值，就像最初调用 env 实用程序时一样。 如上所述，不会检查这些值是否有任何转义序列。 并且 name=value 的任何设置都不会影响 -S 处理中用于替换的值。

此外， -S 处理不能引用大多数 shell 定义的特殊参数的值。 例如， -S 无法识别特殊参数，例如： ‘$*’, ‘$@’, ‘$#’, ‘$?’ 或 ‘$$’ 如果它们出现在给定的 string 中。

env 实用程序通常用作解释脚本的第一行的 interpreter ，如 execve(2) 中所述。

请注意内核解析 ‘#!’ 的方式 自 FreeBSD 6.0 起，解释脚本的（第一行）已更改。 在此之前， FreeBSD 内核会根据在该行中找到的任何空格（空格或 字符）将该第一行拆分为单独的参数。 所以，如果一个名为 /usr/local/bin/someport 的脚本的第一行是：

#!/usr/local/bin/php -n -q -dsafe_mode=0

那么 /usr/local/bin/php 程序将使用以下参数启动：

arg[0] = '/usr/local/bin/php' arg[1] = '-n' arg[2] = '-q' arg[3] = '-dsafe_mode=0' arg[4] = '/usr/local/bin/someport'

加上用户在执行 someport 时指定的任何参数。 但是，这个处理多个选项就 ‘#!’ 行不是任何其他操作系统解析解释脚本的第一行的方式。 因此，在对 FreeBSD 6.0 进行更改后，该脚本将导致 /usr/local/bin/php 以以下参数启动：

arg[0] = '/usr/local/bin/php' arg[1] = '-n -q -dsafe_mode=0' arg[2] = '/usr/local/bin/someport'

加上用户指定的任何参数。 这导致一些脚本的行为发生了重大变化。 在上述脚本的情况下，要让它在 FreeBSD 6.0 下的行为方式与在早期版本下的行为方式相同，第一行应更改为：

#!/usr/bin/env -S /usr/local/bin/php -n -q -dsafe_mode=0

env 实用程序将以整行作为单个参数启动：

arg[1] = '-S /usr/local/bin/php -n -q -dsafe_mode=0'

然后 -S 处理将在执行 /usr/local/bin/php 之前将该行拆分为单独的参数。

如果名称不包含 ‘/’ 字符，则 env 实用程序使用 PATH 环境变量来定位请求的 utility ，除非已指定 -P 选项。

The env utility exits 0 on success, and >0 if an error occurs. 退出状态 126 表示已找到 utility ，但无法执行。 退出状态 127 表示找不到 utility 。

由于 env 实用程序通常用作解释脚本的第一行的一部分，因此以下示例显示了 env 实用程序在脚本中的多种用途。

解释脚本的内核处理不允许脚本直接引用其他脚本作为它自己的解释器。 作为一种解决方法，主要区别在于

#!/usr/local/bin/foo

和

#!/usr/bin/env /usr/local/bin/foo

是即使 /usr/local/bin/foo 本身就是一个解释脚本，后者也可以工作。

可能 env 最常见的用途是为脚本找到正确的解释器，此时解释器可能位于不同系统的不同目录中。 以下示例将通过搜索 PATH 指定的目录来找到 ‘perl’ 解释器。

#!/usr/bin/env perl

该示例的一个限制是它假定用户的 PATH 值设置为一个可以找到您要执行的解释器的值。 -P 选项可用于确保在搜索 utility 时使用特定的目录列表。 请注意，此示例还需要 -S 选项才能正常工作。

#!/usr/bin/env -S -P/usr/local/bin:/usr/bin perl

仅当它位于 /usr/local/bin 或 /usr/bin 中时，上面才会找到 ‘perl’ 。 这可以与 PATH 的当前值相结合，以提供更大的灵活性。 请注意， -S 和 -P 选项之间不需要空格：

#!/usr/bin/env -S-P/usr/local/bin:/usr/bin:${PATH} perl

env 实用程序接受 - 选项作为 -i 的同义词。

printenv(1), sh(1), execvp(3), login.conf(5), environ(7)

env 实用程序符合 IEEE Std 1003.1-2001 (“POSIX.1”) 。 -0, -L, -P, -S, -U, -u 和 -v 选项是 FreeBSD 支持的非标准扩展，但在其他操作系统上可能不可用。

env 命令出现在 4.4BSD 中。 FreeBSD 6.0 中添加了 -P, -S 和 -v 选项。 FreeBSD 13.0 中添加了 -0, -L 和 -U 选项。

出于显而易见的原因， env 实用程序不处理名称中带有等号 (‘=’) 的 utility 值。

env 实用程序在处理 -S 选项时不考虑多字节字符，这可能会导致某些语言环境中的结果不正确。

March 3, 2021

FreeBSD 13.1-RELEASE

CHMOD(1)

CHMOD(1)

FreeBSD General Commands Manual

CHMOD(1)

名称

chmod —

改变文件模式

chmod [-fhv] [-R [-H | -L | -P]] mode file ...

chmod 实用程序修改由 mode 操作数指定的列出文件的文件模式位。

选项如下：

如果 chmod 无法修改 file 的模式，则不要显示诊断消息，也不要修改退出状态以反映此类故障。

如果指定了 -R 选项，则命令行上的符号链接会被跟随，因此不受该命令的影响。 （不遵循树遍历期间遇到的符号链接。）

如果文件是符号链接，请更改链接本身的模式，而不是链接指向的文件。

如果指定了 -R 选项，则遵循所有符号链接。

如果指定了 -R 选项，则不遵循符号链接。 这是默认设置。

更改以文件为根的文件层次结构的模式，而不仅仅是文件本身。 当使用 “.*” 等通配符时，请注意无意中将 “..” 硬链接匹配到父目录。

使 chmod 变得冗长，在修改模式时显示文件名。 如果多次指定 -v 标志，还将以八进制和符号表示法打印文件的旧模式和新模式。

除非指定了 -R 选项，否则 -H -、 -L 和 -P 选项将被忽略。 此外，这些选项相互覆盖，命令的操作由最后一个指定的操作决定。

如果 chmod 接收到 SIGINFO 信号（参见 stty(1) 和 status 参数），则显示当前文件名以及旧模式和新模式。

只有文件的所有者或超级用户才被允许更改文件的模式。

The chmod utility exits 0 on success, and >0 if an error occurs.

模式可以是绝对的或象征性的。 绝对模式是由以下一个或多个值的总和构成的八进制数：

（setuid 位）。 设置了该位的可执行文件将在有效 uid 设置为文件所有者的 uid 的情况下运行。 如果底层文件系统支持此功能，则具有此位集的目录将强制在其中创建的所有文件和子目录由目录所有者拥有，而不是由创建进程的 uid 拥有：参见 chmod(2) 和 suiddir 选项 mount(8) 。

（setgid 位）。 设置了此位的可执行文件将运行时将有效 gid 设置为文件所有者的 gid。

（粘性位）。 请参阅 chmod(2) 和 sticky(7) 。

允许所有者阅读。

允许所有者写入。

对于文件，允许所有者执行。 对于目录，允许所有者在目录中搜索。

允许群组成员阅读。

允许组成员写入。

对于文件，允许组成员执行。 对于目录，允许组成员在目录中搜索。

允许他人阅读。

允许别人写。

对于文件，允许他人执行。 对于目录，允许其他人在目录中搜索。

例如，允许所有者读、写和执行，组成员读和执行，其他人读和执行，并且没有 set-uid 或 set-gid 行为的绝对模式是755（400+200+100+040 +010+004+001)。

符号模式由以下语法描述：

mode ::= clause [, clause ...] clause ::= [who ...] [action ...] action action ::= op [perm ...] who ::= a | u | g | o op ::= + | - | = perm ::= r | s | t | w | x | X | u | g | o

who 符号 ``u''、 ``g'' 和 ``o'' 分别指定用户、组和模式位的其他部分。 who 符号 ``a'' 等价于 ``ugo''。

perm 符号表示模式位的部分，如下所示：

r

读取的位。

s

set-user-ID-on-execution 和 set-group-ID-on-execution 位。

t

粘性位。

w

写入位。

x

执行/搜索位。

X

如果文件是目录或任何执行/搜索位设置为原始（未修改）模式，则执行/搜索位。带有 perm 符号 ``X'' 的操作仅与 op 符号 ``+'' 一起有意义，并且在所有其他情况下都被忽略。

u

文件原始模式中的用户权限位。

g

文件原始模式中的组权限位。

o

文件原始模式中的其他权限位。

op 符号表示执行的操作，如下所示：

如果没有为 perm 提供值，``+'' 操作无效。 如果没有为 who 提供值，则设置 perm 中指定的每个权限位，文件模式创建掩码（请参阅 umask(2) ）中的相应位是明确的。 否则，设置由指定的 who 和 perm 值表示的模式位。

-

如果没有为 perm 提供值，则 ``-'' 操作无效。 如果没有为 who 提供值，则清除 perm 中指定的每个权限位，其中设置了文件模式创建掩码中的相应位。 否则，由指定的 who 和 perm 值表示的模式位将被清除。

=

由 who 值指定的模式位被清除，或者，如果没有指定 who 值，则所有者、组和其他模式位被清除。 然后，如果没有为 who 提供值，则设置 perm 中指定的每个权限位，文件模式创建掩码中的相应位是明确的。 否则，设置由指定的 who 和 perm 值表示的模式位。

每个 clause 指定要对模式位执行的一个或多个操作，并且每个操作都按指定的顺序应用于模式位。

仅对其他权限的操作（由符号“o”本身指定）与 perm 符号 “s” 或 “t” 相结合，将被忽略。

目录上的 “w” 权限将允许文件创建、重定位和复制到该目录。 在目录本身中创建的文件将继承其组 ID。

使任何人都可以读取文件，并且只能由所有者写入文件。

拒绝组和其他人的写权限。

将读取和写入权限设置为通常的默认值，但保留当前设置的任何执行权限。

如果任何人都可以搜索/可执行目录或文件，则让每个人都可以搜索/可执行该目录或文件。

使每个人都可以读取/可执行文件，并且只能由所有者写入。

清除组和其他的所有模式位。

设置组位等于用户位，但清除组写入位。

-v 选项是非标准的，不建议在脚本中使用它。

chflags(1), install(1), setfacl(1), chmod(2), stat(2), umask(2), fts(3), setmode(3), sticky(7), symlink(7), chown(8), mount(8)

chmod 实用程序应与 IEEE Std 1003.2 (“POSIX.2”) 兼容，但该标准中未包含的 perm 符号 “t” 除外。

chmod 命令出现在 Version 1 AT&T UNIX 中。

马的顽皮部位没有 perm 选项。

January 7, 2017

FreeBSD 13.1-RELEASE

CHPASS(1)

CHPASS(1)

FreeBSD General Commands Manual

CHPASS(1)

名称

chpass, chfn, chsh, ypchpass, ypchfn, ypchsh —

添加或更改用户数据库信息

chpass [-a list] [-e expiretime] [-p encpass] [-s newshell] [user] ypchpass [-loy] [-a list] [-d domain] [-e expiretime] [-h host] [-p encpass] [-s newshell] [user]

chpass 实用程序允许编辑与 user 关联的用户数据库信息，默认情况下，与当前用户关联。

chfn, chsh, ypchpass, ypchfn 和 ypchsh 实用程序的行为与 chpass 相同。 （只有一个程序。）

信息被格式化并提供给编辑器进行更改。

仅显示允许用户更改的信息。

选项如下：

list

超级用户可以直接提供用户数据库条目，格式由 passwd(5) 指定，作为参数。 此参数必须是所有用户数据库字段的冒号 (“:”) 分隔列表，尽管它们可能为空。

expiretime

更改帐户过期时间。 此选项用于设置脚本的过期时间，就像在交互式编辑器中完成一样。

encpass

超级用户可以直接提供加密的密码字段，以 crypt(3) 使用的格式作为参数。

newshell

尝试将用户的 shell 更改为 newshell 。

可能的显示项目如下：

Login:

用户的登录名

Password:

用户的加密密码

Uid:

用户登录

Gid:

用户登录组

Class:

用户的一般分类

Change:

密码更改时间

Expire:

账户到期时间

Full Name:

用户的真实姓名

Office Location:

用户办公地点 (1)

Office Phone:

用户办公电话 (1)

Home Phone:

用户家庭电话 (1)

Other Information:

为用户 (1) 定义的任何本地参数

Home Directory:

用户的主目录

Shell:

用户的登录外壳

NOTE(1) -

在实际的 master.passwd 文件中，这些字段是嵌入在 FullName 字段中的逗号分隔字段。

login 字段是用于访问计算机帐户的用户名。

password 字段包含用户密码的加密形式。

uid 字段是与 login 字段关联的数字。 这两个字段在系统中（并且通常在一组系统中）应该是唯一的，因为它们控制文件访问。

虽然可以有多个具有相同登录名和/或相同用户 ID 的条目，但这样做通常是错误的。 处理这些文件的例程通常只会返回多个条目中的一个，并且该条目是随机选择的。

gid 字段是用户在登录时将被放置的组。 由于 BSD 支持多个组（参见 groups(1) ），这个字段目前没有什么特殊意义。 该字段可以填写数字或组名（请参阅 group(5) ）。

class 字段引用 /etc/login.conf 中的类描述，通常用于在用户登录时初始化用户的系统资源限制。

change 字段是必须更改密码的日期。

expire 字段是帐户到期的日期。

change 和 expire 字段都应以 “month day year” 的形式输入，其中 month 为月名（前三个字符即可）， day 为月日， year 为年。

五个字段可用于存储用户的 full name 、 office location 、 work 和 home telephone ，最后是 other information ，这些信息是一个逗号分隔的字符串，表示任何附加的 gecos 字段（通常用于特定于站点的用户信息）。 请注意， finger(1) 将在标题 Office: 下一起显示办公室位置和办公室电话。

用户的 home directory 是用户登录时所在的完整 UNIX 路径名。

shell 字段是用户喜欢的命令解释器。 如果 shell 字段为空，则假定为 Bourne shell， /bin/sh 。 当更改登录 shell 而不是超级用户时，用户可能不会从非标准 shell 更改或更改为非标准 shell。 非标准定义为在 /etc/shells 中找不到的 shell。

验证信息后， chpass 使用 pwd_mkdb(8) 更新用户数据库。

除非环境变量 EDITOR 设置为备用编辑器，否则将使用 vi(1) 编辑器。 当编辑器终止时，信息会被重新读取并用于更新用户数据库本身。 只有用户或超级用户可以编辑与用户相关的信息。

有关设置 PW_SCAN_BIG_IDS 环境变量的影响的说明，请参见 pwd_mkdb(8) 。

chpass 实用程序也可以与 NIS 一起使用，但是有一些限制。 目前， chpass 只能通过 rpc.yppasswdd(8) 更改 NIS passwd 映射，这通常只允许更改用户的密码、shell 和 GECOS 字段。 除非由 NIS 主服务器上的超级用户调用，否则 chpass (以及类似的 passwd(1)) 不能使用 rpc.yppasswdd(8) 服务器更改其他用户信息或向 NIS passwd 映射添加新记录。 此外， rpc.yppasswdd(8) 需要密码验证才能进行任何更改。 唯一允许在不提供密码的情况下提交更改的用户是 NIS 主服务器上的超级用户；所有其他用户，包括在 NIS 客户端（和 NIS 从属服务器）上具有 root 权限的用户，都必须输入密码。 （NIS 主服务器上的超级用户被允许绕过这些限制，主要是为了方便：对 NIS 主服务器具有 root 访问权限的用户已经拥有更新 NIS 映射所需的权限，但手动编辑映射源文件可能很麻烦。

注意：这些例外仅适用于 NIS 主服务器是 FreeBSD 系统时）。

因此，除非另有说明，当 chpass 与 NIS 一起使用时，以下限制适用：

1. 只有外壳和 GECOS 信息可以更改。 所有其他字段都受到限制，即使超级用户调用了 chpass 。 虽然可以添加对更改其他字段的支持，但这会导致与其他支持 NIS 的系统的兼容性问题。 即使超级用户可以在编辑条目时为其他字段提供数据，额外的信息（除了密码 — 见下文）将被静默丢弃。

   例外：NIS 主服务器上的超级用户被允许更改任何字段。

2. 需要密码验证。 chpass 实用程序将在进行任何更改之前提示用户输入 NIS 密码。 如果密码无效，所有更改都将被丢弃。

   例外：NIS 主服务器上的超级用户可以在不提供密码的情况下提交更改。 （超级用户可以选择使用 -o 标志关闭此功能，如下所述。）

当使用 NIS 支持编译 chpass 时，还有一些额外的选项标志可用：

domain

指定特定的 NIS 域。 chpass 实用程序默认使用由 domainname(1) 实用程序设置的系统域名。 -d 选项可用于覆盖默认值，或在未设置系统域名时指定域。

host

指定要查询的 NIS 服务器的名称或地址。 通常， chpass 将与在 master.passwd 或 passwd 映射中指定的 NIS 主控主机通信。 在尚未配置为 NIS 客户端的主机上，除非用户提供服务器的主机名，否则程序无法确定此信息。 请注意，指定的主机名不必是 NIS 主服务器的主机名；给定 NIS 域中的任何服务器（主服务器或从服务器）的名称都可以。

使用 -d 选项时，主机名默认为 “localhost” 。 -h 选项可以与 -d 选项一起使用，在这种情况下，用户指定的主机名将覆盖默认值。

如果用户同时存在于本地和 NIS 数据库中，则强制 chpass 修改用户密码信息的本地副本。

与 rpc.yppasswdd(8) (“old-mode”) 通信时强制使用基于 RPC 的更新。 当 NIS 主服务器上的超级用户调用时， chpass 允许使用专用的、非基于 RPC 的机制（在本例中为 UNIX 域套接字）对 NIS 密码映射进行无限制的更改。 -o 标志可用于强制 chpass 使用标准更新机制。 此选项主要用于测试目的。

的相反效果。 这个标志在很大程度上是多余的，因为如果启用了 NIS， chpass 默认会在 NIS 条目上运行。

/etc/master.passwd

用户数据库

/etc/passwd

版本 7 格式的密码文件

/etc/chpass.XXXXXX

密码文件的临时副本

/etc/shells

批准的 shell 列表

将当前用户的 shell 更改为 ‘/usr/local/bin/zsh’:

chsh -s /usr/local/bin/zsh

finger(1), login(1), passwd(1), getusershell(3), login.conf(5), passwd(5), pw(8), pwd_mkdb(8), vipw(8) Robert Morris and Ken Thompson, UNIX Password security.

chpass 实用程序出现在 4.3BSD-Reno 中。

用户信息应该（并且最终将）存储在其他地方。

November 17, 2020

FreeBSD 13.1-RELEASE

DIFF3(1)

DIFF3(1)

User Commands

DIFF3(1)

名称

diff3 - 逐行比较三个文件

diff3 [OPTION]... MYFILE OLDFILE YOURFILE

逐行比较三个文件。

-e --ed

将 OLDFILE 到 YOURFILE 的未合并更改输出到 MYFILE。

-E --show-overlap

输出未合并的更改，包围冲突。

-A --show-all

输出所有变化，包围冲突。

-x --overlap-only

输出重叠变化。

-X

输出重叠的变化，将它们括起来。

-3 --easy-only

输出未合并的非重叠更改。

-m --merge

输出合并文件而不是 ed 脚本 (默认 -A).

-L LABEL --label=LABEL

使用 LABEL 代替文件名。

-i

将 `w' 和 `q' 命令附加到 ed 脚本。

-a --text

将所有文件视为文本。

--strip-trailing-cr

在输入时去除尾随回车。

-T --initial-tab

通过在前面添加一个 tab 来使选项卡对齐。

--diff-program=PROGRAM

使用 PROGRAM 比较文件。

-v --version

输出版本信息。

--help

输出此帮助。

如果 FILE 是 `-'，则读取标准输入。退出状态为 0 表示成功，1 表示冲突，2 表示故障。

由 Randy Smith 撰写。

向 报告错误。

版权所有 © 2004 Free Software Foundation, Inc。- 这是免费软件；查看复制条件的来源。没有保修；甚至不考虑适销性或特定用途的适用性。

diff3 的完整文档作为 Texinfo 手册进行维护。如果 info 和 diff3 程序已正确安装在您的站点上，则命令

info diff3

应该可以让您访问完整的手册。

April 2004

diffutils 2.8.7

COMM(1)

COMM(1)

FreeBSD General Commands Manual

COMM(1)

comm —

DF(1)

DF(1)

FreeBSD General Commands Manual

DF(1)

名称

df —

显示可用磁盘空间

df [--libxo] [-b | -g | -H | -h | -k | -m | -P] [-acilnT] [-,] [-t type] [file | filesystem ...]

df 实用程序显示有关指定已安装 file system 或 file 系统上的可用磁盘空间量的统计信息。 默认情况下，块计数显示为假定块大小为 512 字节。 如果既没有指定文件也没有指定文件系统操作数，则显示所有已挂载文件系统的统计信息（受下面的 -t 选项影响）。

可以使用以下选项：

通过 libxo(3) 以不同的人类和机器可读格式生成输出。 有关命令行参数的详细信息，请参阅 xo_parse_args(3) 。

显示所有挂载点，包括使用 MNT_IGNORE 标志挂载的那些。 这对于在命令行上指定的文件系统是隐含的。

显式使用 512 字节块，覆盖环境中的任何 BLOCKSIZE 规范。 这与 -P 选项相同。 -k 选项覆盖此选项。

显示总计。

使用 1073741824 字节（1 Gibibyte）块而不是默认值。 这会覆盖环境中的任何 BLOCKSIZE 规范。

“Human-readable” 输出。 使用单位后缀：Byte、Kibibyte、Mebibyte、Gibibyte、Tebibyte 和 Pebibyte（基于 1024 的幂），以便将位数减少到四位或更少。

, -``-si

与 -h 相同，但基于 1000 的幂。

包括有关空闲和已用 inode 数量的统计信息。 结合 -h 或 -H 选项，inode 的数量按 1000 的幂进行缩放。

使用 1024 字节（1 Kibibyte）块而不是默认值。 这会覆盖 -P 选项和环境中的任何 BLOCKSIZE 规范。

仅显示有关本地安装的文件系统的信息。

使用 1048576 字节（1 兆字节）块而不是默认值。 这会覆盖环境中的任何 BLOCKSIZE 规范。

打印出之前从文件系统中获得的统计信息。 如果一个或多个文件系统可能处于无法提供统计信息的状态，则应使用此选项。 指定此选项时， df 将不会从文件系统请求新的统计信息，但会以先前获得的可能陈旧的统计信息进行响应。

显式使用 512 字节块，覆盖环境中的任何 BLOCKSIZE 规范。 这与 -b 选项相同。 -k 选项覆盖此选项。

仅打印指定类型的文件系统的统计信息。 可以在逗号分隔的列表中指定一种以上的类型。 文件系统类型列表可以以 “no” 为前缀，以指定 不应 对其采取操作的文件系统类型。 例如， df 命令：

df -t nonfs,nullfs

列出除 NFS 和 NULLFS 类型之外的所有文件系统。 lsvfs(1) 命令可用于找出系统上可用的文件系统类型。

包括文件系统类型。

-,

（逗号）使用由 localeconv(3)- 返回的非货币分隔符（通常是逗号或句点）将打印尺寸分组并以千为单位分隔。 如果未设置区域设置，或者区域设置没有非货币分隔符，则此选项无效。

指定报告块计数的单位。 这使用 getbsize(3) ，它允许使用字母 k （对于 1024 字节的倍数）、 m （对于 1048576 字节的倍数）或 g 对于 gibibytes）进行缩放的字节或数字单位。 允许的范围是 512 字节到 1 GB。 如果该值在外部，它将被设置为适当的限制。

显示所有挂载点的可读可用磁盘空间，包括文件系统类型：

$ df -ahT Filesystem Type Size Used Avail Capacity Mounted on /dev/ada1p2 ufs 213G 152G 44G 78% / devfs devfs 1.0K 1.0K 0B 100% /dev /dev/ada0p1 ufs 1.8T 168G 1.5T 10% /data linsysfs linsysfs 4.0K 4.0K 0B 100% /compat/linux/sys /dev/da0 msdosfs 7.6G 424M 7.2G 5% /mnt/usb

显示以前收集的数据，包括除 devfs 或 linsysfs 文件系统之外的 inode 统计信息。 请注意， “no” 前缀会影响列表中的所有文件系统，并且 -t 选项只能指定一次：

$ df -i -n -t nodevfs,linsysfs Filesystem 1K-blocks Used Avail Capacity iused ifree %iused Mounted on /dev/ada1p2 223235736 159618992 45757888 78% 1657590 27234568 6% / /dev/ada0p1 1892163184 176319420 1564470712 10% 1319710 243300576 1% /data /dev/da0 7989888 433664 7556224 5% 0 0 100% /mnt/usb

显示包含文件 /etc/rc.conf 的文件系统的人类可读信息：

$ df -h /etc/rc.conf Filesystem Size Used Avail Capacity Mounted on /dev/ada1p2 213G 152G 44G 78% /

与上面相同，但指定了一些文件系统：

$ df -h /dev/ada1p2 Filesystem Size Used Avail Capacity Mounted on /dev/ada1p2 213G 152G 44G 78% /

lsvfs(1), quota(1), fstatfs(2), getfsstat(2), statfs(2), getbsize(3), getmntinfo(3), libxo(3), localeconv(3), xo_parse_args(3), fstab(5), mount(8), pstat(8), quot(8), swapinfo(8)

除大多数选项外， df 实用程序符合 IEEE Std 1003.1-2004 (“POSIX.1”) ，它仅定义 -k, -P 和 -t 选项。

df 命令出现在 Version 1 AT&T UNIX 中。

如果指定了文件或文件系统，则忽略 -n 标志。 此外，如果用户无法访问安装点，则文件系统信息可能已过时。

-b 和 -P 选项是相同的。 前者来自 BSD 传统，后者是 IEEE Std 1003.1-2004 (“POSIX.1”) 一致性所必需的。

October 5, 2020

FreeBSD 13.1-RELEASE

CHGRP(1)

CHGRP(1)

FreeBSD General Commands Manual

CHGRP(1)

名称

chgrp —

更改组

chgrp [-fhvx] [-R [-H | -L | -P]] group file ...

chgrp 实用程序将由每个 file 操作数命名的文件的 group 设置为由组操作数指定的组 ID。

可以使用以下选项：

如果指定了 -R 选项，则命令行上的符号链接会被跟随，因此不受该命令的影响。 （不遵循遍历过程中遇到的符号链接。）

如果指定了 -R 选项，则遵循所有符号链接。

如果指定了 -R 选项，则不遵循符号链接。 这是默认设置。

更改以文件为根的文件层次结构的组 ID，而不仅仅是文件本身。 当使用 “.*” 等通配符时，请注意无意中将 “..” 硬链接匹配到父目录。

force 选项忽略错误，除了使用错误并且不查询奇怪的模式（除非用户没有适当的权限）。

如果文件是符号链接，则链接本身的组 ID 会更改，而不是指向的文件。

使 chgrp 变得冗长，在组被修改时显示文件。 如果多次指定 -v 标志， chgrp 将打印文件名，后跟旧的和新的数字组 ID。

不遍历文件系统挂载点。

除非指定了 -R 选项，否则 -H -、 -L 和 -P 选项将被忽略。 此外，这些选项相互覆盖，命令的操作由最后一个指定的操作决定。

group 操作数可以是组数据库中的组名，也可以是数字组 ID。 如果组名也是数字组 ID，则操作数用作组名。

调用 chgrp 的用户必须属于指定的组并且是文件的所有者，或者是超级用户。

如果 chgrp 接收到 SIGINFO 信号（参见 stty(1) 的 status 参数），则显示当前文件名以及旧的和新的组名。

/etc/group

组 ID 文件

The chgrp utility exits 0 on success, and >0 if an error occurs.

在该系统的早期版本中，符号链接没有组。

-v 和 -x 选项是非标准的，不建议在脚本中使用它们。

chown(2), fts(3), group(5), passwd(5), symlink(7), chown(8)

chgrp 实用程序应与 IEEE Std 1003.2 (“POSIX.2”) 兼容。

January 7, 2017

FreeBSD 13.1-RELEASE

MAIL(1)

MAIL(1)

FreeBSD General Commands Manual

MAIL(1)

mail, Mail,

AR(1)

AR(1)

FreeBSD General Commands Manual

AR(1)

ar, ranlib —