Provided by: manpages-ja_0.5.0.0.20180315+dfsg-1_all 
名前
xargs - 標準入力を読み込んでコマンドラインを作成し、それを実行する
書式
xargs [-0prtx] [-E eof-str] [-e[eof-str]] [--eof[=eof-str]] [--null] [-d delimiter] [--delimiter
delimiter] [-I replace-str] [-i[replace-str]] [--replace[=replace-str]] [-l[max-lines]] [-L max-lines]
[--max-lines[=max-lines]] [-n max-args] [--max-args=max-args] [-s max-chars] [--max-chars=max-chars] [-P
max-procs] [--max-procs=max-procs] [--process-slot-var=name] [--interactive] [--verbose] [--exit]
[--no-run-if-empty] [--arg-file=file] [--show-limits] [--version] [--help] [command [initial-arguments]]
[訳注]: 見やすくするために、整理して単純化すると:
xargs [options] [command [initial-arguments]]
説明
このマニュアルページは、GNU 版 xargs の使用法を説明している。 xargs は、標準入力から空白や改行で区切られ
た一連の項目を読み込み (空白はダブルクォート、シングルクォート、バックスラッシュによって保護できる)、 そ
れを引き数にして、指定した command を 1 回以上実行する (デフォルトのコマンドは /bin/echo である)。このと
き、ユーザが command に対して指定した引き数 (上記書式の initial-arguments) があれば、 標準入力から読み込
んだ一連の項目は、その後ろに追加される。 標準入力における空行は無視する。
command のコマンドラインは、(-n や -L オプションが使用されていない場合は) システムが定めているコマンドラ
インの長さの限界に達するまで、長いものが作成される。 そして、指定された command が、入力項目のリストを一
つ残らず処理するのに必要な回数だけ、呼び出される。 だから、おおむね、command が呼び出される回数は、入力項
目の数よりも、ずっと少なくてすむわけだ。 このことは、たいていの場合、パフォーマンスを著しく向上させること
になる。 なお、コマンドの中には、都合がよいことに、並列的に実行できるものもある。-P オプションを参照して
いただきたい。
Unix ではファイル名に空白や改行を含むことが可能なので、 こうしたデフォルトの動作は、しばしば問題を引き起
こす。空白や改行を含むファイル名は、 xargs によって適切に処理されないのだ。そうした状況では、-0 オプショ
ンを使用した方がよい。そうすれば、その手の問題を回避することができる。 なお、-0 オプションを使う場合
は、xargs の入力を生成するプログラムの方でも、区切りの指標に必ずヌル文字を使うようにする必要がある。 たと
えば、そのプログラムが GNU find ならば、-print0 オプションでそれが可能だ。
指定したコマンドの実行が終了ステータス 255 で終了することがあれば、 xargs は即座に停止して、それ以上入力
を読み込まない。 また、このとき、エラーメッセージを標準エラーに表示する。
オプション
-0, --null
入力される一連の項目が、ホワイトスペース (空白や改行) ではなく、ヌル文字によって区切られることにな
る。 また、引用符やバックスラッシュが特別な意味を持たなくなる (すなわち、あらゆる文字が文字通りに
解釈される)。 後述のファイル終端文字列も無効になり、他の引き数と同じように扱われる。 このオプショ
ンは、入力される項目にホワイトスペース、引用符、バックスラッシュなどが含まれる可能性がある場合
に、役に立つ。 GNU find の -print0 オプションが生成する出力は、このモードに対応した入力になる。
-a file, --arg-file=file
一連の項目を標準入力からではなく、file から読み込む。 デフォルトでは、指定したコマンドが実行される
際に、標準入力が /dev/null に付け換えられるが、このオプションを使用した場合は、標準入力の付け換え
が起こらない (訳注: 別の言い方をすると、指定したコマンドの実行中、デフォルトでは標準入力が使えなく
なるので、たとえば、"rm -i" の出すプロンプトに応答できなくなるが、このオプションを使用した場合
は、標準入力が使えるので、応答できるということ)。
--delimiter=delim, -d delim
入力される一連の項目が、指定された文字によって区切られることになる。 指定される区切り文字は、単一
の文字でもよく、\n のような C 言語式のエスケープ文字でも、8 進数や 16 進数のエスケープコードでもよ
い。 8 進数や 16 進数のエスケープコードは、printf コマンドの場合と同様に解釈される。 マルチバイト
文字には対応していない。入力を処理する際、引用符やバックスラッシュは特別扱いされない。 すなわ
ち、入力中のあらゆる文字が、文字通りに解釈される。 -d オプションを指定すると、ファイル終端文字列は
無効になり、他の引き数と同じように扱われる。 入力が、項目を改行で区切っているだけのような単純な構
成の場合には、このオプションを使ってもよいが、 ほとんどたいていの場合、なるべくなら、xargs の
--null を使うように、出力側のプログラムを組み立てる方が望ましい。
-E eof-str
eof-str をファイル終端文字列として設定する。 ファイル終端文字列が入力中の 1 行として現れると、それ
以後の入力は無視される。 -E も -e も指定しない場合、ファイル終端文字列は使用されない。 (訳注: 原文
には「入力中の 1 行として現れると (occurs as a line of input)」とあるが、実際の動作は「入力中に独
立した 1 項目として現れると、それ以後の入力は無視される」のようだ。)
-e[eof-str], --eof[=eof-str]
このオプションは -E オプションの同義語である。-E の方を使っていただきたい。 理由は、そちらが POSIX
に準拠しているのに対して、こちらは準拠していないからだ。 eof-str の部分が省略されると、ファイル終
端文字列が存在しないことになる。 -E も -e も指定しない場合、ファイル終端文字列は使用されない。
-I replace-str
initial-arguments 中で文字列 replace-str が現れるすべての箇所を、標準入力から読み込んだ名前で置き
換える。 なお、標準入力中にクォートされていない空白があっても、それは入力項目の区切りにはならな
い。 区切りの指標は改行文字だけになるのだ。-x と -L 1 が自動的に設定される。
[訳注]: もう少し詳しく説明した方がよいだろう。普通、ユーザが xargs で実行するコマンドに引き数 (そ
れが initial-arguments である。上記書式を参照) を指定した場合、標準入力から読み込まれた項
目群は、initial-arguments の後ろにどんどん追加されて行く。それに対して、-I replace-str オ
プションを使用した場合は、次の二点が異なっている。 一つは、標準入力は改行で分割され、その
1 行 1 行が、コマンド 1 回の実行につき 1 個づつ使用されること (それが -L 1 ということだ)。
もう一つは、その 1 行が 1 項目として扱われ (-L 1 を単独で使った場合とは、そこが違う)、その
1 項目が、initial-arguments の後ろに追加されるのではなく、initial-arguments 中の文字列
replace-str が現れるすべての位置に埋め込まれることだ。以下の例では、 "{}" が replace-str
であり、"{} is {}" の部分がコマンド echo に対する initial-arguments である。-I の直後の空
白は、あってもなくてもよく、replace-str は "{}" 以外の文字列でもよい。なお "{}" はクォート
した方がよいかもしれない。
$ echo -e "AAA BBB\nCCC\nDDD" |xargs -I{} echo {} is {}
AAA BBB is AAA BBB
CCC is CCC
DDD is DDD
入力項目を区切っているデリミタは改行だけであり、空白は項目の区切りとして機能していないのが
お分かりになるだろう。 別の言い方をすると、-I では、各行は 1 行全体が事実上クォートされて
コマンドに渡される (注意: -L 1 にそんな作用はない)。 従って、-I オプションを使えば、空白を
含むファイル名を処理できるということになる。 たとえば、カレントディレクトリに "nospace" と
"have space" というファイルがあるとしよう。
$ ls |xargs file
have: cannot open `have' (No such file or directory)
space: cannot open `space' (No such file or directory)
nospace: ASCII text
$ ls |xargs -L1 file
have: cannot open `have' (No such file or directory)
space: cannot open `space' (No such file or directory)
nospace: ASCII text
$ ls |xargs -I{} file {}
have space: UTF-8 Unicode text
nospace: ASCII text
-i[replace-str], --replace[=replace-str]
このオプションは、 replace-str が指定されていれば、-Ireplace-str の同義語である。引き数
replace-str が省略されていれば、-I{} と同じことになる。 このオプションは非推奨である。-I を使った
方がよい。
-L max-lines
1 コマンドラインにつき最大 max-lines 行の (空行ではない) 入力行を使用する。 入力行の行末に空白文字
が付いていると、その行は次の入力行に論理的に続いていることになる。 自動的に -x が指定される。
[訳注]: -n オプションとの違いに注意。 「行末に空白文字」云々については、以下の 3 番目の例を他のも
のと比較していただきたい。 コマンドの実行回数がわかるように、echo に initial-argument を付
けてみた (代わりに -t オプションを使ってもよかったかもしれない)。 なお、デリミタをヌル文字
にしたときや、--delimiter で指定したときの動作がどうなるかは、ご自分で試してみていただきた
い。
$ echo AAA BBB CCC |xargs -L1 echo "line: "
line: AAA BBB CCC
$ echo -e "AAA\nBBB\nCCC" |xargs -L1 echo "line: "
line: AAA
line: BBB
line: CCC
$ echo -e "AAA \nBBB\nCCC" |xargs -L1 echo "line: "
line: AAA BBB
line: CCC
-l[max-lines], --max-lines[=max-lines]
-L オプションの同義語である。-L とは違って、max-lines という引き数を指定するかどうかは任意であ
る。引き数 max-lines を指定しなかった場合は、デフォルトの 1 が使用される。POSIX 規格では -L の方を
使うことになっているので、-l オプションの使用はお勧めできない。
-n max-args, --max-args=max-args
1 コマンドラインにつき最大 max-args 個の引き数を使用する。 作成されたコマンドラインが、コマンドラ
イン長の上限を超過する場合は (-s オプション参照)、max-args より少ない引き数が使用されることにな
る。 ただし、-x オプションが指定されているときは別で、その場合は xargs が終了する。
-P max-procs, --max-procs=max-procs
同時に実行するプロセスの最大数を max-procs にする。デフォルトは 1 である。 max-procs が 0 だ
と、xargs はできるだけ多くのプロセスを同時に実行しようとする。 -P オプションには、-n か -L オプ
ションを併せて使用すること。 さもないと、おそらく exec 関数がたった一回しか実行されないことになる
だろう。 xargs の実行中に、そのプロセスに SIGUSR1 シグナルを送れば、同時に実行するコマンドの数を増
やすことができる。 また、SIGUSR2 シグナルを送れば、その数を減らすことができる。 ただし、実装が決め
ている上限を越えて増やすことはできないし (上限は --show-limits を使えば、知ることができる)、1 より
少なくすることもできない。 xargs は、実行しているコマンドを終了させるわけではない。 実行数を減らす
ように命じられたときは、単に現在動いているコマンドが二つ以上終了するのを待ち、 それから別のコマン
ドを開始するのである。
注意していただきたいが、共有リソースに対する並列アクセスをきちんと管理するのは、呼び出されるプロセ
ス側の問題だ。 たとえば、複数のプロセスが標準出力に書き出そうとした場合、出力は不定の順番で生成さ
れることになる (だから，混じり合ってしまう可能性が高い)。そうならないためには、プロセス同士が何ら
かの形で協力し合う必要がある。 ロッキング・スキームのようなものを使うのは、そうした問題を避けるた
めの一方法である。 ただ、一般に、ロッキング・スキームの使用は、適切な出力を保証してはくれるもの
の、パフォーマンスを低下させることになる。 パフォーマンスが落ちるのが嫌ならば、単純に各プロセスが
それぞれ別の出力ファイルを作るように (あるいは、別のリソースを使うように) すればよい。
-p, --interactive
コマンドライン 1 行ごとに、実行するかどうかをユーザに尋ねるプロンプトを出し、端末から 1 行読み込
む。コマンドラインを実行するのは、 返答が `y' または `Y' で 始まるときだけである。自動的に -t が指
定される。
--process-slot-var=name
複数の子プロセスを同時実行しているとき、その各子プロセスで環境変数 name にユニークな値をセットす
る。値は、子プロセスが終了すると、再利用される。 この機能は、たとえば、初歩的な負荷分散スキームで
利用できる。
-r, --no-run-if-empty
標準入力に空白しか含まれていない場合は、指定したコマンドを実行しない。 通常では、入力が全くない場
合でも、コマンドが一回は実行されるのである。 このオプションは GNU の拡張である。
-s max-chars, --max-chars=max-chars
1 コマンドラインにつき最大 max-chars の文字を使用する。 この文字数には、指定したコマンドと
initial-arguments、それに各引き数文字列の終端を示すヌル文字も含まれる。 指定できる値の上限は、シス
テム次第であり、exec 関数に対する引き数の最大長から、現在の環境のサイズと 2048 バイトの余裕領域を
引いたものである。もしその値が 128KiB 以上だったときは、デフォルトの値には 128KiB が使用される。
128KiB 未満のときは、算出された上限がデフォルトの値になる。 1KiB は 1024 バイトである。制限がより
厳しい場合でも、xarg は自動的にそれに対応する。
--show-limits
コマンドライン長の上限を表示する。コマンドライン長の上限は、 オペレーティングシステム、xargs が設
定したバッファサイズ、それに -s オプションによって決まる。xargs にコマンドライン長の上限の表示以外
をさせたくなかったら、 入力を /dev/null からパイプで xargs に渡してやればよい (さらに
--no-run-if-empty を指定した方がよいかもしれない)。
-t, --verbose
実行する前に、コマンドラインを標準エラー出力に表示する。
-x, --exit
作成されたコマンドラインがコマンドライン長の上限を超過していたら (-s オプションを参照)、終了する。
--help xargs のオプションについて簡単に説明し終了する。
--version
xargs のバージョン番号を表示して、終了する。
用例
find /tmp -name core -type f -print | xargs /bin/rm -f
/tmp ディレクトリ以下に core という名前のファイルを捜して、それを消去する。 改行や空白を含むファイル名が
あると、正しく動作しないので、注意すること。
find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f
/tmp ディレクトリ以下に core という名前のファイルを捜して、それを消去する。 ファイル名の処理に当たって
は、ファイル名やディレクトリ名に空白や改行が含まれていても、適切に扱われるようにしている。
find /tmp -depth -name core -type f -delete
/tmp ディレクトリ以下に core という名前のファイルを捜して、それを消去する。 上の例よりもこちらの方が効率
的である (なぜなら、 rm を実行するために fork(2) と exec(2) を使わないですむし、そもそも、 xargs のプロセ
スを必要としないから)。
cut -d: -f1 < /etc/passwd | sort | xargs echo
システムの全ユーザを列挙した簡潔なリストを生成する (訳注: 要するに、改行ではなく、空白で区切られたユーザ
名のリストを作るということ)。
xargs sh -c 'emacs "$@" < /dev/tty' emacs
xargs の標準入力からファイルのリストを受け取り、Emacs を必要なだけ次々と実行して、ファイルを編集する。こ
の例は BSD の -o オプションと同じことを実現するが、こちらの方が柔軟性があり、多くのシステムで利用できる。
終了ステータス
xargs の終了ステータスは以下のとおりである。
0 成功した。
123 指定したコマンドの実行が 1-125 のステータスで終了した。
124 指定したコマンドが 255 のステータスで終了した。
125 指定したコマンドがシグナルによって kill された。
126 指定したコマンドが実行できない。
127 指定したコマンドが見つからない。
1 上記以外のエラーが起きた。
128 以上の終了ステータスは、致命的なシグナルのせいでプログラムが止まったことを示すために、シェルが使用し
ている。
規格への準拠
GNU xargs version 4.2.9 以来、ファイルの論理的な終端を示す指標 (a logical end-of-file marker) を持たない
のが、xargs のデフォルトになっている。このことは POSIX (IEEE Std 1003.1, 2004 Edition) で認められている。
-l や -i オプションは 1997 年版の POSIX 規格には存在するが、 2004 年版の POSIX 規格には存在しない。従っ
て、それぞれ -L や -I の方を使うべきである。
POSIX 規格は、実装に当たって、exec 関数に対する引き数のサイズに上限を設けることを認めている。 そして、そ
の上限は、環境のサイズも含めて、少なくとも 4096 バイトあればよいことになっている。 移植性のあるスクリプト
を書こうと思ったら、これより大きいサイズを当てにしてはいけない。 もっとも、実際の上限がそんなに小さい実装
に、筆者は出会ったことがないけれど。 --show-limits オプションを使えば、使用中のシステムで有効な実際の上限
を知ることができる。
関連項目
find(1), locate(1), locatedb(5), updatedb(1), fork(2), execvp(3), kill(1), signal(7),
xargs には、Texinfo マニュアルの形で保守されている充実した文書がある。 info と xargs プログラムが、御使用
のサイトできちんとインストールされているならば、 info xargs とコマンドを打ち込むことで、詳細なマニュアル
が読めるはずだ。
バグ
-L オプションと -I オプションを組み合わせても、うまく行かない。 組み合わせて使えた方がよいのかもしれない
が。
[訳注]: -I オプションの説明にあるように、-I replace-str を指定すると、 -L 1 が自動的に設定される。だか
ら、ここで言っているのは、現状では -L 2 や -L 3 を -I と一緒に使っても、期待する結果は得られない
ということだろう。
xargs を安全に使うことは不可能である。なぜなら、入力されるファイル名のリストを生成する時間と xargs が実行
するコマンドがそれを使用する時間との間には、必ず時間差があるからだ。 もし、他のユーザがシステムにアクセス
することができれば、 そのユーザはこの時間の隙間にファイルシステムを操作して、xargs が実行するコマンドの動
作を、こちらが意図していないファイルに無理矢理向けることができる。 この問題や、これに関連する問題について
は、 findutils に含まれる Texinfo 文書の「Security Considerations」という章でもっと細かく論じているので、
そちらを参照していただきたい。なお、find の -execdir オプションは、より安全な方法として xargs の代わりに
使用できることが多い。
-I オプションを使うと、標準入力から読み込まれた各行が内部的にバッファされる。 それは、-I オプションを付け
て使ったとき、xargs が受け入れる入力行 1 行の長さに上限があるということだ。この制限を回避するには、-s オ
プションを使って、xargs が使用するバッファ空間のサイズを増やしてやればよい。 さらに、xargs をもう一つ実行
すれば、長すぎる行の出現を確実に避けることができる。たとえば、
somecommand | xargs -s 50000 echo | xargs -I '{}' -s 100000 rm '{}'
この例では、xargs の最初の実行には、入力行の長さの上限がない。 -I オプションを使っていないからである。
xargs の二番目の実行には、そうした上限があるが、処理できる以上の長さの行に絶対に出会わないようになってい
る。 これが理想的な解決法だというのではない。むしろ、 -I オプションによって入力行の長さに上限ができない方
がよいのであり、 だからこそ、この問題を「バグ」セクションで論じているのである。 なお、この問題は find(1)
の出力では起きない。find は 1 行に 1 ファイル名しか出力しないからだ。
バグ報告の最善の方法は、http://savannah.gnu.org/bugs/?group=findutils にある書式を使用することである。そ
うすれば、問題解決の進行状態を追うことができるからだ。 xargs(1) や findutils パッケージ全般についてのその
他のご意見は、 bug-findutils メーリングリストにお出しになればよい。 メーリングリストに参加するに
は、bug-findutils-request@gnu.org 宛に E メールを送っていただきたい。
翻訳について
この翻訳は findutils-4.6.0 所収の xargs.1 の翻訳である。 お手元の findutils は、もっと新しいバージョ
ン、たとえば 4.7.0-git になっているかもしれない。だが、4.7.0 は開発中の版なので、manpage も変化し続けてお
り、現時点で最新の 4.7.0 のマニュアルを翻訳しても、お手元の英語マニュアルとは内容が微妙に違うかもしれない
のだ。 バージョンが同じ 4.7.0 なのに、それでは紛らわしい。そこで、あえて現在の安定版、4.6.0 のマニュアル
を底本にした。
ご参考までに書いておくと、2017/06/09 以降の 4.7.0-git の xargs には、-o (--open-tty) というオプションが追
加されている。4.7.0-git の man xargs によれば、「コマンドを実行する前に、子プロセスで標準入力を /dev/tty
として再オープンする」というものである。そうした最近のバージョンでは -o オプションを使えば、たとえば
"find . -name '*.txt~' | xargs -o rm -i" といったことが可能になるようだ。失敗しても困らないファイルでお試
しいただきたい。 (2018/03/03)
XARGS(1)