.\" grep man page
.if !\n(.g \{\
.	if !\w|\*(lq| \{\
.		ds lq ``
.		if \w'\(lq' .ds lq "\(lq
.	\}
.	if !\w|\*(rq| \{\
.		ds rq ''
.		if \w'\(rq' .ds rq "\(rq
.	\}
.\}
.de Id
.ds Dt \\$4
..
.TH GREP 1  "GNU Project"
.SH NAME
grep, egrep, fgrep \- 打印匹配給定模式的行
.SH 總覽 SYNOPSIS
.B grep
.RI [ options ]
.I PATTERN
.RI [ FILE .\|.\|.]
.br
.B grep
.RI [ options ]
.RB [ \-e
.I PATTERN
|
.B \-f
.IR FILE ]
.RI [ FILE .\|.\|.]
.SH 描述 DESCRIPTION
.PP
.B Grep
搜索以
.IR FILE
命名的文件輸入 (或者是標準輸入，如果沒有指定文件名，或者給出的文件名是
.B \-
的話)，尋找含有與給定的模式
.IR PATTERN 
相匹配的內容的行。
默認情況下，
.B grep
將把含有匹配內容的行打印出來。
.PP
另外，也可以使用兩個變種程序
.B egrep
和
.B fgrep
。
.B Egrep
與
.BR "grep\ \-E"
相同。
.B Fgrep
與
.BR "grep\ \-F"
相同。
.SH 選項 OPTIONS
.TP
.BI \-A " NUM" "\fR,\fP \-\^\-after-context=" NUM
打印出緊隨匹配的行之後的下文
.I NUM
行。在相鄰的匹配組之間將會打印內容是
.B \-\^\-
的一行。
.TP
.BR \-a ", " \-\^\-text
將一個二進制文件視爲一個文本文件來處理；它與
.B \-\^\-binary-files=text
選項等價。
.TP
.BI \-B " NUM" "\fR,\fP \-\^\-before-context=" NUM
打印出匹配的行之前的上文
.I NUM
行。在相鄰的匹配組之間將會打印內容是
.B \-\^\-
的一行。
.TP
.BI \-C " NUM" "\fR,\fP \-\^\-context=" NUM
打印出匹配的行的上下文前後各
.I NUM
行。在相鄰的匹配組之間將會打印內容是
.B \-\^\-
的一行。
.TP
.BR \-b ", " \-\^\-byte-offset
在輸出的每行前面同時打印出當前行在輸入文件中的字節偏移量。
.TP
.BI \-\^\-binary-files= TYPE
如果一個文件的起始幾個字節表明文件包含二進制數據，那麼假定文件是
.IR TYPE
類型的。默認情況下，
.I TYPE
是
.BR binary
，並且
.B grep
一般會輸出一個一行的消息說一個二進制文件匹配，或者如果沒有匹配的話就沒有消息輸出。如果類型
.I TYPE
是
.BR without-match
，那麼
.B grep
假定二進制文件不會匹配；這樣做與
.B \-I
選項等價。如果類型
.I TYPE
是
.BR text
，那麼
.B grep
將一個二進制文件視爲文本文件來處理；它與
.B \-a
選項等價。
.I 警告：
.B "grep \-\^\-binary-files=text"
可能會輸出二進制的無用內容。如果輸出設備是一個終端，並且終端的驅動將這些輸出中的一些當作命令，可能會帶來惡劣的副作用。
.TP
.BI \-\^\-colour[=\fIWHEN\fR] ", " \-\^\-color[=\fIWHEN\fR]
在匹配的行周圍以
.B GREP_COLOR
環境變量中指定的記號來標記。WHEN 可以是 `never', `always', 或是 `auto'。
.TP
.BR \-c ", " \-\^\-count
禁止通常的輸出；作爲替代，爲每一個輸入文件打印一個匹配的行的總數。如果使用
.BR \-v ", " \-\^\-invert-match
選項 (參見下面)，將是不匹配的行的總數。
.TP
.BI \-D " ACTION" "\fR,\fP \-\^\-devices=" ACTION
如果輸入文件是一個設備，FIFO 或是套接字 (socket) ，使用動作
.I ACTION
來處理它。默認情況下，動作
.I ACTION
是
.BR read
，意味着設備將視爲普通文件那樣來讀。如果動作
.I ACTION
是
.BR skip
，將不處理而直接跳過設備。
.TP
.BI \-d " ACTION" "\fR,\fP \-\^\-directories=" ACTION
如果輸入文件是一個目錄，使用動作
.I ACTION
來處理它。默認情況下，動作
.I ACTION
是
.BR read
，意味着目錄將視爲普通文件那樣來讀。如果動作
.I ACTION
是
.BR skip
，將不處理而直接跳過目錄。如果動作
.I ACTION
是
.BR recurse
，
.B grep
將遞歸地讀每一目錄下的所有文件。這樣做和
.B \-r
選項等價。
.TP
.BR \-E ", " \-\^\-extended-regexp
將模式
.I PATTERN
作爲一個擴展的正則表達式來解釋 (參見下面)。
.TP
.BI \-e " PATTERN" "\fR,\fP \-\^\-regexp=" PATTERN
使用模式
.I PATTERN
作爲模式；在保護以
.BR \-
爲起始的模式時有用。
.TP
.BR \-F ", " \-\^\-fixed-strings
將模式
.I PATTERN
視爲一個固定的字符串的列表，用新行 (newlines) 分隔，只要匹配其中之一即可。
.TP
.BR \-P ", " \-\^\-perl-regexp
將模式
.I PATTERN
作爲一個 Perl 正則表達式來解釋。
.TP
.BI \-f " FILE" "\fR,\fP \-\^\-file=" FILE
從文件
.IR FILE
中獲取模式，每行一個。空文件含有0個模式，因此不匹配任何東西。
.TP
.BR \-G ", " \-\^\-basic-regexp
將模式
.I PATTERN
作爲一個基本的正則表達式 (參見下面) 來解釋。這是默認值。
.TP
.BR \-H ", " \-\^\-with-filename
爲每個匹配打印文件名。
.TP
.BR \-h ", " \-\^\-no-filename
當搜索多個文件時，禁止在輸出的前面加上文件名前綴。
.TP
.B \-\^\-help
輸出一個簡短的幫助信息。
.TP
.BR \-I
處理一個二進制文件，但是認爲它不包含匹配的內容。這和
.B \-\^\-binary-files=without-match
選項等價。
.TP
.BR \-i ", " \-\^\-ignore-case
忽略模式
.I PATTERN
和輸入文件中的大小寫的分別。
.TP
.BR \-L ", " \-\^\-files-without-match
禁止通常的輸出；作爲替代，打印出每個在通常情況下不會產生輸出的輸入文件的名字。對每個文件的掃描在遇到第一個匹配的時候就會停止。
.TP
.BR \-l ", " \-\^\-files-with-matches
禁止通常的輸出；作爲替代，打印出每個在通常情況下會產生輸出的輸入文件的名字。對每個文件的掃描在遇到第一個匹配的時候就會停止。
.TP
.BI \-m " NUM" "\fR,\fP \-\^\-max-count=" NUM
在找到
.I NUM
個匹配的行之後，不再讀這個文件。如果輸入是來自一個普通文件的標準輸入，並且已經輸出了
.I NUM
個匹配的行，
.B grep
保證標準輸入被定位於退出時的最後一次匹配的行之後，不管是否指定了要輸出緊隨的下文的行。這樣可以使一個調用程序恢復搜索。當
.B grep
在
.I NUM
個匹配的行之後停止，它會輸出任何緊隨的下文的行。當使用了
.B \-c
或
.B \-\^\-count
選項的時候，
.B grep
不會輸出比
.IR NUM
更多的行。當指定了
.B \-v
或
.B \-\^\-invert-match
選項的時候，
.B grep
會在輸出
.I NUM
個不匹配的行之後停止。
.TP
.B \-\^\-mmap
如果可能的話，使用
.BR mmap (2)
系統調用來讀取輸入，而不是默認的
.BR read (2)
系統調用。在一些情況下，
.B \-\^\-mmap
提供較好的性能。但是，如果一個輸入文件在
.B grep
正在操作時大小發生變化，或者如果發生了一個 I/O 錯誤，
.B \-\^\-mmap
可能導致不可知的行爲 (包括core dumps)。
.TP
.BR \-n ", " \-\^\-line-number
在輸出的每行前面加上它所在的文件中它的行號。
.TP
.BR \-o ", " \-\^\-only-matching
只顯示匹配的行中與
.I PATTERN
相匹配的部分。
.TP
.BI \-\^\-label= LABEL
將實際上來自標準輸入的輸入視爲來自輸入文件
.I LABEL
。這對於 zgrep 這樣的工具非常有用，例如：
.B "gzip -cd foo.gz |grep --label=foo something"
.TP
.BR \-\^\-line-buffering
使用行緩衝，it can be a performance penality.
.TP
.BR \-q ", " \-\^\-quiet ", " \-\^\-silent
安靜。不向標準輸出寫任何東西。如果找到任何匹配的內容就立即以狀態值 0 退出，即使檢測到了錯誤。
參見
.B \-s
或
.B \-\^\-no-messages
選項。
.TP
.BR \-R ", " \-r ", " \-\^\-recursive
遞歸地讀每一目錄下的所有文件。這樣做和
.B "\-d recurse"
選項等價。
.TP
.BR "\fR \fP \-\^\-include=" PATTERN
僅僅在搜索匹配
.I PATTERN
的文件時在目錄中遞歸搜索。
.TP
.BR "\fR \fP \-\^\-exclude=" PATTERN
在目錄中遞歸搜索，但是跳過匹配
.I PATTERN
的文件。
.TP
.BR \-s ", " \-\^\-no-messages
禁止輸出關於文件不存在或不可讀的錯誤信息。
對於可移植性需要注意：與 \s-1GNU\s0
.BR grep
不同，傳統的
.B grep
不遵守 \s-1POSIX.2\s0 規範，因爲傳統的
.B grep
缺少一個
.B \-q
選項，而它的
.B \-s
選項與 \s-1GNU\s0
.BR grep
的
.B \-q
選項行爲相似。需要可移植到傳統
.B grep
的 shell 腳本應當避免使用
.B \-q
和
.B \-s
選項，而應當將輸出重定向到 /dev/null 。
.TP
.BR \-U ", " \-\^\-binary
將文件視爲二進制。默認情況下，在 MS-DOS 和 MS-Windows 系統中，
.BR grep
通過從文件中讀取頭部的 32kB 內容來判斷它的文件類型。如果
.BR grep
判斷文件是一個文本文件，它將原始文件內容中的 CR 字符去除 (使得含有
.B ^
和
.B $
的正則表達式可以正常工作)。指定
.B \-U
將不進行這些工作，而使所有文件保持不變地讀取並傳遞給匹配機制。如果文件是一個以 CR/LF 換行的文本文件，這樣作將導致一些正則表達式失敗。這個選項在 MS-DOS 和 MS-Windows 之外的系統中無效。
.TP
.BR \-u ", " \-\^\-unix-byte-offsets
報告 Unix 風格的字節偏移量。這個開關使得
.B grep
報告字節偏移量時，將文件作爲 Unix 風格的文本文件看待，也就是說將 CR 字符去掉。這將產生與在一臺 Unix 主機上運行
.B grep
完全相同的結果。除非同時使用
.B \-b
選項，否則這個選項無效。這個選項在 MS-DOS 和 MS-Windows 之外的系統中無效。
.TP
.BR \-V ", " \-\^\-version
向標準錯誤輸出打印
.B grep
的版本號。版本號應當包含在所有的 bug 報告中 (參見下面)。
.TP
.BR \-v ", " \-\^\-invert-match
改變匹配的意義，只選擇不匹配的行。
.TP
.BR \-w ", " \-\^\-word-regexp
只選擇含有能組成完整的詞的匹配的行。判斷方法是匹配的子字符串必須是一行的開始，或者是在一個不可能是詞的組成的字符之後。與此相似，它必須是一行的結束，或者是在一個不可能是詞的組成的字符之前。詞的組成字符是字母，數字，還有下劃線。
.TP
.BR \-x ", " \-\^\-line-regexp
只選擇能匹配完整一行的匹配。
.TP
.B \-y
.BR \-i
的同義詞，廢棄不用。
.TP
.BR \-Z ", " \-\^\-null
輸出一個全零字節 (\s-1ASCII\s0 碼中的
.B NUL
字符) 而不是一般情況下輸出在文件名之後的字符。例如，
.B "grep \-lZ"
在每個文件名之後輸出一個全零字節而不是普通的新行符。這個選項使得輸出清楚明白，即使文件名的表示中包含特殊字符比如新行符。這個選項可以與命令
.BR "find \-print0" ,
.BR "perl \-0" ,
.BR "sort \-z" ,
和
.B "xargs \-0"
一起使用，來處理任意的文件名，即使是那些含有新行符的文件名。
.SH "正則表達式 REGULAR EXPRESSIONS"
.PP
一個正則表達式是一個描述了一個字符串集合的模式。正則表達式的構造類似於算術表達式，使用各種各樣的操作符來將更小的表達式連在一起。
.PP
.B Grep
能理解兩種不同版本的正則表達式語法：\*(lqbasic\*(rq 和 \*(lqextended\*(rq。在
.RB "\s-1GNU\s0\ " grep
中，兩種語法可以實現的功能是沒有區別的。在其他實現中，基本 (basic) 正則表達式表達能力要弱一點。下面的描述適用於擴展的 (extended) 正則表達式，它與基本正則表達式的區別會在最後做一個總結。
.PP
基本的構造塊是匹配單個字符的正則表達式。大部分字符，包括所有字母和數字，是匹配它們自身的正則表達式。任何具有特殊含義的元字符可以通過前置一個反斜槓來引用。(may be quoted by preceding it with a backslash.)
.PP
.I "方括號表達式 (bracket)"
是一個字符序列，放在
.B [
和
.BR ]
當中。它匹配序列中的任何一個字符；如果序列中的第一個字符是脫字符 (caret)
.B ^
那麼它匹配
.I 不在
序列中的任何一個字符。例如，正則表達式
.B [0123456789]
匹配任何一個數字。
.PP
在方括號表達式之中，一個
.I "範圍表達式 (range)"
由兩個字符組成，中間用一個連字符 (hyphen) 分隔。它匹配在這兩個字符之間的任何一個字符，使用本地化的序列順序和字符集。(that sorts between the two characters,inclusive, using the locale's collating sequence and character set.) 例如，在默認的 C locale中，
.B [a\-d]
與
.BR [abcd]
等價。典型的，許多 locale 將字符以字典順序排序，在這些 locale 中，
.B [a\-d]
不與
.BR [abcd]
等價；例如它可能與
.BR [aBbCcDd]
等價。要獲得傳統的對方括號表達式的解釋，可以設定環境變量
.B LC_ALL
值爲
.BR C
來使用 locale C 。
.PP
最後，在方括號表達式中有一些預定義的字符類，如下所示。它們的名字是自說明的，它們是
.BR [:alnum:] (字母和數字),
.BR [:alpha:] (字母),
.BR [:cntrl:] (),
.BR [:digit:] (數字),
.BR [:graph:] (),
.BR [:lower:] (小寫字母),
.BR [:print:] (可打印字符),
.BR [:punct:] (),
.BR [:space:] (空格),
.BR [:upper:] (大寫字母),
和
.BR [:xdigit:]
。例如，
.B [[:alnum:]]
意思是
.BR [0\-9A\-Za\-z]
，但是後一種表示方法依賴於 locale C 和\s-1ASCII\s0 字符編碼，而前一種是與 locale 和字符集無關的。(注意這些字符類名中的方括號也是符號名稱的一部分，必須包含在用來爲序列定界的方括號之中。)
.PP
大多數元字符處於序列中時會失去它們的特殊意義。爲了包含一個字面意義 (literal) 的
.B ]
，需要將它放在序列的最前。與此相似，爲了包含一個字面意義 (literal) 的
.B ^
，需要將它放在除了序列最前之外的其他位置。最後，爲了包含一個字面意義 (literal) 的
.B \-
，需要將它放在序列最後。
.PP
句點符 (period)
.B .
匹配任何一個字符。符號
.B \ew
是
.B [[:alnum:]]
的同義詞，
.B \eW
是
.BR [^[:alnum]]
的同義詞。
.PP
脫字符 (caret)
.B ^
和美元標記 (dollar)
.B $
分別是匹配一行的首部和尾部的空字串的元字符。符號
.B \e<
和
.B \e>
分別是匹配一個詞的首部和尾部的空字串的元字符。符號
.B \eb
匹配一個詞邊緣 (edge) 的空字串，符號
.B \eB
匹配
.I 不
處於一個詞的邊緣的空字串。
.PP
一個正則表達式後面可以跟隨多種重複操作符之一。
.PD 0
.TP
.B ?
先前的項是可選的，最多匹配一次。
.TP
.B *
先前的項可以匹配零次或多次。
.TP
.B +
先前的項可以匹配一次或多次。
.TP
.BI { n }
先前的項將匹配恰好
.I n
次。
.TP
.BI { n ,}
先前的項可以匹配
.I n
或更多次。
.TP
.BI { n , m }
先前的項將匹配至少
.I n
詞，但是不會超過
.I m
次。
.PD
.PP
兩個正則表達式可以連接到一起；得出的正則表達式可以匹配任何由兩個分別匹配連接前的子表達式的子字符串連接而成的字符串。
.PP
兩個正則表達式可以用中綴操作符
.BR |
聯合到一起，得出的正則表達式可以匹配任何匹配聯合前的任何一個子表達式的字符串。
.PP
重複操作符的優先級比連接高，接下來又比選擇的優先級高。一個完整的子表達式可以用圓括號 (parentheses) 括住來超越這些優先級規則。(to override these precedence rules.)
.PP
反向引用
.BI \e n\c
\& 中，
.I n
是一個數字，匹配正則表達式中，以第
.IR n
個圓括號括住的子表達式已匹配的子字符串。
.PP
在基本正則表達式中，元字符
.BR ? ,
.BR + ,
.BR { ,
.BR | ,
.BR ( ,
和
.BR )
喪失了它們的特殊意義；作爲替代，使用加反斜槓的 (backslash) 版本
.BR \e? ,
.BR \e+ ,
.BR \e{ ,
.BR \e| ,
.BR \e( ,
和
.BR \e)
。
.PP
傳統的
.B egrep
不支持元字符
.B {
，並且一些
.B egrep
的實現通過支持
.B \e{
來代替它，因此可移植的腳本應當避免
在
.B egrep
中使用
.B {
模式，應當使用
.B [{]
來匹配一個字面意義 (literal) 的
.BR {
。
.PP
\s-1GNU\s0
.B egrep
通過假設如果
.B {
處於 an invalid interval specification 的起始，就不是一個特殊字符，來支持傳統的用法。例如，shell 命令
.B "egrep '{1'"
將會搜索這個兩字符的字符串
.B {1
而不是報告在正則表達式中發生了語法錯誤。\s-1POSIX.2\s0 允許這個行爲，將其視爲一個擴展，但是可移植的腳本應當避免使用它。
.SH "環境變量 ENVIRONMENT VARIABLES"
.B Grep
的行爲受下列環境變量影響。
.PP
一個 locale
.BI LC_ foo
是通過按下面的順序，
.BR LC_ALL ,
.BR LC_\fIfoo\fP ,
.BR LANG ,
檢查這三個環境變量的取值而確定的。設置了的第一個變量指定了 locale。例如，如果
.B LC_ALL
沒有設置，但是
.B LC_MESSAGES
設置爲
.BR pt_BR
，那麼巴西的葡萄牙語 (Brazilian Portuguese) 將用作
.B LC_MESSAGES
locale 的值。如果沒有設置這其中任何一個環境變量，或者沒有安裝所設置的 locale 目錄，或者如果
.B grep
沒有將國家和語言支持 (national language support (\s-1NLS\s0)) 編譯在內，將默認使用 locale C。
.TP
.B GREP_OPTIONS
這個變量指定了將放在所有顯式指定的選項之前的默認選項。例如，如果
.B GREP_OPTIONS
是
.BR "'\-\^\-binary-files=without-match \-\^\-directories=skip'"
的話，
.B grep
將像已經在任何顯式指定的選項之前指定了
.B \-\^\-binary-files=without-match
和
.B \-\^\-directories=skip
選項那樣來運作。選項以空白 (whitespace) 分隔。一個反斜槓 (backslash) 使得下一個字符轉義 (escape)，因此可以用來指定一個含有空白或者反斜槓的選項。
.TP
.B GREP_COLOR
指定用來高亮顯示的標記。
.TP
\fBLC_ALL\fP, \fBLC_COLLATE\fP, \fBLANG\fP
這些變量指定了 locale
.B LC_COLLATE
，決定了解釋類似
.BR [a\-z]
的範圍表達式時的序列順序 (collating sequence) 。
.TP
\fBLC_ALL\fP, \fBLC_CTYPE\fP, \fBLANG\fP
這些選項指定了 locale
.B LC_CTYPE
，決定了字符的類型，例如，哪些字符是空白 (whitespace) 。
.TP
\fBLC_ALL\fP, \fBLC_MESSAGES\fP, \fBLANG\fP
這些選項指定了 locale
.B LC_MESSAGES
，決定了
.B grep
的消息使用的語言。默認的 locale C 使用美國英語的消息。
.TP
.B POSIXLY_CORRECT
如果設置了的話，
.B grep
將像 \s-1POSIX.2\s0 要求的那樣來運作；否則，
.B grep
將像其他 \s-1GNU\s0 程序一樣來運作。\s-1POSIX.2\s0 要求文件名之後的選項必須視爲文件名；默認情況下，這些選項被交換到操作數列表的前面，被當作選項來處理。同時， \s-1POSIX.2\s0 要求不可識別的選項在診斷消息中表示爲 \*(lqillegal\*(rq，但是既然它們沒有真正觸犯法律，因此默認情況下它們在診斷 (diagnose) 消息中表示爲 \*(lqinvalid\*(rq。
.B POSIXLY_CORRECT
同時禁止了下面描述的 \fB_\fP\fIN\fP\fB_GNU_nonoption_argv_flags_\fP。
.TP
\fB_\fP\fIN\fP\fB_GNU_nonoption_argv_flags_\fP
(這裏
.I N
是
.BR grep 's
數字形式的進程ID。) 如果這個環境變量的值的第
.IR i
個字符是
.BR 1
，那麼不將
.B grep
的第
.IR i
個操作數視爲一個選項，即使它看上去像。shell 可以將這個變量設置在它運行的每個命令的環境中，指定哪個操作數是文件名通配符擴展的結果，因此不應當被視爲選項。這個行爲只有在使用 \s-1GNU\s0 C 庫時有效，並且只有在
.B POSIXLY_CORRECT
沒有設置的時候。
.SH 診斷 DIAGNOSTICS
.PP
一般地，如果找到了選擇的行，退出時狀態值爲0，否則爲1。但是如果發生錯誤，退出時狀態值是2，除非指定了
.B \-q
或
.B \-\^\-quiet
或
.B \-\^\-silent
選項，並且找到了選擇的行。
.SH BUGS
.PP
bug 報告的電子郵件地址是
.BR bug-gnu-utils@gnu.org 。
一定要在\*(lqSubject:\*(rq中帶有 \*(lqgrep\*(rq 這個詞。
.PP
在
.BI { n , m }
結構中重複次數過多會導致
.B grep
使用大量內存。另外，一些過分晦澀的正則表達式需要指數級的時間和空間，可能會導致
.B grep
耗盡所有內存。
.PP
向後引用 (backreferences) 非常慢，可能需要指數級的時間。
.SH "[中文版維護人]"
.B 袁乙鈞 <bbbush@163.com>
.SH "[中文版最新更新]"
.B 2003.11.03
.SH "《中國linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net 
.\" Work around problems with some troff -man implementations.
.br
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR