Linux Manpages Online - man.cx manual pages

NOME

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

SINOPSE

pgrep [opções] padrão
pkill [opções] padrão
pidwait [options] pattern

DESCRIÇÃO

pgrep examina os processos atualmente em execução e lista os IDs de processo que combinam os critérios de seleção para stdout (saída padrão). Todos os critérios devem corresponder. Por exemplo,

$ pgrep -u root sshd

vai listar apenas os processos chamados sshd E pertencentes ao root. Por outro lado,

$ pgrep -u root,daemon

vai listar os processos pertencentes ao root OU daemon.

pkill vai enviar um sinal especificado (por padrão, SIGTERM) para cada processo em vez de listá-los na stdout (saída padrão).

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

OPÇÕES

-sinal

--signal sinal

Define o sinal para enviar para cada processo correspondente. Tanto nome numérico quanto o simbólico do sinal podem ser usado. (pkill apenas)

-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 delimitador

Define a sequência usada para delimitar cada ID de processo na saída (por padrão, uma nova linha). (pgrep apenas.)

-e, --echo

Exibe o nome e o PID do processo sendo terminado. (pkill apenas.)

-f, --full

O padrão normalmente é analisado pelo nome do processo. Quando -f é definido, a linha de comando completa é usada.

-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,...

Corresponde apenas aos processos cujo ID de grupo real está listado. Ou o valor numérico ou simbólico pode ser usado.

-i, --ignore-case

Corresponde aos processos sem diferenciar maiúsculo/minúsculo.

-l, --list-name

Lista o nome do processo, bem como o ID do processo. (pgrep apenas.)

-a, --list-full

Lista o linha de comando completa, bem como o ID do processo. (pgrep apenas.)

-n, --newest

Seleciona apenas o mais novo (iniciado mais recentemente) dos processos correspondentes.

-o, --oldest

Seleciona apenas o mais antigo (iniciado menos recentemente) dos processos correspondentes.

-O, --older segundos

seleciona onde mais antigo que segundos

-P, --parent ppid,...

Corresponde apenas processos cujo ID de processo pai está listado.

-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 tty,...

Corresponde apenas os processos cujo terminal controlador está listado. O nome do terminal deve ser especificado sem o prefixo "/dev/".

-u, --euid euid,...

Corresponde apenas os processos cujo ID de usuário efetivo está listado. Ou o valor numérico ou simbólico pode ser usado.

-U, --uid uid,...

Corresponde apenas os processos cujo ID de usuário real está listado. Ou o valor numérico ou simbólico pode ser usado.

-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

Corresponde apenas a processos cujos nomes (ou linhas de comando, se -f for especificado) corresponderem exatamente ao padrão.

-F, --pidfile arquivo

Read PIDs from file. This option is more useful for pkillorpidwait than pgrep.

-L, --logpidfile

Falha se o arquivo de pid (veja -F) não estiver travado.

-r, --runstates D,R,S,Z,...

Corresponde apenas processos que correspondem ao estado de processo.

-A, --ignore-ancestors

Ignore all ancestors of pgrep, pkill, or pidwait. For example, this can be useful when elevating with sudo or similar tools.

--cgroup name,...

Match on provided control group (cgroup) v2 name. See cgroups(8)

--ns pid

Corresponde processos que pertencem aos mesmos espaços de nomes. É necessário executar como root para corresponder processos de outros usuários. Veja --nslist para como limitar quais espaços de nomes para corresponder.

--nslist nome,...

Corresponde apenas aos espaços de nomes fornecidos. Espaços de nomes disponíveis: ipc, mnt, net, pid, user, uts.

-q, --queue valor

Use sigqueue(3) em vez de kill(2) e o argumento de valor é usado para especificar um inteiro a ser enviado com o sinal. Se o processo de recebimento instalou um manipulador para este sinal usando o sinalizador SA_SIGINFO para sigaction(2), então ele pode obter esses dados através do campo si_value da estrutura siginfo_t.

-V, --version

Exibe informação da versão e sai.

-h, --help

Exibe a ajuda e sai.

OPERANDOS

padrão

Especifica uma expressão regular estendida para corresponder nomes de processos ou linhas de comandos.

EXEMPLOS

Exemplo 1: Localizar o ID de processo do daemon named:

$ pgrep -u root named

Exemplo 2: Fazer o syslog reler seu arquivo de configuração:

$ pkill -HUP syslogd

Exemplo 3: Fornecer informação detalhada todos processos de xterm:

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

Exemplo 4: Fazer todos os processos do chrome serem executados com nice maior:

$ renice +4 $(pgrep chrome)

STATUS DE SAÍDA

	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		Nenhum processo correspondido ou nenhum deles pode ser sinalizado.
	2		Erro de sintaxe na linha de comando.
	3		Erro fatal: memória insuficiente etc.

NOTAS

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.

The -O --older option will silently fail if /proc is mounted with the subset=pid option.

ERROS

As opções -n, -o e -v não podem ser combinadas. Me avise se você precisar fazer isso.

Os processos defeituosos são relatados.

pidwait requires the pidfd_open(2) system call which first appeared in Linux 5.3.

Manpages