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);

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 soit à sigemptyset() soit à sigfillset() avant d'être passés aux fonctions sigaddset(), sigdelset() et sigismember() ou aux fonctions supplémentaires de la glibc décrites plus loin (sigisemptyset(), sigandset() et sigdelset()). Les résultats sont indéterminés 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.

ERREURS

EINVAL
    sig n'est pas un signal valide.

CONFORMITÉ
POSIX.1-2001.

NOTES

  Notes 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(sigset_t *set);
    renvoie 1 si set ne contient pas de signaux et 0 autrement.

int sigorset(sigset_t *dest, sigset_t *left, sigset_t *right);
    place l'union des ensembles left et right dans dest.

int sigandset(sigset_t *dest, sigset_t *left, sigset_t *right);
    place l'intersection des ensembles left et right dans dest.

sigorset() et sigandset() renvoient 0 si elles réussissent et -1 si elles échouent.

Ces fonctions ne sont pas standard (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)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 7 novembre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 sigsetops ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.