.\" -*- coding: UTF-8 -*- .\" Copyright (C) Andreas Gruenbacher, February 2001 .\" Copyright (C) Silicon Graphics Inc, September 2001 .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getxattr 2 "2 mai 2024" "Pagini de manual de Linux 6.8" .SH NUME getxattr, lgetxattr, fgetxattr \- recuperează valoarea unui atribut extins .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBssize_t getxattr(const char *\fP\fIpath\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIvalue\fP\fB[.\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP \fBssize_t lgetxattr(const char *\fP\fIpath\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIvalue\fP\fB[.\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP \fBssize_t fgetxattr(int \fP\fIfd\fP\fB, const char *\fP\fIname\fP\fB,\fP \fB void \fP\fIvalue\fP\fB[.\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP .fi .SH DESCRIERE Atributele extinse sunt perechi \fInume\fP:\fIvaloare\fP 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 \fBstat\fP(2)). O prezentare completă a conceptelor de atribute extinse poate fi găsită în \fBxattr\fP(7). .P \fBgetxattr\fP() recuperează valoarea atributului extins identificat prin \fIname\fP și asociat cu \fIpath\fP dat în sistemul de fișiere. Valoarea atributului este plasată în memoria tampon indicată de \fIvalue\fP; \fIsize\fP specifică dimensiunea acestei memorii. Valoarea de returnare a apelului este numărul de octeți plasați în \fIvalue\fP. .P \fBlgetxattr\fP() este identic cu \fBgetxattr\fP(), cu excepția cazului unei legături simbolice, în care se interoghează legătura în sine, nu fișierul la care se referă. .P \fBfgetxattr\fP() este identic cu \fBgetxattr\fP(), numai că fișierul deschis la care face referire \fIfd\fP (returnat de \fBopen\fP(2)) este interogat în locul lui \fIpath\fP. .P Un atribut extins \fIname\fP 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 \fBsetxattr\fP(2). .P Dacă \fIsize\fP este specificată ca fiind zero, aceste apeluri returnează dimensiunea curentă a atributului extins numit (și lasă \fIvalue\fP 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). .SH "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 \fIerrno\fP este configurată pentru a indica eroarea. .SH ERORI\-IEȘIRE .TP \fBE2BIG\fP 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. .TP \fBENODATA\fP .\" .RB ( ENOATTR .\" is defined to be a synonym for .\" .BR ENODATA .\" in .\" .IR .) Atributul numit nu există sau procesul nu are acces la acest atribut. .TP \fBENOTSUP\fP Atributele extinse nu sunt acceptate de sistemul de fișiere sau sunt dezactivate. .TP \fBERANGE\fP \fIValoarea\fP (value) \fIdimensiunii\fP (size) a memoriei tampon este prea mică pentru a conține rezultatul. .P În plus, pot apărea și erorile documentate în \fBstat\fP(2). .SH STANDARDE Linux. .SH ISTORIC .\" .SH AUTHORS .\" Andreas Gruenbacher, .\" .RI < a.gruenbacher@computer.org > .\" and the SGI XFS development team, .\" .RI < linux-xfs@oss.sgi.com >. .\" Please send any bug reports or comments to these addresses. Linux 2.4, glibc 2.3. .SH EXEMPLE A se vedea \fBlistxattr\fP(2). .SH "CONSULTAȚI ȘI" \fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBlistxattr\fP(2), \fBopen\fP(2), \fBremovexattr\fP(2), \fBsetxattr\fP(2), \fBstat\fP(2), \fBsymlink\fP(7), \fBxattr\fP(7) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .