LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

setxattr.2: Rework text describing 'flags' argument 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2015-01-26 09:40:01 +01:00
parent 60da5b89a7
commit 9398702ca2
1 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
man2/setxattr.2
View File

@ -91,18 +91,21 @@ The
of an extended attribute is a chunk of arbitrary textual or
binary data of specified length.
.PP
The
.I flags
argument can be used to modify the semantics of the operation.
.B XATTR_CREATE
specifies a pure create, which fails if the named
attribute exists already.
.B XATTR_REPLACE
specifies a pure replace operation, which fails if the
named attribute does not already exist.
By default (no flags),
By default
(i.e.,
.IR flags
is zero),
the extended attribute will be created if it does not exist,
or the value will be replaced if the attribute already exists.
To modify these semantics, one of the following values can be specified in
.IR flags :
.TP
.B XATTR_CREATE
Perform a pure create, which fails if the named attribute exists already.
.TP
.B XATTR_REPLACE
Perform a pure replace operation,
which fails if the named attribute does not already exist.
.SH RETURN VALUE
On success, zero is returned.
On failure, \-1 is returned and