xargs - 从标准输入重建并执行命令行

总览 (SYNOPSIS)

xargs [-0prtx] [-e[eof-str]] [-i[replace-str]] [-l[max-lines]] [-n max-args] [-s max-chars] [-P max-procs] [--null] [--eof[=eof-str]] [--replace[=replace-str]] [--max-lines[=max-lines]] [--interactive] [--max-chars=max-chars] [--verbose] [--exit] [--max-procs=max-procs] [--max-args=max-args] [--no-run-if-empty] [--version] [--help] [command [initial-arguments]]

描述 (DESCRIPTION)

此手册页描述 GNU 版本的 xargs. xargs 从标准输入读入参数. 参数用空格(可以用双引号单引号或反斜杠转意) 或者回车隔开. 然后一次或者多次执行命令 command (默认是 /bin/echo), 其参数是 initial-arguments 后面再加上从标准输入读入的参数. 标准输入中的空格被忽略. xargs 退出可以有如下状态:

0 如果 成功

123 如果 任何 一个 被 调用 的 命令 command 退出 状态 为 1-125

124 如果 命令 command 退出 状态 为 255

125 如果 命令 command 被 信号 终止

126 如果 不能 执行 命令 command

127 如果 命令 command 没有 找到

1 如果 发生 其它 错误

选项 (OPTIONS)

--null, -0: 输入的文件名以 null 字符结尾, 而不是空格, 引号和反斜杠并不特殊处理 (所有字符都以字面意思解释). 禁止文件尾字符串, 当另一个参数处理. 当参数含有空格, 引号, 反斜杠时很方便. GNU find 的 -print0 选项产生适合这种模式的输出.
--eof[=eof-str], -e[eof-str]: 把文件尾字符串设置成eof-str. 如果文件尾字符串出现在输入中的某行, 余下的行将被忽略. 如果没有 eof-str , 就没有文件尾字符串. 如果没有这个选项, 文件尾字符串默认是 "_".
--help: 显示 xargs 的选项, 然后退出.
--replace[=replace-str], -i[replace-str]: 把 initial-arguments 里的所有 replace-str 替换为从标准输入里读入的名称. 同时, 没有用引号括起来的空格不会结束参数. 如果没有 replace-str , 它默认为 "{}" (同 `find -exec' 一样). 此选项隐含有 -x 和 -l 1 选项.
--max-lines[=max-lines], -l[max-lines]: 每个命令行最多可以有 max-lines 行非空格输入; max-lines 默认是 1. 后面跟着的空格会使后面一行逻辑上是一个输入行的继续. 此选项隐含有 -x 选项.
--max-args=max-args, -n max-args: 每个命令行最多可以有 max-args 个参数. 如果大小超出了 (见 -s 选项) 那么参数个数将会用比 max-args 小; 除非用了 -x 选项, 那么 xargs 将退出.
--interactive, -p: 提示用户是否运行每个命令行, 然后从终端读入一行. 只有当此行以 'y' 或 'Y' 开头才会运行此命令行. 此选项隐含有 -t 选项.
--no-run-if-empty, -r: 如果标准输入不包含任何非空格, 将不运行命令. 一般情况下, 就算没有输入, 命令也会运行一次.
--max-chars=max-chars, -s max-chars: 每个命令行最多可以有 max-chars 个字符, 包括命令和初始参数, 还包括参数后面结尾的 null. 默认是尽可能的大, 有 20k 个字符.
--verbose, -t: 在执行之前在标准错误输出显示命令行.
--version: 显示 xargs 的版本号, 然后退出.
--exit, -x: 如果大小超出 (见 -s 选项) 就退出.
--max-procs=max-procs, -P max-procs: 同时最多运行 max-procs 个进程; 默认是 1. 如果 max-procs 为 0, xargs 将同时运行尽可能多的进程. 最好同时用 -n 选项; 不然很可能只会做一次 exec.