.\" Copyright (c) 1994,1995 Mike Battersby <mib@deakin.edu.au>
.\" based on work by faith@cs.unc.edu
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified, aeb, 960424
.\"
.\" Traduction 14/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 15/04/97
.\" maj 09/04/99
.\" maj 27/08/99
.TH SIGACTION 2 "27 Aot 1999" Linux "Manuel du programmeur Linux"
.SH NOM
sigaction, sigprocmask, sigpending, sigsuspend \- Fonctions POSIX de manipulations de signaux.
.SH SYNOPSIS
.B #include <signal.h>
.sp 2
.BI "int sigaction(int " signum ", const struct sigaction *" act ","
.BI "struct sigaction *" oldact );
.sp
.BI "int sigprocmask(int " how ", const sigset_t *" set ", "
.BI "sigset_t *" oldset );
.sp
.BI "int sigpending(sigset_t *" set );
.sp
.BI "int sigsuspend(const sigset_t *" mask );

.SH DESCRIPTION
L'appel systme
.B sigaction
sert  modifier l'action effectue par un processus  la rception
d'un signal spcifique.
.PP
.I signum
indique le signal concern,  l'exception de
.B SIGKILL
et
.BR SIGSTOP .
.PP
Si
.I act
est non nul, la nouvelle action pour le signal
.I signum
est dfinie par
.IR act .
Si
.I oldact
est non nul, l'ancienne action est sauvegarde dans
.IR oldact .
.PP
La structure 
.B sigaction
est dfinie comme suit :
.sp
.RS
.nf
struct sigaction {
    void (*sa_handler)(int);
    sigset_t sa_mask;
    int sa_flags;
    void (*sa_restorer)(void);
}
.fi
.RE
.PP
.I sa_handler
indique l'action affecte au signal
.IR signum ", "
et peut tre
.B SIG_DFL
pour l'action par dfaut,
.B SIG_IGN
pour ignorer le signal, ou un pointeur sur une fonction de gestion de signaux.
.PP
.I sa_mask
fournit un masque de signaux  bloquer pendant l'excution du gestionnaire.
De plus le signal ayant appel le gestionnaire est bloqu  moins que
les attributs
.B SA_NODEFER
ou
.B SA_NOMASK
soient prciss.
.PP
.I sa_flags
spcifie un ensemble d'attributs qui modifient le comportement du
gestionnaire de signaux. Il est form par un OU binaire ( | ) entre
les options suivantes :
.RS
.TP
.B SA_NOCLDSTOP
Si
.I signum
vaut
.BR SIGCHLD ", "
ne pas recevoir les signaux de notification d'arrt d'un processus fils
(quand le fils reoit un signal
.BR SIGSTOP ", " SIGTSTP ", " SIGTTIN
ou
.BR SIGTTOU ")."
.TP
.BR SA_ONESHOT " or " SA_RESETHAND
Rtablir l'action  son comportement par dfaut une fois que le
gestionnaire a t appel (C'est le comportement par dfaut avec
la fonction
.BR signal (2)
)
.TP
.B SA_RESTART
Fournir un comportement compatible avec la smantique BSD en redmarrant
automatiquement les appels systmes lents interrompus par l'arrive du signal.
.TP
.BR SA_NOMASK " or " SA_NODEFER
Ne pas empcher un signal d'tre reu depuis l'intrieur de son propre
gestionnaire.
.RE
.PP
L'option
.I SA_RESTORER
est obsolte et ne doit pas tre utilise.
.PP
L'appel
.B sigprocmask
est utilis pour changer la liste des signaux actuellement
bloqus. Son comportement est dpendant de la valeur de
.IR how ,
avec les conventions suivantes :
.RS
.TP
.B SIG_BLOCK
L'ensemble des signaux bloqus est l'union de l'ensemble actuel
et de l'argument
.I set.
.TP
.B SIG_UNBLOCK
Les signaux dans l'ensemble
.I set
sont supprims de la liste des signaux bloqus. Il est possible
de dbloquer un signal non bloqu.
.TP
.B SIG_SETMASK
L'ensemble des signaux bloqus est gal  l'argument
.IR set .
.RE
.PP
Si
.I oldset
est non nul, la valeur prcdente du masque de signaux est
stocke dans
.IR oldset .
.PP
L'appel
.B sigpending
permet l'examen des signaux en attente (qui se sont dclenchs
en tant bloqus). Le masque de signaux en attente est stock
dans
.IR set .
.PP
L'appel
.B sigsuspend
remplace temporairement le masque de signaux bloqus par celui
fourni dans
.I mask
puis endort le processus jusqu' arrive d'un signal.

.SH "VALEUR RENVOYE"
.BR sigaction ,
.BR sigprocmask ,
.B sigpending
et
.B sigsuspend
renvoient 0 s'ils russissent, ou \-1 s'ils chouent, auquel
cas 
.I errno
contient le code d'erreur.

.SH ERREURS
.TP
.B EINVAL
Un signal invalide est indique. Ceci se produit galement si l'on
tente de modifier l'action associe 
.BR SIGKILL " ou " SIGSTOP ". "
.TP
.B EFAULT
.IR act ", " oldact ", " set 
ou 
.I oldset
pointent en\-dehors de l'espace d'adressage accessible.
.TP
.B EINTR
L'appel systme a t interrompu.

.SH NOTES
Il est impossible de bloquer
.BR SIGKILL " or " SIGSTOP
avec l'appel sigprocmask. Les tentatives seront ignores silencieusement.
.PP
Suivant POSIX, le comportement d'un processus est indfini aprs qu'il
ait ignor un signal SIGFPE, SIGILL, ou SIGSEGV qui n'avait pas t
engendr par une fonction \fIkill()\fP ou \fIraise()\fP.
La division entire par zro a un rsultat indfini.
Sur certaines architectures, cela dclenchera un signal SIGFPE.
(De mme diviser l'entier le plus ngatif par \-1 peut dclencher SIGFPE).
Ignorer ce signal peut mener  des boucles sans fin.
.PP
POSIX (B.3.3.1.3) dsapprouve le positionnement de SIGCHLD  SIG_IGN.
Les comportements BSD et SYSV diffrent, faisant chouer sous Linux
les logiciels BSD qui positionne l'action de SIGCHK  SIG_IGN.
.PP
Les spcifications POSIX dfinissent seulement
.BR SA_NOCLDSTOP .
L'utilisation des autres options de
.I sa_flags
n'est pas portable.
.PP
L'option
.B SA_RESETHAND
est compatible avec l'option SVr4 du mme nom.
.PP
L'option
.B SA_NODEFER
est compatible avec l'option SVr4 du mme nom pour les noyaux 1.3.9
et ultrieurs. Pour les noyaux plus anciens, Linux autorisera la rception
de tous les signaux et pas seulement celui qui vient de se dclencher
(crasant effectivement
.I sa_mask
).
.PP
Les noms
.BR SA_RESETHAND " et " SA_NODEFER
pour compatibilit avec SVr4 ne sont prsents que dans les bibliothques 3.0.9
et suivantes.
.PP
.B sigaction
peut tre appel avec un second argument null pour obtenir le gestionnaire 
de signaux actuel. On peut aussi vrifier si un signal est valide sur la
machine actuelle en l'appellant avec les deuxime et troisime arguments
nuls.
.PP
Voir
.BR sigsetops (3)
pour les dtails concernant les ensembles de signaux.
.SH "CONFORMIT"
POSIX, SVr4. SVr4 ne documente pas la condition d'erreur EINTR.
.SH "VOIR AUSSI"
.BR kill "(1), " kill "(2), " killpg "(2), " pause "(2), " raise "(3), " 
.BR siginterrupt "(3), " signal "(2), " signal "(7), " sigsetops "(3), "
.BR sigvec (2) 

.SH TRADUCTION
Christophe Blaess, 1997.