path: root/po-man/uk/pgrep.1

.\"
.\" Copyright (c) 2004-2023 Craig Small <csmall@dropbear.xyz>
.\" Copyright (c) 2013-2023 Jim Warner <james.warner@comcast.net>
.\" Copyright (c) 2011-2012 Sami Kerola <kerolasa@iki.fi>
.\" Copyright (c) 2002-2004 Albert Cahalan
.\" Copyright (c) 2000      Kjetil Torgrim Homme
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH PGREP 1 "16 січня 2023 року" procps\-ng "Команди користувача"
.SH НАЗВА
pgrep, pkill, pidwait — пошук, надсилання сигналів процесам або очікування
на завершення роботи процесів на основі даних щодо їхньої назви та інших
атрибутів
.SH "КОРОТКИЙ ОПИС"
\fBpgrep\fP [параметри] взірець
.br
\fBpkill\fP [параметри] взірець
.br
\fBpidwait\fP [параметри] взірець
.SH ОПИС
\fBpgrep\fP виконує пошук серед поточних запущених процесів і виводить список
ідентифікаторів процесів, які відповідають критерію вибору до
stdout. Виконуватися мають усі критерії. Наприклад,
.IP
$ pgrep \-u root sshd
.PP
покаже список процесів, які мають назву \fBsshd\fP і належать \fBroot\fP. З іншого
боку,
.IP
$ pgrep \-u root,daemon
.PP
виведе список процесів, власником яких є \fBroot\fP або \fBdaemon\fP.
.PP
\fBpkill\fP надішле вказаний сигнал (типово \fBSIGTERM\fP) кожному процесу,
замість виведення списку процесів до stdout.
.PP
\fBpidwait\fP чекатиме на усі процеси замість виведення їхнього списку до
stdout.
.SH ПАРАМЕТРИ
.TP 
\fB\-\fP\fIсигнал\fP
.TQ
\fB\-\-signal\fP \fIсигнал\fP
Визначає сигнал, який слід надіслати кожному відповідному процесу. Можна
скористатися числовим значенням або символічною назвою сигналу. У режимі
\fBpgrep\fP або \fBpidwait\fP можна використовувати лише довгу версію параметра. У
цьому режимі параметр не працює, якщо не використано у поєднанні із
\fB\-\-require\-handler\fP для фільтрування процесів із наявним обробником певного
сигналу у просторі користувача.

.TP 
\fB\-c\fP, \fB\-\-count\fP
Придушити звичайне виведення. Замість цього, вивести кількість відповідних
процесів. Якщо не вдасться знайти нічого, наприклад, буде повернуто нульове
значення, програма поверне ненульове значення помилки. Зауважте, що для
pkill і pidwait кількість є кількістю відповідних процесів, а не кількістю
процесів, яким було успішно надіслано сигнал, або кількість процесів, на які
очікувала програма.
.TP 
\fB\-d\fP, \fB\-\-delimiter\fP \fIроздільник\fP
Встановлює рядок, що використовуватиметься для відокремлення ідентифікаторів
процесів у виведених даних (типовим роздільником є символ розриву
рядка). (Лише \fBpgrep\fP.)
.TP 
\fB\-e\fP, \fB\-\-echo\fP
Показати назву і PID процесів, роботу яких буде завершено (лише \fBpkill\fP).
.TP 
\fB\-f\fP, \fB\-\-full\fP
Зазвичай, відповідність \fIвзірця\fP встановлюється лише для назви
процесу. Якщо використано \fB\-f\fP, відповідність встановлюється за цілим
рядком команди.
.TP 
\fB\-g\fP, \fB\-\-pgroup\fP \fIгрупа процесів\fP,...
Встановлювати відповідність процесів лише для вказаного списку
ідентифікаторів груп. Група процесів 0 відповідає власній групі процесів
\fBpgrep\fP, \fBpkill\fP або \fBpidwait\fP.
.TP 
\fB\-G\fP, \fB\-\-group\fP \fIgid\fP,...
Встановлювати відповідність процесів зі списку справжніх ідентифікаторів
груп. Можна використовувати цифрове або символічне значення ідентифікатора.
.TP 
\fB\-i\fP, \fB\-\-ignore\-case\fP
Виконувати пошук процесів без врахування регістру символів.
.TP 
\fB\-l\fP, \fB\-\-list\-name\fP
Вивести список назв процесів, а також ідентифікаторів процесів. (Лише
\fBpgrep\fP.)
.TP 
\fB\-a\fP, \fB\-\-list\-full\fP
Вивести список рядків команд повністю, а також ідентифікаторів
процесів. (Лише \fBpgrep\fP.)
.TP 
\fB\-n\fP, \fB\-\-newest\fP
Вибрати лише найновіші (запущені якомога пізніше) відповідні процеси.
.TP 
\fB\-o\fP, \fB\-\-oldest\fP
Вибрати лише найдавніші (запущені якомога раніше) відповідні процеси.
.TP 
\fB\-O\fP, \fB\-\-older\fP \fIсекунди\fP
Вибрати процеси, які є старішими за вказану кількість секунд.
.TP 
\fB\-P\fP, \fB\-\-parent\fP \fIppid\fP,...
Встановлювати відповідність лише тих процесів, які мають батьківські процеси
зі вказаного списку.
.TP 
\fB\-s\fP, \fB\-\-session\fP \fIsid\fP,...
Встановлювати відповідність лише тих процесів, які мають ідентифікатори
сеансів процесів зі вказаного списку. Ідентифікатор 0 відповідає
ідентифікаторам сеансів самих програм \fBpgrep\fP, \fBpkill\fP або \fBpidwait\fP.
.TP 
\fB\-t\fP, \fB\-\-terminal\fP \fIтермінал\fP,...
Встановлювати відповідність лише процесів із терміналом керування із
вказаного списку. Назву термінала слід вказувати без префікса «/dev/».
.TP 
\fB\-u\fP, \fB\-\-euid\fP \fIeuid\fP,...
Встановлювати відповідність процесів зі списку ідентифікаторів ефективних
користувачів. Можна використовувати цифрове або символічне значення
ідентифікатора.
.TP 
\fB\-U\fP, \fB\-\-uid\fP \fIuid\fP,...
Встановлювати відповідність процесів зі списку справжніх ідентифікаторів
користувачів. Можна використовувати цифрове або символічне значення
ідентифікатора.
.TP 
\fB\-v\fP, \fB\-\-inverse\fP
Інвертує відповідність. Зазвичай, цей параметр використовується у контексті
\fBpgrep\fP або \fBpidwait\fP. У контексті \fBpkill\fP скорочену форму параметра
вимкнено для того, щоб запобігти випадковому використанню цього параметра.
.TP 
\fB\-w\fP, \fB\-\-lightweight\fP
Показує усіх ідентифікатори потоків обробки, замість ідентифікаторів, у
контексті \fBpgrep\fP або \fBpidwait\fP. У контексті \fBpkill\fP цей параметр
вимкнено.
.TP 
\fB\-x\fP, \fB\-\-exact\fP
Встановлювати відповідність лише процесів, назви яких (або рядки команд,
якщо вказано параметр \fB\-f\fP) \fBточно\fP відповідає \fIвзірцю\fP.
.TP 
\fB\-F\fP, \fB\-\-pidfile\fP \fIфайл\fP
Прочитати \fIPID\fP з \fIфайла\fP. Ймовірно, цей параметр корисніший для \fBpkill\fP
або \fBpidwait\fP, а не для \fBpgrep\fP.
.TP 
\fB\-L\fP, \fB\-\-logpidfile\fP
Завершувати роботу повідомленням про помилку, якщо pid\-файл (див. \fB\-F\fP) не
заблоковано.
.TP 
\fB\-r\fP, \fB\-\-runstates\fP \fID,R,S,Z,\fP...
Виконати пошук лише тих процесів, які відповідають вказаному значенню стану
процесу.
.TP 
\fB\-A\fP, \fB\-\-ignore\-ancestors\fP
Ігнорувати усі попередники \fBpgrep\fP, \fBpkill\fP та \fBpidwait\fP. Наприклад, це
може бути корисним при розширенні прав доступу за допомогою \fBsudo\fP або
подібних інструментів.
.TP 
\fB\-H\fP, \fB\-\-require\-handler\fP
Встановлювати відповідність лише тих процесів, які мають обробник сигналу,
який має бути надіслано, у просторі користувача.
.TP 
\fB\-\-cgroup \fP\fIназва\fP\fB,...\fP
Встановити відповідність наданій назві групи керування (cgroup) у версії
2. Див. \fBcgroups\fP(8)
.TP 
\fB\-\-ns \fP\fIpid\fP
Встановлювати відповідність процесів, які належать до одного простору
назв. Для встановлення відповідності для процесів інших користувачів
програму має бути запущено від імені користувача root. Див. довідку щодо
\fB\-\-nslist\fP, щоб дізнатися про те, як обмежити перелік відповідних просторів
назв.
.TP 
\fB\-\-nslist \fP\fIназва\fP\fB,...\fP
Встановлювати відповідність лише для вказаних просторів назв. Можливі
простори назв: ipc, mnt, net, pid, user, uts.
.TP 
\fB\-q\fP, \fB\-\-queue \fP\fIзначення\fP
Скористайтеся \fBkill\fP(2) замість \fBsigqueue\fP(3), і аргумент значення, який
використовується для задання цілого значення, буде надіслано разом із
сигналом. Якщо у процесі, який його отримає, встановлено обробки сигналу,
який використовує прапорець SA_SIGINFO \fBsigaction\fP(2), процес зможе
отримати ці дані за допомогою поля si_value структури siginfo_t.
.TP 
\fB\-V\fP, \fB\-\-version\fP
Вивести дані щодо версії і завершити роботу.
.TP 
\fB\-h\fP, \fB\-\-help\fP
Показати довідкові дані і завершити роботу.
.PD
.SH ОПЕРАНДИ
.TP 
\fIвзірець\fP
Вказує розширений формальний вираз для відповідності за назвами процесів або
рядками команд.
.SH ПРИКЛАДИ
Приклад 1: знайти ідентифікатор процесу фонової служби \fBnamed\fP:
.IP
$ pgrep \-u root named
.PP
Приклад 2: змусити \fBsyslog\fP виконати повторне читання файла налаштувань:
.IP
$ pkill \-HUP syslogd
.PP
Приклад 3: надати докладну інформацію щодо усіх процесів \fBxterm\fP:
.IP
$ ps \-fp $(pgrep \-d, \-x xterm)
.PP
Приклад 4: підвищити пріоритетність усіх процесів \fBchrome\fP:
.IP
$ renice +4 $(pgrep chrome)
.SH "СТАН ВИХОДУ"
.PD 0
.TP 
0
Вказаному критерію відповідає один або декілька процесів. Для \fBpkill\fP і
\fBpidwait\fP також має бути один або декілька процесів, яким успішно надіслано
сигнал або які перебувають у стані очікування.
.TP 
1
Не знайдено жодного відповідного процесу або жодному зі знайдених процесів
не вдалося надіслати сигнал.
.TP 
2
Синтаксична помилка у рядку команди.
.TP 
3
Критична помилка: вичерпано пам’ять тощо.
.PD
.SH ЗАУВАЖЕННЯ
Назву процесу, що використовується для встановлення відповідності, обмежено
15 символами, які виводить /proc/\fIpid\fP/stat. Для встановлення відповідності
за цілим командним рядком, /proc/\fIpid\fP/cmdline, скористайтеся параметром
\fB\-f\fP. Потоки обробки можуть не мати такої самої назви процесу, що і
батьківський процес, але матимуть той самий рядок команди.
.PP
Запущений процес \fBpgrep\fP, \fBpkill\fP або \fBpidwait\fP ніколи не
повідомлятиметься самим собою як відповідник.
.PP
Використання параметра \fB\-O \-\-older\fP буде без повідомлень не враховано, якщо
\fI/proc\fP змонтовано з параметром \fIsubset=pid\fP.
.SH ВАДИ
Не можна одночасно використовувати параметри \fB\-n\fP, \fB\-o\fP та \fB\-v\fP
одночасно. Повідомте авторам, якщо вам потрібне таке поєднання.
.PP
Програма повідомляє про щезлі процеси.
.PP
\fBpidwait\fP потребує системного виклику \fBpidfd_open\fP(2), який вперше
з'явився у Linux 5.3.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\fBps\fP(1), \fBregex\fP(7), \fBsignal\fP(7), \fBsigqueue\fP(3), \fBkillall\fP(1),
\fBskill\fP(1), \fBkill\fP(1), \fBkill\fP(2), \fBcgroups\fP(8).
.SH АВТОР
.UR kjetilho@ifi.uio.no
Kjetil Torgrim Homme
.UE
.SH "Як надіслати звіт про вади"
Про вади, будь ласка, повідомляйте на адресу
.UR procps@freelists.org
.UE