НАЗВА

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

КОРОТКИЙ ОПИС

       pgrep [параметри] взірець
       pkill [параметри] взірець
       pwait [параметри] взірець

ОПИС

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

              $ pgrep -u root sshd

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

              $ pgrep -u root,daemon

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

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

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

ПАРАМЕТРИ

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

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

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

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

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

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

       -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
              або pwait.

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

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

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

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

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

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

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

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

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

       --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 і pwait також  має  бути  один
              або декілька процесів, яким успішно надіслано сигнал або які перебувають у стані очікування.
       1      Не  знайдено  жодного  відповідного процесу або жодному зі знайдених процесів не вдалося надіслати
              сигнал.
       2      Синтаксична помилка у рядку команди.
       3      Критична помилка: вичерпано пам’ять тощо.

ЗАУВАЖЕННЯ

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

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

ВАДИ

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

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

ТАКОЖ ПЕРЕГЛЯНЬТЕ

       ps(1), regex(7), signal(7), sigqueue(3), killall(1), skill(1), kill(1), kill(2)

АВТОР

       Kjetil Torgrim Homme

Як надіслати звіт про вади

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

procps-ng                                      4 червня 2020 року                                       PGREP(1)