PGREP(1)

NAMN
pgrep, pkill, pidwait - look up, signal, or wait for processes based on name and other attributes

SYNOPSIS
pgrep [flaggor] mönster
pkill [flaggor] mönster
pidwait [options] pattern

BESKRIVNING
pgrep letar igenom de just nu körande processerna och listar de process-ID:n som matchar urvalskriterierna till standard ut. Alla kriterierna måste matcha. Till exempel,

    $ pgrep -u root sshd

kommer endast lista processerna som heter sshd OCH ägs av root. Å andra sidan,

    $ pgrep -u root,daemon

kommer lista processerna som ägs av root ELLER daemon.

pkill kommer skicka den angivna signalen (SIGTERM som standard) till varje process istället för att lista dem på standard ut.

pidwait will wait for each process instead of listing them on stdout.

FLAGGOR

-signal
--signal signal
    Definierar signalen att skicka till varje matchad process. Både det numeriska eller det symboliska signalnamnet kan användas. (Endast pkill.)

-c, --count
    Suppress normal output; instead print a count of matching processes. When count does not match anything, e.g. returns zero, the command will return non-zero value. Note that for pkill and pidwait, the count is the number of matching processes, not the processes that were successfully signaled or waited for.

-d, --delimiter avgränsare
    Sätter strängen som används för att avgränsa varje process-ID i utdata (nyrad som standard). (Endast pgrep.)

-e, --echo
    Visa namnet och PID processen som dödas. (Endast pkill.)

-f, --full
    Mönstret matchas normalt endast mot processnamnet. När -f anges används hela kommandoraden.

-g, --pgroup pgrp,…
    Only match processes in the process group IDs listed. Process group 0 is translated into pgrep's, pkill's, or pidwait's own process group.

-G, --group gid,…
    Matcha endast processer vars verkliga grupp-ID listas. Både det numeriska och det symboliska värdet kan användas.

-i, --ignore-case
    Matcha processer skiftlägesokänsligt.

-l, --list-name
    Lista processnamnet såväl som process-ID:t. (Endast pgrep.)

-a, --list-full
    Lista den fullständiga kommandoraden såväl som process-ID:t. (Endast pgrep.)

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

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

-O, --older sekunder
    Välj processer som är äldre än sek.

-P, --parent fpid,…
    Matcha endast processer vars föräldraprocess-ID listas.

-s, --session sid,…
    Only match processes whose process session ID is listed. Session ID 0 is translated into pgrep's, pkill's, or pidwait's own session ID.

-t, --terminal term,…
    Matcha endast processer vars styrande terminal listas. Terminalnamnet skall anges utan prefixet ”/dev/”.

-u, --euid eaid,…
    Matcha endast processer vars effektiva användar-ID listas. Både det numeriska och symboliska värdet kan användas.

-U, --uid aid,…
    Matcha endast processer vars verkliga användar-ID listas. Både det numeriska och symboliska värdet kan användas.

-v, --inverse
    Negates the matching. This option is usually used in pgrep's or pidwait's context. In pkill's context the short option is disabled to avoid accidental usage of the option.

-w, --lightweight
    Shows all thread ids instead of pids in pgrep's or pidwait's context. In pkill's context this option is disabled.

-x, --exact
    Matcha endast processer vars namn (eller kommandorader om -f anges) exakt matchar mönstret.

-F, --pidfile fil
    Read PIDs from file. This option is more useful for pkillorpidwait than pgrep.

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

-r, --runstates D,R,S,Z,…
    Matcha endast processer som matchar processtillståndet.

-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 med sudo eller liknande verktyg.

--cgroup name,...
    Matcha det givna styrgruppsnamnet (cgroup) v2. Se cgroups(8)

--ns pid
    Matcha processer som hör till samma namnrymder. Måste köras som root för att matcha andra användares processer. Se --nslist för hur man begränsar vilka namnrymder som skall matchas.

--nslist namn,…
    Matcha endast de angivna namnrymderna. Tillgängliga namnrymder: ipc, mnt, net, pid, user, uts.

-q, --queue värde
    Använd sigqueue(3) istället för kill(2) och värdeargumentet används för att ange ett heltal att skickas med signalen. Om den mottagande processen har installerat en hanterare för denna signal med flaggan SA_SIGINFO till sigaction(2) så kan den hämta denna data via fältet si_value i posten siginfo_t.

-V, --version
    Visa versionsinformation och avsluta.

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

OPERANDER

mönster
    Specificerar ett utökat reguljärt uttryck att matcha mot processnamnen eller kommandoraderna.

EXEMPEL
Exempel 1: Hitta process-ID:t för demonen named:

    $ 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: Få alla chrome-processer köra med nice:

    $ renice +4 $(pgrep chrome)

SLUTSTATUS
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   Inga processer matchade eller inga av dem kunde signaleras.
2   Syntaxfel på kommandoraden.
3   Ödesdigert fel: slut på minne etc.

OBSERVERA
The process name used for matching is limited to the 15 characters present in the output of /proc/pid/stat. Use the -f option to match against the complete command line, /proc/pid/cmdline. Threads may not have the same process name as the parent process but will have the same command line.

The running pgrep, pkill, or pidwait process will never report itself as a match.

Flagga -O --older kommer tyst misslyckas om /proc är monterat med flaggan subset=pid.

FEL
Flaggorna -n och -o och -v kan inte kombineras. Berätta för mig om du behöver kunna göra detta.

Döda (defunct) processer rapporteras.

pidwait behöver systemanropet pidfd_open(2) som först dök up i Linux 5.3.

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

UPPHOVSMAN
Kjetil Torgrim Homme (kjetilho@ifi.uio.no)

RAPPORTERA FEL
Skicka felrapporter till procps@freelists.org Skicka synpunkter på översättningen till tp-sv@listor.tp-sv.se