grep(1) manページ

-A NUM, --after-context=NUM
	NUM で指定した行数だけ、パターンにマッチした行の後の行も表示します。マッチしたグループの間には、 -- を含む行を挿入します。
-a, --text
	バイナリファイルをテキストファイルであるかのように処理します。これは --binary-files=text オプションと等価です。
-B NUM, --before-context=NUM
	NUM で指定した行数だけ、パターンにマッチした行の前の行も表示します。マッチしたグループの間には、 -- を含む行を挿入します。
-C NUM, --context=NUM
	NUM で指定した行数だけ、パターンにマッチした行の前後の行も表示します。マッチしたグループの間には、 -- を含む行を挿入します。
-b, --byte-offset
	各出力行の前に、入力ファイルの先頭からのバイト単位のオフセットを表示します。
--binary-files=TYPE
	ファイルの最初の数バイトが、ファイルの内容がバイナリファイルであることを示す場合、ファイルのタイプを TYPE であると仮定します。デフォルトでは TYPE は binary であり、 grep は通常、バイナリファイルの一致を示す一行メッセージを表示するか、マッチしない場合にはなにも表示しません。 TYPE が without-match の場合、 grep はバイナリファイルはマッチしないものと仮定します。これは -I オプションと等価です。 TYPE が text の場合、 grep はバイナリファイルをテキストであるかのように扱います。これは -a オプションと等価です。警告: grep --binary-files=text はバイナリのゴミを表示する可能性があります。出力先が端末である場合で、端末ドライバがこのゴミの一部をコマンドであると解釈する場合、このゴミが悪い副作用をおよぼす可能性があります。
--colour[=WHEN], --color[=WHEN]
	マッチした文字列を GREP_COLOR 環境変数でで指定されたマーカで囲みます。 WHEN は、`never' または `always'、`auto' のどれかです。
-c, --count
	通常の出力はせず、各入力ファイルについてマッチした行数を表示します。 -v, --invert-match オプションと共に指定した場合は、マッチしなかった行数を表示します (下記参照)。
-D ACTION, --devices=ACTION
	入力ファイルがデバイス、FIFO もしくはソケットの場合、 ACTION を使ってその処理を行いますデフォルトでは ACTION は read であり、デバイスが通常ファイルであるかのように読み取る事を意味します。 ACTION が skip なら、デバイスを黙って読み飛ばします。
-d ACTION, --directories=ACTION
	入力ファイルがディレクトリの場合に、 ACTION を使ってその処理を行います。デフォルトでは ACTION は read であり、ディレクトリを普通のファイルであるかの様に読み取る事を意味します。 ACTION が skip なら、ディレクトリを黙って読み飛ばします。 ACTION が recurse なら、 grep は各ディレクトリ下のすべてのファイルを再帰的に読み取ります。これは -r オプションと等価です。
-E, --extended-regexp
	PATTERN を拡張された正規表現として扱います (下記参照)。
-e PATTERN, --regexp=PATTERN
	PATTERN をパターンとして指定します。 - で始まるパターンを保護するために有効です。
-F, --fixed-strings
	PATTERN を改行で区切られた固定文字列のリストとして扱います。その文字列のどれかとマッチするかを調べます。
-P, --perl-regexp
	PATTERN を Perl の正規表現として解釈します。
-f FILE, --file=FILE
	パターンを FILE から 1 行ごとに読み込みます。空のファイルはパターンを含まないので、何にもマッチしません。
-G, --basic-regexp
	PATTERN を基本的な正規表現として扱います (下記参照)。デフォルトです。
-H, --with-filename
	各々のマッチに対してファイル名を表示します。
-h, --no-filename
	複数ファイルを検索した時に、出力の前にファイル名を付けることを抑制します。
--help	簡単なヘルプメッセージを出力します。
-I	バイナリファイルをマッチするデータを含まないかのように処理します。これは --binary-files=without-match オプションと等価です。
-i, --ignore-case
	PATTERN と入力ファイルの双方で、英大文字と小文字の区別をしないようにします。
-L, --files-without-match
	通常の出力はせず、このオプションを指定しなかったときに全く出力されない入力ファイルの名前を表示します。スキャン動作は最初のマッチで終了します。
-l, --files-with-matches
	通常の出力はせず、このオプションを指定しなかったときに出力される入力ファイルの名前を表示します。スキャン動作は最初のマッチで終了します。
-m NUM, --max-count=NUM
	NUM 個のマッチした行のあと、ファイルの読み取りを停止します。もし、通常ファイルから標準入力を介して入力が行われており、 NUM 個のマッチした行が出力だった場合、その後に続くコンテキスト行があるかどうかに関わらず、 grep は、終了する前に標準入力が最後にマッチした行の直後に位置される事を保証します。これによって、呼び出したプロセスが検索を再開する事が可能となります。 NUM 個のマッチした行の後に停止した場合、 grep は、その後に続くコンテキスト行を出力します。 -c や --count オプションも指定された場合、 grep は NUM より大きな行数を出力しません。 -v や --invert-match オプションも指定された場合、 grep は NUM 個のマッチしない行の出力後に停止します。
--mmap	可能ならば、デフォルトの read(2) システムコールの代わりに mmap(2) システムコールを使って入力を読み取ります。ある状況において、 --mmap はよりよい性能をもたらします。しかし、 grep の動作中に入力ファイルが小さくなるか、または I/O エラーが生じた場合に、 --mmap は (コアダンプを含む) 未定義の動作を引き起こす可能性があります。
-n, --line-number
	各出力行の前に、入力ファイルにおける行番号を表示します。
-o, --only-matching
	マッチした行の PATTERN にマッチした部分のみを表示します。
--label=LABEL
	実際には標準入力からの入力を、ファイル LABEL からの入力として表示します。これは zgrep などのツールに対して、特に便利です。例: gzip -cd foo.gz \|grep --label=foo something
--line-buffered
	行ごとに出力をおこないます。これはパフォーマンスが悪くなる事があります。
-q, --quiet, --silent
	沈黙: 標準出力には何も出力しません。何かマッチした場合、エラーが起きた時でも直ちに返り値 0 で終了します。 -s や --no-messages オプションも参照。
-R, -r, --recursive
	各ディレクトリ下のすべてのファイルを再帰的に読み取ります。これは -d recurse オプションと等価です。
--include=PATTERN
	PATTERN にマッチするファイルのみを検索しながら、ディレクトリを再帰します。
--exclude=PATTERN
	PATTERN にマッチするファイルを読み飛ばしながら、ディレクトリを再帰します。
-s, --no-messages
	指定されたファイルが存在しないことや読み込みできないことを示すエラーメッセージを抑止します。移植性に関する注: GNU grep とは異なり、伝統的な grep は POSIX.2 に適合していませんでした。なぜなら、伝統的な grep には -q オプションが無く、 -s オプションは GNU grep の -q オプションの様に動作したからです。伝統的な grep へ移植可能であることを意図したシェルスクリプトは、 -q と -s を両方とも使わずに、出力を /dev/null へリダイレクトすべきです。
-U, --binary
	ファイルをバイナリとして扱います。デフォルトでは、MS-DOS と MS-Windows 環境下で grep は、ファイルから読み取った最初の 32KB の内容を見て、ファイルタイプを推測します。 grep はファイルをテキストファイルと判断した場合、オリジナルのファイル内容から ( ^ と $ が使われている正規表現を正しく動作させるために ) CR 文字を取り除きます。 -U を指定すると、この当て推量を抑制し、すべてのファイルを読み取ってマッチ機構へそのまま渡します。もしファイルが各行の末尾に CR/LF の組みを持つテキストファイルなら、このオプションは正規表現を役に立たなくさせることがあるでしょう。このオプションは MS-DOS と MS-Windows 以外のプラットフォームでは効果がありません。
-u, --unix-byte-offsets
	unix 形式のバイト単位オフセットを報告します。このスイッチを指定すると grep は、ファイルが unix 形式のテキストファイル、すなわち、 CR 文字が取り除かれたファイルであるかのごとくにバイト単位オフセットを報告します。このことは grep を Unix マシンで動作させたのと同じ結果を生成します。このオプションは -b オプションも使用しない限り効果がありません。 MS-DOS と MS-Windows 以外のプラットフォームでは効果がありません。
-V, --version
	grep のバージョン番号を標準エラー出力に表示します。バグレポートには、この番号を付記してください (下記参照)。
-v, --invert-match
	結果を反転し、マッチしなかった行を選択します。
-w, --word-regexp
	完全な語にマッチする行のみを選択します。マッチする部分文字列が行頭から始まっているか、単語構成文字以外の文字が前にあることがテストされます。同様に、マッチする部分文字列が行末まであるか、単語構成文字以外の文字が後にある必要があります。単語構成文字とは、レター・数字・アンダスコアです。
-x, --line-regexp
	行全体と正確にマッチする行のみを選択します。
-y	-i と同じ意味を持つ旧式のオプションです。
--null	通常ファイル名の後に続く文字の代わりにバイト 0 (ASCII NUL 文字) を出力します。例えば、 grep -l --null は各ファイル名の後に、通常の newline ではなくバイト 0 を出力します。このオプションを指定すると、 newline 等の例外的な文字を含むファイル名に直面した場合でも出力が明白になります。このオプションを find -print0, perl -0, sort -z, xargs -0 等のコマンドと共に使用すれば、任意のファイル名を処理できます。ファイル名が newline 文字を含んでいても処理可能です。
-Z, --decompress
	検索を開始する前に入力データを伸長します。このオプションは zlib(3) ライブラリと共にコンパイルした場合のみ使用可能です。 -J, --bz2decompress 検索を開始する前に入力データを bzip2(1) を使用して伸長します。

?	直前の項目はオプションであり、最大 1 回マッチします。
*	直前の項目は 0 回以上マッチします。
+	直前の項目は 1 回以上マッチします。
{n}	直前の項目は厳密に n 回マッチします。
{n,}	直前の項目は n 回以上マッチします。
{n,m}
	直前の項目は、最低 n 回、最大 m 回マッチします。

GREP_OPTIONS
	この変数は明示的なオプションの前に指定されるデフォルトオプションを指定します。例えば、もし GREP_OPTIONS が '--binary-files=without-match --directories=skip' である場合、 grep は 2 つのオプション --binary-files=without-match と --directories=skip が明示的なオプションの前に指定されている様に動作します。オプションの指定は空白によって区切られます。バックスラッシュは次の文字をエスケープします。これは空白やバックスラッシュを含むオプションを指定するために用いられます。
GREP_COLOR
	ハイライトするマーカを指定します。
LC_ALL, LC_COLLATE, LANG
	これらの変数は、 [a-z] のような範囲式を解釈する際の参照順序を決定する LC_COLLATE を指定します。
LC_ALL, LC_CTYPE, LANG
	これらの変数は、例えばどの文字が空白であるかなど、文字の種類を決定する LC_CTYPE を指定します。
LC_ALL, LC_MESSAGES, LANG
	これらの変数は、 grep の出すメッセージの言語を決定する LC_MESSAGES を指定します。デフォルトの C ロケールは、アメリカ英語のメッセージを使用します。
POSIXLY_CORRECT
	設定されている場合、 grep は POSIX.2 として動作し、それ以外の場合は grep は他の GNU プログラムのように動作します。 POSIX.2 ではファイル名の後に続くオプションはファイル名として扱われます。デフォルトでは、このようなオプションはオペランドリストの先頭に並び変えられて、オプションとして扱われます。また、POSIX.2 では認識できないオプションは `` 不法 (illegal)'' であると診断されますが、法律に違反しているわけではないので、デフォルトではこれらは``不正 (invalid)'' であると診断されます。

manページ — GREP

名称

内容

書式

解説

オプション

正規表現

環境変数

診断

バグ