getxattr, lgetxattr, fgetxattr - Lire la valeur d'un attribut étendu
Bibliothèque C standard (
libc,
-lc)
#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);
Les attributs étendus sont des paires
nom:
valeur
associées aux inœuds (fichiers, répertoires, liens
symboliques, etc.). Ce sont des extensions des attributs normaux qui
sont associés avec tous les inœuds du système (les
informations renvoyées par
stat(2). Une description
complète des concepts d'attributs étendus est disponible dans
xattr(7).
getxattr() récupère la valeur de l'attribut étendu
identifié par le
nom et associé au
chemin
donné dans le système de fichiers. La valeur de l'attribut est
placée 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 placés dans
valeur.
lgetxattr() est identique à
getxattr(), sauf dans le cas
d'un lien symbolique, où il interroge le lien lui-même et non le
fichier qu'il vise.
fgetxattr() est identique à
getxattr(), seulement c'est le
fichier ouvert indiqué par le
descripteur (fourni par
open(2)) qui est interrogé à la place du
chemin.
Un attribut étendu
nom est une chaîne qui se termine par un
octet nul. Le nom inclut un préfixe d'espace de noms - il peut y avoir
plusieurs espaces de noms disjoints associés avec un inœud
donné. La valeur d'un attribut étendu est un bloc de
données littérales ou binaires arbitraires assignées en
utilisant
setxattr(2).
Si
taille est indiquée comme étant zéro, ces appels
renvoient la taille actuelle de l'attribut étendu nommé (et
laissent
valeur inchangée). Cela peut être utilisé
pour déterminer la taille du tampon à fournir dans un tampon
subséquent (mais gardez à l'esprit qu'il existe une
possibilité que la valeur de l'attribut change entre les deux appels,
il est donc nécessaire de vérifier l'état de retour du
second appel).
S'ils réussissent, ces appels renvoient un nombre positif correspondant
à la taille de la valeur de l'attribut étendu (en octets). En
cas d'échec, ils renvoient
-1 et positionnent
errno pour
indiquer l'erreur.
- E2BIG
- La taille de la valeur de l'attribut est supérieure
à la taille maximale autorisée ; l'attribut ne peut
pas être récupéré. Cela peut arriver sur des
systèmes de fichiers qui gèrent de très grandes
valeurs d'attributs comme, par exemple, NFSv4.
- ENODATA
- L'attribut indiqué n'existe pas, ou le processus n'a
pas accès à cet attribut.
- ENOTSUP
- Les attributs étendus ne sont pas pris en charge par
le système de fichiers ou sont désactivés.
- ERANGE
- La taille du tampon value est trop petite
pour contenir le résultat.
De plus, les erreurs documentées dans
stat(2) peuvent aussi
survenir.
Ces appels système sont disponibles depuis Linux 2.4 ; la
gestion de la glibc est fournie depuis la glibc 2.3.
Ces appels système sont spécifiques à Linux.
Voir
listxattr(2).
getfattr(1),
setfattr(1),
listxattr(2),
open(2),
removexattr(2),
setxattr(2),
stat(2),
symlink(7),
xattr(7)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Jean-Philippe MENGUAL <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]