summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/extattr_get_file.2
diff options
context:
space:
mode:
authortrhodes <trhodes@FreeBSD.org>2008-01-29 18:15:38 +0000
committertrhodes <trhodes@FreeBSD.org>2008-01-29 18:15:38 +0000
commit46c986723be8ba3b655706aef0c13422aa6cfa5a (patch)
tree8467081b66b21ab9d7d4d31395214001f4b16705 /lib/libc/sys/extattr_get_file.2
parent050f1fe2976b266b02140b04a20f11259ebcd949 (diff)
downloadFreeBSD-src-46c986723be8ba3b655706aef0c13422aa6cfa5a.zip
FreeBSD-src-46c986723be8ba3b655706aef0c13422aa6cfa5a.tar.gz
Update this manual page to describe the extattr_list_file() and the
extattr_list_fd() functions. PR: 108142 Submitted by: Richard Dawe <rich@phekda.gotadsl.co.uk> Reviewed by: kientzle
Diffstat (limited to 'lib/libc/sys/extattr_get_file.2')
-rw-r--r--lib/libc/sys/extattr_get_file.219
1 files changed, 13 insertions, 6 deletions
diff --git a/lib/libc/sys/extattr_get_file.2 b/lib/libc/sys/extattr_get_file.2
index 6fd2a18..e8faa13 100644
--- a/lib/libc/sys/extattr_get_file.2
+++ b/lib/libc/sys/extattr_get_file.2
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd February 23, 2005
+.Dd January 29, 2008
.Dt EXTATTR 2
.Os
.Sh NAME
@@ -120,6 +120,8 @@ is
.Dv NULL
in a call to
.Fn extattr_get_file
+and
+.Fn extattr_list_file
then the size of defined extended attribute data will be returned, rather
than the quantity read, permitting applications to test the size of the
data without performing a read.
@@ -134,8 +136,9 @@ they do not follow symlinks.
The
.Fn extattr_get_fd ,
.Fn extattr_set_fd ,
+.Fn extattr_delete_fd ,
and
-.Fn extattr_delete_fd
+.Fn extattr_list_fd ,
calls are identical to their
.Qq Li _file
counterparts except for the first argument.
@@ -170,9 +173,10 @@ change as applications are adapted to use it.
Developers are discouraged from relying on its stability.
.Sh RETURN VALUES
If successful, the
-.Fn extattr_get_file
+.Fn extattr_get_file ,
+.Fn extattr_set_file ,
and
-.Fn extattr_set_file
+.Fn extattr_list_file
calls return the number of bytes
that were read or written from the
.Fa data ,
@@ -182,7 +186,9 @@ was
.Dv NULL ,
then
.Fn extattr_get_file
-returns the number of bytes available to read.
+and
+.Fn extattr_list_file
+return the number of bytes available to read.
If any of the calls are unsuccessful, the value \-1 is returned
and the global variable
.Va errno
@@ -213,8 +219,9 @@ The attribute name was longer than
The
.Fn extattr_get_fd ,
.Fn extattr_set_fd ,
+.Fn extattr_delete_fd ,
and
-.Fn extattr_delete_fd
+.Fn extattr_list_fd
system calls may also fail if:
.Bl -tag -width Er
.It Bq Er EBADF
OpenPOWER on IntegriCloud