xargsコマンドの使い方:標準入力の内容を引数としてコマンドに渡す
xargsは、標準入力から受け取った内容を、別のコマンドの引数として渡して実行するコマンドです。findやgrepで見つけた複数のファイルを、まとめて処理したいときに活躍します。
xargsの仕組みと基本の考え方
Linuxのコマンドがデータを受け取る方法には、標準入力と引数の2つがあります。grepやsortは標準入力を読めますが、rm・cp・lsなどは、対象を引数で受け取ります。xargsは、標準入力で届いた内容を引数に並べ直して、指定したコマンドを起動する橋渡し役です。
xargsは、受け取った項目をできるだけ多くまとめて、1回のコマンドに渡します。たとえば1000個のファイル名を受け取ると、rmを1000回ではなく、数回だけ実行します。引数の長さがシステムの上限を超えそうな場合は、自動で複数回に分割されるため、Argument list too longのエラーを避けられます。
動作は、オプションで調整できます。-nは1回のコマンドに渡す個数、-Iは値を埋め込む位置、-Pは同時に実行するプロセスの数を指定します。-Pを使うと、複数のサーバーへの疎通確認や、ファイルの圧縮などを並列で進められます。
xargsのよく使う形
実務や学習で登場しやすい使い方を、そのまま入力できる形でまとめました。
| コマンド例 | 内容 |
|---|---|
find . -name '*.log' | xargs ls -l | 見つかったファイルを、まとめて引数に渡す |
find . -name '*.tmp' -print0 | xargs -0 rm | 空白を含む名前も、安全に処理する |
cat list.txt | xargs -n 1 echo | 1件ずつ、コマンドを実行する |
ls *.txt | xargs -I {} cp {} {}.bak | 受け取った値を、指定した位置に埋め込む |
cat hosts.txt | xargs -P 4 -n 1 ping -c 1 | 最大4つまで、並列で実行する |
echo a b c | xargs -t echo | 実行されるコマンドを表示してから実行する |
xargsの主なオプション
| オプション | 意味 |
|---|---|
-I{} | 出力を差し込む位置を指定 |
-n | 引数の個数を指定 |
-0 | NUL区切りに対応(findの-print0と組み合わせ) |
xargsの実行例と結果の読み方
ls *.tmp | xargs -t rm を実行した結果です。表示の意味は、画面の下の「出力の読み方」で項目ごとに説明しています。
$ ls *.tmp | xargs -t rm
rm a.tmp b.tmp c.tmp
出力の読み方
| 表示・項目 | 意味 |
|---|---|
rm a.tmp b.tmp c.tmp | -t を付けたときの表示。実際に実行されたコマンド。受け取った行が、引数として後ろに並ぶ |
-n 1 | 1つずつ別々にコマンドを実行する |
-0 | find -print0 と組み合わせて、空白を含むファイル名を正しく扱う |
練習用ターミナルでは、xargsをブラウザ上で安全に試せます。
xargsの実務での使いどころ
特定の文字列を含むファイルを、まとめて確認する
grep -rl 'old-domain.example' /etc/nginx | xargs grep -n 'server_name'grep -lで該当するファイル名だけを取り出し、そのファイルに対して別の検索を行います。設定の変更前に、影響範囲を調べる場面で使えます。
古い一時ファイルを、確認してから削除する
find /tmp -name '*.tmp' -mtime +7 -print0 | xargs -0 ls -l
find /tmp -name '*.tmp' -mtime +7 -print0 | xargs -0 -r rmまずls -lで対象を確認し、問題がなければrmに置き換えて実行します。確認と実行を分けることで、誤って削除する事故を防げます。
xargsを組み合わせて使う実践例
複数のファイルを、並列で圧縮する
find /var/log/app -name '*.log' -mtime +1 -print0 | xargs -0 -P 4 -n 1 gzip-P 4で、最大4つのgzipを同時に実行します。ファイル数が多いとき、CPUのコアを活かして処理時間を短縮できます。
一覧に書かれたサーバーへ、順番に疎通確認する
cat hosts.txt | xargs -I {} sh -c 'ping -c 1 -W 1 {} > /dev/null && echo "{}: OK" || echo "{}: NG"'ホスト名を1行ずつ書いたファイルを読み、1台ごとにpingの結果を表示します。sh -cを使うと、複数のコマンドを組み合わせた処理を実行できます。
似たコマンドとの違い・使い分け
find -exec コマンド {} \;は1件ごとに、find -exec コマンド {} +はまとめてコマンドを実行します。後者はxargsとほぼ同じ動作で、空白を含む名前も安全に扱えます。findの結果を処理するだけなら-exec ... +、grepやファイルの一覧など別の入力を使う場合や、並列で実行したい場合はxargsが向いています。
実際の出力を並べると、違いがつかみやすくなります。
・find
条件を指定してファイルを検索する。
$ touch d.tmp e.tmp; find . -name '*.tmp' -exec rm -v {} \;
removed './d.tmp'
removed './e.tmp'
xargsを使うときの注意点
xargsは既定で、空白と改行を区切りとして入力を分割します。そのため、ファイル名にスペースが含まれると、別々の引数として扱われてしまいます。ファイル名を扱うときは、-print0と-0の組み合わせが安全です。
実行するコマンドを省略すると、echoが使われます。本番の処理の前に、どんな引数が渡されるかを確認する用途に使えます。
xargsでよくある失敗と対処
スペースを含むファイル名で、別のファイルが処理された
my file.txtは、myとfile.txtの2つとして扱われます。-print0と-0を組み合わせましょう。
対象が0件のときに、意図しない動作になった
入力が空でも、コマンドは引数なしで1回実行されます。-rを付けて、空のときは実行しないようにします。
xargsで困ったときの症状別チェック
実際の現場で出会いやすい症状を、原因の見当と確認方法とあわせて、逆引きできる形にまとめました。
| 症状 | 考えられる原因 | 確認・対処 |
|---|---|---|
| ファイルが見つからない、というエラーが出る | スペースを含む名前が、分割されている | -print0 | xargs -0の形にします。 |
unmatched single quoteと出る | 入力に引用符が含まれ、特別な文字として解釈された | -0を使うか、-d '\n'で改行だけを区切りにします。 |
| 対象が0件なのに、コマンドが実行された | 入力が空でも、1回は実行される仕様 | -rを付けます。 |
Argument list too longと出る | -Iなどで、1回の引数が長くなりすぎた | -nで1回に渡す個数を減らします。 |
xargsを手を動かして試す
スペースを含むファイル名が、通常の渡し方では分割され、-0を使うと正しく扱われることを比べます。続いて-n・-I・-tの動作も確認します。
mkdir -p ~/xatest && cd ~/xatest
touch a.txt b.txt 'c d.txt'
ls | xargs -n 1 echo item:
find . -name '*.txt' -print0 | xargs -0 -n 1 echo item:
echo 1 2 3 4 | xargs -n 2 echo
ls *.txt | head -n 2 | xargs -I {} echo copy {} to {}.bak
echo a b | xargs -t echo
安全に練習したいときは、練習用ターミナルでも同じ操作を試せます。
xargsを使う練習課題
ブラウザで動く練習用ターミナルに、xargsを実際に打って進める課題があります。リンクを開くと、その課題がすぐに始まります。
- find と xargs で複数ファイルをまとめて処理する(中級)
- find と xargs で不要なファイルをまとめて削除する(中級)
- 複数のログファイルを横断してエラーを調査する(中級)
- 複数階層にまたがる不要ファイルを一括削除する(上級)
xargsに関するよくある質問
パイプで直接渡すのと、何が違いますか?
パイプは、前のコマンドの出力を「標準入力」として渡します。rmやlsのように、対象を「引数」で受け取るコマンドは標準入力を読まないため、xargsで引数に変換する必要があります。
スペースを含むファイル名を安全に扱うには?
find ... -print0 | xargs -0 コマンドの形を使います。区切りをヌル文字にすることで、スペースや改行を含む名前も1つの引数として扱われます。
受け取った値を、コマンドの途中に入れるには?
-I {}を付けると、{}と書いた位置に値が埋め込まれます。このとき、コマンドは1件ごとに実行されます。
入力が空のときに、コマンドを実行させないようにするには?
-r(--no-run-if-empty)を付けます。対象が見つからなかったときに、引数なしでコマンドが実行されるのを防げます。
find -execとの違いは?
どちらも見つけたファイルにコマンドを実行できます。xargsはfind以外の出力にも使え、-Pで並列実行もできます。findだけで完結するなら、-exec ... +のほうが空白の扱いで安全です。
xargsのまとめ
xargsは、標準入力を引数に変換する橋渡し役です。ファイル名を扱うときは、-print0と-0を組み合わせましょう。
xargsが登場する記事
トラブルシューティングやエラーの対処、現場の作業手順の中で、xargsを使っている記事です。実際の場面での使い方の参考にしてください。
- Argument list too longの原因と対処法(エラーメッセージ辞典)
関連ページ
「シェル操作の基礎」のコマンド解説:echo・tee・which・alias・export
xargsが登場する章:中級 第8章
コマンドをまとめて自動化したいときは、Linuxシェルスクリプト入門も参考にしてください。