aboutsummaryrefslogtreecommitdiff
path: root/share/man/man9/VOP_GETEXTATTR.9
diff options
context:
space:
mode:
authorChad David <davidc@FreeBSD.org>2002-04-12 04:26:15 +0000
committerChad David <davidc@FreeBSD.org>2002-04-12 04:26:15 +0000
commit94552cece2a3610d3e52a73a0dc5b0ae00560d01 (patch)
tree9d52c831b042fb2f36c102942b497c51bb029d0a /share/man/man9/VOP_GETEXTATTR.9
parentac05f754382298b00d3d13ae7562f4723f5f46f7 (diff)
Document the new size parameter.
Notes
Notes: svn path=/head/; revision=94476
Diffstat (limited to 'share/man/man9/VOP_GETEXTATTR.9')
-rw-r--r--share/man/man9/VOP_GETEXTATTR.926
1 files changed, 23 insertions, 3 deletions
diff --git a/share/man/man9/VOP_GETEXTATTR.9 b/share/man/man9/VOP_GETEXTATTR.9
index 49957db2ceab..257f66b9ba2f 100644
--- a/share/man/man9/VOP_GETEXTATTR.9
+++ b/share/man/man9/VOP_GETEXTATTR.9
@@ -36,13 +36,21 @@
.In sys/vnode.h
.In sys/extattr.h
.Ft int
-.Fn VOP_GETEXTATTR "struct vnode *vp" "int attrnamespace" "const char *name" "struct uio *uio" "struct ucred *cred" "struct thread *td"
+.Fo VOP_GETEXTATTR
+.Fa "struct vnode *vp"
+.Fa "int attrnamespace"
+.Fa "const char *name"
+.Fa "struct uio *uio"
+.Fa "size_t *size"
+.Fa "struct ucred *cred"
+.Fa "struct thread *td"
+.Fc
.Sh DESCRIPTION
This vnode call may be used to retrieve a specific named extended attribute
from a file or directory.
.Pp
Its arguments are:
-.Bl -tag -width type
+.Bl -tag -width ".Fa attrnamespace"
.It Fa vp
the vnode of the file or directory
.It Ar attrnamespace
@@ -51,7 +59,19 @@ name is present in
.It Fa name
pointer to a null-terminated character string containing the attribute name
.It Fa uio
-the location of the data to be read or written
+the location of the data to be read
+.It Fa size
+if not
+.Dv NULL ,
+on return it will contain the number of bytes required to read all of the
+attribute data.
+In most cases
+.Fa uio
+will be
+.Dv NULL
+when
+.Fa size
+is not, and vise versa.
.It Fa cred
the user credentials to use in authorizing the request
.It Fa td