File: getxattr.2

package info (click to toggle)
manpages-fr 1.58.1-3
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 10,104 kB
  • ctags: 4
  • sloc: makefile: 106; sh: 8
file content (147 lines) | stat: -rw-r--r-- 4,467 bytes parent folder | download
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.