killpg(3)

NOM
killpg - Envoyer un signal à un groupe de processus

BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)

SYNOPSIS
#include <signal.h>

int killpg(int pgrp, int sig);

    Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

killpg() :
    _XOPEN_SOURCE >= 500
        || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
        || /* glibc <= 2.19 : */ _BSD_SOURCE

DESCRIPTION
killpg() envoie le signal sig au groupe de processus pgrp. Consultez signal(7) pour la liste des signaux.

Si pgrp vaut 0, killpg() envoie le signal au groupe de processus du processus appelant. (POSIX dit : si pgrp est inférieur ou égal à 1, le comportement est indéterminé.)

Consultez kill(2) pour connaître les permissions nécessaires pour envoyer un signal à un autre processus.

VALEUR RENVOYÉE
En cas de succès, zéro est renvoyé. En cas d'erreur, -1 est renvoyé et errno est définie pour préciser l'erreur.

ERREURS

EINVAL
    sig n'est pas un numéro de signal valide.

EPERM
    Le processus n'a pas la permission d'envoyer un signal à aucun des processus visés. Pour les permissions nécessaires, consultez kill(2).

ESRCH
    Aucun processus n'appartient au groupe pgrp.

ESRCH
    On a voulu émettre vers le groupe 0, mais le processus en cours n'appartient pas à un groupe.

STANDARDS
POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD (la fonction killpg() est apparue dans 4BSD).

NOTES
Il y a des différences dans la vérification des permissions entre les systèmes de type BSD et ceux de type System V. Consultez l'explication de POSIX pour kill(3p). Une différence non mentionnée dans POSIX concerne la valeur de retour EPERM : BSD dit que lorsque la vérification des permissions échoue pour au moins un des processus cible, aucun signal n'est envoyé et EPERM et retournée, alors que POSIX dit que EPERM est retournée seulement lorsque la vérification des permissions échoue pour tous les processus cible.

  différences entre bibliothèque C et noyau
Sous Linux, killpg() est implémenté comme une fonction de bibliothèque appelant kill(-pgrp, sig).

VOIR AUSSI
getpgrp(2), kill(2), signal(2), capabilities(7), credentials(7)

TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Cédric Boutillier <cedric.boutillier@gmail.com> et Frédéric Hantrais <fhantrais@gmail.com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.