diff options
author | trhodes <trhodes@FreeBSD.org> | 2008-01-29 18:15:38 +0000 |
---|---|---|
committer | trhodes <trhodes@FreeBSD.org> | 2008-01-29 18:15:38 +0000 |
commit | 46c986723be8ba3b655706aef0c13422aa6cfa5a (patch) | |
tree | 8467081b66b21ab9d7d4d31395214001f4b16705 /lib/libc/sys/extattr_get_file.2 | |
parent | 050f1fe2976b266b02140b04a20f11259ebcd949 (diff) | |
download | FreeBSD-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.2 | 19 |
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 |