NAZWA

       pgrep,  pkill,  pidwait  -  wyszukiwanie, wysyłanie sygnałów lub oczekiwanie na procesy na
       podstawie nazwy i innych atrybutów

SKŁADNIA

       pgrep [opcje] wzorzec
       pkill [opcje] wzorzec
       pidwait [opcje] wzorzec

OPIS

       pgrep  przeszukuje  aktualnie  działające  procesy  i  wypisuje  na  standardowym  wyjściu
       identyfikatory  procesów,  które  pasują  do wybranych kryteriów. Wszystkie kryteria muszą
       pasować. Na przykład:

              $ pgrep -u root sshd

       wypisze tylko listę procesów o nazwie sshd  ORAZ  będących  własnością  roota.  Z  drugiej
       strony:

              $ pgrep -u root,daemon

       wypisze procesy, których właścicielem jest root LUB daemon.

       pkill zamiast wypisywania procesów wyśle do każdego podany sygnał (domyślnie SIGTERM).

       pidwait zamiast wypisywania procesów oczekuje na nie.

OPCJE

       -sygnał
       --signal sygnał
              Defines  the  signal  to  send  to each matched process.  Either the numeric or the
              symbolic signal name can be used. In pgrep or  pidwait  mode  this  has  no  effect
              unless  used  in  conjunction  with --require-handler to filter to processes with a
              userspace signal handler present for a particular signal.

       -c, --count
              Pominięcie zwykłego wyjścia; zamiast niego wypisanie  liczby  pasujących  procesów.
              Jeśli  nic  nie  zostanie  policzone  (np.  liczba  będzie zerem), polecenie zwróci
              wartość niezerową. Uwaga: w przypadku pkill i pidwait zwracana  wartość  to  liczba
              pasujących  procesów,  a  nie  procesów, do których udało się dostarczyć sygnał lub
              zaczekać na zakończenie.

       -d, --delimiter separator
              Ustawienie łańcucha oddzielającego identyfikatory procesów  na  wyjściu  (domyślnie
              nowa linia). (tylko pgrep)

       -e, --echo
              Wyświetlanie nazw oraz identyfikatorów zabijanych procesów (tylko pkill).

       -f, --full
              wzorzec  normalnie  jest dopasowywany tylko do nazwy procesu. Z ustawioną opcją -f,
              wykorzystywana jest cała linia poleceń.

       -g, --pgroup pgrp,...
              Dopasowanie tylko do procesów z grup o podanych identyfikatorach. Grupa procesów  0
              jest tłumaczona na własną grupę procesów polecenia pgrep, pkill lub pidwait.

       -G, --group gid,...
              Dopasowanie tylko do procesów o podanych identyfikatorach grup rzeczywistych. Można
              użyć wartości liczbowych lub symbolicznych.

       -e, --ignore-case
              Dopasowywanie procesów bez rozróżniania wielkości liter.

       -l, --list-name
              Wypisanie nazw oraz identyfikatorów procesów. (tylko pgrep)

       -a, --list-full
              Wypisanie pełnych linii poleceń oraz identyfikatorów procesów. (tylko pgrep)

       -n, --newest
              Wybór tylko najnowszych (najpóźniej uruchomionych) spośród pasujących procesów.

       -o, --oldest
              Wybór tylko najstarszych (najwcześniej uruchomionych) spośród pasujących procesów.

       -O, --older sekundy
              Wybór procesów starszych niż podana liczba sekund.

       -P, --parent ppid,...
              Dopasowanie tylko do procesów o wymienionych identyfikatorach procesów rodziców.

       -s, --session sid,...
              Dopasowanie tylko do  procesów  o  wymienionych  identyfikatorach  sesji  procesów.
              Identyfikator sesji 0 jest tłumaczony na własny procesu pgrep, pkill lub pidwait.

       -t, --terminal term,...
              Dopasowanie  tylko  do  procesów  o  wymienionych  terminalach  sterujących.  Nazwa
              terminala powinna być podana bez przedrostka "/dev/".

       -u, --euid euid,...
              Dopasowanie  tylko  do  procesów  o  wymienionych   identyfikatorach   użytkowników
              efektywnych. Można użyć wartości liczbowych lub symbolicznych.

       -U, --uid uid,...
              Dopasowanie   tylko   do  procesów  o  wymienionych  identyfikatorach  użytkowników
              rzeczywistych. Można użyć wartości liczbowych lub symbolicznych.

       -v, --inverse
              Negacja dopasowania. Zwykle używana w kontekście  programu  pgrep  lub  pidwait.  W
              kontekście pkill krótka opcja jest wyłączona, aby zapobiec przypadkowemu użyciu.

       -w, --lightweight
              Wyświetlenie  wszystkich identyfikatorów wątków zamiast pidów w kontekście programu
              pgrep lub pidwait. W kontekście pkill ta opcja jest wyłączona.

       -x, --exact
              Dopasowanie tylko do procesów, których nazwy (lub linie poleceń, jeśli podano opcję
              -f) pasują dokładnie do wzorca.

       -F, --pidfile plik
              Read PIDs from file.  This option is more useful for pkill or pidwait than pgrep.

       -L, --logpidfile
              Niepowodzenie, jeśli plik PID (p. opcja -F) nie jest zablokowany.

       -r, --runstates D,R,S,Z,...
              Dopasowanie tylko do procesów o pasującym stanie.

       -e, --ignore-ancestors
              Ignorowanie  wszystkich  przodków pgrep, pkill i pidwait. Może to być przydatne np.
              przy podnoszeniu uprawnień przez sudo lub podobne narzędzia.

       -H, --require-handler
              Only match processes with a userspace signal handler present for the signal  to  be
              sent.

       --cgroup nazwa,...
              Dopasowanie po przekazanej nazwie grupy kontrolnej (cgroup) v2. P. cgroups(8)

       --ns pid
              Dopasowanie  do  procesów  należących  do  tych samych przestrzeni nazw. Wymagane w
              przypadku uruchamiania przez roota, aby dopasować do procesów innych  użytkowników.
              Więcej o ograniczaniu dopasowywanych przestrzeni nazw przy opcji --nslist.

       --nslist nazwa,...
              Match only the provided namespaces. Available namespaces: ipc, mnt, net, pid, user,
              uts.

       -q, --queue wartość
              Use sigqueue(3)  rather than kill(2)  and the value argument is used to specify  an
              integer  to  be  sent  with  the  signal.  If the receiving process has installed a
              handler for this signal using the SA_SIGINFO flag  to  sigaction(2),  then  it  can
              obtain this data via the si_value field of the siginfo_t structure.

       -V, --version
              Wyświetlenie informacji o wersji i zakończenie.

       -h, --help
              Wyświetlenie opisu i zakończenie.

ARGUMENTY

       wzorzec
              Określenie  rozszerzonego  wyrażenia  regularnego  do dopasowania nazwy procesu lub
              linii poleceń.

PRZYKŁADY

       Przykład 1: znalezienie identyfikatora procesu demona named:

              $ pgrep -u root named

       Przykład 2: wymuszenie ponownego odczytu pliku konfiguracyjnego przez program syslog:

              $ pkill -HUP syslogd

       Przykład 3: podanie szczegółowych informacji o wszystkich procesach xterm:

              $ ps -fp $(pgrep -d, -x xterm)

       Przykład 4: zwiększenie nice wszystkich procesów chrome:

              $ renice +4 $(pgrep chrome)

KOD WYJŚCIA

       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      Brak procesów pasujących do warunków lub do żadnego nie udało się wysłać sygnału.
       2      Błąd składni w linii poleceń.
       3      Błąd krytyczny: brak pamięci itp.

UWAGI

       Nazwa  procesu  używana  przy dopasowaniu jest ograniczona do 15 znaków obecnych w wyjściu
       /proc/pid/stat. Aby dopasować do pełnej linii  poleceń  (/proc/pid/cmdline),  należy  użyć
       opcji -f. Wątki mogą nie mieć tej samej nazwy procesu jako rodzica, ale będą miały tę samą
       linię poleceń.

       Działający proces pgrep, pkill ani pidwait nigdy nie zgłosi siebie jako dopasowania.

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

BŁĘDY

       Opcji -n, -o oraz -v nie można łączyć. Gdyby było to przydatne, proszę zawiadomić autora.

       Zgłoszono procesy nie funkcjonujące.

       pidwait wymaga wywołania systemowego pidfd_open(2), które pojawiło się w Linuksie 5.3.

ZOBACZ TAKŻE

       ps(1),  regex(7),  signal(7),  sigqueue(3),  killall(1),   skill(1),   kill(1),   kill(2),
       cgroups(8).

AUTOR

       Kjetil Torgrim Homme ⟨kjetilho@ifi.uio.no⟩

ZGŁASZANIE BŁĘDÓW

       Zgłoszenia błędów prosimy wysyłać na adres ⟨procps@freelists.org⟩