.\" -*- coding: UTF-8 -*- .\" Copyright (c) 2002 Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" 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. .\" %%%LICENSE_END .\" .\" 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 Septiembre 2017" Linux "Manual del Programador de Linux" .SH NOMBRE sigqueue \- envía una señal y un bloque de datos a un proceso .SH SINOPSIS \fB#include \fP .PP \fBint sigqueue(pid_t \fP\fIpid\fP\fB, int \fP\fIsig\fP\fB, const union sigval \fP\fIvalue\fP\fB);\fP .PP .RS -4 Requisitos de Macros de Prueba de Características para glibc (véase \fBfeature_test_macros\fP(7)): .RE .PP \fBsigqueue\fP(): _POSIX_C_SOURCE\ >=\ 199309L .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() 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). .TS allbox; lb lb lb l l l. Interfaz Atributo Valor T{ \fBsigqueue\fP() T} Seguridad del hilo Multi\-hilo seguro .TE .SH "CONFORME A" 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) .SH COLOFÓN Esta página es parte de la versión 5.10 del proyecto Linux \fIman\-pages\fP. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en \%https://www.kernel.org/doc/man\-pages/. .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Miguel Pérez Ibars . .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 .