NUME

sigqueue - pune la coadă un semnal și date pentru un proces

BIBLIOTECA

Biblioteca C standard (libc, -lc)

REZUMAT

#include <signal.h>

int sigqueue(pid_t pid, int sig, const union sigval value);

sigqueue():

    _POSIX_C_SOURCE >= 199309L

DESCRIERE

sigqueue() trimite semnalul specificat în sig către procesul al cărui PID este dat în pid. Permisiunile necesare pentru a trimite un semnal sunt aceleași ca pentru kill(2). Ca și în cazul kill(2), semnalul nul (0) poate fi utilizat pentru a verifica dacă există un proces cu un PID dat.

Argumentul value 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:

union sigval {
    int   sival_int;
    void *sival_ptr;
};

În cazul în care procesul de recepție a instalat un gestionar pentru acest semnal utilizând fanionul SA_SIGINFO la sigaction(2), atunci acesta poate obține aceste date prin intermediul câmpului si_value din structura siginfo_t transmisă ca al doilea argument al gestionarului. În plus, câmpul si_code al acestei structuri va fi stabilit la SI_QUEUE.

VALOAREA RETURNATĂ

În caz de succes, sigqueue() returnează 0, indicând că semnalul a fost pus cu succes în coadă către procesul receptor. În caz contrar, se returnează -1, iar errno este configurată pentru a indica eroarea.

ERORI-IEȘIRE

EAGAIN

A fost atinsă limita de semnale care pot fi puse în coadă. A se vedea signal(7) pentru informații suplimentare.

EINVAL

sig nu a fost valid.

EPERM

Procesul nu are permisiunea de a trimite semnalul către procesul receptor. Pentru permisiunile necesare, a se vedea kill(2).

ESRCH

Niciun proces nu are un PID care să corespundă cu pid.

ATRIBUTE

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

VERSIUNI

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() */

STANDARDE

POSIX.1-2008.

ISTORIC

Linux 2.2. POSIX.1-2001.

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 sigwait(3)), atunci cel puțin un semnal trebuie să fie transmis acestui fir înainte ca această funcție să returneze.

CONSULTAȚI ȘI

kill(2), rt_sigqueueinfo(2), sigaction(2), signal(2), pthread_sigqueue(3), sigwait(3), signal(7)

TRADUCERE

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.