Add brief mention of the extattr_*_link() system call variants.

Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, Network Associates Laboratories
This commit is contained in:
Robert Watson 2002-10-09 22:26:48 +00:00
parent 4f4c431d9b
commit cc7a6f19d0

View File

@ -35,6 +35,9 @@
.Nm extattr_get_file , .Nm extattr_get_file ,
.Nm extattr_set_file , .Nm extattr_set_file ,
.Nm extattr_delete_file .Nm extattr_delete_file
.Nm extattr_get_link ,
.Nm extattr_set_link ,
.Nm extattr_delete_link
.Nd system calls to manipulate VFS extended attributes .Nd system calls to manipulate VFS extended attributes
.Sh LIBRARY .Sh LIBRARY
.Lb libc .Lb libc
@ -54,6 +57,12 @@
.Fn extattr_set_file "const char *path" "int attrnamespace" "const char *attrname" "const void *data" "size_t nbytes" .Fn extattr_set_file "const char *path" "int attrnamespace" "const char *attrname" "const void *data" "size_t nbytes"
.Ft int .Ft int
.Fn extattr_delete_file "const char *path" "int attrnamespace" "const char *attrname" .Fn extattr_delete_file "const char *path" "int attrnamespace" "const char *attrname"
.Ft ssize_t
.Fn extattr_get_link "const char *path" "int attrnamespace" "const char *attrname" "void *data" "size_t nbytes"
.Ft int
.Fn extattr_set_link "const char *path" "int attrnamespace" "const char *attrname" "const void *data" "size_t nbytes"
.Ft int
.Fn extattr_delete_link "const char *path" "int attrnamespace" "const char *attrname"
.Sh DESCRIPTION .Sh DESCRIPTION
Named extended attributes are meta-data associated with vnodes Named extended attributes are meta-data associated with vnodes
representing files and directories. representing files and directories.
@ -97,6 +106,13 @@ in a call to
then the size of defined extended attribute data will be returned, rather then the size of defined extended attribute data will be returned, rather
than the quantity read, permitting applications to test the size of the than the quantity read, permitting applications to test the size of the
data without performing a read. data without performing a read.
The
.Fn extattr_delete_link ,
.Fn extattr_get_link ,
and
.Fn extattr_set_link
functions behave in the same way as their _file counterparts, except that
they do not follow symlinks.
.Pp .Pp
The The
.Fn extatttr_get_fd , .Fn extatttr_get_fd ,