PGREP(1) Polecenia użytkownika PGREP(1) 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ł Określenie sygnału, jaki ma być wysłany do wszystkich pasujących procesów. Może być numerem lub nazwą sygnału. (tylko pkill) -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 Odczyt PIDów z pliku. Ta opcja jest bardziej przydatna dla programu pkill lub pidwait niż 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. --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,... Dopasowanie tylko do podanych przestrzeni nazw. Dostępne przestrzenie: ipc, mnt, net, pid, user, uts. -q, --queue wartość Użycie sigqueue(3) zamiast kill(2), a argument będący wartością określa liczbę całkowitą do wysłania wraz z sygnałem. Jeśli proces odbierający ma zainstalowaną procedurę obsługi dla tego sygnału przy użyciu flagi SA_SIGINFO wywołania sigaction(2), może następnie odebrać te dane w poli si_value struktury siginfo_t. -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 Jeden lub więcej procesów pasowało do warunków. W przypadku pkill i pidwait, musi udać się wysłać sygnał lub zaczekać na przynajmniej jeden proces. 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. Opcja -O --older cicho się nie powiedzie, jeśli /proc jest zamontowany z opcją subset=pid. 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⟩ procps-ng 2022-08-31 PGREP(1)
Generated by dwww version 1.15 on Sat Jun 29 23:41:39 CEST 2024.