.\" -*- coding: UTF-8 -*- .de dT .ds Dt \\$2 .. .\" GNU grep man page .dT Time-stamp: 2019-12-29 .\" Update the above date whenever a change to either this file or .\" grep.c's 'usage' function results in a nontrivial change to the man page. .\" In Emacs, you can update the date by running 'M-x time-stamp' .\" after you make a change that you decide is nontrivial. .\" It is no big deal to forget to update the date. . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH GREP 1 \*(Dt "GNU grep 3.11" "Команды пользователя" . .if !\w|\*(lq| \{\ .\" groff an-old.tmac does not seem to be in use, so define lq and rq. . ie \n(.g \{\ . ds lq \(lq\" . ds rq \(rq\" . \} . el \{\ . ds lq `` . ds rq '' . \} .\} . .if !\w|\*(la| \{\ .\" groff an-ext.tmac does not seem to be in use, so define the parts of .\" it that are used below. For a copy of groff an-ext.tmac, please see: .\" https://git.savannah.gnu.org/cgit/groff.git/plain/tmac/an-ext.tmac .\" --- Start of lines taken from groff an-ext.tmac . .\" Check whether we are using grohtml. .nr mH 0 .if \n(.g \ . if '\*(.T'html' \ . nr mH 1 . . .\" Map mono-width fonts to standard fonts for groff's TTY device. .if n \{\ . do ftr CR R . do ftr CI I . do ftr CB B .\} . .\" groff has glyph entities for angle brackets. .ie \n(.g \{\ . ds la \(la\" . ds ra \(ra\" .\} .el \{\ . ds la <\" . ds ra >\" . \" groff's man macros control hyphenation with this register. . nr HY 1 .\} . .\" Start URL. .de UR . ds m1 \\$1\" . nh . if \\n(mH \{\ . \" Start diversion in a new environment. . do ev URL-div . do di URL-div . \} .. . . .\" End URL. .de UE . ie \\n(mH \{\ . br . di . ev . . \" Has there been one or more input lines for the link text? . ie \\n(dn \{\ . do HTML-NS "" . \" Yes, strip off final newline of diversion and emit it. . do chop URL-div . do URL-div . do HTML-NS . \} . el \ . do HTML-NS "\\*(m1" \&\\$*\" . \} . el \ \\*(la\\*(m1\\*(ra\\$*\" . . hy \\n(HY .. . . .\" Start email address. .de MT . ds m1 \\$1\" . nh . if \\n(mH \{\ . \" Start diversion in a new environment. . do ev URL-div . do di URL-div . \} .. . . .\" End email address. .de ME . ie \\n(mH \{\ . br . di . ev . . \" Has there been one or more input lines for the link text? . ie \\n(dn \{\ . do HTML-NS "" . \" Yes, strip off final newline of diversion and emit it. . do chop URL-div . do URL-div . do HTML-NS . \} . el \ . do HTML-NS "\\*(m1" \&\\$*\" . \} . el \ \\*(la\\*(m1\\*(ra\\$*\" . . hy \\n(HY .. .\" --- End of lines taken from groff an-ext.tmac .\} . .hy 0 . .SH ИМЯ grep — вывести строки, соответствующие шаблонам . .SH СИНТАКСИС \fBgrep\fP [\fIПАРАМЕТР\fP.\|.\|.]\& \fIШАБЛОНЫ\fP [\fIФАЙЛ\fP.\|.\|.] .br \fBgrep\fP [\fIПАРАМЕТР\fP.\|.\|.]\& \fB\-e\fP \fIШАБЛОНЫ\fP \&.\|.\|.\& [\fIФАЙЛ\fP.\|.\|.] .br \fBgrep\fP [\fIПАРАМЕТР\fP.\|.\|.]\& \fB\-f\fP \fIФАЙЛ_ШАБЛОНОВ\fP \&.\|.\|.\& [\fIФАЙЛ\fP.\|.\|.] . .SH ОПИСАНИЕ \fBgrep\fP ищет соответствия \fIШАБЛОНАМ\fP в каждом \fIФАЙЛ\fPе. \fIШАБЛОНЫ\fP представляют собой один или несколько шаблонов, разделённых символами перевода на новую строку; \fBgrep\fP выводит каждую строку, которая совпадает с шаблоном. Обычно \fIШАБЛОНЫ\fP следует заключать в кавычки, если \fBgrep\fP используется в командах оболочки. .PP Если \fIФАЙЛ\fP задан как «\fB\-\fP», под ним подразумевается стандартный поток ввода. Если \fIФАЙЛ\fP не задан, то в случае рекурсивного поиска будет выполнен анализ рабочего каталога, а в случае нерекурсивного поиска будет выполнено чтение из стандартного потока ввода. . .SH ПАРАМЕТРЫ .SS "Общая информация о программе" .TP \fB\-\^\-help\fP Вывести информацию об использовании программы и завершить работу. .TP \fB\-V\fP, \fB\-\^\-version\fP Вывести номер версии \fBgrep\fP и завершить работу. .SS "Синтаксис шаблонов" .TP \fB\-E\fP, \fB\-\^\-extended\-regexp\fP Воспринимать \fIШАБЛОНЫ\fP как расширенные регулярные выражения (EREs — extended regular expressions, см. ниже). .TP \fB\-F\fP, \fB\-\^\-fixed\-strings\fP Воспринимать \fIШАБЛОНЫ\fP как фиксированные строки, а не регулярные выражения. .TP \fB\-G\fP, \fB\-\^\-basic\-regexp\fP Воспринимать \fIШАБЛОНЫ\fP как простые регулярные выражения (BREs — basic regular expressions, см. ниже). Данный параметр используется по умолчанию. .TP \fB\-P\fP, \fB\-\^\-perl\-regexp\fP Воспринимать \fIШАБЛОНЫ\fP как регулярные выражения, совместимые с Perl (PCREs — Perl\-compatible regular expressions). Данный параметр является экспериментальным, если используется в сочетании с параметром \fB\-z\fP (\fB\-\^\-null\-data\fP); \fBgrep \-P\fP может выводить предупреждения о возможностях, которые не были реализованы. .SS "Настройки поиска соответствий" .TP \fB\-e\fP\fI ШАБЛОНЫ\fP,\fB \-\^\-regexp=\fP\fIШАБЛОНЫ\fP Использовать \fIШАБЛОНЫ\fP в качестве шаблонов. Если данный параметр указан несколько раз или в сочетании с параметром \fB\-f\fP (\fB\-\^\-file\fP), выполнять поиск для всех перечисленных шаблонов. Данный параметр может быть использован для корректной обработки шаблонов, начинающихся с «\-». .TP \fB\-f\fP\fI ФАЙЛ\fP,\fB \-\^\-file=\fP\fIФАЙЛ\fP Считать шаблоны из \fIФАЙЛ\fPа, по одному на каждую строку. Если данный параметр указан несколько раз или в сочетании с параметром \fB\-e\fP (\fB\-\^\-regexp\fP), выполнять поиск для всех перечисленных шаблонов. Пустой файл содержит нулевое количество шаблонов и, таким образом, не приводит к нахождению соответствий. Если \fIФАЙЛ\fP задан как \fB\-\fP, считать шаблоны из стандартного потока ввода. .TP \fB\-i\fP, \fB\-\^\-ignore\-case\fP Игнорировать различия в регистре в шаблонах и входных данных, чтобы символы, отличающиеся только регистром, считались совпадающими. .TP \fB\-\^\-no\-ignore\-case\fP Не игнорировать различия в регистре в шаблонах и входных данных. Такое поведение используется по умолчанию. Данный параметр удобен для передачи сценариям оболочки, которые уже используют параметр \fB\-i\fP, чтобы отменить действие последнего, так как эти два параметра переопределяют друг друга. .TP \fB\-v\fP, \fB\-\^\-invert\-match\fP Изменить логику поиска соответствий на обратную, выбирая несоответствующие строки. .TP \fB\-w\fP, \fB\-\^\-word\-regexp\fP Выбирать только те строки, в которых найденные соответствия образуют целые слова. Проверка заключается в том, что совпавшая подстрока должна либо находиться в начале строки, либо следовать за символом, не являющимся частью слова. Аналогичным образом, эта подстрока должна либо находиться в конце строки, либо предшествовать символу, не являющемуся частью слова. Символами, которые считаются частью слов, являются буквы, цифры и символ подчёркивания. Данный параметр не действует, если был также указан параметр \fB\-x\fP. .TP \fB\-x\fP, \fB\-\^\-line\-regexp\fP Выбирать только те совпадения, которые в точности соответствуют строке целиком. При использовании шаблона с регулярным выражением действие данного параметра равнозначно заключению шаблона в круглые скобки, а затем — в символы \fB^\fP и \fB$\fP. .SS "Общие настройки вывода" .TP \fB\-c\fP, \fB\-\^\-count\fP Подавлять обычно выводимую информацию; вместо неё выводить для каждого входного файла количество строк, в которых были обнаружены соответствия. При использовании параметра \fB\-v\fP, \fB\-\^\-invert\-match\fP (см. выше) подсчитывать строки без соответствий. .TP \fB\-\^\-color\fP[\fB=\fP\fIКОГДА\fP], \fB\-\^\-colour\fP[\fB=\fP\fIКОГДА\fP] Окружать (непустые) соответствия, содержащие их строки, контекстные строки, имена файлов, номера строк, смещения в байтах и разделители (полей и групп контекстных строк) экранированными последовательностями для отображения их в цвете при выводе в терминал. Цвета задаются переменной среды окружения \fBGREP_COLORS\fP. \fIКОГДА\fP может принимать значения \fBnever\fP (никогда), \fBalways\fP (всегда) или \fBauto\fP (автоматически). .TP \fB\-L\fP, \fB\-\^\-files\-without\-match\fP Подавлять обычно выводимую информацию; вместо неё выводить имя каждого входного файла, содержимое которого не было бы выведено в нормальном режиме работы, так как оно не содержит соответствий. .TP \fB\-l\fP, \fB\-\^\-files\-with\-matches\fP Подавлять обычно выводимую информацию; вместо неё выводить имя каждого входного файла, содержимое которого было бы выведено в нормальном режиме работы, так как оно содержит соответствия. Поиск в каждом входном файле прекращается после нахождения первого соответствия. .TP \fB\-m\fP\fI ЧИСЛО\fP,\fB \-\^\-max\-count=\fP\fIЧИСЛО\fP Прекратить чтение файла после \fIЧИСЛА\fP строк с соответствиями. Если \fIЧИСЛО\fP равно нулю, \fBgrep\fP прекращает работу сразу, не выполняя чтение входных данных. \fIЧИСЛО\fP, заданное как \-1 (используется по умолчанию), считается бесконечностью и позволяет \fBgrep\fP не прекращать чтение. Если входные данные поступают из стандартного потока ввода и являются содержимым обычного файла, \fBgrep\fP гарантирует, что после вывода \fIЧИСЛА\fP строк с совпадениями текущая позиция в стандартном потоке ввода будет указывать на строку, следующую непосредственно за последней совпавшей строкой, независимо от наличия завершающих вывод контекстных строк. Это позволяет продолжить поиск вызывающему процессу. Когда утилита \fBgrep\fP прекращает обработку после обнаружения \fIЧИСЛА\fP строк с соответствиями, она выводит завершающие вывод контекстные строки. Если также указан параметр \fB\-c\fP или \fB\-\^\-count\fP, \fBgrep\fP не будет выводить количество, превышающее значение \fIЧИСЛО\fP. Если также указан параметр \fB\-v\fP или \fB\-\^\-invert\-match\fP, \fBgrep\fP прекратит обработку после вывода \fIЧИСЛА\fP несоответствующих строк. .TP \fB\-o\fP, \fB\-\^\-only\-matching\fP Выводить только совпавшие (непустые) части строки с соответствиями, при выводе помещая каждую такую часть на новую строку. .TP \fB\-q\fP, \fB\-\^\-quiet\fP, \fB\-\^\-silent\fP «Тихий» режим работы: не записывать ничего в стандартный поток вывода. Немедленно завершить работу с кодом, равным нулю, при нахождении любого соответствия даже в случае возникновения ошибок. См. также параметр \fB\-s\fP или \fB\-\^\-no\-messages\fP. .TP \fB\-s\fP, \fB\-\^\-no\-messages\fP Не выводить сообщения об ошибках, связанных с отсутствующими или нечитаемыми файлами. .SS "Настройки префиксов выводимых строк" .TP \fB\-b\fP, \fB\-\^\-byte\-offset\fP Выводить отсчитываемое от 0 в байтах смещение во входном файле перед каждой выводимой строкой. Если указан параметр \fB\-o\fP (\fB\-\^\-only\-matching\fP), выводить смещение самой совпавшей части. .TP \fB\-H\fP, \fB\-\^\-with\-filename\fP Выводить имя файла для каждого соответствия. Данный параметр используется по умолчанию, если поиск выполняется в нескольких файлах. Данный параметр является расширением GNU. .TP \fB\-h\fP, \fB\-\^\-no\-filename\fP Не выводить имена файлов в качестве префиксов выводимых строк. Данный параметр используется по умолчанию, если поиск выполняется только в одном файле (или в данных из стандартного потока ввода). .TP \fB\-\^\-label=\fP\fIМЕТКА\fP Отображать выходные данные, получаемые из стандартного потока ввода, так, как если бы они были получены из файла с именем \fIМЕТКА\fP. Это может оказаться полезным при использовании команд, преобразующих содержимое файла перед поиском, например \fBgzip \-cd foo.gz | grep \-\^\-label=foo \-H 'некий шаблон'\fP. См. также параметр \fB\-H\fP. .TP \fB\-n\fP, \fB\-\^\-line\-number\fP Предварять вывод каждой строки её номером во входном файле, отсчитывая его от 1. .TP \fB\-T\fP, \fB\-\^\-initial\-tab\fP Осуществлять вывод таким образом, чтобы первый символ фактического содержимого строки располагался на позиции табуляции и выравнивание символов табуляции выглядело нормальным. Это может быть полезно при использовании параметров, добавляющих префиксы к выводимому фактическому содержимому: \fB\-H\fP,\fB\-n\fP и \fB\-b\fP. Чтобы повысить вероятность того, что все строки из одного файла будут начинаться с одного и того же столбца, данный параметр также уменьшает размер полей с номерами строк и смещениями в байтах (при их наличии) до минимального. .TP \fB\-Z\fP, \fB\-\^\-null\fP Выводить нулевой байт (символ \fBNUL\fP в таблице ASCII) вместо символа, который обычно следует за именем файла. Например, \fBgrep \-lZ\fP будет выводить нулевой байт после каждого имени файла вместо обычного перевода на новую строку. Данный параметр позволяет привести выходные данные к однозначному виду, даже если имена файлов содержат такие необычные символы, как переводы строк. Данный параметр может быть использован с такими командами, как \fBfind \-print0\fP, \fBperl \-0\fP, \fBsort \-z\fP и \fBxargs \-0\fP, чтобы обеспечить обработку произвольных имён файлов, в том числе содержащих символы перевода на новую строку. .SS "Настройки контекстных строк" .TP \fB\-A\fP\fI ЧИСЛО\fP,\fB \-\^\-after\-context=\fP\fIЧИСЛО\fP Выводить \fIЧИСЛО\fP строк контекста, следующего за строками с найденными соответствиями. Между смежными группами соответствий помещается строка с групповым разделителем (\fB\-\^\-\fP). Данный параметр не действует при использовании параметра \fB\-o\fP или \fB\-\^\-only\-matching\fP, о чём будет выведено предупреждение. .TP \fB\-B\fP\fI ЧИСЛО\fP,\fB \-\^\-before\-context=\fP\fIЧИСЛО\fP Выводить \fIЧИСЛО\fP строк контекста, предшествующего строкам с найденными соответствиями. Между смежными группами соответствий помещается строка с групповым разделителем (\fB\-\^\-\fP). Данный параметр не действует при использовании параметра \fB\-o\fP или \fB\-\^\-only\-matching\fP, о чём будет выведено предупреждение. .TP \fB\-C\fP\fI ЧИСЛО\fP,\fB \-\fP\fIЧИСЛО\fP,\fB \-\^\-context=\fP\fIЧИСЛО\fP Выводить \fIЧИСЛО\fP строк контекста. Между смежными группами соответствий помещается строка с групповым разделителем (\fB\-\^\-\fP). Данный параметр не действует при использовании параметра \fB\-o\fP или \fB\-\^\-only\-matching\fP, о чём будет выведено предупреждение. .TP \fB\-\^\-group\-separator=\fP\fIРАЗДЕЛИТЕЛЬ\fP При использовании параметров \fB\-A\fP, \fB\-B\fP или \fB\-C\fP выводить \fIРАЗДЕЛИТЕЛЬ\fP вместо \fB\-\^\-\fP между группами строк. .TP \fB\-\^\-no\-group\-separator\fP При использовании параметров \fB\-A\fP, \fB\-B\fP или \fB\-C\fP не выводить разделитель между группами строк. .SS "Выбор файлов и каталогов" .TP \fB\-a\fP, \fB\-\^\-text\fP Обрабатывать двоичные файлы как текстовые; данный параметр равнозначен параметру \fB\-\^\-binary\-files=text\fP. .TP \fB\-\^\-binary\-files=\fP\fIТИП\fP Если данные или метаданные файла указывают на то, что файл содержит двоичные данные, считать, что файл имеет тип \fIТИП\fP. Байты, не являющиеся текстовой информацией, указывают на двоичные данные; таковыми являются либо выходные байты, неверно закодированные с точки зрения текущих региональных настроек, либо нулевые входные байты, если параметр \fB\-z\fP не задан. .IP По умолчанию \fIТИП\fP задан как \fBbinary\fP, и \fBgrep\fP подавляет вывод после обнаружения нулевых байтов в двоичных входных данных, а также подавляет вывод строк, содержащих неверно закодированную информацию. В случае подавления каких\-либо выходных данных \fBgrep\fP сопровождает это сообщением в стандартный поток ошибок о том, что в двоичном файле найдены соответствия. .IP Если \fIТИП\fP задан как \fBwithout\-match\fP, при обнаружении нулевых байтов в двоичных входных данных \fBgrep\fP полагает, что оставшаяся часть файла не содержит соответствий; данный параметр равнозначен параметру \fB\-I\fP. .IP Если \fIТИП\fP задан как \fBtext\fP, \fBgrep\fP обрабатывает двоичные файлы как текстовые; данный параметр равнозначен параметру \fB\-a\fP. .IP Когда \fIТИП\fP задан как \fBbinary\fP, \fBgrep\fP может воспринимать нетекстовые байты в качестве разделителей строк даже при отсутствии параметра \fB\-z\fP. Это означает, что выбор между \fBbinary\fP и \fBtext\fP может повлиять на обнаружение соответствия шаблона и содержимого файла. Например, если \fIТИП\fP задан как \fBbinary\fP, шаблон \fBq$ может\fP соответствовать символу \fBq\fP, непосредственно за которым следует нулевой байт, хотя этого соответствия не будет обнаружено, если \fIТИП\fP задан как \fBtext\fP. И наоборот, если \fIТИП\fP задан как \fBbinary\fP, шаблон \fB.\&\fP (точка) может не совпасть с нулевым байтом. .IP \fIОбратите внимание:\fP использование параметра \fB\-a\fP может привести к выводу двоичного «мусора», что может иметь нежелательные последствия, если вывод осуществляется в терминал и его драйвер воспримет часть вывода как команды. С другой стороны, при чтении файлов с неизвестной кодировкой текста использование параметра \fB\-a\fP или задание \fBLC_ALL='C'\fP в среде окружения может оказаться полезным, чтобы найти больше соответствий, даже если они небезопасны для непосредственного отображения. .TP \fB\-D\fP\fI ДЕЙСТВИЕ\fP,\fB \-\^\-devices=\fP\fIДЕЙСТВИЕ\fP Если входной файл представляет собой устройство, FIFO или сокет, выполнить \fIДЕЙСТВИЕ\fP для его обработки. По умолчанию \fIДЕЙСТВИЕ\fP задаётся как \fBread\fP, что означает, что устройства будут считываться так же, как если бы они были обычными файлами. Если \fIДЕЙСТВИЕ\fP задано как \fBskip\fP, устройства будут пропущены без каких\-либо уведомлений. .TP \fB\-d\fP\fI ДЕЙСТВИЕ\fP,\fB \-\^\-directories=\fP\fIДЕЙСТВИЕ\fP Если входной файл представляет собой каталог, выполнить \fIДЕЙСТВИЕ\fP для его обработки. По умолчанию \fIДЕЙСТВИЕ\fP задаётся как \fBread\fP, что подразумевает чтение каталогов так, как если бы они были обычными файлами. Если \fIДЕЙСТВИЕ\fP задано как \fBskip\fP, пропускать каталоги без каких\-либо уведомлений. Если \fIДЕЙСТВИЕ\fP задано как \fBrecurse\fP, рекурсивно считывать все файлы в каждом каталоге, разыменовывая символьные ссылки, только если они указаны в командной строке. Выбор этого действия равнозначен указанию параметра \fB\-r\fP. .TP \fB\-\^\-exclude=\fP\fIШАБЛОН_ИМЕНИ\fP Пропускать любые указанные в командной строке файлы, окончание имени которых соответствует шаблону \fIШАБЛОН_ИМЕНИ\fP с использованием сравнения по маске (wildcard); окончанием имени считается либо всё имя целиком, либо его завершающая часть, начинающаяся с первого символа, следующего за косой чертой (\fB/\fP) и не являющегося символом косой черты. При рекурсивном поиске пропускать любой вложенный файл, простое имя которого соответствует \fIШАБЛОНУ_ИМЕНИ\fP; простым именем считается его часть, следующая за последней косой чертой. В шаблоне можно использовать символы \fB*\fP, \fB?\fP и \fB[\fP.\|.\|.\fB]\&\fP для задания маски, а \fB\e\fP позволяет экранировать эти символы или символ обратной косой черты для их буквального восприятия. .TP \fB\-\^\-exclude\-from=\fP\fIФАЙЛ\fP Пропускать файлы, простые имена которых соответствуют какому\-либо шаблону имени среди считанных из \fIФАЙЛА\fP (используя сравнение по маске так же, как это описано для параметра \fB\-\^\-exclude\fP). .TP \fB\-\^\-exclude\-dir=\fP\fIШАБЛОН_ИМЕНИ\fP Пропускать любые указанные в командной строке каталоги, окончание имени которых соответствует шаблону \fIШАБЛОН_ИМЕНИ\fP. При рекурсивном поиске пропускать любой вложенный каталог, простое имя которого соответствует \fIШАБЛОНУ_ИМЕНИ\fP. Игнорировать лишние символы косой черты, завершающие \fIШАБЛОН_ИМЕНИ\fP. .TP \fB\-I\fP Обрабатывать двоичные файлы так, как если бы они не содержали совпавших данных; данный параметр равнозначен параметру \fB\-\^\-binary\-files=without\-match\fP. .TP \fB\-\^\-include=\fP\fIШАБЛОН_ИМЕНИ\fP Выполнять поиск только в файлах, простые имена которых соответствуют \fIШАБЛОНУ_ИМЕНИ\fP (используя сравнение по маске так же, как это описано для параметра \fB\-\^\-exclude\fP). Если заданы противоречащие друг другу параметры \fB\-\^\-include\fP и \fB\-\^\-exclude\fP, силу будет иметь последний соответствующий из них. Если соответствие не было найдено ни для параметра \fB\-\^\-include\fP, ни для параметра \fB\-\^\-exclude\fP, файл включается в поиск, если параметр \fB\-\^\-include\fP не указан первым. .TP \fB\-r\fP, \fB\-\^\-recursive\fP Рекурсивно считывать все файлы в каждом каталоге, разыменовывая только те символьные ссылки, которые указаны в командной строке. Обратите внимание, что при отсутствии файловых операндов \fBgrep\fP выполняет поиск в рабочем каталоге. Данный параметр равнозначен параметру \fB\-d recurse\fP. .TP \fB\-R\fP, \fB\-\^\-dereference\-recursive\fP Рекурсивно считывать все файлы в каждом каталоге. В отличие от \fB\-r\fP разыменовывать все символьные ссылки. .SS "Остальные параметры" .TP \fB\-\^\-line\-buffered\fP Использовать буферизацию строк при выводе. Данный параметр может привести к снижению производительности. .TP \fB\-U\fP, \fB\-\^\-binary\fP Обрабатывать файлы как двоичные. По умолчанию при работе под управлением MS\-DOS и MS\-Windows \fBgrep\fP пытается угадать, является ли файл текстовым или двоичным, так, как это описано для параметра \fB\-\^\-binary\-files\fP. Если \fBgrep\fP решает, что файл является текстовым, он удаляет символы возврата каретки из исходного содержимого файла (чтобы обеспечить правильную работу регулярных выражений с \fB^\fP и \fB$\fP). Указание \fB\-U\fP переопределяет это поведение, позволяя выполнять чтение и передачу всех файлов механизму сопоставления дословно; если файл является текстовым файлом с парами символов CR/LF (возврат каретки и перевод на новую строку) в конце каждой строки, это приведёт к невозможности сопоставления с некоторыми регулярными выражениями. Данный параметр не действует на платформах, отличных от MS\-DOS и MS\-Windows. .TP \fB\-z\fP, \fB\-\^\-null\-data\fP Обрабатывать входные и выходные данные как последовательности строк, завершающихся нулевым байтом (символом NUL таблицы ASCII), а не символом перевода на новую строку. Как и параметры \fB\-Z\fP и \fB\-\^\-null\fP, этот параметр может использоваться с командами наподобие \fBsort \-z\fP, чтобы обеспечить обработку произвольных имён файлов. . .SH "РЕГУЛЯРНЫЕ ВЫРАЖЕНИЯ" Регулярное выражение — это шаблон, описывающий набор строк. Регулярные выражения составляются аналогично арифметическим выражениям с использованием различных операторов для соединения меньших выражений. .PP \fBgrep\fP поддерживает три различных варианта синтаксиса регулярных выражений: «basic» (простые, BRE), «extended» (расширенные, ERE) и «perl» (PCRE). В GNU \fBgrep\fP простые и расширенные регулярные выражения — это лишь разные способы записи для одного и того же набора функций сравнения с шаблоном. В других реализациях простые регулярные выражения как правило менее функциональны, чем расширенные, хотя иногда бывает наоборот. Следующее ниже описание относится к расширенным регулярным выражениям; отличия простых регулярных выражений приведены за ним. Perl\-совместимые регулярные выражения обладают другим набором функций и описаны в \fBpcre2syntax\fP(3) и \fBpcre2pattern\fP(3), однако работают, только если включена поддержка PCRE. .PP Основополагающими компонентами являются регулярные выражения, которые соответствуют одному символу. Большинство символов, включая все буквы и цифры, являются регулярными выражениями, которые соответствуют самим себе. Любой метасимвол, имеющий особое значение, можно экранировать, расположив перед ним символ обратной косой черты. .PP Точка \fB.\&\fP соответствует любому одному символу. Не уточняется, соответствует ли она символу, полученному в результате ошибки кодирования. .SS "Классы символов и выражения в квадратных скобках" \fIВыражение в квадратных скобках\fP представляет собой список символов, заключённых в символы \fB[\fP и \fB]\fP. Такое выражение соответствует любому одному символу из этого списка. Если первым символом в списке является карет \fB^\fP, то выражение соответствует любому одному символу, \fIне входящему\fP в список; не уточняется, соответствует ли оно символу, полученному в результате ошибки кодирования. Например, регулярное выражение \fB[0123456789]\fP соответствует любой одной цифре. .PP Внутри выражения в квадратных скобках может находиться \fIдиапазонное выражение\fP, состоящее из двух символов, разделённых дефисом. Оно соответствует любому одному символу, находящемуся с точки зрения порядка при сортировке между двумя указанными символами включительно, с учётом региональных правил упорядочивания и набора символов. Например, при использовании принятых по умолчанию региональных настроек C выражение \fB[a\-d]\fP равносильно выражению \fB[abcd]\fP. Для многих региональных настроек принят словарный порядок сортировки, в таких случаях \fB[a\-d]\fP обычно не соответствует \fB[abcd]\fP, а может быть равносильно, например, \fB[aBbCcDd]\fP. Чтобы добиться традиционной интерпретации выражений в квадратных скобках, вы можете использовать региональные настройки C, установив переменную среды \fBLC_ALL\fP в значение \fBC\fP. .PP Наконец, существуют предопределённые классы символов, используемые внутри выражений в квадратных скобках в следующем виде: \fB[:alnum:]\fP (буквенно\-цифровые), \fB[:alpha:]\fP (буквенные), \fB[:blank:]\fP (пробел или табуляция), \fB[:cntrl:]\fP (управляющие), \fB[:digit:]\fP (цифровые), \fB[:graph:]\fP (графические), \fB[:lower:]\fP (нижнего регистра), \fB[:print:]\fP (печатаемые), \fB[:punct:]\fP (пунктуационные), \fB[:space:]\fP (пробельные), \fB[:upper:]\fP (верхнего регистра) и \fB[:xdigit:]\fP (шестнадцатеричные). Например, \fB[[:alnum:]]\fP означает класс символов, включающий цифры и буквы с учётом текущих региональных настроек. При использовании региональных настроек C и кодового набора символов ASCII этот класс равносилен выражению \fB[0\-9A\-Za\-z]\fP. Следует обратить внимание, что квадратные скобки в именах перечисленных классов являются частью их имени и должны быть включены в дополнение к скобкам, отделяющим выражение в квадратных скобках. Большинство метасимволов теряют своё особое значение при использовании внутри выражений в квадратных скобках. Чтобы включить символ \fB]\fP, поместите его в начало списка. Аналогично, чтобы включить символ \fB^\fP, поместите его в любое место кроме начала. Наконец, чтобы включить символ \fB\-\fP, поместите его в конец списка. .SS Якоря Карет \fB^\fP и знак доллара \fB$\fP являются метасимволами, которые соответствуют пустой последовательности в начале и в конце строки соответственно. .SS "Символ обратной косой черты и специальные выражения" Символы \fB\e<\fP и \fB\e>\fP соответствуют пустой последовательности в начале и в конце слова соответственно. Символ \fB\eb\fP соответствует пустой последовательности на границе слова, а \fB\eB\fP соответствует пустой последовательности, которая \fIне находится\fP на границе слова. Символ \fB\ew\fP является синонимом выражения \fB[_[:alnum:]]\fP, а \fB\eW\fP — синонимом \fB[^_[:alnum:]]\fP. .SS Повторение За регулярным выражением может следовать один или несколько операторов повторения: .PD 0 .TP \fB?\fP Предыдущий элемент является необязательным и сопоставляется не более одного раза. .TP \fB*\fP Предыдущий элемент сопоставляется ноль или более раз. .TP \fB+\fP Предыдущий элемент сопоставляется один или более раз. .TP \fB{\fP\fIn\fP\fB}\fP Предыдущий элемент сопоставляется в точности \fIn\fP раз. .TP \fB{\fP\fIn\fP\fB,}\fP Предыдущий элемент сопоставляется \fIn\fP или более раз. .TP \fB{,\fP\fIm\fP\fB}\fP Предыдущий элемент сопоставляется не более \fIm\fP раз. Данный оператор является расширением GNU. .TP \fB{\fP\fIn\fP\fB,\fP\fIm\fP\fB}\fP Предыдущий элемент сопоставляется минимум \fIn\fP раз, но не более \fIm\fP раз. .PD .SS Объединение Два регулярных выражения могут быть объединены; результирующее регулярное выражение соответствует любой строке, полученной посредством объединения двух подстрок, каждая из которых удовлетворяет соответствующему ей исходному регулярному выражению. .SS Чередование Два регулярных выражения могут быть соединены инфиксным оператором \fB|\fP; результирующее регулярное выражение соответствует любой строке, которая соответствует одному из соединённых выражений. .SS Очерёдность Повторение имеет приоритет перед объединением, которое, в свою очередь, имеет приоритет перед чередованием. Выражение может быть заключено в круглые скобки, чтобы переопределить эти правила очерёдности и сформировать подвыражение. .SS "Обратные ссылки и подвыражения" Обратная ссылка \fB\e\fP\fIn\fP\&, где \fIn\fP — одиночная цифра, соответствует подстроке, для которой ранее было найдено соответствие \fIn\fP\-ому подвыражению в круглых скобках, входящему в состав регулярного выражения. .SS "Различия между простыми и расширенными регулярными выражениями" В простых регулярных выражениях метасимволы \fB?\fP, \fB+\fP, \fB{\fP, \fB|\fP, \fB(\fP и \fB)\fP теряют своё особое значение; вместо них следует использовать экранированные варианты \fB\e?\fP, \fB\e+\fP, \fB\e{\fP, \fB\e|\fP, \fB\e(\fP и \fB\e)\fP. . .SH "КОД ЗАВЕРШЕНИЯ" В обычном режиме работы код завершения равен 0, если строка с совпадением была обнаружена; 1, если таких строк не было найдено; 2, если произошла ошибка. Однако, при использовании параметров \fB\-q\fP, \fB\-\^\-quiet\fP или \fB\-\^\-silent\fP обнаружение строки с совпадением приводит к завершению с кодом 0, даже если были обнаружены ошибки. . .SH "СРЕДА ОКРУЖЕНИЯ" На поведение \fBgrep\fP влияют следующие переменные среды окружения. .PP Региональные настройки для категории \fBLC_\fP\fIfoo\fP определяются путём анализа трёх переменных среды \fBLC_ALL\fP, \fBLC_\fP\fIfoo\fP, \fBLANG\fP в указанном порядке. Первая из этих переменных, для которой было задано значение, определяет региональные настройки. Например, если переменная \fBLC_ALL\fP не установлена, а \fBLC_MESSAGES\fP задано значение \fBpt_BR\fP, то для категории \fBLC_MESSAGES\fP будут использованы настройки, принятые для бразильского португальского. Если ни одна из перечисленных переменных не задана, не установлен каталог региональных настроек или компиляция \fBgrep\fP осуществлялась без поддержки национальных языков (NLS), то будут использованы региональные настройки C. Команда оболочки \fBlocale \-a\fP позволяет вывести список доступных региональных настроек. .TP \fBGREP_COLORS\fP Управляет подсветкой выводимых данных при использовании параметра \fB\-\^\-color\fP. Значение этой переменной представляет собой список возможностей, разделённых двоеточиями; по умолчанию оно задано как \fBms=01;31:mc=01;31:sl=:cx=:fn=35:ln=32:bn=32:se=36\fP, при этом возможности \fBrv\fP и \fBne\fP опущены (т.е. установлены в логическое значение «ложь»). Поддерживаемые возможности представлены ниже. .RS .TP \fBsl=\fP Подстрока SGR для выбранных строк целиком (другими словами, для строк с соответствиями, если не указан параметр командной строки \fB\-v\fP, или для строк без соответствий, если \fB\-v\fP указан). Однако, если задана возможность \fBrv\fP и параметр командной строки \fB\-v\fP, то вместо этого данная подстрока SGR применяется к контекстным строкам с соответствиями. По умолчанию значение не устанавливается (т.е. используется цветовая пара по умолчанию, заданная для терминала). .TP \fBcx=\fP Подстрока SGR для контекстных строк целиком (другими словами, для строк без соответствий, если не указан параметр командной строки \fB\-v\fP, или для строк с соответствиями, если \fB\-v\fP указан). Однако, если задана возможность \fBrv\fP и параметр командной строки \fB\-v\fP, то вместо этого данная подстрока SGR применяется к выбранным строкам без соответствий. По умолчанию значение не устанавливается (т.е. используется цветовая пара по умолчанию, заданная для терминала). .TP \fBrv\fP Логическое значение, которое меняет действия возможностей \fBsl=\fP и \fBcx=\fP на противоположные, если указан параметр командной строки \fB\-v\fP. Значением по умолчанию является «ложь» (т.е. возможность не указана). .TP \fBmt=01;31\fP Подстрока SGR для непустого совпавшего текста в любой строке с соответствиями (другими словами, в выбранной строке, если не указан параметр командной строки \fB\-v\fP, или в контекстной строке, если \fB\-v\fP указан). Установка этой возможности равносильна одновременной установке \fBms=\fP и \fBmc=\fP в одно и то же значение. По умолчанию используется выделенный жирным красным шрифтом текст на переднем плане поверх текущего фонового цвета строки. .TP \fBms=01;31\fP Подстрока SGR для непустого совпавшего текста в выбранной строке (используется только в том случае, если параметр командной строки \fB\-v\fP не указан). Действие возможности \fBsl=\fP (или \fBcx=\fP при активной \fBrv\fP) остаётся в силе, когда данная возможность срабатывает. По умолчанию используется выделенный жирным красным шрифтом текст на переднем плане поверх текущего фонового цвета строки. .TP \fBmc=01;31\fP Подстрока SGR для непустого совпавшего текста в контекстной строке (используется только в том случае, если указан параметр командной строки \fB\-v\fP). Действие возможности \fBcx=\fP (или \fBsl=\fP при активной \fBrv\fP) остаётся в силе, когда данная возможность срабатывает. По умолчанию используется выделенный жирным красным шрифтом текст на переднем плане поверх текущего фонового цвета строки. .TP \fBfn=35\fP Подстрока SGR для имён файлов, предшествующих строкам с любым содержимым. По умолчанию используется пурпурный текст на переднем плане поверх фонового цвета по умолчанию, заданного для терминала. .TP \fBln=32\fP Подстрока SGR для номеров строк, предшествующих строкам с любым содержимым. По умолчанию используется зелёный текст на переднем плане поверх фонового цвета по умолчанию, заданного для терминала. .TP \fBbn=32\fP Подстрока SGR для смещений в байтах, предшествующих строкам с любым содержимым. По умолчанию используется зелёный текст на переднем плане поверх фонового цвета по умолчанию, заданного для терминала. .TP \fBse=36\fP Подстрока SGR для разделителей, которые помещаются между полями выбранных строк (\fB:\fP), между полями контекстных строк (\fB\-\fP) и между группами смежных строк, если задан ненулевой размер контекста (\fB\-\^\-\fP). По умолчанию используется бирюзовый текст на переднем плане поверх фонового цвета по умолчанию, заданного для терминала. .TP \fBne\fP Логическое значение, которое позволяет предотвратить удаление данных до конца строки с использованием Erase in Line (EL) to Right (\fB\e33[K\fP) каждый раз, когда заканчивается выделенный цветом элемент. Это необходимо для терминалов, которые не поддерживают EL. В других случаях это полезно для терминалов, к которым не применяется логическая возможность terminfo \fBback_color_erase\fP (\fBbce\fP), в ситуациях, когда выбранные для выделения цвета не влияют на фон, или когда обработка EL выполняется слишком медленно или вызывает слишком сильное мерцание. Значением по умолчанию является «ложь» (т.е. возможность не указана). .PP Обратите внимание, что логические возможности не имеют \fB=\fP.\|.\|.\& в своём составе. Они опускаются (т.е. принимают значение «ложь») по умолчанию, а при указании принимают значение «истина». .PP Обратитесь к разделу Select Graphic Rendition (SGR) в документации к используемому текстовому терминалу, чтобы получить информацию о допустимых значениях и функциях, которые они выполняют в качестве атрибутов символов. Значения рассматриваемых подстрок SGR представляют собой целые числа в десятичном представлении и могут объединяться друг с другом через точки с запятой. \fBgrep\fP берёт на себя задачу сборки результата в полноценную последовательность SGR (\fB\e33[\fP.\|.\|.\fBm\fP). Распространённые значения, используемые при объединении, включают в себя \fB1\fP для получения жирного шрифта, \fB4\fP для подчёркивания, \fB5\fP для мигания, \fB7\fP для инвертирования цвета, \fB39\fP для цвета переднего плана по умолчанию, от \fB30\fP до \fB37\fP для выбора цвета переднего плана, от \fB90\fP до \fB97\fP для выбора цвета переднего плана в 16\-цветном режиме, от \fB38;5;0\fP до \fB38;5;255\fP для выбора цвета переднего плана в 88\-цветном и 256\-цветном режимах, \fB49\fP для фонового цвета по умолчанию, от \fB40\fP до \fB47\fP для выбора фонового цвета, от \fB100\fP до \fB107\fP для выбора фонового цвета в 16\-цветном режиме, от \fB48;5;0\fP до \fB48;5;255\fP для выбора фонового цвета в 88\-цветном и 256\-цветном режимах. .RE .TP \fBLC_ALL\fP, \fBLC_COLLATE\fP, \fBLANG\fP Данные переменные задают региональные настройки для категории \fBLC_COLLATE\fP, которая определяет правила упорядочивания, используемые при интерпретации диапазонных выражений наподобие \fB[a\-z]\fP. .TP \fBLC_ALL\fP, \fBLC_CTYPE\fP, \fBLANG\fP Данные переменные задают региональные настройки для категории \fBLC_CTYPE\fP, которая определяет типы символов, например, какие символы считаются пробельными. Эта категория также определяет кодирование символов, то есть закодирован ли текст в UTF\-8, ASCII или какой\-либо другой кодировке. При использовании региональных настроек C или POSIX все символы кодируются одним байтом и каждый байт является допустимым символом. .TP \fBLC_ALL\fP, \fBLC_MESSAGES\fP, \fBLANG\fP Данные переменные задают региональные настройки для категории \fBLC_MESSAGES\fP, которая определяет язык, используемый \fBgrep\fP при выводе сообщений. Выбираемые по умолчанию региональные настройки C используют сообщения на американском варианте английского языка. .TP \fBPOSIXLY_CORRECT\fP Если данная переменная задана, поведение \fBgrep\fP будет соответствовать требованиям POSIX; в противном случае поведение \fBgrep\fP будет больше похоже на поведение других программ от GNU. Стандарты POSIX требуют, чтобы параметры, следующие за именами файлов, воспринимались как имена файлов; по умолчанию такие параметры перемещаются в начало списка операндов и воспринимаются как параметры. Кроме того, стандарты POSIX требуют, чтобы нераспознанные параметры помечались как «незаконные» (illegal), но поскольку на самом деле они не противоречат закону, по умолчанию они помечаются как «недопустимые» (invalid). . .SH ПРИМЕЧАНИЯ Данная страница руководства обновляется по мере возможности; полная документация нередко является более актуальной. . .SH "АВТОРСКИЕ ПРАВА" Copyright 1998\-2000, 2002, 2005\-2023 Free Software Foundation, Inc. .PP Это свободное программное обеспечение; обратитесь к исходному коду для получения информации об условиях копирования. НЕ ПРЕДОСТАВЛЯЕТСЯ каких\-либо гарантий, в том числе гарантий ОКУПАЕМОСТИ или СООТВЕТСТВИЯ КОНКРЕТНЫМ ЦЕЛЯМ. . .SH ОШИБКИ .SS "Отчёты об ошибках" Отправляйте отчёты об ошибках на адрес электронной почты .MT bug\-grep@gnu.org .ME . Также доступны архив электронных писем .UR https://lists.gnu.org/mailman/listinfo/bug\-grep .UE и система отслеживания ошибок .UR https://debbugs.gnu.org/cgi/pkgreport.cgi?package=grep .UE . .SS "Известные ошибки" Задание большого количества повторений в конструкции \fB{\fP\fIn\fP\fB,\fP\fIm\fP\fB}\fP может привести к использованию \fBgrep\fP больших объёмов памяти. Кроме того, существуют и некоторые другие регулярные выражения, требующие экспоненциального роста затрачиваемого времени и пространства и способные вызвать нехватку памяти при работе \fBgrep\fP. .PP Обратные ссылки являются очень медленной конструкцией и могут привести к экспоненциальному росту затрачиваемого времени. . .SH ПРИМЕР Следующий пример выводит расположение и содержимое всех строк, содержащих «f» и заканчивающихся на «.c», которые встречаются во всех файлах текущего каталога, чьи имена содержат «g» и заканчиваются на «.h». Параметр \fB\-n\fP позволяет вывести номера строк; аргумент \fB\-\-\fP предназначен для того, чтобы при раскрытии «*g*.h» имена, начинающиеся с «\-», воспринимались как имена файлов, а не параметры; пустой файл /dev/null позволяет вывести имена файлов, даже если только одно имя файла имеет вид «*g*.h». .PP .in +2n .EX $ \fBgrep\fP \-n \-\- 'f.*\e.c$' *g*.h /dev/null argmatch.h:1:/* definitions and prototypes for argmatch.c .EE .in .PP Единственной строкой, в которой было найдено соответствие, является строка 1 файла argmatch.h. Обратите внимание, что синтаксис регулярного выражения, используемый в шаблоне, отличается от синтаксиса шаблона файловых имён, который использует оболочка. . .SH "СМОТРИТЕ ТАКЖЕ" .SS "Обычные страницы руководства" \fBawk\fP(1), \fBcmp\fP(1), \fBdiff\fP(1), \fBfind\fP(1), \fBperl\fP(1), \fBsed\fP(1), \fBsort\fP(1), \fBxargs\fP(1), \fBread\fP(2), \fBpcre2\fP(3), \fBpcre2syntax\fP(3), \fBpcre2pattern\fP(3), \fBterminfo\fP(5), \fBglob\fP(7), \fBregex\fP(7) .SS "Полная документация" По адресу .UR https://www.gnu.org/software/grep/manual/ .UE доступно полное руководство. Если программы \fBinfo\fP и \fBgrep\fP корректно установлены в вашей системе, команда .IP \fBinfo grep\fP .PP должна предоставить вам доступ к полному руководству. . .\" Work around problems with some troff -man implementations. .br . .\" Format for Emacs-maintained Dt string defined at this file's start. .\" Local variables: .\" time-stamp-format: "%:y-%02m-%02d" .\" End: .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Андрей Догадкин . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .