Manpages

НАЗВА

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)

СТАН ВИХОДУ

ЗАУВАЖЕННЯ

Назву процесу, що використовується для встановлення відповідності, обмежено 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).

АВТОР

kjetilho [AT] ifi.no">Kjetil Torgrim Homme

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

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