getxattr(2) System Calls Manual getxattr(2) NOM getxattr, lgetxattr, fgetxattr - Lire la valeur d'un attribut etendu BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #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); DESCRIPTION Les attributs etendus sont des paires nom:valeur associees aux inoeuds (fichiers, repertoires, liens symboliques, etc.). Ce sont des extensions des attributs normaux qui sont associes avec tous les inoeuds du systeme (les informations renvoyees par stat(2). Une description complete des concepts d'attributs etendus est disponible dans xattr(7). getxattr() recupere la valeur de l'attribut etendu identifie par le nom et associe au chemin donne dans le systeme de fichiers. La valeur de l'attribut est placee dans le tampon vers lequel pointe valeur ; taille indique la taille du tampon. Le code de retour de l'appel est le nombre d'octets places dans valeur. lgetxattr() est identique a getxattr(), sauf dans le cas d'un lien symbolique, ou il interroge le lien lui-meme et non le fichier qu'il vise. fgetxattr() est identique a getxattr(), seulement c'est le fichier ouvert indique par le descripteur (fourni par open(2)) qui est interroge a la place du chemin. Un attribut etendu nom est une chaine qui se termine par un octet nul. Le nom inclut un prefixe d'espace de noms - il peut y avoir plusieurs espaces de noms disjoints associes avec un inoeud donne. La valeur d'un attribut etendu est un bloc de donnees litterales ou binaires arbitraires assignees en utilisant setxattr(2). Si taille est indiquee comme etant zero, ces appels renvoient la taille actuelle de l'attribut etendu nomme (et laissent valeur inchangee). Cela peut etre utilise pour determiner la taille du tampon a fournir dans un tampon subsequent (mais gardez a l'esprit qu'il existe une possibilite que la valeur de l'attribut change entre les deux appels, il est donc necessaire de verifier l'etat de retour du second appel). VALEUR RENVOYEE S'ils reussissent, ces appels renvoient un nombre positif correspondant a la taille de la valeur de l'attribut etendu (en octets). En cas d'echec, ils renvoient -1 et positionnent errno pour indiquer l'erreur. ERREURS E2BIG La taille de la valeur de l'attribut est superieure a la taille maximale autorisee ; l'attribut ne peut pas etre recupere. Cela peut arriver sur des systemes de fichiers qui gerent de tres grandes valeurs d'attributs comme, par exemple, NFSv4. ENODATA L'attribut indique n'existe pas, ou le processus n'a pas acces a cet attribut. ENOTSUP Les attributs etendus ne sont pas pris en charge par le systeme de fichiers ou sont desactives. ERANGE La taille du tampon value est trop petite pour contenir le resultat. De plus, les erreurs documentees dans stat(2) peuvent aussi survenir. STANDARDS Linux. HISTORIQUE Linux 2.4, glibc 2.3. EXEMPLES Voir listxattr(2). VOIR AUSSI getfattr(1), setfattr(1), listxattr(2), open(2), removexattr(2), setxattr(2), stat(2), symlink(7), xattr(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 getxattr(2)