pgrep, pkill, pidwait - rechercher, signaler ou attendre des processus en fonction de leur nom et d'autres attributs
SYNTAXE
pgrep [options] motif
pkill [options] motif
pidwait [options] motif
DESCRIPTION
pgrep examine les processus en cours d'exécution et affiche sur la sortie standard les ID de processus qui correspondent aux critères de sélection. Tous les critères doivent correspondre. Par exemple,
$ pgrep -u root sshd
n'affichera que les processus appelés sshd ET appartenant à root. D'autre part,
$ pgrep -u root,daemon
affichera les processus appartenant à root OU à daemon.
pkill envoie le signal spécifié (par défaut SIGTERM) à chaque processus au lieu de les afficher sur la sortie standard.
pidwait attend chaque processus au lieu de les afficher sur la sortie standard.
OPTIONS
-signal
--signal signal
Définit le signal à envoyer à chaque processus correspondant. Soit la valeur numérique, soit le nom symbolique du signal peut être utilisé. Dans le mode pgrep ou pidwait, seule l'option longue peut être utilisée et n'a aucun effet, sauf si elle est utilisée en conjonction avec --require-handler pour filtrer les processus disposant d'un gestionnaire de signal utilisateur pour un signal particulier.
-c, --count
Supprime la sortie normale ; affiche plutôt le nombre de processus correspondants. Lorsque le comptage ne correspond à rien, par exemple, renvoie zéro, la commande renvoie une valeur non nulle.
-d, --delimiter délimiteur
Définit la chaîne utilisée pour délimiter chaque ID de processus dans la sortie (par défaut, un saut de ligne). (pgrep uniquement.)
-e, --echo
Affiche le nom et l'ID du processus en cours de suppression. (pkill uniquement.)
-f, --full
Normalement, le motif est uniquement mis en correspondance avec le nom du processus. Lorsque -f est défini, la ligne de commande complète est utilisée.
-g, --pgroup pgrp,...
Ne correspond que aux processus appartenant aux ID de groupe de processus répertoriés. Le groupe de processus 0 est traduit en groupe de processus de pgrep, pkill ou pidwait.
-G, --group gid,...
Ne correspond que aux processus dont l'ID de groupe réel est répertorié. Soit la valeur numérique, soit la valeur symbolique peut être utilisée.
-i, --ignore-case
Effectue une correspondance insensible à la casse des processus.
-l, --list-name
Affiche le nom du processus ainsi que l'ID du processus. (pgrep uniquement.)
-a, --list-full
Affiche la ligne de commande complète ainsi que l'ID du processus. (pgrep uniquement.)
-n, --newest
Sélectionne uniquement le processus correspondant le plus récent (le plus récemment démarré).
-o, --oldest
Sélectionne uniquement le processus correspondant le plus ancien (le moins récemment démarré).
-O, --older secs
Sélectionne les processus plus anciens que le nombre de secondes spécifié.
-P, --parent ppid,...
Ne correspond qu’aux processus dont l’ID de processus parent figure dans la liste.
-s, --session sid,...
Ne correspond qu’aux processus dont l’ID de session de processus figure dans la liste. L’ID de session 0 est traduit en l’ID de session de pgrep, pkill ou pidwait.
-t, --terminal term,...
Ne correspond qu’aux processus dont le terminal de contrôle figure dans la liste. Le nom du terminal doit être spécifié sans le préfixe "/dev/".
-u, --euid euid,...
Ne correspond qu’aux processus dont l’ID d’utilisateur effectif figure dans la liste. La valeur numérique ou symbolique peut être utilisée.
-U, --uid uid,...
Ne correspond qu’aux processus dont l’ID d’utilisateur réel figure dans la liste. La valeur numérique ou symbolique peut être utilisée.
-v, --inverse
Inverse la correspondance. Cette option est généralement utilisée dans le contexte de pgrep ou de pidwait. Dans le contexte de pkill, l’option courte est désactivée pour éviter une utilisation accidentelle.
-w, --lightweight
Affiche tous les ID de thread au lieu des ID de processus dans le contexte de pgrep ou de pidwait. Dans le contexte de pkill, cette option est désactivée.
-x, --exact
Ne correspond qu’aux processus dont les noms (ou les lignes de commande si -f est spécifié) correspondent exactement au modèle.
-F, --pidfile file
Lit les ID de processus à partir du fichier. Cette option est plus utile pour pkill ou pidwait que pour pgrep.
-L, --logpidfile
Échoue si le fichier pid (voir -F) n’est pas verrouillé.
-r, --runstates D,R,S,Z,...
Ne correspond qu’aux processus dont l’état correspond.
-A, --ignore-ancestors
Ignore tous les ancêtres de pgrep, pkill ou pidwait. Par exemple, cela peut être utile lors de l’élévation des privilèges avec sudo ou des outils similaires.
-H, --require-handler
Ne correspond qu’aux processus qui ont un gestionnaire de signaux défini dans l’espace utilisateur pour le signal à envoyer.
--cgroup name,...
Correspond au nom de groupe de contrôle (cgroup) v2 fourni. Voir cgroups(8).
--ns pid
Correspond aux processus qui appartiennent aux mêmes espaces de noms. Il est nécessaire de s’exécuter en tant que root pour correspondre aux processus d’autres utilisateurs. Voir --nslist pour savoir comment limiter les espaces de noms à faire correspondre.
--nslist name,...
Ne correspond qu’aux espaces de noms fournis. Espaces de noms disponibles : ipc, mnt, net, pid, user, uts.
-q, --queue value
Utilise sigqueue(3) au lieu de [kill]({filename}../../kill)(2) et l’argument value est utilisé pour spécifier un entier à envoyer avec le signal. Si le processus récepteur a installé un gestionnaire pour ce signal en utilisant le drapeau SA_SIGINFO dans sigaction(2), alors il peut obtenir ces données via le champ si_value de la structure siginfo_t.
-V, --version
Affiche les informations de version et quitte.
-h, --help
Affiche l’aide et quitte.
OPERANDS
pattern
Spécifie une expression régulière étendue pour la correspondance avec les noms de processus ou les lignes de commande.
EXEMPLES
Exemple 1 : Trouver l’ID de processus du démon nommé :
$ pgrep -u root named
Exemple 2 : Demander à syslog de relire son fichier de configuration :
$ pkill -HUP syslogd
Exemple 3 : Afficher des informations détaillées sur tous les processus xterm :
$ ps -fp $(pgrep -d, -x xterm)
Exemple 4 : Demander à tous les processus Chrome d’être exécutés avec une priorité plus faible :
$ renice +4 $(pgrep chrome)
CODE DE RETOUR
0 Un ou plusieurs processus correspondent aux critères. Pour pkill et pidwait, un ou plusieurs processus doivent également avoir été signalés ou surveillés avec succès.
1 Aucun processus ne correspond ou aucun d’entre eux n’a pu être signalé.
2 Erreur de syntaxe dans la ligne de commande.
3 Erreur fatale : manque de mémoire, etc.
NOTES
Le nom du processus utilisé pour la correspondance est limité aux 15 caractères présents dans la sortie de /proc/pid/stat. Utilisez l’option -f pour effectuer une correspondance avec la ligne de commande complète, /proc/pid/cmdline. Les threads peuvent ne pas avoir le même nom de processus que le processus parent, mais ils auront la même ligne de commande.
Le processus pgrep, pkill ou pidwait en cours d’exécution ne se signalera jamais comme une correspondance.
L’option -O --older échouera silencieusement si /proc est monté avec l’option subset=pid.
BUGS
Les options -n et -o et -v ne peuvent pas être combinées. Faites-moi savoir si vous avez besoin de le faire.
Les processus zombies sont signalés.
pidwait nécessite l’appel système pidfd_open(2) qui est apparu pour la première fois dans Linux 5.3.
VOIR AUSSI
ps(1), regex(7), signal(7), sigqueue(3), killall(1), skill(1), kill(1), kill(2), cgroups(8).
AUTEUR
Kjetil Torgrim Homme
SIGNALEMENT DES BUGS
Veuillez envoyer les signalements de bogues à _