readdir_r(3)               Library Functions Manual               readdir_r(3)

NUME
       readdir_r - cite<?>te un director

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <dirent.h>

       [[depreciat]] int readdir_r(DIR *restrict dirp,
                                    struct dirent *restrict entry,
                                    struct dirent **restrict result);

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

       readdir_r():
           _POSIX_C_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIERE
       Aceasta func<?>ie este depa<?>ita; utiliza<?>i in schimb readdir(3).

       Func<?>ia readdir_r() a fost inventata ca o versiune reentranta a
       readdir(3).  Aceasta cite<?>te urmatoarea intrare de director din
       fluxul de directoare dirp <?>i o returneaza in memoria tampon alocata
       de apelant, indicata de entry.  Pentru detalii privind structura
       dirent, a se vedea readdir(3).

       Un indicator la memoria tampon returnata este plasat in *result; daca a
       fost intalnit sfar<?>itul fluxului de directoare, atunci NULL este
       returnat in *result.

       Se recomanda ca aplica<?>iile sa utilizeze readdir(3) in loc de
       readdir_r().  In plus, incepand cu glibc 2.24, glibc depreciaza
       readdir_r().  Motivele sunt urmatoarele:

       o  In sistemele in care NAME_MAX este nedefinit, apelarea readdir_r()
          poate fi nesigura, deoarece interfa<?>a nu permite apelantului sa
          specifice lungimea memoriei tampon utilizate pentru intrarea de
          director returnata.

       o  Pe unele sisteme, readdir_r() nu poate citi intrarile de directoare
          cu nume foarte lungi.  Atunci cand implementarea glibc intalne<?>te
          un astfel de nume, readdir_r() e<?>ueaza cu eroarea ENAMETOOLONG
          dupa ce a fost citita ultima intrare de director.  Pe alte sisteme,
          readdir_r() poate returna o stare de succes, dar campul d_name
          returnat poate sa nu fie terminat la zero sau poate fi trunchiat.

       o  In specifica<?>ia POSIX.1 actuala (POSIX.1-2008), readdir(3) nu este
          necesar sa fie sigur pentru fire de execu<?>ie.  Cu toate acestea,
          in implementarile moderne (inclusiv in implementarea glibc),
          apelurile simultane la readdir(3) care specifica fluxuri de
          directoare diferite sunt sigure pentru fire.  Prin urmare,
          utilizarea lui readdir_r() nu este, in general, necesara in
          programele cu mai multe fire.  In cazurile in care mai multe fire de
          execu<?>ie trebuie sa citeasca din acela<?>i flux de directoare,
          utilizarea readdir(3) cu sincronizare externa este in continuare
          preferabila utilizarii readdir_r(), din motivele prezentate la
          punctele de mai sus.

       o  Se preconizeaza ca o versiune viitoare a POSIX.1 va face ca
          readdir_r() sa devina invechit <?>i va impune ca readdir(3) sa fie
          sigur pentru firele de execu<?>ie atunci cand este utilizat simultan
          pe diferite fluxuri de directoare.

VALOAREA RETURNATA
       Func<?>ia readdir_r() returneaza 0 in caz de succes.  In caz de eroare,
       aceasta returneaza un numar pozitiv de eroare (enumerat la rubrica
       ERRORI).  Daca se ajunge la sfar<?>itul fluxului de directoare,
       readdir_r() returneaza 0 <?>i returneaza NULL in *result.

ERORI-IE<?>IRE
       EBADF  Descriptor de flux de director nevalid dirp.

       ENAMETOOLONG
              A fost intalnita o intrare de director al carei nume era prea
              lung pentru a fi citit.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |readdir_r()                           | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001.

CONSULTA<?>I <?>I
       readdir(3)

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.06 31 octombrie 2023                  readdir_r(3)