XARGS(1)

名称
xargs - 標準入力から引数を読み、コマンドを実行する

書式
xargs [-t] [[-x] -n number] [-s size] [utility [arguments ...]]

解説
xargs ユーティリティは、スペース、タブ文字、改行、及び EOF で区切られた引数を標準入力から読み取り、指定した utility にその引数をつけて実行します。

utility は標準入力を使い切るまで繰り返し実行されます。

スペース、タブ、改行はシングルクォート (`` ' '') や ダブルクォート (``"'') やバックスラッシュ (``\'') で埋め込むことができます。シングルクォートは次のシングル クォートにマッチするまで改行を除く全てのシングルクォート でない文字のエスケープを行います。 ダブルクォートは次のダブル クォートにマッチするまで改行を除く全てのダブルクォート でない文字のエスケープを行います。 バックスラッシュは改行を含む全てのキャラクタのエスケープ を行います。

オプションは以下のものがあります:

-n number
    utility の各実行で消費する引数の個数の最大数をセットします。 もしバイト数が size を越えた場合 (-s オプション参照) や utility の最後の実行用に残った引数の個数が number 以下の 場合は number 以下の個数で実行されます。 number の現在の デフォルト値は 5000 です。

-s size
    utility に渡すコマンドラインの最大バイト数をセットします。 utility の長さと utility に渡される引数の長さの和 (終端の NULL も含む) がこの値以下になります。 size の現在のデフォルト値は ARG_MAX - 2048 です。

-t  実行されるコマンドをその実行の直前に標準出力にエコーします。

-x  引数の個数が number 引数で指定した (もしくはデフォルトの) 長さに 合わない場合は xargs は直ちに終了します。

もし utility が指定されていなければ、 echo(1) が使われます。

utility が標準入力を読むプログラムの場合は予期せぬ動作を するかもしれません。

もし、コマンドラインを組み立てられなかった時や utility を実行 出来なかった時、ユーティリティがシグナルで終了した時、もしくは ユーティリティが戻り値 255 で終了した時は xargs は直ちに終了します。

戻り値
xargs は終了時に以下の値を返します:
0   utility の実行全てが 0 を返した場合。
123 utility の実行において、1 つ以上の実行で 0 以外の値が返ってきた場合。
124 utility の戻り値が 255 で終了した場合。
125 utility が kill されたか、シグナルでストップした場合。
126 utility は見つかったが実行できなかった場合。
127 utility が見つからなかった場合。
1   上記以外のエラーが起こった場合。

関連項目
echo(1), find(1)

規格
xargs ユーティリティは p1003.2 互換です。