Pgrep(1)

PGREP(1)

Användarkommandon PGREP(1)

NAMN

pgrep, pkill, pidwait - sök efter, skicka signaler till eller vänta på processer baserat på namn och andra attribut.

SYNTAX

pgrep [alternativ ...] mönster pkill [alternativ ...] mönster pidwait [alternativ ...] mönster

BESKRIVNING

pgrep söker igenom de för närvarande körande processerna och listar process-ID:n som matchar urvalskriterierna till standardutgång. Alla kriterier måste matcha. Till exempel, `$ pgrep -u root sshd` visar endast processerna vars namn innehåller sshd OCH som ägs av root. Å andra sidan, `$ pgrep -u root,daemon` visar processerna som ägs av root ELLER daemon.

pkill skickar den specificerade signalen (standard är SIGTERM) till varje process istället för att lista dem på standardutgången.

pidwait väntar på varje process istället för att lista dem på standardutgången.

ALTERNATIV

-signal --signal signal Definierar signalen som ska skickas till varje matchande process. Både numeriska eller symboliska signalnamn kan användas. I pgrep eller pidwait-läge kan endast den långa varianten användas och har ingen effekt om den inte används tillsammans med --require-handler för att filtrera processer med en användarsignalsbehandlare för en viss signal.

-c, --count Undertrycker normal utgång; istället visas en räkning av matchande processer. När räkningen inte matchar något, t.ex. om den returnerar noll, kommer kommandot att returnera ett icke-nollvärde. Observera att för pkill och pidwait är räkningen antalet matchande processer, inte de processer som framgångsrikt signalerades eller väntades på.

-d, --delimiter delimiter Sätter strängen som används för att avgränsa varje process-ID i utgången (standard är en ny rad). (Endast pgrep.)

-e, --echo Visa namn och PID för den process som ska dödas. (Endast pkill.)

-f, --full Mönstret matchas normalt endast mot processens namn. När -f är satt används den fullständiga kommandoraden.

-g, --pgroup pgrp,... Matcha endast processer i de listade processgrupp-ID:erna. Processgrupp 0 översätts till pgreps, pkills eller pidwaits egen processgrupp.

-G, --group gid,... Matcha endast processer vars verkliga grupp-ID är listat. Både numeriska eller symboliska värden kan användas.

-i, --ignore-case Matcha processer utan att ta hänsyn till versaler och gemener.

-l, --list-name Lista processens namn tillsammans med process-ID. (Endast pgrep.)

-a, --list-full Lista den fullständiga kommandoraden tillsammans med process-ID. (Endast pgrep.)

-n, --newest Välj endast den nyaste (nyligen startade) av de matchande processerna.

-o, --oldest Välj endast den äldsta (minst nyligen startade) av de matchande processerna.

-O, --older secs Välj processer som är äldre än ett angivet antal sekunder.

-P, --parent ppid,... Matcha endast processer vars föräldraprocess-ID är listat.

-s, --session sid,... Matcha endast processer vars processsession-ID är listat. Session-ID 0 översätts till pgreps, pkills eller pidwaits egen session-ID.

-t, --terminal term,... Matcha endast processer vars styrande terminal är listad. Terminalens namn ska anges utan "/dev/"-prefix.

-u, --euid euid,... Matcha endast processer vars effektiva användar-ID är listat. Både numeriska eller symboliska värden kan användas.

-U, --uid uid,... Matcha endast processer vars verkliga användar-ID är listat. Både numeriska eller symboliska värden kan användas.

-v, --inverse Negativ matchning. Denna alternativ används vanligtvis i pgrep eller pidwaits kontext. I pkills kontext är den korta varianten inaktiverad för att undvika oavsiktlig användning.

-w, --lightweight Visar alla trådans identifierare istället för process-ID:n i pgreps eller pidwaits kontext. Denna alternativ är inaktiverad i pkills kontext.

-x, --exact Matcha endast processer vars namn (eller kommandorad om -f används) exakt matchar mönstret.

-F, --pidfile fil Läs PID:er från fil. Detta alternativ är mer användbart för pkill eller pidwait än för pgrep. Filnamnet "-" kan användas för att läsa från STDIN.

-L, --logpidfile Misslyckas om pidfilen (se -F) inte är låst.

-r, --runstates D,R,S,Z,... Matcha endast processer som matchar processstatusen.

-A, --ignore-ancestors Ignorera alla förfäder till pgrep, pkill eller pidwait. Till exempel kan detta vara användbart när man höjer privilegier med sudo eller liknande verktyg.

-H, --require-handler Matcha endast processer med en användarsignalsbehandlare när signalen skickas.

--cgroup name,... Matcha på den angivna kontrollgruppen (cgroup) v2-namnet. Se cgroups(8).

--env name[=value],... Matcha på processer som har dessa miljövariabler. Om =value inte anges matchas endast variabelnamnet.

--ns pid Matcha processer som tillhör samma namespace. Kräver root-åtkomst för att matcha processer från andra användare. Se --nslist för hur man begränsar vilka namespaces som ska matchas.

--nslist name,... Matcha endast de angivna namespaces. Tillgängliga namespaces: ipc, mnt, net, pid, user, uts.

-q, --queue value Använd sigqueue(3) snarare än kill(2), och värdeparametern används för att specificera ett heltal som ska skickas med signalen. Om den mottagande processen har installerat en hanterare för denna signal med hjälp av SA_SIGINFO-flaggan i sigaction(2) kan den få tillgång till dessa data via si_value-fältet i siginfo_t-strukturen.

-V, --version Visa versionsinformation och avsluta.

-h, --help Visa hjälp och avsluta.

OPERANDER

mönster Specifikation av ett utökat reguljärt uttryck för att matcha mot processnamn eller kommandorader.

EXEMPEL

Exempel 1: Hitta process-ID för den namngivna daemonen: `$ pgrep -u root named`

Exempel 2: Få syslog att läsa om sin konfigurationsfil: `$ pkill -HUP syslogd`

Exempel 3: Ge detaljerad information om alla xterm-processer: `$ ps -fp $(pgrep -d, -x xterm)`

Exempel 4: Gör så att alla chrome-processer körs med lägre prioritet: `$ renice +4 $(pgrep chrome)`

Exempel 5: Vänta på att en process med känt PID ska avslutas: `$ echo ${PID} | pidwait -F -`

EXIT STATUS

0 En eller flera processer matchade kriterierna. För pkill och pidwait måste också en eller flera processer ha blivit framgångsrikt signalerade eller väntade på.

1 Inga processer matchade eller ingen av dem kunde signaleras.

2 Syntaxfel i kommandoraden.

3 Feltillstånd: slut på minne etc.

NOTER

Processnamnet som används för matchning är begränsat till de 15 tecken som finns i utmatningen från /proc/pid/stat. Använd -f för att matcha mot den fullständiga kommandoraden, /proc/pid/cmdline. Trådar kan ha ett annat processnamn än föräldraprocessen men kommer att ha samma kommandorad.

Den körande pgrep-, pkill- eller pidwait-processen kommer aldrig att rapportera sig själv som en matchning.

Alternativet -O --older kommer att tyst misslyckas om /proc är monterat med subset=pid-alternativet.

BUGGAR

Alternativen -n, -o och -v kan inte kombineras. Låt mig veta om du behöver göra detta.

Defunct-processer rapporteras.

pidwait kräver systemanropet pidfd_open(2) som först kom i Linux 5.3.

SE ÄVEN

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

FÖRFATTARE

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

RAPPORTERA BUGGAR

Vänligen skicka buggrapporter till ⟨procps@freelists.org⟩.

COLOPHON

Denna sida är en del av procps-ng (/proc filsystemverktyg) projektet. Information om projektet finns på ⟨https://gitlab.com/procps-ng/procps⟩. Om du har en buggrapport för denna manual kan du se ⟨https://gitlab.com/procps-ng/procps/blob/master/Documentation/bugs.md⟩.

Denna sida erhölls från projektets uppströms Git-förvar ⟨https://gitlab.com/procps-ng/procps.git⟩ den 14 juni 2024.