SIGSETOPS

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 25 novembre 2007
Index Menu principal  

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.

 

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
Notes glibc
VOIR AUSSI
TRADUCTION

Dernière mise à jour : 17 juillet 2008