Provided by: manpages-es_1.55-10_all bug

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)