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 only the long option can be  used  and  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⟩