getxattr.2, removexattr.2, setxattr.2: Note that ENOATTR is a synonym for ENODATA

Various people have pointed out that strace(1) shows ENODATA
for the case where the named attribute does not exist, or
the process has no access to this attribute. ENODATA
and ENOATTR are in fact defined as synonyms. Point this out
in the man page, so that people understand the strace(1) info.

See https://bugzilla.kernel.org/show_bug.cgi?id=51871

Reported-by: Andrew Perepechko <andrew_perepechko@xyratex.com>
Reported-by: <starlight.2013q1@binnacle.cx>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2013-01-18 23:29:28 +01:00
parent 37f02e322c
commit 2965fbf165
3 changed files with 18 additions and 3 deletions

View File

@ -24,7 +24,7 @@
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.TH GETXATTR 2 2001-12-01 "Linux" "Linux Programmer's Manual"
.TH GETXATTR 2 2013-01-19 "Linux" "Linux Programmer's Manual"
.SH NAME
getxattr, lgetxattr, fgetxattr \- retrieve an extended attribute value
.SH SYNOPSIS
@ -111,6 +111,11 @@ this attribute,
.I errno
is set to
.BR ENOATTR .
.RB ( ENOATTR
is defined to be a synonym for
.BR ENODATA
in
.IR <attr/xattr.h> .)
.PP
If the
.I size

View File

@ -24,7 +24,7 @@
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.TH REMOVEXATTR 2 2001-12-01 "Linux" "Linux Programmer's Manual"
.TH REMOVEXATTR 2 2013-01-19 "Linux" "Linux Programmer's Manual"
.SH NAME
removexattr, lremovexattr, fremovexattr \- remove an extended attribute
.SH SYNOPSIS
@ -87,6 +87,11 @@ If the named attribute does not exist,
.I errno
is set to
.BR ENOATTR .
.RB ( ENOATTR
is defined to be a synonym for
.BR ENODATA
in
.IR <attr/xattr.h> .)
.PP
If extended attributes are not supported by the file system, or are disabled,
.I errno

View File

@ -24,7 +24,7 @@
.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
.\" USA.
.\"
.TH SETXATTR 2 2001-12-31 "Linux" "Linux Programmer's Manual"
.TH SETXATTR 2 2013-01-19 "Linux" "Linux Programmer's Manual"
.SH NAME
setxattr, lsetxattr, fsetxattr \- set an extended attribute value
.SH SYNOPSIS
@ -122,6 +122,11 @@ is specified, and the attribute does not exist,
.I errno
is set to
.BR ENOATTR .
.RB ( ENOATTR
is defined to be a synonym for
.BR ENODATA
in
.IR <attr/xattr.h> .)
.PP
If there is insufficient space remaining to store the extended attribute,
.I errno