PGREP(1)

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

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

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

    $ pgrep -u root sshd

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

    $ pgrep -u root,daemon

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

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

pidwait чекатиме на усі процеси замість виведення їхнього списку до stdout.

ПАРАМЕТРИ

-сигнал
--signal сигнал
    Визначає сигнал, який слід надіслати кожному відповідному процесу. Можна скористатися числовим значенням або символічною назвою сигналу. У режимі pgrep або pidwait не працює, якщо не використано у поєднанні із --require-handler для фільтрування процесів із наявним обробником певного сигналу у просторі користувача.

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

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

-e, --echo
    Показати назву і PID процесів, роботу яких буде завершено (лише pkill).

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

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

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

-i, --ignore-case
    Виконувати пошук процесів без врахування регістру символів.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

-r, --runstates D,R,S,Z,...
    Виконати пошук лише тих процесів, які відповідають вказаному значенню стану процесу.

-A, --ignore-ancestors
    Ігнорувати усі попередники pgrep, pkill та pidwait. Наприклад, це може бути корисним при розширенні прав доступу за допомогою sudo або подібних інструментів.

-H, --require-handler
    Встановлювати відповідність лише тих процесів, які мають обробник сигналу, який має бути надіслано, у просторі користувача.

--cgroup назва,...
    Встановити відповідність наданій назві групи керування (cgroup) у версії 2. Див. cgroups(8)

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

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

-q, --queue значення
    Скористайтеся kill(2) замість sigqueue(3), і аргумент значення, який використовується для задання цілого значення, буде надіслано разом із сигналом. Якщо у процесі, який його отримає, встановлено обробки сигналу, який використовує прапорець SA_SIGINFO sigaction(2), процес зможе отримати ці дані за допомогою поля si_value структури siginfo_t.

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

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

ОПЕРАНДИ

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

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

    $ pgrep -u root named

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

    $ pkill -HUP syslogd

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

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

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

    $ renice +4 $(pgrep chrome)

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

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

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

Використання параметра -O --older буде без повідомлень не враховано, якщо /proc змонтовано з параметром subset=pid.

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

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

pidwait потребує системного виклику pidfd_open(2), який вперше з'явився у Linux 5.3.

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

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

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