sigwaitinfo(2)                System Calls Manual               sigwaitinfo(2)

NUME
       sigwaitinfo, sigtimedwait, rt_sigtimedwait - a<?>teapta in mod sincron
       pentru semnalele din coada de a<?>teptare

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <signal.h>

       int sigwaitinfo(const sigset_t *restrict set,
                       siginfo_t *_Nullable restrict info);
       int sigtimedwait(const sigset_t *restrict set,
                       siginfo_t *_Nullable restrict info,
                       const struct timespec *restrict timeout);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       sigwaitinfo(), sigtimedwait():
           _POSIX_C_SOURCE >= 199309L

DESCRIERE
       sigwaitinfo() suspenda execu<?>ia firului apelant pana cand unul dintre
       semnalele din set este in a<?>teptare; (daca unul dintre semnalele din
       set este deja in a<?>teptare pentru firul apelant, sigwaitinfo()
       returneaza imediat).

       sigwaitinfo() elimina semnalul din setul de semnale in a<?>teptare <?>i
       returneaza numarul semnalului ca rezultat al func<?>iei sale. Daca
       argumentul siginfo nu este NULL, atunci memoria tampon la care acesta
       indica este utilizata pentru a returna o structura de tip siginfo_t (a
       se vedea sigaction(2)) care con<?>ine informa<?>ii despre semnal.

       In cazul in care mai multe semnale din set sunt in a<?>teptare pentru
       apelant, semnalul care este recuperat de sigwaitinfo() este determinat
       in conformitate cu regulile obi<?>nuite de ordonare; a se vedea
       signal(7) pentru mai multe detalii.

       sigtimedwait() func<?>ioneaza exact in acela<?>i mod ca <?>i
       sigwaitinfo(), cu excep<?>ia faptului ca are un argument suplimentar,
       timeout, care specifica intervalul pentru care firul este suspendat in
       a<?>teptarea unui semnal; (acest interval va fi rotunjit la
       granularitatea (gradul de fine<?>e al) ceasului de sistem, iar
       intarzierile de programare ale nucleului inseamna ca intervalul poate
       fi depa<?>it cu o mica cantitate). Acest argument este o structura
       timespec(3).

       In cazul in care ambele campuri ale acestei structuri sunt specificate
       ca fiind 0, se efectueaza un sondaj: sigtimedwait() revine imediat, fie
       cu informa<?>ii despre un semnal care era in a<?>teptare pentru
       apelant, fie cu o eroare daca niciunul dintre semnalele din set nu era
       in a<?>teptare.

VALOAREA RETURNATA
       In caz de succes, atat sigwaitinfo(), cat <?>i sigtimedwait()
       returneaza un numar de semnal (adica o valoare mai mare decat zero). In
       caz de e<?>ec, ambele apeluri returneaza -1, cu errno configurata
       pentru a indica eroarea.

ERORI-IE<?>IRE
       EAGAIN Niciun semnal din set nu a devenit in a<?>teptare in perioada
              timeout specificata la sigtimedwait().

       EINTR  A<?>teptarea a fost intrerupta de un gestionar de semnal; a se
              vedea signal(7); (acest gestionar era pentru un alt semnal decat
              unul dintre cele din set).

       EINVAL timeout nu a fost valid.

VERSIUNI
   Diferen<?>e intre biblioteca C <?>i nucleu
       In Linux, sigwaitinfo() este o func<?>ie de biblioteca implementata pe
       langa sigtimedwait().

       Func<?>iile glibc pentru sigwaitinfo() <?>i sigtimedwait() ignora in
       tacere incercarile de a a<?>tepta cele doua semnale in timp real care
       sunt utilizate in mod intern de catre implementarea de fire de
       execu<?>ie ,,NPTL threading". A se vedea nptl(7) pentru detalii.

       Apelul de sistem original din Linux a fost numit sigtimedwait(). Cu
       toate acestea, odata cu adaugarea semnalelor in timp real in Linux 2.2,
       tipul de dimensiune fixa, pe 32 de bi<?>i sigset_t acceptat de acest
       apel de sistem nu mai era potrivit scopului. In consecin<?>a, a fost
       adaugat un nou apel de sistem, rt_sigtimedwait(), pentru a suporta un
       tip sigset_t marit. Noul apel de sistem prime<?>te un al patrulea
       argument, size_t sigsetsize, care specifica dimensiunea in octe<?>i a
       setului de semnale din set. In prezent, acest argument trebuie sa aiba
       valoarea sizeof(sigset_t) (in caz contrar, apare eroarea EINVAL).
       Func<?>ia de invaluire glibc sigtimedwait() ne ascunde aceste detalii,
       apeland in mod transparent rt_sigtimedwait() atunci cand nucleul o
       furnizeaza.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001.

NOTE
       In mod normal, programul apelant blocheaza semnalele din set printr-un
       apel anterior la sigprocmask(2) (astfel incat dispozi<?>ia implicita
       pentru aceste semnale sa nu apara daca acestea devin in a<?>teptare
       intre apelurile succesive la sigwaitinfo() sau sigtimedwait()) <?>i nu
       stabile<?>te gestionari pentru aceste semnale. Intr-un program cu mai
       multe fire de execu<?>ie, semnalul trebuie blocat in toate firele de
       execu<?>ie, pentru a preveni ca semnalul sa fie tratat in conformitate
       cu dispozi<?>ia sa implicita intr-un alt fir de execu<?>ie decat cel
       care apeleaza sigwaitinfo() sau sigtimedwait()).

       Setul de semnale care este in a<?>teptare pentru un anumit fir de
       execu<?>ie este uniunea dintre setul de semnale care este in
       a<?>teptare in mod specific pentru acel fir de execu<?>ie <?>i setul de
       semnale care este in a<?>teptare pentru intregul proces (a se vedea
       signal(7)).

       Incercarile de a a<?>tepta SIGKILL <?>i SIGSTOP sunt ignorate in
       tacere.

       In cazul in care mai multe fire ale unui proces sunt blocate in
       a<?>teptarea aceluia<?>i semnal (semnale) in sigwaitinfo() sau
       sigtimedwait(), atunci exact unul dintre fire va primi efectiv semnalul
       daca acesta devine in a<?>teptare pentru intregul proces; care dintre
       fire prime<?>te semnalul este nedeterminat.

       sigwaitinfo() sau sigtimedwait(), nu pot fi utilizate pentru a primi
       semnale care sunt generate in mod sincron, cum ar fi semnalul SIGSEGV
       care rezulta din accesarea unei adrese de memorie invalida sau semnalul
       SIGFPE care rezulta dintr-o eroare aritmetica. Astfel de semnale pot fi
       recep<?>ionate numai prin intermediul unui gestionar de semnal.

       POSIX lasa nespecificata semnifica<?>ia unei valori NULL pentru
       argumentul timeout din sigtimedwait(), permi<?>and posibilitatea ca
       acest lucru sa aiba aceea<?>i semnifica<?>ie ca un apel la
       sigwaitinfo() <?>i, intr-adevar, acest lucru este ceea ce se face sub
       Linux.

CONSULTA<?>I <?>I
       kill(2), sigaction(2), signal(2), signalfd(2), sigpending(2),
       sigprocmask(2), sigqueue(3), sigsetops(3), sigwait(3), timespec(3),
       signal(7), time(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.9.1   2 mai 2024                    sigwaitinfo(2)