PGREP(1)

НАЗВА
pgrep, pkill, pidwait - look up, signal, or wait for processes based on name and other attributes

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

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

    $ pgrep -u root sshd

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

    $ pgrep -u root,daemon

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

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

pidwait will wait for each process instead of listing them on stdout.

ПАРАМЕТРИ

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

-c, --count
    Suppress normal output; instead print a count of matching processes. When count does not match anything, e.g. returns zero, the command will return non-zero value. Note that for pkill and pidwait, the count is the number of matching processes, not the processes that were successfully signaled or waited for.

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

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

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

-g, --pgroup група процесів,...
    Only match processes in the process group IDs listed. Process group 0 is translated into pgrep's, pkill's, or pidwait's own process group.

-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,...
    Only match processes whose process session ID is listed. Session ID 0 is translated into pgrep's, pkill's, or pidwait's own session ID.

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

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

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

-v, --inverse
    Negates the matching. This option is usually used in pgrep's or pidwait's context. In pkill's context the short option is disabled to avoid accidental usage of the option.

-w, --lightweight
    Shows all thread ids instead of pids in pgrep's or pidwait's context. In pkill's context this option is disabled.

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

-F, --pidfile файл
    Read PIDs from file. This option is more useful for pkillorpidwait than pgrep.

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

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

--cgroup name,...
    Match on provided control group (cgroup) v2 name. See 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   One or more processes matched the criteria. For pkill and pidwait, one or more processes must also have been successfully signalled or waited for.
1   Не знайдено жодного відповідного процесу або жодному зі знайдених процесів не вдалося надіслати сигнал.
2   Синтаксична помилка у рядку команди.
3   Критична помилка: вичерпано пам’ять тощо.

ЗАУВАЖЕННЯ
The process name used for matching is limited to the 15 characters present in the output of /proc/pid/stat. Use the -f option to match against the complete command line, /proc/pid/cmdline. Threads may not have the same process name as the parent process but will have the same command line.

The running pgrep, pkill, or pidwait process will never report itself as a match.

The -O --older option will silently fail if /proc is mounted with the subset=pid option.

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

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

ТАКОЖ ПЕРЕГЛЯНЬТЕ
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