.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2002 Michael Kerrisk .\" .\" 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 "31 octombrie 2023" "Pagini de manual de Linux 6.06" .SH NUME sigqueue \- pune la coadă un semnal și date pentru un proces .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .P \fBint sigqueue(pid_t \fP\fIpid\fP\fB, int \fP\fIsig\fP\fB, const union sigval \fP\fIvalue\fP\fB);\fP .fi .P .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .P \fBsigqueue\fP(): .nf _POSIX_C_SOURCE >= 199309L .fi .SH DESCRIERE \fBsigqueue\fP() trimite semnalul specificat în \fIsig\fP către procesul al cărui PID este dat în \fIpid\fP. Permisiunile necesare pentru a trimite un semnal sunt aceleași ca pentru \fBkill\fP(2). Ca și în cazul \fBkill\fP(2), semnalul nul (0) poate fi utilizat pentru a verifica dacă există un proces cu un PID dat. .P Argumentul \fIvalue\fP este utilizat pentru a specifica un element de date însoțitor (fie un număr întreg, fie o valoare de indicator) care urmează să fie trimis împreună cu semnalul și are următorul tip: .P .in +4n .EX union sigval { int sival_int; void *sival_ptr; }; .EE .in .P În cazul în care procesul de recepție a instalat un gestionar pentru acest semnal utilizând fanionul \fBSA_SIGINFO\fP la \fBsigaction\fP(2), atunci acesta poate obține aceste date prin intermediul câmpului \fIsi_value\fP din structura \fIsiginfo_t\fP transmisă ca al doilea argument al gestionarului. În plus, câmpul \fIsi_code\fP al acestei structuri va fi stabilit la \fBSI_QUEUE\fP. .SH "VALOAREA RETURNATĂ" În caz de succes, \fBsigqueue\fP() returnează 0, indicând că semnalul a fost pus cu succes în coadă către procesul receptor. În caz contrar, se returnează \-1, iar \fIerrno\fP este configurată pentru a indica eroarea. .SH ERORI\-IEȘIRE .TP \fBEAGAIN\fP A fost atinsă limita de semnale care pot fi puse în coadă. A se vedea \fBsignal\fP(7) pentru informații suplimentare. .TP \fBEINVAL\fP \fIsig\fP nu a fost valid. .TP \fBEPERM\fP Procesul nu are permisiunea de a trimite semnalul către procesul receptor. Pentru permisiunile necesare, a se vedea \fBkill\fP(2). .TP \fBESRCH\fP Niciun proces nu are un PID care să corespundă cu \fIpid\fP. .SH ATRIBUTE Pentru o explicație a termenilor folosiți în această secțiune, a se vedea \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfață Atribut Valoare T{ .na .nh \fBsigqueue\fP() T} Siguranța firelor MT\-Safe .TE .SH VERSIUNI .SS "Diferențe între biblioteca C și nucleu" În Linux, \fBsigqueue\fP() este implementat utilizând apelul de sistem \fBrt_sigqueueinfo\fP(2). Apelul de sistem diferă prin cel de\-al treilea argument, care este structura \fIsiginfo_t\fP care va fi furnizată gestionarului de semnal al procesului receptor sau returnată de apelul \fBsigtimedwait\fP(2) al procesului receptor. În interiorul funcției învăluitoare \fBsigqueue\fP() a glibc, acest argument, \fIuinfo\fP, este inițializat după cum urmează: .P .in +4n .EX uinfo.si_signo = sig; /* Argument furnizat pentru sigqueue() */ uinfo.si_code = SI_QUEUE; uinfo.si_pid = getpid(); /* ID\-ul de proces al expeditorului */ uinfo.si_uid = getuid(); /* UID\-ul real al expeditorului */ uinfo.si_value = val; /* Argument furnizat pentru sigqueue() */ .EE .in .SH STANDARDE POSIX.1\-2008. .SH ISTORIC Linux 2.2. POSIX.1\-2001. .SH NOTE Dacă această funcție are ca rezultat trimiterea unui semnal către procesul care a invocat\-o, iar acest semnal nu a fost blocat de firul apelant și nici un alt fir nu a fost dispus să gestioneze acest semnal (fie prin deblocarea lui, fie prin așteptarea lui folosind \fBsigwait\fP(3)), atunci cel puțin un semnal trebuie să fie transmis acestui fir înainte ca această funcție să returneze. .SH "CONSULTAȚI ȘI" \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 TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .