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 echo1件ずつ、コマンドを実行する
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引数の個数を指定
-0NUL区切りに対応(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 11つずつ別々にコマンドを実行する
-0find -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を実際に打って進める課題があります。リンクを開くと、その課題がすぐに始まります。

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を使っている記事です。実際の場面での使い方の参考にしてください。

関連ページ

あわせて覚えたいコマンド:find・grep・rm・awk

「シェル操作の基礎」のコマンド解説:echo・tee・which・alias・export

xargsが登場する章:中級 第8章

コマンドをまとめて自動化したいときは、Linuxシェルスクリプト入門も参考にしてください。

← Linuxコマンド一覧へ戻る