SIGSETOPS(3)

NOM
sigsetops, sigemptyset, sigfillset, sigaddset, sigdelset, sigismember - Opérations sur les ensembles de signaux POSIX

SYNOPSIS
#include <signal.h>

int sigemptyset(sigset_t *set);

int sigfillset(sigset_t *set);

int sigaddset(sigset_t *set, int signum);

int sigdelset(sigset_t *set, int signum);

int sigismember(const sigset_t *set, int signum);

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

sigemptyset(), sigfillset(), sigaddset(), sigdelset(), sigismember() :
    _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE

DESCRIPTION
Ces fonctions permettent la manipulation des ensembles de signaux POSIX.

sigemptyset() vide l'ensemble de signaux fourni par set, tous les signaux étant exclus de cet ensemble.

sigfillset() remplit totalement l'ensemble de signaux set en incluant tous les signaux.

sigaddset() et sigdelset() ajoutent ou suppriment respectivement le signal signum de l'ensemble set.

sigismember() teste si le signal signum est membre de l'ensemble set.

Les objets de type sigset_t doivent être initialisés par un appel à sigemptyset() ou sigfillset() avant d'être passé aux fonctions sigaddset(), sigdelset() et sigismember() ou aux fonctions aupplémentaires de la glibc décrites ci-dessous (sigisemptyset(), sigandset() et sigorset()). Les résultats ne sont pas définis si ce n'est pas fait.

VALEUR RENVOYÉE
sigemptyset(), sigfillset(), sigaddset() et sigdelset() renvoient 0 s'il réussissent, et -1 s'ils échouent.

sigismember() renvoie 1 si le signal signum est dans l'ensemble set, 0 si signum n'y est pas, et -1 en cas d'erreur.En cas d'erreur, errno contient le code d'erreur.

ERREURS

EINVAL
    sig n'est pas un signal valide.

ATTRIBUTS

  Multithreading (voir pthreads(7))
Les fonctions sigemptyset(), sigfillset(), sigaddset(), sigdelset(), sigismember(), sigisemptyset(), sigorset() et sigandset() sont sûres dans un contexte multithread.

CONFORMITÉ
POSIX.1-2001.

NOTES

  Notes sur la glibc
Si la macro de test de fonctionnalités _GNU_SOURCE est définie, <signal.h> expose trois autres fonctions pour la manipulation des ensembles de signaux :
int sigisemptyset(const sigset_t *set);
int sigorset(sigset_t *dest, const sigset_t *left,
              const sigset_t *right);
int sigandset(sigset_t *dest, const sigset_t *left,
              const sigset_t *right);
sigisemptyset() renvoie 1 si set ne contient pas de signaux et 0 autrement. sigorset() place l'union des ensembles left et right dans dest. sigandset() place l'intersection des ensembles left et right dans dest. Les deux fonctions renvoient 0 si elles réussissent et -1 si elles échouent.

Ces fonctions ne sont pas standards (quelques autres systèmes ont des fonctions similaires) et ne devraient pas être utilisées dans des applications conçues pour être portables.

VOIR AUSSI
sigaction(2), sigpending(2), sigprocmask(2), sigsuspend(2)

COLOPHON
Cette page fait partie de la publication 3.70 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».