1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
|
.\"
.\" Extended attributes system calls manual pages
.\"
.\" (C) Andreas Gruenbacher, February 2001
.\" (C) Silicon Graphics Inc, September 2001
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.\" Traduction Christophe Blaess
.\" MJ 18/07/2003 - LDP-1.56
.TH GETXATTR 2 "18 juillet 2003" LDP "Manuel du programmeur Linux"
.SH NOM
getxattr, lgetxattr, fgetxattr \- Lire la valeur d'un attribut tendu.
.SH SYNOPSIS
.fam C
.nf
.B #include <sys/types.h>
.B #include <attr/xattr.h>
.sp
.BI "ssize_t getxattr (const char\ *" chemin ", const char\ *" nom ",
.BI "\t\t\t\t void\ *" valeur ", size_t " taille );
.BI "ssize_t lgetxattr (const char\ *" chemin ", const char\ *" nom ",
.BI "\t\t\t\t void\ *" valeur ", size_t " taille );
.BI "ssize_t fgetxattr (int " descripteur ", const char\ *" nom ",
.BI "\t\t\t\t void\ *" valeur ", size_t " taille );
.fi
.fam T
.SH DESCRIPTION
Les attributs tendus sont des paires
.IR nom :\c
.I valeur
associes aux i-noeuds (fichiers, rpertoires, liens symboliques, etc).
Ce sont des extensions des attributs normaux qui sont associs avec tous les
i-noeuds du systme (les informations renvoyes
par
.BR stat (2).
Une description complte des concepts d'attributs tendus est disponible dans
.BR attr (5).
.PP
.B getxattr
rcupre la
.I valeur
de l'attribut tendu identifi par le
.I nom
et associ au
.I chemin
donn dans le systme de fichiers.
La longueur de la
.I valeur
est renvoye.
.PP
.B lgetxattr
est identique
.BR getxattr ,
sauf dans le cas d'un lien symbolique, o il interroge le lien lui-mme
et non le fichier qu'il vise.
.PP
.B fgetxattr
est identique
.BR getxattr ,
seulement c'est le fichier ouvert indiqu par le
.I descripteur
(fourni par
.BR open (2))
qui est interrog la place du
.IR chemin .
.PP
Le
.I nom
d'un attribut tendu est une simple chane termine par un caractre nul.
Le nom inclut un prfixe d'espace de noms - il peut y avoir plusieurs espaces
de noms disjoints associs avec un i-noeud donn.
La valeur d'un attribut tendu est un bloc de donnes littrales ou binaires
d'une longueur donne.
.PP
Un buffer vide, de
.I taille
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
ncessaire pour contenir la valeur associe l'attribut
tendu.
.PP
L'interface est conue pour permettre de supposer une taille de buffer initiale
et de l'agrandir si la valeur renvoye indique
qu'il est trop petit.
.SH "VALEUR RENVOYE"
S'ils russissent, 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
avec un code d'erreur.
.PP
Si aucun attribut du nom indiqu n'existe, ou si le processus n'a pas accs
cet attribut,
.I errno
contient ENOATTR.
.PP
Si lae
.I taille
du buffer
.I value
est trop petite pour contenir le rsultat,
.I errno
contient ERANGE.
.PP
Si les attributs tendus ne sont pas suports par le systme de fichiers ou le noyau
.I errno
contient ENOTSUP.
.PP
Les erreurs documents pour l'appel-systme
.BR stat (2)
sont galement applicables ici.
.SH AUTEURS
Andreas Gruenbacher,
.RI < a.gruenbacher@computer.org >
et l'quipe de dveloppement SGI XFS,
.RI < linux-xfs@oss.sgi.com >.
Envoyez les rapports de bogues et les commentaires (en anglais) ces adresses.
.SH "VOIR AUSSI"
.BR getfattr (1),
.BR setfattr (1),
.BR open (2),
.BR stat (2),
.BR setxattr (2),
.BR listxattr (2),
.BR removexattr (2),
.BR attr (5)
.SH TRADUCTION
Christophe Blaess, 1996-2003.
|