Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getxattr, lgetxattr, fgetxattr - Lire la valeur d'un attribut étendu. [size=18] [b]Résumé[/b] [/size] .fam C .nf [b]#include <sys/types.h>[/b] [b]#include <attr/xattr.h>[/b] [b][i]ssize_t getxattr (const char * chemin , const char * nom ,[/i][/b] [b][i]tttt void * valeur , size_t taille );[/i][/b] [b][i]ssize_t lgetxattr (const char * chemin , const char * nom ,[/i][/b] [b][i]tttt void * valeur , size_t taille );[/i][/b] [b][i]ssize_t fgetxattr (int descripteur , const char * nom ,[/i][/b] [b][i]tttt void * valeur , size_t taille );[/i][/b] .fi .fam T [size=18] [b]Description[/b] [/size] Les attributs étendus sont des paires [b]nom :c[/b] [i]valeur[/i] associées aux i-noeuds (fichiers, répertoires, liens symboliques, etc). Ce sont des extensions des attributs normaux qui sont associés avec tous les i-noeuds du système (les informations renvoyées par [b]stat (2).[/b] Une description complète des concepts d'attributs étendus est disponible dans [b]attr (5).[/b] [b]getxattr[/b] récupère la [i]valeur[/i] de l'attribut étendu identifié par le [i]nom[/i] et associé au [i]chemin[/i] donné dans le système de fichiers. La longueur de la [i]valeur[/i] est renvoyée. [b]lgetxattr[/b] est identique à [b]getxattr ,[/b] sauf dans le cas d'un lien symbolique, où il interroge le lien lui-même et non le fichier qu'il vise. [b]fgetxattr[/b] est identique à [b]getxattr ,[/b] seulement c'est le fichier ouvert indiqué par le [i]descripteur[/i] (fourni par [b]open (2))[/b] qui est interrogé à la place du [b]chemin .[/b] Le [i]nom[/i] d'un attribut étendu est une simple chaîne terminée par un caractère nul. Le nom inclut un préfixe d'espace de noms - il peut y avoir plusieurs espaces de noms disjoints associés avec un i-noeud donné. La valeur d'un attribut étendu est un bloc de données littérales ou binaires d'une longueur donnée. Un buffer vide, de [i]taille[/i] nulle peut être transmis à ses appels, pour qu'ils renvoient la taille actuelle de l'attribut étendu indiqué, ce qui permet d'estimer la taille de buffer nécessaire pour contenir la valeur associée à l'attribut étendu. L'interface est conçue pour permettre de supposer une taille de buffer initiale et de l'agrandir si la valeur renvoyée indique qu'il est trop petit. [size=18] [b]Valeur renvoyée[/b] [/size] S'ils réussissent, ces appels renvoient un nombre positif correspondant à la taille de la valeur de l'attribut étendu. En cas d'échec, ils renvoient -1 et remplissent [i]errno[/i] avec un code d'erreur. Si aucun attribut du nom indiqué n'existe, ou si le processus n'a pas accès à cet attribut, [i]errno[/i] contient ENOATTR. Si lae [i]taille[/i] du buffer [i]value[/i] est trop petite pour contenir le résultat, [i]errno[/i] contient ERANGE. Si les attributs étendus ne sont pas suportés par le système de fichiers ou le noyau [i]errno[/i] contient ENOTSUP. Les erreurs documentés pour l'appel-système [b]stat (2)[/b] sont également applicables ici. [size=18] [b]Auteurs[/b] [/size] Andreas Gruenbacher, [i]< a.gruenbacher@computer.org >[/i] et l'équipe de développement SGI XFS, [i]< linux-xfs@oss.sgi.com >.[/i] Envoyez les rapports de bogues et les commentaires (en anglais) à ces adresses. [size=18] [b]Voir aussi[/b] [/size] [b]getfattr (1),[/b] [b]setfattr (1),[/b] [b]open (2),[/b] [b]stat (2),[/b] [b]setxattr (2),[/b] [b]listxattr (2),[/b] [b]removexattr (2),[/b] [b]attr (5)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier