PGREP(1)

НАЗВА
pgrep, pkill — пошук або надсилання сигналів процесам на основі даних щодо їхньої назви та інших атрибутів

КОРОТКИЙ ОПИС
pgrep [параметри] взірець
pkill [параметри] взірець

ОПИС
pgrep виконує пошук серед поточних запущених процесів і виводить список ідентифікаторів процесів, які відповідають критерію вибору до stdout. Виконуватися мають усі критерії. Наприклад,

    $ pgrep -u root sshd

покаже список процесів, які мають назву sshd і належать root. З іншого боку,

    $ pgrep -u root,daemon

виведе список процесів, власником яких є root або daemon.

pkill надішле вказаний сигнал (типово SIGTERM) кожному процесу, замість виведення списку процесів до stdout.

ПАРАМЕТРИ

-сигнал
--signal сигнал
    Визначає сигнал для надсилання кожному відповідному процесу. Для визначення сигналу можна скористатися цифровим значенням або символічною назвою сигналу. (лише для pkill.)

-c, --count
    Придушити звичайне виведення. Замість цього, вивести кількість відповідних процесів. Якщо не вдасться знайти нічого, наприклад, буде повернуто нульове значення, програма поверне ненульове значення помилки.

-d, --delimiter роздільник
    Встановлює рядок, що використовуватиметься для відокремлення ідентифікаторів процесів у виведених даних (типовим роздільником є символ розриву рядка). (Лише pgrep.)

-f, --full
    Зазвичай, відповідність взірця встановлюється лише для назви процесу. Якщо використано -f, відповідність встановлюється за цілим рядком команди.

-g, --pgroup група процесів,...
    Встановлювати відповідність процесів лише для вказаного списку ідентифікаторів груп. Група процесів 0 відповідає власній групі процесів pgrep або pkill.

-G, --group gid,...
    Встановлювати відповідність процесів зі списку справжніх ідентифікаторів груп. Можна використовувати цифрове або символічне значення ідентифікатора.

-l, --list-name
    Вивести список назв процесів, а також ідентифікаторів процесів. (Лише pgrep.)

-a, --list-full
    Вивести список рядків команд повністю, а також ідентифікаторів процесів. (Лише pgrep.)

-n, --newest
    Вибрати лише найновіші (запущені якомога пізніше) відповідні процеси.

-o, --oldest
    Вибрати лише найдавніші (запущені якомога раніше) відповідні процеси.

-P, --parent ppid,...
    Встановлювати відповідність лише тих процесів, які мають батьківські процеси зі вказаного списку.

-s, --session sid,...
    Встановлювати відповідність лише тих процесів, які мають ідентифікатори сеансів процесів зі вказаного списку. Ідентифікатор 0 відповідає ідентифікаторам сеансів самих програм pgrep або pkill.

-t, --terminal термінал,...
    Встановлювати відповідність лише процесів із терміналом керування із вказаного списку. Назву термінала слід вказувати без префікса «/dev/».

-u, --euid euid,...
    Встановлювати відповідність процесів зі списку ідентифікаторів ефективних користувачів. Можна використовувати цифрове або символічне значення ідентифікатора.

-U, --uid uid,...
    Встановлювати відповідність процесів зі списку справжніх ідентифікаторів користувачів. Можна використовувати цифрове або символічне значення ідентифікатора.

-v, --inverse
    Інвертує відповідність. Зазвичай, цей параметр використовується у контексті pgrep. У контексті pkill скорочену форму параметра вимкнено для того, щоб запобігти випадковому використанню цього параметра.

-w, --lightweight
    Показує усіх ідентифікатори потоків обробки, замість ідентифікаторів, у контексті pgrep. У контексті pkill цей параметр вимкнено.

-x, --exact
    Встановлювати відповідність лише процесів, назви яких (або рядки команд, якщо вказано параметр -f) точно відповідає взірцю.

-F, --pidfile файл
    Прочитати PID з файла. Ймовірно, цей параметр корисніший для pkill, а не для pgrep.

-L, --logpidfile
    Завершувати роботу повідомленням про помилку, якщо pid-файл (див. -F) не заблоковано.

--ns pid
    Встановлювати відповідність процесів, які належать до одного простору назв. Для встановлення відповідності для процесів інших користувачів програму має бути запущено від імені користувача root. Див. довідку щодо --nslist, щоб дізнатися про те, як обмежити перелік відповідних просторів назв.

--nslist назва,...
    Встановлювати відповідність лише для вказаних просторів назв. Можливі простори назв: ipc, mnt, net, pid, user, uts.

-V, --version
    Вивести дані щодо версії і завершити роботу.

-h, --help
    Показати довідкові дані і завершити роботу.

ОПЕРАНДИ

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

ПРИКЛАДИ
Приклад 1: знайти ідентифікатор процесу фонової служби named:

    $ pgrep -u root named

Приклад 2: змусити syslog виконати повторне читання файла налаштувань:

    $ pkill -HUP syslogd

Приклад 3: надати докладну інформацію щодо усіх процесів xterm:

    $ ps -fp $(pgrep -d, -x xterm)

Приклад 4: підвищити пріоритетність усіх процесів netscape:

    $ renice +4 $(pgrep netscape)

СТАН ВИХОДУ
0   Критеріям відповідає один або декілька процесів.
1   Не знайдено відповідних процесів.
2   Синтаксична помилка у рядку команди.
3   Критична помилка: вичерпано пам’ять тощо.

ЗАУВАЖЕННЯ
Назву процесу, що використовується для встановлення відповідності, обмежено 15 символами, які виводить /proc/pid/stat. Для встановлення відповідності за цілим командним рядком, /proc/pid/cmdline, скористайтеся параметром -f.

Запущений процес pgrep або pkill ніколи не повідомлятиметься самим собою як відповідник.

ВАДИ
Не можна одночасно використовувати параметри -n, -o та -v одночасно. Повідомте авторам, якщо вам потрібне таке поєднання.

Програма повідомляє про щезлі процеси.

ТАКОЖ ПЕРЕГЛЯНЬТЕ
ps(1), regex(7), signal(7), killall(1), skill(1), kill(1), kill(2)

СТАНДАРТИ
pkill та pgrep було впроваджено у Sun Solaris 7. Ця реалізація є повністю сумісною із реалізацією для Solaris.

АВТОР
Kjetil Torgrim Homme (kjetilho@ifi.uio.no)

Як надіслати звіт про вади
Про вади, будь ласка, повідомляйте на адресу procps@freelists.org