PKILL(1)              Справочник основных команд FreeBSD              PKILL(1)

НАЗВАНИЕ
     pgrep, pkill -- найти процессы по имени с возможной отправкой им сигнала

СИНТАКСИС
     pgrep [-LSfilnovx] [-F pidfile] [-G gid] [-M дамп] [-N система] [-P ppid]
           [-U uid] [-d разделитель] [-g pgrp] [-j jid] [-s sid] [-t tty]
           [-u euid] шаблон ...
     pkill [-сигнал] [-ILfinovx] [-F pidfile] [-G gid] [-M дамп] [-N система]
           [-P ppid] [-U uid] [-g pgrp] [-j jid] [-s sid] [-t tty] [-u euid]
           шаблон ...

ОПИСАНИЕ
     Команда pgrep производит поиск в таблице процессов работающей системы и
     выводит идентификаторы процессов, удовлетворяющих заданному в командной
     строке критерию.

     Команда pkill производит поиск в таблице процессов работающей системы и
     посылает сигнал всем процессам, удовлетворяющим заданному в командной
     строке критерию.

     Имеются следующие опции:

     -F pidfile      Ограничить совпадения процессом, чей идентификатор про-
                     цесса (PID) хранится в файле pidfile.

     -G gid          Ограничить совпадения процессами с идентификатором дей-
                     ствительной группы (real group ID) из разделённого запя-
                     тыми списка gid.

     -I              Запросить подтверждение на отправку сигнала каждому про-
                     цессу.

     -L              Файл pidfile, передаваемый в качестве параметра опции -F,
                     должен быть заблокирован с использованием системного
                     вызова flock(2) или создан с помощью pidfile(3).

     -M дамп         Извлечь значения, связанные со списком имён (namelist),
                     из указанного дампа памяти ядра дамп, вместо памяти рабо-
                     тающей в текущий момент системы.

     -N система      Извлечь список имён из указанной системы, вместо исполь-
                     зуемого по умолчанию образа ядра, с которого произведена
                     загрузка.

     -P ppid         Ограничить совпадения процессами, идентификаторы роди-
                     тельских процессов (PPID) которых перечислены в разделён-
                     ном запятыми списке ppid.

     -S              Искать также среди системных процессов (нитей ядра).

     -U uid          Ограничить совпадения процессами с идентификаторами дей-
                     ствительного пользователя (real user ID), находящимися в
                     разделённом запятыми списке uid.

     -d разделитель  Использовать заданный разделить для выводимых идентифика-
                     торов процессов.  По умолчанию используется символ новой
                     строки.  Эта опция может быть использована только с
                     командой pgrep.

     -f              Производить поиск совпадений по полному списку аргумен-
                     тов.  По умолчанию проверяются только имена процессов.

     -g pgrp         Ограничить совпадения списком процессов с идентификато-
                     рами группы процессов (process group ID) из разделенного
                     запятыми списка pgrp.  Ноль означает идентификатор группы
                     процессов работающей команды pgrep или pkill.

     -i              Игнорировать различия в регистре символов в таблице про-
                     цессов и указанном шаблоне.

     -j jid          Ограничить совпадения процессами внутри тюрьмы (jail) с
                     идентификатором из разделённого запятыми списка jid.
                     Значение ``any'' означает любой процесс в любой тюрьме.
                     Значение ``none'' означает любой процесс не в тюрьме.

     -l              Подробный вывод.  В дополнение к идентификатору процесса
                     также выводить его имя.  При использовании совместно с
                     -f, для каждого подходящего процесса выводить его иденти-
                     фикатор и полный список аргументов.  Эта опция может быть
                     использована только с командой pgrep.

     -n              Из всех подходящих процессов выбрать только самый новый
                     (по времени запуска).

     -o              Из всех подходящих процессов выбрать только самый старый
                     (по времени запуска).

     -s sid          Ограничить совпадения процессами с идентификатором сессии
                     (session ID) из разделённого запятыми списка sid.  Ноль
                     означает идентификатор сессии работающей команды pgrep
                     или pkill.  sid.

     -t tty          Ограничить совпадения процессами, связанными с одним из
                     терминалов из разделённого запятыми списка tty.  Имена
                     терминалов задаются в форме ttyxx или в более короткой
                     xx.  Одиночный дефис (`-') задаёт процессы, не связанные
                     с терминалом.

     -u euid         Ограничить совпадения процессами с идентификатором эффек-
                     тивного пользователя (effective user ID) из разделённого
                     запятыми списка euid.

     -v              Инвертировать совпадение, т.е., вывести процессы, не удо-
                     влетворяющие заданному условию.

     -x              Требовать точного совпадения с именем процесса, или, если
                     задана опция -f, списком аргументов.  По умолчанию произ-
                     водится поиск подстроки.

     -сигнал         Неотрицательное десятичное значение или символьное имя
                     сигнала.  Указывает сигнал, отправляемый вместо использу-
                     емого по умолчанию TERM.  Эта опция допустима только в
                     качестве первого аргумента pkill.

     При указании одного или более операнда шаблон, они используются как регу-
     лярные выражения для поиска совпадения с именем команды или полным спис-
     ком аргументов каждого процесса.  Если опция -f не указана, шаблон срав-
     нивается только с именем команды.  Однако в настоящее время FreeBSD
     отслеживает лишь первые 19 символов имени команды для каждого процесса.
     Попытка найти что-либо в имени команды после первых 19 символов всегда
     даёт отрицательный результат.

     Следует отметить, что работающий процесс pgrep или pkill никогда не выбе-
     рет ни себя, ни системные процессы (нити ядра) как удовлетворяющие крите-
     риям поиска.

СТАТУС ЗАВЕРШЕНИЯ
     Утилиты pgrep и pkill на выходе возвращают одно из следующих значений:

     0       Был найден один или более подходящих процессов.

     1       Подходящие процессы не были найдены.

     2       В командной строке указаны недопустимые опции.

     3       Произошла внутренняя ошибка.

СОВМЕСТИМОСТЬ
     Исторически, опция ``-j 0'' означала "любая тюрьма", хотя в других утили-
     тах, таких как ps(1), идентификатор тюрьмы (jail ID) 0 имеет обратное
     значение, "не в тюрьме".  Поэтому ``-j 0'' считается устаревшей, а вместо
     неё возможно использовать ``-j any''.

СМОТРИ ТАКЖЕ
     kill(1), killall(1), ps(1), flock(2), kill(2), sigaction(2), pidfile(3),
     re_format(7)

ИСТОРИЯ
     Утилиты pkill и pgrep впервые появились в NetBSD 1.6.  Они смоделированы
     на основе одноимённых утилит, появившихся в Sun Solaris 7.  Впервые они
     появились во FreeBSD 5.3.

АВТОРЫ
     Andrew Doran <ad [at] NetBSD [dot] org>

FreeBSD 6.2                     23 ноября 2006                     FreeBSD 6.2