.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 2002 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" added note on self-signaling, aeb, 2002-06-07
.\" added note on CAP_KILL, mtk, 2004-06-16
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH sigqueue 3 "15 Diciembre 2022" "Páginas de manual de Linux 6.03" 
.SH NOMBRE
sigqueue \- envía una señal y un bloque de datos a un proceso
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <signal.h>\fP
.PP
\fBint sigqueue(pid_t \fP\fIpid\fP\fB, int \fP\fIsig\fP\fB, const union sigval \fP\fIvalue\fP\fB);\fP
.fi
.PP
.RS -4
Requisitos de Macros de Prueba de Características para glibc (véase
\fBfeature_test_macros\fP(7)):
.RE
.PP
\fBsigqueue\fP():
.nf
    _POSIX_C_SOURCE >= 199309L
.fi
.SH DESCRIPCIÓN
\fBsigqueue\fP()  envía la señal especificada en \fIsig\fP al proceso cuyo
identificador de proceso es dado en \fIpid\fP.  Los permisos requeridos para
enviar la señal son los mismos que para \fBkill\fP(2).  Como pasa con
\fBkill\fP(2), la señal nula (0) puede emplearse para comprobar si existe un
proceso con un identificador de proceso dado.
.PP
El argumento \fIvalue\fP se utiliza para especificar un bloque de datos
acompañante (o bien un entero o un puntero) que se enviará con la señal, y
que tiene el siguiente tipo:
.PP
.in +4n
.EX
union sigval {
    int   sival_int;
    void *sival_ptr;
};
.EE
.in
.PP
Si el proceso receptor tiene un manejador instalado para esta señal usando
la opción \fBSA_SIGINFO\fP en la llamada a \fBsigaction\fP(2), puede obtener los
datos a través del campo \fIsi_value\fP de la estructura \fIsiginfo_t\fP pasada
como segundo argumento al manejador.  Además, se asignará al campo
\fIsi_code\fP de esta estructura el valor \fBSI_QUEUE\fP.
.SH "VALOR DEVUELTO"
En caso de éxito, \fBsigqueue\fP()  devuelve 0, indicando que la señal fue
ennviada satisfactoriamente al proceso receptor.  En otro caso se devuelve
\-1 y \fIerrno\fP se modifica para indicar el error.
.SH ERRORES
.TP 
\fBEAGAIN\fP
Se alcanzó el límite de señales que puede ser encolado.  (Véase \fBsignal\fP(7)
para más información.)
.TP 
\fBEINVAL\fP
\fIsig\fP es inválido.
.TP 
\fBEPERM\fP
The process does not have permission to send the signal to the receiving
process.  For the required permissions, see \fBkill\fP(2).
.TP 
\fBESRCH\fP
No hay ningún proceso cuyo identificador de proceso coincida con \fIpid\fP.
.SH VERSIONES
\fBsigqueue\fP()  and the underlying \fBrt_sigqueueinfo\fP(2)  system call first
appeared in Linux 2.2.
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Interfaz	Atributo	Valor
T{
\fBsigqueue\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.hy
.ad
.sp 1
.SH ESTÁNDARES
POSIX.1\-2001, POSIX.1\-2008.
.SH NOTAS
Si esta función termina por enviar una señal al proceso que la invocó, y esa
señal no fue bloqueada por el hilo invocador, y no hay otros hilos
dispuestos a manejar esta señal (ya sea porque la tienen desbloqueada o
porque la esperan con \fBsigwait\fP(3)), entonces deberá enviarse al menos
alguna señal a este hilo antes de que esta función regrese.
.SS "Diferencias núcleo / biblioteca C"
On Linux, \fBsigqueue\fP()  is implemented using the \fBrt_sigqueueinfo\fP(2)
system call.  The system call differs in its third argument, which is the
\fIsiginfo_t\fP structure that will be supplied to the receiving process's
signal handler or returned by the receiving process's \fBsigtimedwait\fP(2)
call.  Inside the glibc \fBsigqueue\fP()  wrapper, this argument, \fIuinfo\fP, is
initialized as follows:
.PP
.in +4n
.EX
uinfo.si_signo = sig;      /* Argument supplied to sigqueue() */
uinfo.si_code = SI_QUEUE;
uinfo.si_pid = getpid();   /* Process ID of sender */
uinfo.si_uid = getuid();   /* Real UID of sender */
uinfo.si_value = val;      /* Argument supplied to sigqueue() */
.EE
.in
.SH "VÉASE TAMBIÉN"
\fBkill\fP(2), \fBrt_sigqueueinfo\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2),
\fBpthread_sigqueue\fP(3), \fBsigwait\fP(3), \fBsignal\fP(7)
.PP
.SH TRADUCCIÓN
La traducción al español de esta página del manual fue creada por
Miguel Pérez Ibars <mpi79470@alu.um.es>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .