get_robust_list(2)            System Calls Manual           get_robust_list(2)

NUME
       get_robust_list, set_robust_list - ob<?>ine/stabile<?>te lista de
       futex-uri robuste

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <linux/futex.h>   /* Defini<?>ia lui struct robust_list_head */
       #include <sys/syscall.h>   /* Definirea constantelor SYS_* */
       #include <unistd.h>

       long syscall(SYS_get_robust_list, int pid,
                    struct robust_list_head **head_ptr, size_t *sizep);
       long syscall(SYS_set_robust_list,
                    struct robust_list_head *head, size_t size);

       Nota: Nu exista nicio func<?>ie invaluitoare (wrapper) glibc pentru
       aceste apeluri de sistem astfel ca este necesara utilizarea a
       syscall(2).

DESCRIERE
       Aceste apeluri de sistem se ocupa de listele futex robuste pentru
       fiecare fir. Aceste liste sunt gestionate in spa<?>iul utilizatorului:
       nucleul <?>tie doar despre loca<?>ia antetului listei. Un fir de
       execu<?>ie poate informa nucleul cu privire la loca<?>ia listei sale de
       futex-uri robuste folosind set_robust_list(). Adresa listei de
       futex-uri robuste a unui fir de execu<?>ie poate fi ob<?>inuta folosind
       get_robust_list().

       Scopul listei robuste de futex este de a se asigura ca, in cazul in
       care un fir nu reu<?>e<?>te din gre<?>eala sa deblocheze un futex
       inainte de a se termina sau de a apela execve(2), un alt fir care
       a<?>teapta acel futex este notificat ca fostul proprietar al futexului
       a murit.  Aceasta notificare consta in doua par<?>i: bitul
       FUTEX_OWNER_DIED este activat in cuvantul futex, iar nucleul efectueaza
       o opera<?>ie futex(2) FUTEX_WAKE pe unul dintre firele care a<?>teapta
       futex-ul.

       Apelul de sistem get_robust_list() returneaza antetul listei futex
       robusta a firului al carui ID de fir este specificat in pid. Daca pid
       este 0, se returneaza antetul listei pentru firul apelant. Antetul
       listei este stocat in loca<?>ia indicata de head_ptr. Dimensiunea
       obiectului indicat de **head_ptr este stocata in sizep.

       Permisiunea de a utiliza get_robust_list() este guvernata de o
       verificare a modului de acces ptrace PTRACE_MODE_READ_REALCREDS; a se
       vedea ptrace(2).

       Apelul de sistem set_robust_list() solicita nucleului sa inregistreze
       antetul listei de futex-uri robuste de<?>inute de firul apelant.
       Argumentul head este antetul listei care trebuie inregistrat.
       Argumentul size trebuie sa fie sizeof(*head).

VALOAREA RETURNATA
       Apelurile de sistem set_robust_list() <?>i get_robust_list() returneaza
       zero atunci cand opera<?>iunea este reu<?>ita, iar in caz contrar un
       cod de eroare.

ERORI-IE<?>IRE
       Apelul de sistem set_robust_list() poate e<?>ua cu urmatoarea eroare:

       EINVAL size nu este egala cu sizeof(struct robust_list_head).

       Apelul de sistem get_robust_list() poate e<?>ua cu urmatoarele erori:

       EFAULT Antetul listei futex robuste nu poate fi stocat in loca<?>ia
              head.

       EPERM  Procesul care face apelul nu are permisiunea de a vedea lista
              robusta futex a firului cu ID-ul firului pid <?>i nu are
              capacitatea CAP_SYS_PTRACE.

       ESRCH  Nu a putut fi gasit niciun fir cu ID-ul firului pid.

VERSIUNI
       Aceste apeluri de sistem au fost adaugate in Linux 2.6.17.

NOTE
       Aceste apeluri de sistem nu sunt necesare pentru aplica<?>iile normale.

       Un fir de execu<?>ie poate avea doar o singura lista de futex-uri
       robuste; prin urmare, aplica<?>iile care doresc sa utilizeze aceasta
       func<?>ionalitate ar trebui sa foloseasca mutex-urile robuste furnizate
       de glibc.

       In implementarea ini<?>iala, un fir de execu<?>ie care a<?>tepta un
       futex era notificat ca proprietarul acestuia a murit numai daca
       proprietarul se termina. Incepand cu Linux 2.6.28, notificarea a fost
       extinsa pentru a include cazul in care proprietarul efectueaza un
       execve(2).

       ID-urile de fire men<?>ionate in textul principal sunt ID-uri de fire
       kernel de tipul celor returnate de clone(2) <?>i gettid(2).

CONSULTA<?>I <?>I
       futex(2), pthread_mutexattr_setrobust(3)

       Documentation/robust-futexes.txt <?>i
       Documentation/robust-futex-ABI.txt in arborele sursa al nucleului Linux

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.15    17 mai 2025               get_robust_list(2)