summaryrefslogtreecommitdiff
path: root/man/man3/attr_set.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/man3/attr_set.3')
-rw-r--r--man/man3/attr_set.340
1 files changed, 19 insertions, 21 deletions
diff --git a/man/man3/attr_set.3 b/man/man3/attr_set.3
index 567ba74..fbf8ad9 100644
--- a/man/man3/attr_set.3
+++ b/man/man3/attr_set.3
@@ -7,19 +7,19 @@ attr_set, attr_setf \- set the value of a user attribute of a filesystem object
.nf
.B #include <attr/attributes.h>
.sp
-.B "int attr_set (const char **path, const char **attrname, "
-.B " const char **attrvalue, const int valuelength,"
-.B " int flags);"
+.B "int attr_set (const char **\f2path\f3, const char **\f2attrname\f3, "
+.B " const char **\f2attrvalue\f3, const int \f2valuelength\f3,"
+.B " int \f2flags\f3);"
.PP
-.B "int attr_setf (int fd, const char **attrname, "
-.B " const char **attrvalue, const int valuelength,"
-.B " int flags);"
+.B "int attr_setf (int \f2fd\f3, const char **\f2attrname\f3, "
+.B " const char **\f2attrvalue\f3, const int \f2valuelength\f3,"
+.B " int \f2flags\f3);"
.Op
.SH DESCRIPTION
The
-.I attr_set
+.B attr_set
and
-.I attr_setf
+.B attr_setf
functions provide a way to create attributes and set/change their values.
.P
.I Path\^
@@ -57,7 +57,7 @@ address space.
Do not follow symbolic links when resolving a
.I path
on an
-.I attr_set
+.B attr_set
function call.
The default is to follow symbolic links.
.TP
@@ -68,7 +68,7 @@ already exists on the indicated filesystem object,
otherwise create an attribute with the given name and value.
This flag is used to implement a pure create operation,
without this flag
-.I attr_set
+.B attr_set
will create the attribute if it does not already exist.
An error (EINVAL) will be returned if both ATTR_CREATE and ATTR_REPLACE
are set in the same call.
@@ -80,12 +80,12 @@ does not already exist on the indicated filesystem object,
otherwise replace the existing attribute\'s value with the given value.
This flag is used to implement a pure replacement operation,
without this flag
-.I attr_set
+.B attr_set
will create the attribute if it does not already exist.
An error (EINVAL) will be returned if both ATTR_CREATE and ATTR_REPLACE
are set in the same call.
.PP
-.I attr_set
+.B attr_set
will fail if one or more of the following are true:
.TP 17
.SM
@@ -158,7 +158,7 @@ or a pathname component is longer than
.SM
.RI { MAXNAMELEN }.
.PP
-.I attr_setf\^
+.B attr_setf\^
will fail if:
.TP 15
.SM
@@ -196,16 +196,14 @@ points outside the allocated address space of the process.
\%[EBADF]
.I Fd\^
does not refer to a valid descriptor.
-.SH "SEE ALSO"
-attr(1),
-.br
-attr_get(3), attr_getf(3),
-.br
-attr_multi(3), attr_multif(3),
-.br
-attr_remove(3), attr_removef(3),
.SH "DIAGNOSTICS"
Upon successful completion, a value of 0 is returned.
Otherwise, a value of \-1 is returned and
.I errno\^
is set to indicate the error.
+.SH "SEE ALSO"
+.BR attr (1),
+.BR attr_get (3),
+.BR attr_multi (3),
+and
+.BR attr_remove (3).