pgrep, pkill, pidwait - procura, sinaliza ou aguarda processos com base no nome e outros atributos
SINTAXE
pgrep [opções] padrão
pkill [opções] padrão
pidwait [opções] padrão
DESCRIÇÃO
pgrep pesquisa os processos em execução e lista os IDs de processo que correspondem aos critérios de seleção no stdout. Todos os critérios devem corresponder. Por exemplo,
$ pgrep -u root sshd
listará apenas os processos chamados sshd E pertencentes a root. Por outro lado,
$ pgrep -u root,daemon
listará os processos pertencentes a root OU daemon.
pkill enviará o sinal especificado (por padrão, SIGTERM) para cada processo em vez de listá-los no stdout.
pidwait aguardará cada processo em vez de listá-los no stdout.
OPÇÕES
-signal
--signal sinal
Define o sinal a ser enviado para cada processo correspondente. Tanto o valor numérico quanto o nome simbólico do sinal podem ser usados. No modo pgrep ou pidwait, apenas a opção longa pode ser usada e não tem efeito, a menos que seja usada em conjunto com --require-handler para filtrar os processos com um manipulador de sinal do espaço do usuário presente para um sinal específico.
-c, --count
Suprime a saída normal; em vez disso, imprime uma contagem dos processos correspondentes. Quando a contagem não corresponde a nada, por exemplo, retorna zero, o comando retornará um valor diferente de zero.
-d, --delimiter delimitador
Define a string usada para delimitar cada ID de processo na saída (por padrão, uma nova linha). (Apenas pgrep).
-e, --echo
Exibe o nome e o PID do processo que está sendo encerrado. (Apenas pkill).
-f, --full
Normalmente, o padrão só é correspondido ao nome do processo. Quando -f é definido, a linha de comando completa é usada.
-g, --pgroup pgrp,...
Corresponde apenas aos processos nos IDs de grupo de processos listados. O grupo de processos 0 é traduzido para o próprio grupo de processos de pgrep, pkill ou pidwait.
-G, --group gid,...
Corresponde apenas aos processos cujo ID de grupo real está listado. Seja o valor numérico ou simbólico, ele pode ser usado.
-i, --ignore-case
Corresponde aos processos de forma independente de maiúsculas e minúsculas.
-l, --list-name
Lista o nome do processo, bem como o ID do processo. (Apenas pgrep).
-a, --list-full
Lista a linha de comando completa, bem como o ID do processo. (Apenas pgrep).
-n, --newest
Seleciona apenas o processo mais recente (iniciado mais recentemente) dos processos correspondentes.
-o, --oldest
Seleciona apenas o processo mais antigo (iniciado primeiro) dos processos correspondentes.
-O, --older secs
Seleciona processos com mais de secs de idade.
-P, --parent ppid,...
Corresponde apenas aos processos cujo ID de processo pai está listado.
-s, --session sid,...
Só corresponda aos processos cujo ID de sessão do processo esteja listado. O ID de sessão 0 é traduzido para o ID de sessão do próprio [pgrep](/), [pkill](/) ou [pidwait](/).
-t, --terminal term,...
Só corresponda aos processos cujo terminal de controle esteja listado. O nome do terminal deve ser especificado sem o prefixo "/dev/".
-u, --euid euid,...
Só corresponda aos processos cujo ID de usuário efetivo esteja listado. Pode ser usado o valor numérico ou simbólico.
-U, --uid uid,...
Só corresponda aos processos cujo ID de usuário real esteja listado. Pode ser usado o valor numérico ou simbólico.
-v, --inverse
Inverte a correspondência. Esta opção é normalmente usada no contexto de [pgrep](/) ou [pidwait](/). No contexto de [pkill](/), a opção curta é desabilitada para evitar o uso acidental da opção.
-w, --lightweight
Mostra todos os IDs de thread em vez de PIDs no contexto de [pgrep](/) ou [pidwait](/). No contexto de [pkill](/), esta opção é desabilitada.
-x, --exact
Só corresponda aos processos cujos nomes (ou linhas de comando, se -f for especificado) correspondam exatamente ao padrão.
-F, --pidfile file
Lê os PIDs do arquivo. Esta opção é mais útil para [pkill](/) ou [pidwait](/) do que para [pgrep](/).
-L, --logpidfile
Falha se o arquivo pidfile (veja -F) não estiver bloqueado.
-r, --runstates D,R,S,Z,...
Só corresponda aos processos que correspondam ao estado do processo.
-A, --ignore-ancestors
Ignora todos os ancestrais de [pgrep](/), [pkill](/) ou [pidwait](/). Por exemplo, isso pode ser útil ao elevar privilégios com [sudo](/) ou ferramentas semelhantes.
-H, --require-handler
Só corresponda aos processos que tenham um manipulador de sinal do usuário presente para o sinal a ser enviado.
--cgroup name,...
Corresponde ao nome do grupo de controle (cgroup) v2 fornecido. Veja [cgroups(8)](/).
--ns pid
Corresponda aos processos que pertencem aos mesmos namespaces. Requer que você execute como root para corresponder a processos de outros usuários. Veja --nslist para saber como limitar quais namespaces corresponder.
--nslist name,...
Só corresponda aos namespaces fornecidos. Namespaces disponíveis: ipc, mnt, net, pid, user, uts.
-q, --queue value
Use [sigqueue(3)](/) em vez de [kill](filename kill.md)(2) e o argumento value é usado para especificar um inteiro a ser enviado com o sinal. Se o processo receptor tiver instalado um manipulador para este sinal usando a flag SA_SIGINFO em [sigaction(2)](/), então ele poderá obter esses dados por meio do campo si_value da estrutura siginfo_t.
-V, --version
Exibe informações da versão e sai.
-h, --help
Exibe ajuda e sai.
OPERANDOS
pattern
Especifica uma Expressão Regular Estendida para correspondência com os nomes dos processos ou linhas de comando.
EXEMPLOS
Exemplo 1: Encontre o ID do processo do daemon nomeado:
$ pgrep -u root named
Exemplo 2: Faça com que o syslog releia seu arquivo de configuração:
$ pkill -HUP syslogd
Exemplo 3: Forneça informações detalhadas sobre todos os processos xterm:
$ ps -fp $(pgrep -d, -x xterm)
Exemplo 4: Faça com que todos os processos chrome executem de forma mais "agradável":
$ renice +4 $(pgrep chrome)
STATUS DE SAÍDA
0 Um ou mais processos corresponderam aos critérios. Para [pkill](/) e [pidwait](/), um ou mais processos também devem ter sido sinalizados ou aguardados com sucesso.
1 Nenhum processo correspondeu ou nenhum deles pôde ser sinalizado.
2 Erro de sintaxe na linha de comando.
3 Erro fatal: falta de memória, etc.
NOTAS
O nome do processo usado para correspondência é limitado aos 15 caracteres presentes na saída de /proc/pid/stat. Use a opção -f para corresponder à linha de comando completa, /proc/pid/cmdline. As threads podem não ter o mesmo nome de processo do processo pai, mas terão a mesma linha de comando.
O processo pgrep, pkill ou pidwait em execução nunca se reportará como uma correspondência.
A opção -O --older falhará silenciosamente se /proc estiver montado com a opção subset=pid.
BUGS
As opções -n e -o e -v não podem ser combinadas. Avise-me se precisar fazer isso.
Processos zumbis são relatados.
pidwait requer a chamada de sistema pidfd_open(2), que apareceu pela primeira vez no Linux 5.3.
VEJA TAMBÉM
ps(1), regex(7), signal(7), sigqueue(3), killall(1), skill(1), kill(1), kill(2), cgroups(8).
AUTOR
Kjetil Torgrim Homme
RELATANDO BUGS
Por favor, envie relatórios de bugs para _