.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