Provided by: manpages-zh_1.5.2-1_all bug

NAME

       grep, egrep, fgrep - 列印匹配給定模式的行

總覽 SYNOPSIS
       grep [options] PATTERN [FILE...]
       grep [options] [-e PATTERN | -f FILE] [FILE...]

描述 DESCRIPTION
       Grep  搜索以  FILE  命名的檔案輸入  (或者是標準輸入,如果沒有指定檔名,或者給出的檔名是  -  的話),尋找含有與給定的模式
       PATTERN 相匹配的內容的行。 預設情況下, grep 將把含有匹配內容的行列印出來。

       另外,也可以使用兩個變種程式 egrepfgrepEgrepgrep -E 相同。 Fgrepgrep -F 相同。

選項 OPTIONS
       -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 類型的。預設情況下, TYPEbinary
              ,並且  grep  一般會輸出一個一行的消息說一個二進制檔案匹配,或者如果沒有匹配的話就沒有消息輸出。如果類型  TYPEwithout-match ,那麼 grep 假定二進制檔案不會匹配;這樣做與 -I 選項等價。如果類型 TYPEtext
              ,那麼  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   或是套接字  (socket)  ,使用動作  ACTION  來處理它。預設情況下,動作
              ACTIONread ,意味著設備將視為普通檔案那樣來讀。如果動作 ACTIONskip ,將不處理而直接跳過設備。

       -d ACTION, --directories=ACTION
              如果輸入檔案是一個目錄,使用動作   ACTION   來處理它。預設情況下,動作    ACTIONread
              ,意味著目錄將視為普通檔案那樣來讀。如果動作  ACTIONskip ,將不處理而直接跳過目錄。如果動作 ACTIONrecursegrep 將遞歸地讀每一目錄下的所有檔案。這樣做和 -r 選項等價。

       -E, --extended-regexp
              將模式 PATTERN 作為一個擴展的正則表達式來解釋 (參見下面)。

       -e PATTERN, --regexp=PATTERN
              使用模式 PATTERN 作為模式;在保護以 - 為起始的模式時有用。

       -F, --fixed-strings
              將模式 PATTERN 視為一個固定的字符串的列表,用新行 (newlines) 分隔,只要匹配其中之一即可。

       -P, --perl-regexp
              將模式 PATTERN 作為一個 Perl 正則表達式來解釋。

       -f FILE, --file=FILE
              從檔案 FILE 中獲取模式,每行一個。空檔案含有0個模式,因此不匹配任何東西。

       -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
              保証標準輸入被定位於退出時的最後一次匹配的行之後,不管是否指定了要輸出緊隨的下文的行。這樣可以使一個調用程式恢復搜索。當
              grepNUM 個匹配的行之後停止,它會輸出任何緊隨的下文的行。當使用了 -c--count 選項的時候, grep
              不會輸出比 NUM 更多的行。當指定了 -v--invert-match  選項的時候,  grep  會在輸出  NUM
              個不匹配的行之後停止。

       --mmap 如果可能的話,使用  mmap(2)  系統調用來讀取輸入,而不是預設的 read(2) 系統調用。在一些情況下, --mmap
              提供較好的性能。但是,如果一個輸入檔案在 grep 正在操作時大小發生變化,或者如果發生了一個 I/O  錯誤,  --mmap
              可能導致不可知的行為 (包括core dumps)。

       -n, --line-number
              在輸出的每行前面加上它所在的檔案中它的行號。

       -o, --only-matching
              只顯示匹配的行中與 PATTERN 相匹配的部分。

       --label=LABEL
              將實際上來自標準輸入的輸入視為來自輸入檔案  LABEL  。這對於  zgrep 這樣的工具非常有用,例如: gzip -cd
              foo.gz |grep --label=foo something

       --line-buffering
              使用行緩沖,it can be a performance penality.

       -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  的  shell  稿本應當避免使用  -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    字符去掉。這將產生與在一台    Unix   主機上運行   grep   完全相同的結果。除非同時使用   -b
              選項,否則這個選項無效。這個選項在 MS-DOS 和 MS-Windows 之外的系統中無效。

       -V, --version
              向標準錯誤輸出列印 grep 的版本號。版本號應當包含在所有的 bug 報告中 (參見下面)。

       -v, --invert-match
              改變匹配的意義,只選擇不匹配的行。

       -w, --word-regexp
              只選擇含有能組成完整的詞的匹配的行。判斷方法是匹配的子字符串必須是一行的開始,或者是在一個不可能是詞的組成的字符之後。與此相似,它必須是一行的結束,或者是在一個不可能是詞的組成的字符之前。詞的組成字符是字母,數字,還有下劃線。

       -x, --line-regexp
              只選擇能匹配完整一行的匹配。

       -y     -i 的同義詞,廢棄不用。

       -Z, --null
              輸出一個全零字節  (ASCII  碼中的  NUL  字符)  而不是一般情況下輸出在檔名之後的字符。例如, grep -lZ
              在每個檔名之後輸出一個全零字節而不是普通的新行符。這個選項使得輸出清楚明白,即使檔名的表示中包含特殊字符比如新行符。這個選項可以與命令
              find    -print0,    perl    -0,    sort    -z,    和   xargs   -0
              一起使用,來處理任意的檔名,即使是那些含有新行符的檔名。

正則表達式 REGULAR EXPRESSIONS
       一個正則表達式是一個描述了一個字符串集合的模式。正則表達式的構造類似於算術表達式,使用各種各樣的操作符來將更小的表達式連在一起。

       Grep     能理解兩種不同版本的正則表達式語法:“basic”     和     “extended”。在      GNU grep
       中,兩種語法可以實現的功能是沒有區別的。在其他實現中,基本     (basic)     正則表達式表達能力要弱一點。下面的描述適用於擴展的
       (extended) 正則表達式,它與基本正則表達式的區別會在最後做一個總結。

       基本的構造塊是匹配單個字符的正則表達式。大部分字符,包括所有字母和數字,是匹配它們自身的正則表達式。任何具有特殊含義的元字符可以通過前置一個反斜槓來引用。(may
       be quoted by preceding it with a backslash.)

         (bracket)  是一個字符序列,放在  [] 當中。它匹配序列中的任何一個字符;如果序列中的第一個字符是脫字符
       (caret) ^ 那麼它匹配  序列中的任何一個字符。例如,正則表達式 [0123456789] 匹配任何一個數字。

       在方括號表達式之中,一個           (range)      由兩個字符組成,中間用一個連字符      (hyphen)
       分隔。它匹配在這兩個字符之間的任何一個字符,使用本地化的序列順序和字符集。(that   sorts   between   the  two
       characters,inclusive,  using  the  locale's  collating   sequence   and
       character  set.)  例如,在預設的  C  locale中,  [a-d][abcd] 等價。典型的,許多 locale
       將字符以字典順序排序,在這些  locale  中,  [a-d]   不與   [abcd]   等價;例如它可能與   [aBbCcDd]
       等價。要獲得傳統的對方括號表達式的解釋,可以設定環境變量 LC_ALL 值為 C 來使用 locale C 。

       最後,在方括號表達式中有一些預定義的字符類,如下所示。它們的名字是自說明的,它們是             [:alnum:](字母和數字),
       [:alpha:](字母),      [:cntrl:](),      [:digit:](數字),       [:graph:](),
       [:lower:](小寫字母),    [:print:](可列印字符),    [:punct:](),    [:space:](空格),
       [:upper:](大寫字母),  和  [:xdigit:]  。例如,   [[:alnum:]]   意思是   [0-9A-Za-z]
       ,但是後一種表示方法依賴於      locale      C      和ASCII     字符編碼,而前一種是與     locale
       和字符集無關的。(注意這些字符類名中的方括號也是符號名稱的一部分,必須包含在用來為序列定界的方括號之中。)

       大多數元字符處於序列中時會失去它們的特殊意義。為了包含一個字面意義         (literal)         的         ]
       ,需要將它放在序列的最前。與此相似,為了包含一個字面意義           (literal)           的          ^
       ,需要將它放在除了序列最前之外的其他位置。最後,為了包含一個字面意義 (literal) 的 - ,需要將它放在序列最後。

       句點符 (period) .  匹配任何一個字符。符號 \w[[:alnum:]]  的同義詞,  \W[^[:alnum]]
       的同義詞。

       脫字符  (caret)  ^  和美元標記  (dollar)  $  分別是匹配一行的首部和尾部的空字串的元字符。符號  \<\>
       分別是匹配一個詞的首部和尾部的空字串的元字符。符號  \b  匹配一個詞邊緣   (edge)   的空字串,符號   \B   匹配   
       處於一個詞的邊緣的空字串。

       一個正則表達式後面可以跟隨多種重復操作符之一。
       ?      先前的項是可選的,最多匹配一次。
       *      先前的項可以匹配零次或多次。
       +      先前的項可以匹配一次或多次。
       {n}    先前的項將匹配恰好 n 次。
       {n,}   先前的項可以匹配 n 或更多次。
       {n,m}  先前的項將匹配至少 n 詞,但是不會超過 m 次。

       兩個正則表達式可以連接到一起;得出的正則表達式可以匹配任何由兩個分別匹配連接前的子表達式的子字符串連接而成的字符串。

       兩個正則表達式可以用中綴操作符 | 聯合到一起,得出的正則表達式可以匹配任何匹配聯合前的任何一個子表達式的字符串。

       重復操作符的優先級比連接高,接下來又比選擇的優先級高。一個完整的子表達式可以用圓括號                (parentheses)
       括住來超越這些優先級規則。(to override these precedence rules.)

       反向引用 \n 中, n 是一個數字,匹配正則表達式中,以第 n 個圓括號括住的子表達式已匹配的子字符串。

       在基本正則表達式中,元字符 ?, +, {, |, (, 和 ) 喪失了它們的特殊意義;作為替代,使用加反斜槓的 (backslash) 版本
       \?, \+, \{, \|, \(, 和 \) 。

       傳統的 egrep 不支持元字符 { ,並且一些 egrep 的實現通過支持 \{ 來代替它,因此可移植的稿本應當避免 在 egrep 中使用
       { 模式,應當使用 [{] 來匹配一個字面意義 (literal) 的 { 。

       GNU   egrep   通過假設如果   {   處於   an   invalid   interval   specification
       的起始,就不是一個特殊字符,來支持傳統的用法。例如,shell   命令   egrep   '{1'   將會搜索這個兩字符的字符串  {1
       而不是報告在正則表達式中發生了語法錯誤。POSIX.2 允許這個行為,將其視為一個擴展,但是可移植的稿本應當避免使用它。

環境變量 ENVIRONMENT VARIABLES
       Grep 的行為受下列環境變量影響。

       一個    locale    LC_foo     是通過按下面的順序,     LC_ALL,     LC_foo,     LANG,
       檢查這三個環境變量的取值而確定的。設置了的第一個變量指定了  locale。例如,如果  LC_ALL 沒有設置,但是 LC_MESSAGES
       設置為 pt_BR ,那麼巴西的葡萄牙語  (Brazilian  Portuguese)  將用作  LC_MESSAGES  locale
       的值。如果沒有設置這其中任何一個環境變量,或者沒有安裝所設置的    locale   目錄,或者如果   grep   沒有將國家和語言支持
       (national language support (NLS)) 編譯在內,將預設使用 locale C。

       GREP_OPTIONS
              這個變量指定了將放在所有顯式指定的選項之前的預設選項。例如,如果   GREP_OPTIONS'--binary-
              files=without-match       --directories=skip'      的話,      grep
              將像已經在任何顯式指定的選項之前指定了        --binary-files=without-match--directories=skip     選項那樣來運作。選項以空白    (whitespace)    分隔。一個反斜槓
              (backslash) 使得下一個字符轉義 (escape),因此可以用來指定一個含有空白或者反斜槓的選項。

       GREP_COLOR
              指定用來高亮顯示的標記。

       LC_ALL, LC_COLLATE, LANG
              這些變量指定了 locale LC_COLLATE ,決定了解釋類似 [a-z] 的范圍表達式時的序列順序 (collating
              sequence) 。

       LC_ALL, LC_CTYPE, LANG
              這些選項指定了 locale LC_CTYPE ,決定了字符的類型,例如,哪些字符是空白 (whitespace) 。

       LC_ALL, LC_MESSAGES, LANG
              這些選項指定了  locale  LC_MESSAGES  ,決定了  grep  的消息使用的語言。預設的  locale C
              使用美國英語的消息。

       POSIXLY_CORRECT
              如果設置了的話,  grep   將像   POSIX.2   要求的那樣來運作;否則,   grep   將像其他   GNU
              程式一樣來運作。POSIX.2
              要求檔名之後的選項必須視為檔名;預設情況下,這些選項被交換到操作數列表的前面,被當作選項來處理。同時,      POSIX.2
              要求不可識別的選項在診斷消息中表示為         “illegal”,但是既然它們沒有真正觸犯法律,因此預設情況下它們在診斷
              (diagnose)   消息中表示為   “invalid”。   POSIXLY_CORRECT    同時禁止了下面描述的
              _N_GNU_nonoption_argv_flags__N_GNU_nonoption_argv_flags_
              (這裏 Ngrep's 數字形式的進程ID。) 如果這個環境變量的值的第 i 個字符是 1 ,那麼不將 grep 的第 i
              個操作數視為一個選項,即使它看上去像。shell
              可以將這個變量設置在它運行的每個命令的環境中,指定哪個操作數是檔名通配符擴展的結果,因此不應當被視為選項。這個行為只有在使用
              GNU C 庫時有效,並且只有在 POSIXLY_CORRECT 沒有設置的時候。

診斷 DIAGNOSTICS
       一般地,如果找到了選擇的行,退出時狀態值為0,否則為1。但是如果發生錯誤,退出時狀態值是2,除非指定了  -q--quiet--silent 選項,並且找到了選擇的行。

BUGS

       bug 報告的電子郵件地址是 bug-gnu-utils@gnu.org。 一定要在“Subject:”中帶有 “grep” 這個詞。

       在 {n,m} 結構中重復次數過多會導致 grep 使用大量記憶體。另外,一些過分晦澀的正則表達式需要指數級的時間和空間,可能會導致 grep
       耗盡所有記憶體。

       向後引用 (backreferences) 非常慢,可能需要指數級的時間。

[中文版維護人]
       袁乙鈞 <bbbush@163.com>

[中文版最新更新]
       2003.11.03

《中國linux論壇man手冊頁翻譯計劃》:
       http://cmpp.linuxforum.net

                                  GNU Project                          GREP(1)