.TH XARGS 1 \" -*- nroff -*-

.SH NAME
xargs \- 從標準輸入重建並執行命令行

.SH "總覽 (SYNOPSIS)"
.B 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]]

.SH "描述 (DESCRIPTION)"
此 手冊頁 描述 GNU 版本 的
.BR xargs .
.B xargs
從 標準 輸入 讀入 參數. 參數 用 空格(可以 用 雙引號 單引號 或 反斜槓 轉意) 或者 回車 隔開.
然後 一次 或者 多次 執行 命令
.I command
(默認 是 /bin/echo), 其 參數 是
.I initial-arguments
後面 再 加上 從 標準 輸入 讀入 的 參數. 標準 輸入中 的 空格 被 忽略.
.P
.B xargs
退出 可以有 如下 狀態:
.nf
0 如果 成功
123 如果 任何 一個 被 調用 的 命令 command 退出 狀態 爲 1-125
124 如果 命令 command 退出 狀態 爲 255
125 如果 命令 command 被 信號 終止
126 如果 不能 執行 命令 command
127 如果 命令 command 沒有 找到
1 如果 發生 其它 錯誤
.fi

.SS "選項 (OPTIONS)"
.TP
.I "\-\-null, \-0"
輸入 的 文件名 以 null 字符 結尾, 而不是 空格, 引號 和 反斜槓 並不 特殊 處理
(所有 字符 都以 字面 意思 解釋). 禁止 文件尾 字符串, 當 另一個 參數 處理. 當
參數 含有 空格, 引號, 反斜槓 時 很方便. GNU find 的 \-print0 選項 產生 適合
這種 模式 的 輸出.
.TP
.I "\-\-eof[=eof-str], \-e[eof-str]"
把 文件尾 字符串 設置 成\fIeof-str\fR. 如果 文件尾 字符串 出現 在 輸入中 的
某行, 餘下的 行 將被 忽略. 如果 沒有 \fIeof-str\fR , 就 沒有 文件尾 字符串.
如果 沒有 這個 選項, 文件尾 字符串 默認 是 "_".
.TP
.I "\-\-help"
顯示
.B xargs
的 選項, 然後 退出.
.TP
.I "\-\-replace[=replace-str], \-i[replace-str]"
把 initial-arguments 裏的 所有 \fIreplace-str\fR 替換爲 從 標準 輸入 裏 讀入
的 名稱. 同時, 沒有 用 引號 括起來 的 空格 不會 結束 參數. 如果 沒有
\fIreplace-str\fR , 它 默認爲 "{}" (同 `find \-exec' 一樣). 此 選項 隱含有
\fI\-x\fP 和 \fI\-l 1\fP 選項.
.TP
.I "\-\-max-lines[=max-lines], -l[max-lines]"
每個 命令行 最多 可以 有 \fImax-lines\fR 行 非空格 輸入; \fImax-lines\fR 默認
是 1.  後面 跟着 的 空格 會使 後面 一行 邏輯 上 是 一個 輸入行 的 繼續. 此 選項
隱含有 \fI\-x\fR 選項.
.TP
.I "\-\-max-args=max-args, \-n max-args"
每個 命令行 最多 可以 有 \fImax-args\fR 個 參數. 如果 大小 超出了 (見 \-s 選項)
那麼 參數 個數 將 會用 比 \fImax-args\fR 小; 除非 用了 \-x 選項, 那麼
\fBxargs\fR 將 退出.
.TP
.I "\-\-interactive, \-p"
提示 用戶 是否 運行 每個 命令行, 然後 從 終端 讀入 一行. 只有 當 此行 以 'y'
或 'Y' 開頭 纔會 運行 此 命令行. 此 選項 隱含有 \fI\-t\fR 選項.
.TP
.I "\-\-no-run-if-empty, \-r"
如果 標準 輸入 不 包含 任何 非空格, 將 不運行 命令. 一般 情況下, 就算 沒有
輸入, 命令 也會 運行 一次.
.TP
.I "\-\-max-chars=max-chars, \-s max-chars"
每個 命令行 最多 可以 有 \fImax-chars\fR 個 字符, 包括 命令 和 初始 參數, 還
包括 參數 後面 結尾 的 null. 默認 是 儘可能的 大, 有 20k 個 字符.
.TP
.I "\-\-verbose, \-t"
在 執行 之前 在 標準 錯誤 輸出 顯示 命令行.
.TP
.I "\-\-version"
顯示
.B xargs
的 版本號, 然後 退出.
.TP
.I "\-\-exit, \-x"
如果 大小 超出 (見 \fI\-s\fR 選項) 就 退出.
.TP
.I "\-\-max-procs=max-procs, \-P max-procs"
同時 最多 運行 \fImax-procs\fR 個 進程; 默認 是 1. 如果 \fImax-procs\fR 爲 0,
\fBxargs\fR 將 同時 運行 儘可能 多 的 進程. 最好 同時 用 \fI\-n\fR 選項; 不然
很 可能 只會 做 一次 exec.

.SH "參見 (SEE ALSO)"
\fBfind\fP(1L), \fBlocate\fP(1L), \fBlocatedb\fP(5L), \fBupdatedb\fP(1)
\fBFinding Files\fP (在線 Info, 或者 打印的)

.SH "[中文版維護人]"
.B 唐友 \<tony_ty@263.net\>
.SH "[中文版最新更新]"
.BR 2001/10/31
.SH "[中國Linux論壇man手冊頁翻譯計劃]"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR