Provided by:
manpages-es_1.55-10_all 
NOMBRE
sigqueue - envia una senal y un bloque de datos a un proceso
SINOPSIS
#include <signal.h>
int sigqueue(pid_t pid, int sig, const union sigval value);
DESCRIPCI'ON
sigqueue() envia la senal especificada en sig al proceso cuyo
identificador de proceso es dado en pid. Los permisos requeridos para
enviar la senal son los mismos que para kill(2). Como pasa con
kill(2), la senal nula (0) puede emplearse para comprobar si existe un
proceso con un identificador de proceso dado.
El argumento value se utiliza para especificar un bloque de datos
acompanante (o bien un entero o un puntero) que se enviara con la
senal, y que tiene el siguiente tipo:
union sigval {
int sival_int;
void *sival_ptr;
};
Si el proceso receptor tiene un manejador instalado para esta senal
usando la opcion SA_SIGINFO en la llamada a sigaction(2), puede obtener
los datos a traves del campo si_value de la estructura siginfo_t pasada
como segundo argumento al manejador. Ademas, se asignara al campo
si_code de esta estructura el valor SI_QUEUE.
VALOR DEVUELTO
En caso de exito, sigqueue() devuelve 0, indicando que la senal fue
ennviada satisfactoriamente al proceso receptor. En otro caso se
devuelve -1 y errno se modifica para indicar el error.
ERRORES
EAGAIN Se alcanzo el limite de senales que puede ser encolado. (Vease
signal(7) para mas informacion.)
EINVAL sig es invalido.
ESRCH No hay ningun proceso cuyo identificador de proceso coincida con
pid.
EPERM El proceso no tiene permiso para enviar la senal al proceso
receptor. (Vease kill(2) para mas informacion.)
OBSERVACIONES
Si esta funcion termina por enviar una senal al proceso que la invoco,
y esa senal no fue bloqueada por el hilo invocador, y no hay otros
hilos dispuestos a manejar esta senal (ya sea porque la tienen
desbloqueada o porque la esperan con sigwait(3)), entonces debera
enviarse al menos alguna senal a este hilo antes de que esta funcion
regrese.
CONFORME A
POSIX 1003.1-2001
V'EASE TAMBI'EN
kill(2), sigaction(2), signal(2), sigwait(3), signal(7)