НАЗВА¶

grep, egrep, fgrep - вивід рядків узгоджених із зразком

СИНОПСИС¶

grep [ опції ] ЗРАЗОК [ FILE ...]

grep [ опції ] [ -e ЗРАЗОК | -f ФАЙЛ ] [ ФАЙЛ ...]

ОПИС¶

Grep шукає у вказаному вводі ФАЙЛ(И) (чи в звичному вводі, якщо не вказано файли, чи вказана назва файлу - ) рядки, що містять збіг із наданим зразком ЗРАЗОК . За замовчуванням, grep друкує відповідні рядки.

Додатково, є два варіанти програм: egrep та fgrep . Egrep - це те саме, що grep -E . Fgrep - це те саме, що grep -F.

ОПЦІЇ¶

-A ЧИСЛО, --after-context=ЧИСЛО

Вивести ЧИСЛО рядків наступного контексту після відповідних рядків. Рядок складений з символів -- розмежує суміжні групи збігу.

-a , --text

Обробляти двійковий файл, наче він текстовий; це тотожно опції --binary-files=text.

-B ЧИСЛО, --before-context=ЧИСЛО

Вивести ЧИСЛО рядків попереднього контексту перед відповідними рядками. Рядок складений з символів -- розмежує суміжні групи збігу.

-C ЧИСЛО, --context=ЧИСЛО

Вивести ЧИСЛО рядків контексту. Рядок складений з символів -- розмежує суміжні групи збігу.

-b, --byte-offset

Ставить перед кожним рядком номер блоку, в якому він був знайдений. Це може знадобитись при пошуку блоків за контекстом (блоки нумеруються з 0).

--binary-files=ТИП

Якщо перші декілька байтів файлу вказують що він утримує двійкові дані, припустити що файл буде ТИП типу. За замовчуванням ТИП вважається binary (двійковим) і grep виводить рядок повідомлення про співпадання ("binary file matches"), або жодних повідомлень у випадку неузгодження з зразком. Якщо вказати ТИП як without-match, grep вважатиме що жодний двійковий файл не співпадає, це рівносильне -I опції. Якщо ТИП буде text, grep обробляє двійкові файли так ніби вони були звичайними текстовими, це рівносильне -a опції. Попередження: --binary-files=text може також вивести двійкове сміття, що іноді матиме небажаний ефект якщо виводом служить термінал, чий двигун може сприйняти цей вивід за команди.

--colour[=КОЛИ], --color[=КОЛИ]

Оточує рядок що співпав з зразком кольором, вказаним у змінній середовища GREP_COLOR. КОЛИ може бути `never' (ніколи), `always' (завжди) або `auto' (автоматично).

-c, --count

Пригнічує звичайний вивід, натомість виводить число яке дорівнює кількості рядків що співпала у кожному файлі вводу. З -v, --invert-match опцією (дивіться нижче) виводить число рядків що не співпала.

-D ДІЯ, --device=ДІЯ

Якщо файл вводу є пристроєм, FIFO або сокетом, використає ДІЮ щоб обробити ввід. За замовчуванням дією є read, що означає що пристрої будуть прочитані так, ніби вони є звичайними файлами. Якщо значенням ДІЇ буде skip, пристрої на братимуться до уваги.

-d ДІЯ, --directories=ДІЯ

Якщо файл вводу є каталогом, використає ДІЮ щоб обробити його. За замовчуванням ДІЄЮ є read, що означає що каталоги читаються так, ніби вони є звичайним файлами. Якщо значенням ДІЇ буде skip, каталоги не братимуться до уваги. Якщо ж ДІЄЮ буде recurse, grep прочитає кожний файл у кожному каталозі рекурсивно, це рівнозначно -r опції.

-E, --extended-regexp

Розглядає ЗРАЗОК як розширений регулярний вираз (дивіться нижче).

-e ЗРАЗОК, --regexp=ЗРАЗОК

Використає ЗРАЗОК як зразок. Зручно для використання зразків що починаються з - (риски).

-F, --fixed-strings

Розгляне ЗРАЗОК як список фіксованих рядків, розділених новою лінією; співпадання може відбутися з любим з них.

-P, --perl-regexp

Розгляне ЗРАЗОК як Perl регулярний вираз.

-f ФАЙЛ, --file=ФАЙЛ

Вкаже файл у якому знаходяться ЗРАЗКИ, один на кожний рядок. Порожній файл утримує нуль зразків і тому не не співпадає з нічим.

-G, --basic-regexp

Розгляне ЗРАЗОК як базовий регулярний вираз (дивіться нижче). Це є стандартним поводженням.

-H, --with-filename

Виведе назву файлу рядом з кожним рядком співпадання.

-h, --no-filename

Запобігає показу назви файлу рядом з кожним рядком що співпав. Використовується при пошуку по декільком файлам.

--help

Виводить коротке повідомлення з допомогою.

-I

Розглядатиме двійкові файли так, ніби вони не містять жодних співпадань; опція рівнозначна --binary-files=without-match.

-i, --ignore-case

Ігнорує регістр символів при порівняннях.

-L, --files-without-match

Пригнічує звичайний вивід, виводить тільки назви файлів де не відбулося співпадань. Пошук всередині файлів припиняється після першого ж співпадання.

-l, --files-with-matches

Пригнічує звичайний вивід, видає тільки назви файлів, що містять збіги. Пошук всередині файлів припиняється після першого ж співпадання.

-m ЧИСЛО, --max-count=ЧИСЛО

Припиняє пошук всередині файла після вказаного ЧИСЛА рядків із співпаданнями. Якщо ввід відбувається з звичайного файла, grep зупинить пошук одразу ж на наступному рядку після останнього рядка що співпав і припинить роботу. Останнє дозволяє виклик процесу для відновлення пошуку з місця зупинки.

Коли додатково вживається -c або --count опція, grep не виведе цифру більше за ЧИСЛО аргумент. Коли додатково вживається -v або --invert-match опція, grep припинить вивід після ЧИСЛА рядків що не співпали.

--mmap

Якщо можливо, використає mmap(2) системний виклик для зчитування вводу, замість read(2) за замовчуванням. В деяких випадках, --mmap призводить до кращих результатів. Тим не менш, --mmap може викликати довільне поводження (включаючи дамп оперативної пам'яті) якщо файл вводу зменшився розміром під час дії grep, або якщо виникла помилка вводу/виводу.

-n, --line-number

Виводить перед кожним рядком його номер у файлі (рядки нумеруються з 1).

-o, --only-matching

Покаже лише ту частину рядка що співпала із ЗРАЗКОМ. (Зручно для тестування зразків.)

--label=НАЗВА

Вказує ніби ввід надходить з файла з назвою НАЗВА. Ця опція корисна у поєднанні з знаряддям на кшталт zgrep, тобто gzip -cd foo.gz | grep -label=foo ЗРАЗОК.

--line-buffering

Використає буферування рядків, може сказатися на ефективності.

-q, --quiet, --silent

Мовчазний вивід. Не виводитиме нічого на стандартний пристрій виводу. Зупиниться одразу, із нульовим статусом виходу (успіх), як тільки буде знайдене співпадання, навіть якщо виявиться якась помилка. Також дивіться -s і --no-message опції.

-R, -r, --recursive

Прочитає кожний файл у кожному підкаталозі рекурсивно. Рівнозначна -d recurse опції.

--include=ЗРАЗОК

Рекурсивно шукатиме тільки у каталогах, назва яких співпадає із ЗРАЗКОМ.

--exclude=ЗРАЗОК

Рекурсивно шукатиме у всіх каталогах, окрім тих чия назва співпадає із ЗРАЗКОМ.

-s, --no-messages

Пригнічує повідомлення про помилки про неіснуючі файли або файли, недоступні для прочитання. Примітка щодо переносності: на відміну від grep GNU, традиційна grep не узгоджувалась з POSIX.2 у тому що в останній була відсутня опція -q і її опція -s, натомість, поводилась як -s GNU. Оболонкові скрипти які бажають бути сумісними з традиційною grep, повинні уникати обидвох опцій, -q і -s, натомість переправляючи вивід до /dev/null.

-U, --binary

Розглядатиме файл(и) як двійкові. За замовчуванням, у MS-DOS та MS-Windows системах, grep вгадує тип файлу прочитавши його перші 32 кілобайти. Якщо grep вирішить що це текстовий файл, вона видалить CR знаки з оригінального файлу (щоб забезпечити функціонування ^ та $). Вказування -U відміняє це вгадування, зумовлюючи прочитання всіх файлів і буквальну передачу їх механізму порівнювання; якщо це був текстовий файл із CR/LF парою наприкінці кожного рядка, це може призвести до неспівпадання з деякими зразками. Ця опція не має жодного впливу на відмінних від MS-DOS/MS-Windows платформах.

-u, --unix-byte-offsets

Звітувати розположення байтів типу Юнікс. Цей ключ змушує grep сприймати розположення байтів у файлі так ніби це був звичайний текстовий файл Юнікса, тобто із видаленими CR знаками. Це призведе до результатів ідентичних із запуском grep на Юнікс машинах. Ця опція не працює лише у поєднанні з -b ключем і не має жодного впливу на відмінних від MS-DOS/MS-Windows платформах.

-V, --version

Виведе номер версії програми grep у вигляді стандартної помилки. Номер версії програми повинен включатися у всі повідомлення про вади (дивіться нижче).

-v, --invert-match

Міняє зміст співпадань. Виводить усі рядки, за винятком тих, що містять співпадання.

-w, --word-regexp

Серед порівнювань із зразком вибирає лише ті що цілком співпадають і утворюють цілі "слова". Під цілковитим співпаданням мається на увазі що послідовність знаків тексту що співпала один до одного із зразком повинна обмежуватись з обох сторін знаками що не відносяться до "слова"; це може бути початок або кінець рядка, або любий знак крім літер, чисел і твердого пробілу (останні regex розглядатиме як такі що утворюють "слово").

-x, --line-regexp

Вибере лише співпадання із цілим рядком.

-y

Застарілий синонім для -i.

-Z, --null

Виведе нульовий байт (NULL знак ASCII) замість знака що звичайно слідує за назвою файла. Так, наприклад, grep -lZ помістить нульовий байт після кожного імені файла замість стандартної нової лінії. Ця опція забезпечує однозначний вивід, навіть у випадку назв файлів що містять незвичні знаки, такі як знак нового рядка. Ця опція може використовуватись разом з такими командами як find -print, perl -0, sort -z і xargs для обробки довільних назв файлів.

-z, --null-data

Розгляне ввід ак набір рядків, кожен з яких буде закінчуватись нульовим байтом (NULL знак ASCII) замість знака нового рядка. Так само як і -Z або --null опції, може бути використаною з командами на зразок sort -z для обробки довільних назв файлів.

РЕГУЛЯРНІ ВИРАЗИ¶

Регулярний вираз - це зразок що описує набір текстових ланцюжків. Побудова регулярних виразів дещо схожа на побудову арифметичних виразів у тому що використовуються різноманітні оператори для комбінації менших виразів.

Grep розуміє три, дещо відмінні, версії синтаксису регулярних виразів, а саме: "basic", "extended" і "perl" (базовий, розширений і perl). У grep GNU немає різниці у функціональності при використанні перших двох версій. У інших втіленнях, базові регулярні вирази - менш потужні. Наступне описує розширені регулярні вирази, відмінності від базових вказані в кінці. Perl регулярні вирази надають додаткову функціональність. Це нова риса програми grep, не скрізь підтримувана. Ми не будемо озглядати цю версію тут, натомість зверніться до perlrequick((1) або perlre(1).

Основною складовою частиною є регулярні вирази що співпадають з одним знаком. Більшість знаків, включаючи всі літери і цифри утворять регулярний вираз що співпадатиме з тим самим знаком. Любий знак із спеціальним значенням може бути екрановано за допомогою попереднього оберненого слешу.

Вирази в квадратних дужках ([ і ]) співпадатимуть із одним із знаків перелічених всередині дужок, за винятком коли першим знаком є шапочка (^), у такому разі цей вираз, навпаки, співпадатиме із любим знаком окрім перечислених у списку. Так, наприклад, вираз [01234] співпаде з однією з цих цифр, тоді як [^24] - з любим знаком крім 2 і 4.

Всередині виразів у квадратних дужках можуть також знаходитись вирази діапазону знаків. Діапазон знаків складатиметься з двох знаків із рискою поміж ними. Діапазон співпадатиме із любим знаком що знаходиться між двома вказаними, включаючи самі вказівники. Пошук можливих співпадань здійснюється завдяки сортуванню, відповідно до впорядкованості і набору знаків локалі. Так, наприклад, у стандартній C локалі, [a-d] рівнозначне [abcd]. Деякі локалі сортують у словниковій послідовності, в такому випадку [a-d] може означати [aBbCcDd], натомість. Щоб отримати традиційну інтерпретацію виразів у квадратних дужках, можете спробувати надати змінній середовища LC_ALL значення C (дивіться ЗМІННІ СЕРЕДОВИЩА нижче).

Накінець, певні класи знаків об'єднані і можуть вказуватись як одна назва всередині квадратних дужок. Їхні назви підказують що саме вони означають:

ЗМІННІ СЕРЕДОВИЩА¶

Поведінка grep залежить від змінних середовища, описаних нижче. Для додаткової інформації про змінні середовища дивіться також сторінку посібника для environ(5).

Локаль LC_foo встановлюється через прочитання трьох змінних середовища, LC_ALL, LC_foo, LANG, саме в цій послідовності. Найперша з цих змінних що буде встановленою вказуватиме локаль. Наприклад, якщо LC_ALL не встановлена, зате LC_MESSAGES надане значення pt_BR, тоді Бразільська Португальська мова використовуватиметься для LC_MESSAGES локалі. Локаль C вживатиметься якщо жодна з цих змінних середовища не є встановленою, або якщо locale каталог не інстальований, або, нарешті, якщо grep не була копільованою з підтримкою іноземних мов (NLS - national language support).

GREP_OPTIONS

Ця змінна вказує на опції що додаватимуться попереду будь-яких інших прапорців під час виклику програми. Так, наприклад, якщо GREP_OPTIONS матиме значення '--binary-files=without-match', grep поводитиметься так ніби обидві опції, --binary-files=without-match та --directories=skip були вказані поперед аргументів на командній лінії. Якщо ви хочете надати GREP_OPTIONS більше значень, розділяйте їх пробілами. Обернений слеш екранує наступний знак, тож ви можете вживати також опції що містять пробіли і обернені слеші.

GREP_COLOR

Вказує колір для підсвітки співпадань.

LC_ALL, LC_COLLATE, LC_ALL

Ці змінні встановлюють LC_COLLATE локаль, що відповідає за порядок сортування використованого для інтерпретації діапазонів на зразок [a-z].

LC_ALL, LC_CTYPE, LANG

Ці змінні встановлюють LC_TYPE локаль, яка визначає типи знаків, тобто які з знаків є пробілами.

LC_ALL, LC_MESSAGES, LANG

Ці змінні встановлюють LC_MESSAGES локаль, яка визначає мову повідомлень grep. За замовчуванням, C локаль послуговується американською англійською.

POSIXLY_CORRECT

Якщо ця змінна встановлена, grep поводиться відповідно до POSIX.2 вимог; в протилежному випадку - як решта програм GNU. POSIX.2 вимагає щоб опції що слідують за назвами файлів розглядались теж як назви файлів; за замовчуванням такі опції переносяться на початок списку операндів і розглядаються як опції. Також POSIX.2 наполягає щоб нерозпізнані опції діагнозувалися як заборонені, незаконні (illegal), тоді як звичайно вони діагнозуються як недійсні ("invalid"). POSIXLY_CORRECT також робить неможливою _N_GNU_nonoption_argv_flags_, описану нижче.

_N_GNU_nonoption_argv_flags_

(N у цьому випадку буде ідентифікаційним номером процесу grep.) Якщо x-ний елемент цієї змінної є одиницею (1), не братиметься до уваги x-ний операнд grep як опція, навіть якщо даний операнд виглядає нею. Оболонка в змозі помістити цю змінну у середовище для використання кожною запущеною командою. Це надає змогу підказати які з операндів являються результатом розкриття назви файла або байдужого символу і тому не розглядатися як прапорець або опція програми. Ця властивість доступна лише з GNU C бібліотекою і тільки коли POSIXLY_CORRECT не є встановленою.

ДІАГНОСТИКА¶

Як правило, статусом виходу буде 0, якщо рядки що відповідають зразку знайдено і 1 у протилежному випадку. У випадку помилки, статусом виходу є 2, хіба використовувалась опція -q, --quiet або --silent і рядок із співпаданням було знайдено.

ДИВІТЬСЯ ТАКОЖ¶

regcomp(3), regex(7)

ВАДИ¶

Повідомлення про вади надсилайте на bug-gnu-utils@gnu.org. Впевніться що ви включили слово "grep" десь у полі "Subject:".

Великі значення у {n,m} виразах можуть спричинити використання grep значної кількості пам'яті. На додаток, деякі інші ускладнені регулярні вирази можуть вимагати значного часу і місця на обробку і зумовити недостачу пам'яті для grep.

Обернені звертання досить повільні і можуть вимагати додаткового часу на обробку.