NUME

       getxattr, lgetxattr, fgetxattr - recuperează valoarea unui atribut extins

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

REZUMAT

       #include <sys/xattr.h>

       ssize_t getxattr(const char *path, const char *name,
                        void value[.size], size_t size);
       ssize_t lgetxattr(const char *path, const char *name,
                        void value[.size], size_t size);
       ssize_t fgetxattr(int fd, const char *name,
                        void value[.size], size_t size);

DESCRIERE

       Atributele  extinse  sunt  perechi  nume:valoare  asociate  cu  noduri-i  (fișiere,  directoare, legături
       simbolice etc.).  Acestea sunt extensii ale atributelor normale care sunt asociate cu toate nodurile  din
       sistem  (de  exemplu,  datele stat(2)).  O prezentare completă a conceptelor de atribute extinse poate fi
       găsită în xattr(7).

       getxattr() recuperează valoarea atributului extins identificat prin  name  și  asociat  cu  path  dat  în
       sistemul  de  fișiere.   Valoarea  atributului  este  plasată  în  memoria tampon indicată de value; size
       specifică dimensiunea acestei memorii.  Valoarea de returnare a apelului este numărul de  octeți  plasați
       în value.

       lgetxattr()  este  identic  cu  getxattr(),  cu  excepția  cazului  unei  legături  simbolice, în care se
       interoghează legătura în sine, nu fișierul la care se referă.

       fgetxattr() este identic cu getxattr(), numai că fișierul deschis la care face referire fd  (returnat  de
       open(2)) este interogat în locul lui path.

       Un  atribut  extins name este un șir de caractere cu terminație nulă.  Numele include un prefix de spațiu
       de nume; pot exista mai multe spații de nume disjuncte asociate cu un nod-i  individual.   Valoarea  unui
       atribut  extins  este  o  bucată  de date textuale sau binare arbitrare care a fost atribuită cu ajutorul
       setxattr(2).

       Dacă size este specificată ca fiind zero, aceste apeluri returnează  dimensiunea  curentă  a  atributului
       extins  numit  (și lasă value neschimbată).  Acest lucru poate fi utilizat pentru a determina dimensiunea
       memoriei tampon care trebuie furnizată într-un apel ulterior; (dar, rețineți că există  posibilitatea  ca
       valoarea atributului să se schimbe între cele două apeluri, astfel încât este în continuare necesar să se
       verifice starea de returnare a celui de-al doilea apel).

VALOAREA RETURNATĂ

       În  caz de succes, aceste apeluri returnează o valoare nenegativă care reprezintă dimensiunea (în octeți)
       a valorii atributului extins.  În caz de eșec, se returnează -1, iar  errno  este  configurată  pentru  a
       indica eroarea.

ERORI

       E2BIG  Dimensiunea valorii atributului este mai mare decât dimensiunea maximă permisă; atributul nu poate
              fi  recuperat.   Acest  lucru se poate întâmpla în cazul sistemelor de fișiere care acceptă valori
              foarte mari ale atributelor, cum ar fi NFSv4, de exemplu.

       ENODATA
              Atributul numit nu există sau procesul nu are acces la acest atribut.

       ENOTSUP
              Atributele extinse nu sunt acceptate de sistemul de fișiere sau sunt dezactivate.

       ERANGE Valoarea (value) dimensiunii (size) a memoriei tampon este prea mică pentru a conține rezultatul.

       În plus, pot apărea și erorile documentate în stat(2).

VERSIUNI

       Aceste apeluri de sistem au fost disponibile începând cu Linux 2.4; suportul glibc este  oferit  începând
       cu glibc 2.3.

STANDARDE

       Aceste apeluri de sistem sunt specifice pentru Linux.

EXEMPLE

       A se vedea listxattr(2).

CONSULTAȚI ȘI

       getfattr(1),  setfattr(1),  listxattr(2),  open(2),  removexattr(2),  setxattr(2),  stat(2),  symlink(7),
       xattr(7)

TRADUCERE

       Traducerea   în   limba   română   a   acestui   manual   a   fost   creată   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.

Pagini de manual de Linux 6.03                  4 decembrie 2022                                     getxattr(2)