.\" 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
.\" Modified Fri Jan 31 17:31:20 1997 by Eric S. Raymond <esr@thyrsus.com>
.\" Translated into Spanish Thu Jan 29 1998 by Gerardo Aburruzaga
.\" Garca <gerardo.aburruzaga@uca.es>
.TH SIGACTION 2 "29 Enero 1998" "Linux 1.3" "Manual del Programador Linux"

.SH NOMBRE
sigaction, sigprocmask, sigpending, sigsuspend \- funciones POSIX de
manejo de seales

.SH SINOPSIS
.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 DESCRIPCIN
La llamad al sistema
.B sigaction
se emplea para cambiar la accin tomada por un proceso cuando recibe
una determinada seal.
.PP
.I signum
especifica la seal y puede ser cualquiera vlida salvo
.B SIGKILL
o
.BR SIGSTOP .
.PP
Si
.I act
no es nulo, la nueva accin para la seal
.I signum
se instala como
.IR act .
Si
.I oldact
no es nulo, la accin anterior se guarda en
.IR oldact .
.PP
La estructura
.B sigaction
se define como
.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
especifica la accin que se va a asociar con
.I signum
y puede ser
.B SIG_DFL
para la accin predeterminada,
.B SIG_IGN
para no tener en cuenta la seal, o un puntero a una funcin
manejadora para la seal.
.PP
.I sa_mask
da una mscara de seales que deberan bloquearse durante la ejecucin
del manejador de seal. Adems, la seal que lance el manejador ser
bloqueada, a menos que se activen las opciones
.B SA_NODEFER
o
.BR SA_NOMASK .
.PP
.I sa_flags
especifica un conjunto de opciones que modifican el comportamiento del
proceso de manejo de seal. Se forma por la aplicacin del operador de
bits OR a cero o ms de las siguientes constantes:
.RS
.TP
.B SA_NOCLDSTOP
Si
.I signum
es
.BR SIGCHLD ", "
no se reciba notificacin cuando los procesos hijos se paren (esto es,
cuando los procesos hijos reciban una de las seales
.BR SIGSTOP ", " SIGTSTP ", " SIGTTIN
o
.BR SIGTTOU ")."
.TP
.BR SA_ONESHOT " o " SA_RESETHAND
Resturese la accin para la seal al estado predeterminado una vez
que el manejador de seal haya sido llamado. (Esto es el
comportamiento predeterminado de la llamada al sistema
.BR signal (2).)
.TP
.B SA_RESTART
Proporciona un comportamiento compatible con la semntica de seales
de BSD haciendo re-ejecutables algunas llamadas al sistema entre seales.
.TP
.BR SA_NOMASK " o " SA_NODEFER
No se impida que se reciba la seal desde su propio manejador.
.RE
.PP
El elemento
.I sa_restorer
est anticuado y no debera emplearse.
.PP
La llamada
.B sigprocmask
se emplea para cambiar la lista de seales bloqueadas actualmente. El
comportamiento de la llamada depende del valor de
.IR how ,
como sigue:
.RS
.TP
.B SIG_BLOCK
El conjunto de seales bloqueadas es la unin del conjunto actual y el
argumento
.IR set .
.TP
.B SIG_UNBLOCK
Las seales en
.I set
se quitan del conjunto actual de seales bloqueadas. Es legal intentar
el desbloqueo de una seal que no est bloqueada.
.TP
.B SIG_SETMASK
El conjunto de seales bloqueadas se pone segn el argumento
.IR set .
.RE
.PP
Si
.I oldset
no es nulo, el valor anterior de la mscara de seal se guarda en
.IR oldset .
.PP
La llamada
.B sigpending
permite el examen de seales pendientes (las que han sido producidas
mientras estaban bloqueadas). La mscara de seal de las seales
pendientes se guarda en
.IR set .
.PP
La llamada
.B sigsuspend
reemplaza temporalmente la mscara de seal para el proceso con la
dada por
.I mask
y luego suspende el proceso hasta que se recibe una seal.

.SH "VALORES DEVUELTOS"
.BR sigaction ,
.BR sigprocmask ,
.B sigpending
y
.B sigsuspend
devuelven 0 en caso de xito y \-1 en caso de error.

.SH ERRORES
.TP
.B EINVAL
Se ha especificado una seal invlida. Esto tambin se genera si se
hace un intento de cambiar la accin para
.BR SIGKILL " o " SIGSTOP ", "
que no pueden ser capturadas.
.TP
.B EFAULT
.IR act ", " oldact ", " set 
u 
.I oldset
apuntan a una zona de memoria que no forma parte vlida del espacio de
direcciones del proceso.
.TP
.B EINTR
La llamada al sistema ha sido interrumpida.

.SH OBSERVACIONES
No es posible bloquear
.BR SIGKILL " ni " SIGSTOP
con una llamada a sigprocmask.  Los intentos de hacerlo no sern
tenidos en cuenta, silenciosamente.
.PP
De acuerdo con POSIX, el comportamiento de un proceso est indefinido
despus de que no haga caso de una seal SIGFPE, SIGILL o SIGSEGV que
no haya sido generada por las funciones \fIkill()\fP o \fIraise()\fP.
La divisin entera por cero da un resultado indefinido.
En algunas arquitecturas generar una seal SIGFPE.
No hacer caso de esta seal puede llevar a un bucle infinito.
.PP
El poner
.B SIGCHLD
a
.B SIG_IGN
proporciona la cosecha automtica de procesos hijos.
.PP
La espec. POSIX slo define
.BR SA_NOCLDSTOP .
El empleo de otros valores en
.I sa_flags
no es transportable.
.PP
La opcin
.B SA_RESETHAND
es compatible con la de SVr4 del mismo nombre.
.PP
La opcin
.B SA_NODEFER
es compatible con la de SVr4 del mismo nombre bajo los kernels
1.3.9 y posteriores. En kernels ms viejos la implementacin de Linux 
permita la recepcin de cualquier seal, no slo la que estbamos
instalando (sustituyendo as efectivament cualquier valor de
.IR sa_mask ).
.PP
Los nombres
.BR SA_RESETHAND " y " SA_NODEFER
para compatibilidad con SVr4 estn presentes solamente en las
versiones de la biblioteca 3.0.9 y mayores.
.PP
.B sigaction
puede llamarse con un segundo argumento nulo para saber el manejador
de seal en curso. Tambin puede emplearse para comprobar si una seal
dada es vlida para la mquina donde se est, llamndola con el
segundo y el tercer argumento nulos.
.PP
Vea
.BR sigsetops (3)
para detalles sobre manipulacin de conjuntos de seales.
.SH "CONFORME CON"
POSIX, SVr4.  SVr4 no documenta la condicin EINTR.

.SH "VASE TAMBIN"
.BR kill "(1), " kill "(2), " killpg "(2), " pause "(2), " raise "(3), " 
.BR siginterrupt "(3), " signal "(2), " signal "(7), " sigsetops "(3), "
.BR sigvec (2)