getxattr(2) System Calls Manual getxattr(2) NUME getxattr, lgetxattr, fgetxattr - recupereaza valoarea unui atribut extins BIBLIOTECA Biblioteca C standard (libc, -lc) REZUMAT #include 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 (fiiere, directoare, legaturi simbolice etc.). Acestea sunt extensii ale atributelor normale care sunt asociate cu toate nodurile din sistem (de exemplu, datele stat(2)). O prezentare completa a conceptelor de atribute extinse poate fi gasita in xattr(7). getxattr() recupereaza valoarea atributului extins identificat prin name i asociat cu path dat in sistemul de fiiere. Valoarea atributului este plasata in memoria tampon indicata de value; size specifica dimensiunea acestei memorii. Valoarea de returnare a apelului este numarul de octei plasai in value. lgetxattr() este identic cu getxattr(), cu excepia cazului unei legaturi simbolice, in care se interogheaza legatura in sine, nu fiierul la care se refera. fgetxattr() este identic cu getxattr(), numai ca fiierul deschis la care face referire fd (returnat de open(2)) este interogat in locul lui path. Un atribut extins name este un ir de caractere cu terminaie nula. Numele include un prefix de spaiu de nume; pot exista mai multe spaii de nume disjuncte asociate cu un nod-i individual. Valoarea unui atribut extins este o bucata de date textuale sau binare arbitrare care a fost atribuita cu ajutorul setxattr(2). Daca size este specificata ca fiind zero, aceste apeluri returneaza dimensiunea curenta a atributului extins numit (i lasa value neschimbata). Acest lucru poate fi utilizat pentru a determina dimensiunea memoriei tampon care trebuie furnizata intr-un apel ulterior; (dar, reinei ca exista posibilitatea ca valoarea atributului sa se schimbe intre cele doua apeluri, astfel incat este in continuare necesar sa se verifice starea de returnare a celui de-al doilea apel). VALOAREA RETURNATA In caz de succes, aceste apeluri returneaza o valoare nenegativa care reprezinta dimensiunea (in octei) a valorii atributului extins. In caz de eec, se returneaza -1, iar errno este configurata pentru a indica eroarea. ERORI-IEIRE E2BIG Dimensiunea valorii atributului este mai mare decat dimensiunea maxima permisa; atributul nu poate fi recuperat. Acest lucru se poate intampla in cazul sistemelor de fiiere care accepta valori foarte mari ale atributelor, cum ar fi NFSv4, de exemplu. ENODATA Atributul numit nu exista sau procesul nu are acces la acest atribut. ENOTSUP Atributele extinse nu sunt acceptate de sistemul de fiiere sau sunt dezactivate. ERANGE Valoarea (value) dimensiunii (size) a memoriei tampon este prea mica pentru a conine rezultatul. In plus, pot aparea i erorile documentate in stat(2). STANDARDE Linux. ISTORIC Linux 2.4, glibc 2.3. EXEMPLE A se vedea listxattr(2). CONSULTAI I getfattr(1), setfattr(1), listxattr(2), open(2), removexattr(2), setxattr(2), stat(2), symlink(7), xattr(7) TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . Pagini de manual de Linux 6.06 31 octombrie 2023 getxattr(2)