'\" t
.\" 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>
.\" Modified Thu Nov 26 02:12:45 1998 by aeb - add SIGCHLD stuff.
.\" Modified Sat May  8 17:40:19 1999 by Matthew Wilcox - add POSIX.1b signals
.\"
.\" Translated into Spanish Thu Jan 29 1998 by Gerardo Aburruzaga
.\" Garca <gerardo.aburruzaga@uca.es>
.\" Translation revised Wed Dec 30 1998 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised Sun Jun 27 1999 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH SIGACTION 2 "8 Mayo 1999" "Linux 2.2" "Manual del Programador de 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);
    void (*sa_sigaction)(int, siginfo_t *, void *);
    sigset_t sa_mask;
    int sa_flags;
    void (*sa_restorer)(void);
}
.fi
.RE
.PP
El elemento
.I sa_restorer
est obsoleto y no debera utilizarse.
.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.
.TP
.B SA_SIGINFO
El manejador de seal toma 3 argumentos, no uno. En este caso, se debe
configurar
.I sa_sigaction
en lugar de
.IR sa_handler .
(El campo sa_sigaction fue aadido en la versin 2.1.86 de Linux.)
.RE
.PP
El parmetro
.I siginfo_t
para
.I sa_sigaction
es una estructura con los siguientes elementos
.sp
.RS
.nf
.ta 4 13 24
siginfo_t {
	int	si_signo;	/* Nmero de seal */
	int	si_errno;	/* Un valor errno */
	int	si_code;	/* Cdigo de seal */
	pid_t	si_pid;	/* ID del proceso emisor */
	uid_t	si_uid;	/* ID del usuario real del proceso emisor */
	int	si_status;	/* Valor de salida o seal */
	clock_t	si_utime;	/* Tiempo de usuario consumido */
	clock_t	si_stime;	/* Tiempo de sistema consumido */
	sigval_t	si_value;	/* Valor de seal */
	int	si_int;	/* seal POSIX.1b */
	void *	si_ptr;	/* seal POSIX.1b */
	void *	si_addr;	/* Direccin de memoria que ha producido el fallo */
	int	si_band;	/* Evento de conjunto */
	int	si_fd;	/* Descriptor de fichero */
}
.fi
.RE
.IR si_signo ", " si_errno " y " si_code
estn definidos para todas las seales.
.BR kill (2),
las seales POSIX.1b y SIGCHLD rellenan
.IR si_pid " y " si_uid .
.BR
SIGCHLD tambin rellena
.IR si_status ", " si_utime " y " si_stime .
.IR si_int " y " si_ptr
son especificados por el emisor de la seal POSIX.1b.
.\" See
.\" .BR sigqueue (2)
.\" for more details.
 SIGILL, SIGFPE, SIGSEGV y SIGBUS rellenan
.I si_addr
con la direccin del fallo.
SIGPOLL rellena
.IR si_band " y " si_fd .

.I si_code
indica por qu se ha enviado la seal. Es un valor, no una mscara de bits.
Los valores que son posibles para cualquier seal se listan en la siguiente
tabla:
.TS
tab(:) allbox;
c s
l l.
\fIsi_code\fR
Valor:Origen de la seal
SI_USER:kill, sigsend o raise
SI_KERNEL:El ncleo
SI_QUEUE:sigqueue
SI_TIMER:el cronmetro ha vencido
SI_MESGQ:ha cambiado el estado de mesq
SI_ASYNCIO:ha terminado una E/S asncrona
SI_SIGIO:SIGIO encolada
.TE

.TS
tab(:) allbox;
c s
l l.
SIGILL
ILL_ILLOPC:cdigo de operacin ilegal
ILL_ILLOPN:operando ilegal
ILL_ILLADR:modo de direccionamiento ilegal
ILL_ILLTRP:trampa ilegal
ILL_PRVOPC:cdigo de operacin privilegiada
ILL_PRVREG:registro privilegiado
ILL_COPROC:error del coprocesador
ILL_BADSTK:error de la pila interna
.TE

.TS
tab(:) allbox;
c s
l l.
SIGFPE
FPE_INTDIV:entero dividido por cero
FPE_INTOVF:desbordamiento de entero
FPE_FLTDIV:punto flotante dividido por cero
FPE_FLTOVF:desbordamiento de punto flotante
FPE_FLTUND:desbordamiento de punto flotante por defecto
FPE_FLTRES:resultado de punto flotante inexacto
FPE_FLTINV:operacin de punto flotante invlida
FPE_FLTSUB:subscript fuera de rango
.TE

.TS
tab(:) allbox;
c s
l l.
SIGSEGV
SEGV_MAPERR:direccin no asociada a un objeto
SEGV_ACCERR:permisos invlidos para un objeto presente en memoria
.TE

.TS
tab(:) allbox;
c s
l l.
SIGBUS
BUS_ADRALN:alineamiento de direccin invlido
BUS_ADRERR:direccin fsica inexistente
BUS_OBJERR:error hardware especfico del objeto
.TE

.TS
tab(:) allbox;
c s
l l.
SIGTRAP
TRAP_BRKPT:punto de parada de un proceso
TRAP_TRACE:trampa de seguimiento paso a paso de un proceso
.TE

.TS
tab(:) allbox;
c s
l l.
SIGCHLD
CLD_EXITED:ha terminado un hijo
CLD_KILLED:se ha matado a un hijo
CLD_DUMPED:un hijo ha terminado anormalmente
CLD_TRAPPED:un hijo con seguimiento paso a paso ha sido detenido
CLD_STOPPED:ha parado un hijo
CLD_CONTINUED:un hijo parado ha continuado
.TE

.TS
tab(:) allbox;
c s
l l.
SIGPOLL
POLL_IN:datos de entrada disponibles
POLL_OUT:buffers de salida disponibles
POLL_MSG:mensaje de entrada disponible
POLL_ERR:error de E/S
POLL_PRI:entrada de alta prioridad disponible
POLL_HUP:dispositivo desconectado
.TE

.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 "VALOR DEVUELTO"
.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.
(Tambin, el dividir el entero ms negativo por \-1 puede generar una seal
SIGFPE.)
No hacer caso de esta seal puede llevar a un bucle infinito.
.PP
POSIX (B.3.3.1.3) anula el establecimiento de SIG_IGN como accin para SIGCHLD.
Los comportamientos de BSD y SYSV difieren, provocando el fallo en
Linux de aquellos programas BSD que asignan SIG_IGN como accin para SIGCHLD.
.PP
La especificacin 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 ncleos
1.3.9 y posteriores. En ncleos 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
La opcin
.BR SA_SIGINFO
viene especificada por POSIX.1b. El soporte para ella se aadi en la
versin 2.2 de Linux.
.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 A"
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)