Provided by: procps_4.0.4-4ubuntu3_amd64 bug

NUME

       pgrep,  pkill,  pidwait  -  caută,  semnalează sau așteaptă procesele pe baza numelui și a
       altor atribute

REZUMAT

       pgrep [opțiuni] model
       pkill [opțiuni] model
       pidwait [opțiuni] model

DESCRIERE

       pgrep examinează procesele care rulează în prezent și listează  ID-urile  proceselor  care
       corespund  criteriilor  de  selecție  la ieșirea standard.  Toate criteriile trebuie să se
       potrivească.  De exemplu,

              $ pgrep -u root sshd

       va lista numai procesele numite sshd ȘI deținute de root.  Pe de altă parte,

              $ pgrep -u root,daemon

       va lista procesele deținute de root SAU daemon.

       pkill va trimite semnalul specificat (în mod implicit SIGTERM)  către  fiecare  proces  în
       loc să le listeze la ieșirea standard.

       pidwait va aștepta pentru fiecare proces în loc să le listeze la ieșirea standard.

OPȚIUNI

       -semnal
       --signal semnal
              Definește  semnalul  care  urmează să fie trimis fiecărui proces asociat.  Se poate
              utiliza fie numele numeric, fie numele simbolic al semnalului. În modul  pgrep  sau
              pidwait,  se  poate  utiliza  numai  opțiunea  lungă,  care nu are niciun efect, cu
              excepția cazului în care este utilizată  împreună  cu  --require-handler  pentru  a
              filtra procesele care au un gestionar de semnal în spațiul utilizatorului pentru un
              anumit semnal.

       -c, --count
              Suprimă ieșirea normală; în schimb, afișează un  număr  de  procese  de  potrivire.
              Când numărul nu corespunde cu nimic, de exemplu returnează zero, comanda va returna
              o valoare diferită de zero. Rețineți că  pentru  pkill  și  pidwait,  numărul  este
              numărul  de procese de potrivire, nu procesele care au fost semnalate cu succes sau
              așteptate.

       -d, --delimiter delimitator
              Stabilește șirul utilizat pentru a delimita fiecare ID de proces din ieșire (în mod
              implicit, o linie nouă).  (Numai pgrep.)

       -e, --echo
              Afișează numele și PID-ul procesului în curs de omorâre.  (Numai pkill.)

       -f, --full
              modelul  se  potrivește  în  mod  normal doar cu numele procesului.  Când este dată
              opțiunea -f, se utilizează linia de comandă completă.

       -g, --pgroup PGID,...
              Potrivește numai procesele din ID-urile grupului de procese enumerate.   Grupul  de
              procese  0  este  convertit  în  grupul  de procese propriu al lui pgrep, pkill sau
              pidwait.

       -G, --group GID,...
              Potrivește numai procesele al căror ID de grup real este listat.  Se  poate  folosi
              fie valoarea numerică, fie valoarea simbolică.

       -i, --ignore-case
              Potrivește procesele fără a ține seama de diferența dintre majuscule și minuscule.

       -l, --list-name
              Listează numele procesului, precum și ID-ul procesului.  (Numai pgrep.)

       -a, --list-full
              Listează linia de comandă completă, precum și ID-ul procesului.  (Numai pgrep.)

       -n, --newest
              Selectează  doar  cel  mai  nou (cel mai recent început) dintre procesele care s-au
              potrivit modelului dat.

       -o, --oldest
              Selectați doar cel mai vechi (cel mai puțin recent) început dintre  procesele  care
              s-au potrivit modelului dat.

       -O, --older secunde
              Selectează procesele mai vechi de secunde secunde.

       -P, --parent ppid,...
              Potrivește doar procesele al căror ID de proces părinte este listat.

       -s, --session SID,...
              Potrivește  doar  procesele al căror ID de sesiune de proces este listat.  ID-ul de
              sesiune 0 este convertit în ID-ul de sesiune al lui pgrep, pkill sau pidwait.

       -t, --terminal terminal,...
              Potrivește numai procesele al  căror  terminal  de  control  este  listat.   Numele
              terminalului trebuie specificat fără prefixul „/dev/”.

       -u, --euid uid_efectiv,...
              Potrivește numai procesele al căror ID de utilizator efectiv este listat.  Se poate
              folosi fie valoarea numerică, fie valoarea simbolică.

       -U, --uid uid,...
              Potrivește numai procesele al căror ID de utilizator real este  listat.   Se  poate
              folosi fie valoarea numerică, fie valoarea simbolică.

       -v, --inverse
              Inversează  rezultatul  potrivirii(va  afișa  toate procesele ce NU se potrivesc cu
              modelul).  Această opțiune este de obicei  folosită  în  contextul  lui  pgrep  sau
              pidwait.   În  contextul lui pkill, opțiunea scurtă este dezactivată pentru a evita
              utilizarea accidentală a opțiunii.

       -w, --lightweight
              Afișează toate ID-urile firelor de  execuție  în  loc  de  id-urile  proceselor  în
              contextul  lui  pgrep  sau  pidwait.   În contextul lui pkill, această opțiune este
              dezactivată.

       -x, --exact
              Potrivește numai  procesele  ale  căror  nume  (sau  linii  de  comandă  dacă  este
              specificată opțiunea -f) se potrivesc exact cu modelul.

       -F, --pidfile fișier
              Citește  PID-urile  din  fișier.   Această  opțiune este mai utilă pentru pkill sau
              pidwait decât pentru pgrep.

       -L, --logpidfile
              Eșuează dacă fișierul pid (a se vedea -F) nu este blocat.

       -r, --runstates D,R,S,Z,...
              Potrivește numai procesele care se potrivesc cu starea procesului.

       -A, --ignore-ancestors
              Ignoră toți antecesorii lui pgrep, pkill și pidwait.  De exemplu, acest lucru poate
              fi  util  atunci  când escaladați drepturile de acces folosind sudo sau instrumente
              similare.

       -H, --require-handler
              Se potrivește numai cu procesele  care  au  un  gestionar  de  semnal  din  spațiul
              utilizatorului prezent pentru semnalul care urmează să fie trimis.

       --cgroup nume,...
              Potriviți  pe  numele  grupului  de  control  (cgroup)  v2  furnizat.   A  se vedea
              cgroups(8)

       --ns pid
              Potrivește procesele care aparțin acelorași spații de nume. Este necesar să  ruleze
              ca  root  pentru  a  potrivi  procesele de la alți utilizatori. Consultați --nslist
              pentru cum să limitați spațiile de nume care să corespundă.

       --nslist nume,...
              Potrivește numai spațiile de nume furnizate.  Spațiile de nume  disponibile,  sunt:
              ipc, mnt, net, pid, user, uts.

       -q, --queue valoare
              Utilizează  sigqueue(3)  mai  degrabă  decât  kill(2) și valoarea argumentului este
              folosită pentru a specifica  un  număr  întreg  care  trebuie  trimis  împreună  cu
              semnalul.  Dacă procesul de recepție a instalat un operator pentru a gestiona acest
              semnal utilizând indicatorul SA_SIGINFO la sigaction(2), atunci poate obține aceste
              date prin câmpul si_value al structurii siginfo_t.

       -V, --version
              Afișează informațiile despre versiune și iese.

       -h, --help
              Afișează mesajul de ajutor și iese.

OPERANZI

       model  Specifică  o  expresie  regulată extinsă pentru potrivirea cu numele proceselor sau
              liniile de comandă.

EXEMPLE

       Exemplul 1: Găsiți ID-ul de proces al demonului named:

              $ pgrep -u root named

       Exemplul 2: Face ca syslog să recitească fișierul său de configurare:

              $ pkill -HUP syslogd

       Exemplul 3: Oferă informații detaliate despre toate procesele xterm:

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

       Exemplul 4: Face ca toate procesele chrome să ruleze cu o valoare „nice”, incrementată (să
       ruleze cu o prioritate mai mică):

              $ renice +4 $(pgrep chrome)

STARE DE IEȘIRE

       0      Unul  sau  mai  multe procese s-au potrivit cu criteriile. Pentru pkill și pidwait,
              unul sau mai multe procese trebuie, de asemenea, să fi fost semnalate sau așteptate
              cu succes.
       1      Niciun proces nu s-a potrivit sau niciunul dintre ele nu a putut fi semnalat.
       2      Eroare de sintaxă în linia de comandă.
       3      Eroare fatală: memorie insuficientă, etc.

NOTE

       Numele  procesului  folosit pentru potrivire este limitat la cele 15 caractere prezente în
       ieșirea /proc/pid/stat.  Utilizați opțiunea -f pentru a se potrivi  cu  linia  de  comandă
       completă, /proc/pid/cmdline. Este posibil ca firele de execuție să nu aibă același nume de
       proces ca și procesul părinte, dar vor avea aceeași linie de comandă.

       Procesul care rulează pgrep, pkill sau pidwait nu se va raporta niciodată ca o potrivire.

       Opțiunea -O --older va eșua în tăcere dacă /proc este montat cu opțiunea subset=pid.

ERORI

       Opțiunile -n și -o și -v nu pot fi combinate.  Anunțați  autorii,  dacă  credeți  că  este
       necesar să puteți face asta.

       Sunt raportate procesele defuncte.

       pidwait necesită apelul de sistem pidfd_open(2) care a apărut pentru prima dată în nucleul
       Linux versiunea 5.3.

CONSULTAȚI ȘI

       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

RAPORTAREA ERORILOR

       Trimiteți rapoartele de eroare la ⟨procps@freelists.org