diff - コマンド (プログラム) の説明 - Linux コマンド集 一覧表

diff - 2 つのファイル間の違いを探す

diff [-abcdefhilnpqrstuwyBEHNPT ] [-LINES ] [-x PATTERN ] [-C LINES ] [-D NAME ] [-F REGEXP ] [-I REGEXP ] [-L LABEL ] [-S FILE ] [-U LINES ] [-W COLUMNS ] [-X FILE ] [--binary ] [--brief ] [--changed-group-format=fORMAT ] [--context [=LINES ]] [--diff-program=PROGRAM ] [--ed ] [--exclude=PATTERN ] [--exclude-from=FILE ] [--expand-tabs ] [--forward-ed ] [--from-file=FILE ] [--horizon-lines=LINES ] [--ifdef=NAME ] [--ignore-all-space ] [--ignore-blank-lines ] [--ignore-case ] [--ignore-file-name-case ] [--ignore-matching-lines=REGEXP ] [--ignore-space-change ] [--ignore-tab-expansion ] [--inhibit-hunk-merge ] [--initial-tab] [--label=LABEL ] [--left-column ] [--line-format=FORMAT ] [--minimal ] [--new-file ] [--new-group-format=FORMAT ] [--new-line-format=FORMAT ] [--no-ignore-file-name-case] [--old-group-format=FORMAT ] [--old-line-format=FORMAT ] [--paginate ] [--rcs ] [--recursive ] [--report-identical-files ] [--sdiff-merge-assist ] [--show-c-function ] [--show-function-line=REGEXP ] [--side-by-side ] [--speed-large-files ] [--starting-file=FILE ] [--strip-trailing-cr ] [--supress-common-lines ] [--text ] [--to-file=FILE ] [--unchanged-group-format=FORMAT ] [--unchanged-line-format=FORMAT ] [--unidirectional-new-file] [--unified [=LINES ]] [--width=COLUMNS ] FROMFILE TOFILE
diff [-v ] [--help ] [--version ]

diff は 2 つのファイルを比較し、それらの違いを記述して出力する。
もっとも簡単な場合は、比較対象のファイルは FROMFILE と TOFILE である。これらのファイルのうちのどちらかは ` - 'と指定しても良い。この時はそのファイルは標準入力から読み込まれる。
FROMFILE がディレクトリで TOFILE がディレクトリではない場合、 diff はディレクトリ FROMFILE にある、ファイル名が TOFILE のファイルを比較対象にする (逆も同様)。 ディレクトリでない方の指定を ` - 'にすることはできない。
両方がディレクトリのときは、 diff は双方のディレクトリにある、対応するファイルを アルファベット順にそれぞれ比較する。 比較は再帰的には行われないが、 -r または --recursive オプションを指定すれば再帰的になる。 diff はディレクトリの内容そのものをファイルのように比較することはしない。 フルパス指定のファイルは ` - 'であってはならない。なぜなら標準入力には名前がないので、 「同名のファイル」という概念が使えないからである。
--from-file=FILE オプションが与えられると、任意の数のファイル名を与えることができ、 それぞれのファイルは FILE と比較される。 同様に、 --to-file=FILE オプションが与えられると、それぞれ指定されたファイルは FILE と比較される。 [訳注: 2.7 にはこれらのオプションは存在しない]

- LINES

異なっている部分の前後 LINES 行 (整数) 分のコンテクストを表示する。 このオプションは出力形式自体の指定は行わない。 したがって -c や -u オプションと一緒に用いないと、なんの効果も持たない。 このオプションは obsolete である。   patch (1) が正しく動作するには、少なくとも 2 行のコンテクストが必要である。

-a, --text

ファイルがテキストには見えないような場合でも、 全てのファイルをテキストとみなして 1 行ずつ比較を行う。

-b, --ignore-space-change

スペースの数だけが違う場合には違いを無視する。 不完全な行は無視される。

-c

context 出力形式を用いる。

-d, --minimal

アルゴリズムを変更し、より小さな差分が生成できるようにする。 これを使うと diff は遅くなる (非常に遅くなる場合もある)。

-e, --ed

  ed (1) のスクリプト形式で出力する。

-f, --forward-ed

ed のスクリプトと一見同じような出力をする。 しかし出力に現れる順序が異なる [訳注: したがって ed では使えない]。

-h

現在は何も効果を持たない。Unix との互換性のために存在している。 これは推奨されない。

-i, --ignore-case

英大文字と小文字の違いを無視する。

-l, --paginate

出力を   pr (1) に通してページ付けを行う。

-n, --rcs

RCS 形式の diff を出力する。 -f と似ているが、それぞれのコマンドは処理する行数を指定する。

-p, --show-c-function

変更がどの C 関数で行われたのかを表示する。 `-F'^[_a-zA-Z$]'' と同じ。

-q, --brief

ファイルが違うかどうかだけを報告する。 違いの詳細は報告しない。

-r, --recursive

ディレクトリを比較するとき、 見付かったサブディレクトリをすべて再帰的に比較する。

-s, --report-identical-files

2 つのファイルが同じだったときも報告する。

-t, --expand-tabs

入力ファイルでのタブによる位置あわせを保存するため、 出力のタブをスペースに展開する。

-u

unified 出力形式を用いる。

-w, --ignore-all-space

行を比較するときスペースを無視する。 不完全な行は無視される。

-x PATTERN , --exclude= PATTERN

ディレクトリを比較するとき、 ファイル名の base 部が PATTERN にマッチするファイルやサブディレクトリを無視する。

-y, --side-by-side

side-by-side 出力形式を用いる。

-B, --ignore-blank-lines

空行を挿入・削除するだけの変更を無視する。

-C LINES , --context[= LINES ]

context 出力形式を用い、 LINES 行 (整数値) のコンテクストを表示する。 LINES が与えられなければ 3 行表示する。 patch が正しく動作するためには、 少なくとも 2 行のコンテクストが必要であることが多い。

-D NAME , --ifdef= NAME

if-then-else 形式でマージされた出力を行い、 プリプロセッサの条件マクロに NAME を用いる。

"-E, --ignore-tab-expansion"

タブ展開によるスペースの変更を無視する。

-F REGEXP , --show-function-line= REGEXP

context 形式と unified 形式において、 各差分 hunk (テキストブロック) に対し、 その前方で REGEXP にマッチした最後の行の一部を表示する。

-H, --speed-large-files

小さな変更が大量にあるような大きなファイルを高速に扱うために、 ヒューリスティックな手法を用いる。 短縮形式 -H は推奨されなくなった。

-I REGEXP , --ignore-matching-lines= REGEXP

REGEXP にマッチするような行を挿入・削除するだけの変更を無視する。

-L LABEL , --label= LABEL

context 形式と unified 形式のヘッダに、 ファイル名ではなく LABEL を用いる。 短縮形式 -L は推奨されなくなった。

-N, --new-file

ディレクトリを比較する際、 片方のディレクトリにのみファイルが存在していたら、 もう片方のディレクトリには同名の空っぽのファイルがあるように動作する。

-P, --unidirectional-new-file

ディレクトリを比較する際、 2 番目のディレクトリにのみファイルが存在していたら、 1 番目のディレクトリには同名の空っぽのファイルがあるように動作する。 短縮形式 -P は推奨されなくなった。

-S FILE , --starting-file= FILE

ディレクトリを比較する際、 FILE から始める。中断した比較を続行する際に利用できる。

-T, --initial-tab

normal 形式や context 形式で、テキストの前にスペースでなくタブを出力する。 こうすると行中でのタブによる桁揃えが普通に見える。

-U LINES , --unified [ = LINES ]

unified 出力形式を用い、 LINES 行 (整数値) のコンテクストを表示する。 LINES が与えられなければ 3 行表示する。 patch が正しく動作するためには、 少なくとも 2 行のコンテクストが必要であることが多い。

-W COLUMNS , --width= COLUMNS

side-by-side 形式で、出力の幅を COLUMNS にする。

-X FILE , --exclude-from= FILE

ディレクトリを比較する際、 ファイル名の base 部が FILE のパターンのいずれかにマッチするファイルやサブディレクトリを無視する。

--binary

データをバイナリモードで読み書きする (Linux やその他の POSIX ホストでは意味なし)。

--changed-group-format= FORMAT

if-then-else 形式で、 両方のファイルで異なる行グループの出力に FORMAT を用いる。

--diff-program= PROGRAM

ファイルの比較するために diff と互換性のある 外部プログラム PROGRAM を用いる。

--from-file= FILE

FILE を各オペランドと比較する (FILE はディレクトリでも良い)。 [訳注: 2.7 にはこのオプションは存在しない]

--horizon-lines= LINES

差分をもっともコンパクトに出力するために、 違う部分の前後にある共通部分のそれぞれ LINES 行を捨てずに保存する。

--ignore-file-name-case

ファイルを比較する際にファイル名の大文字小文字を無視する。 そのため ``foo'' と ``Foo'' は同じとされるので、互いに比較される。

--inhibit-hunk-merge

隣接する hunk の境界を移動して hunk をマージする動作を行わない。

--left-column

side-by-side 形式で、共通な行は左側の列にしか表示しない。

--line-format= FORMAT

if-then-else 形式で、全ての入力行の出力に FORMAT を用いる。

--new-group-format= FORMAT

if-then-else 形式で、 2 番目のファイルだけにある行グループの出力に FORMAT を用いる。

--new-line-format= FORMAT

if-then-else 形式で、 2 番目のファイルだけにある行の出力に FORMAT を用いる。

--no-ignore-file-name-case

ファイルを比較する際に、ファイル名の大文字小文字を考慮する。 そのため ``foo'' と ``Foo'' は同じものとされない。 --ignore-file-name-case を参照すること。

--old-group-format= FORMAT

if-then-else 形式で、 1 番目のファイルだけにある行グループの出力に FORMAT を用いる。

--old-line-format= FORMAT

if-then-else 形式で、 1 番目のファイルだけにある行の出力に FORMAT を用いる。

--sdiff-merge-assist

  sdiff (1) 用に追加情報を表示する。 sdiff が diff を実行するときにこのオプションを用いる。 通常のユーザーがこのオプションを直接指定する場合はあまり想定されていない。

--strip-trailing-cr

行末の CR を取り除く。 行末のマーカとして CRLF を使うシステムの出力を処理するときに役立つ。

--suppress-common-lines

side-by-side 形式で共通な行を表示しない。

--unchanged-group-format= FORMAT

if-then-else 形式で、 両方のファイルに共通な行グループの出力に FORMAT を用いる。

--unchanged-line-format= FORMAT

if-then-else 形式で、 両方のファイルに共通な行の出力に FORMAT を用いる。

"--help"

標準出力に使用方法のメッセージを出力して正常終了する。

-v, --version

diff のバージョン番号を出力する。

context 形式

*** FROMFILE FROMFILE-MODIFICATION-TIME
--- TOFILE TOFILE-MODIFICATION-TIME

***************
*** FROMFILE-LINE-RANGE ****
  FROMFILE-LINE
  FROMFILE-LINE...
--- TOFILE-LINE-RANGE ----
  TOFILE-LINE
  TOFILE-LINE...

unified 形式

--- FROMFILE FROMFILE-MODIFICATION-TIME
+++ TOFILE TOFILE-MODIFICATION-TIME

@@ FROMFILE-RANGE TOFILE-RANGE @@
LINE-FROM-EITHER-FILE
LINE-FROM-EITHER-FILE...

side-by-side 形式

ed(1) 形式

CHANGE-COMMAND
TO-FILE-LINE
TO-FILE-LINE...
.

RCS 形式

C ソース形式

    do {
 #ifndef HAVE_WAITPID
          if ((w = wait (&s)) < 0 && errno != EINTR)
 #else /* HAVE_WAITPID */
          if ((w = waitpid (-1, &s, 0)) < 0  &&  errno != EINTR)
 #endif /* HAVE_WAITPID */
          return w;
    } while (w != child);

行グループ形式

 diff \
    --old-group-format='\begin{em}
 %<\end{em}
 '  \
    --new-group-format='\begin{bf}
 %>\end{bf}
 '  \
    old new

 diff \
    --old-group-format='\begin{em}
 %<\end{em}
 ' \
    --new-group-format='\begin{bf}
 %>\end{bf}
 ' \
    --unchanged-group-format='%=' \
    --changed-group-format='\begin{em}
 %<\end{em}
 \begin{bf}
 %>\end{bf}
 '  \
    old new

 diff \
    --unchanged-group-format='' \
    --old-group-format='-------- %dn line%(n=1?:s) deleted at %df:
 %<' \
    --new-group-format='-------- %dN line%(N=1?:s) added after %de:
 %>' \
    --changed-group-format='-------- %dn line%(n=1?:s) changed at %df:
 %<-------- to:
 %>' \
    old new

グループ変換

行形式

diff への 2 つの引数がディレクトリだった場合、 両方のディレクトリにそれぞれのファイルが、 ファイル名のアルファベット順に比較される。 通常はファイルのペアに違いが全くなければ、何も出力しない。 しかし -s オプションを用いると、同一のファイルも報告する。 両方のディレクトリに同名のサブディレクトリがあると、 通常 diff は報告だけしてサブディレクトリ以下のファイルは比較しない。 しかし -r オプションを用いると、 ディレクトリツリーを辿れる限り、対応する全てのファイルを比較する。
片方のディレクトリだけにあるファイルに対しては、 diff は通常存在するファイルの内容を表示せず、 ファイルが片方にあって他方にはないことだけを報告する。 diff の振舞いを変えて、 他方のディレクトリにもファイルが空の状態で存在するかのように 動作させることもできる。すなわち diff は実際に存在するファイルの内容をすべて出力する。 (この出力は、ファイルが第 1 ディレクトリにあれば削除、 第 2 ディレクトリにあれば挿入となる。) この指定には -N オプションを使う。
古いほうのディレクトリに大きなファイルがあって、 新しいほうにはない場合、 -N オプションの代わりに -Pオプションを用いるとパッチの大きさを小さくできる。 -P オプションは -N オプションと似ているが、第 2 ディレクトリにあるファイルの内容だけを 出力に挿入し、第 1 ディレクトリだけにあるファイルは無視する (すなわち、追加されたファイルだけを扱う)。 そして、パッチを当てる前に消去されたファイルを削除するよう、 パッチの先頭にパッチを当てるユーザーへの指示を書く。
ディレクトリの比較時に特定のファイルを無視させるには、 -x PATTERN オプションを用いる。シェルとは異なり、ファイル名の先頭のピリオドは、 パターン先頭のワイルドカードにマッチする。 シェルによって展開されないよう、 PATTERN はクォート記号で囲うべきである。 例えば `-x '*.[ao]'' は `.a' や `.o' で終わる名前のファイルをすべて無視する。 このオプションは、複数指定するとそれぞれが有効になる。 例えば `-x 'RCS' -x '*,v'' というオプションを指定すると、 ファイル名が `RCS' だったり `*,v' で終わるような ファイルとサブディレクトリをすべて無視する。

diff は以下の値のどれかで終了する:

0

全く変更がなかった。

1

変更があった。

2

何らかのエラーが起こった。

  cmp (1),   comm (1),   diff3 (1),   ed (1),   patch (1),   pr (1),   sdiff (1) 

プログラムのバグについては bug-gnu-utils@gnu.org へ報告してください。 ページの更新は Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com> が行っています。