Provided by: procps_3.3.17-7ubuntu1_amd64
НАЗВА
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 ⟨kjetilho@ifi.uio.no⟩
Як надіслати звіт про вади
Про вади, будь ласка, повідомляйте на адресу ⟨procps@freelists.org⟩