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>
diff --git a/man2/getxattr.2 b/man2/getxattr.2
index 86dfc89..5638080 100644
--- a/man2/getxattr.2
+++ b/man2/getxattr.2
@@ -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 @@
.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
diff --git a/man2/removexattr.2 b/man2/removexattr.2
index aae3e66..c920a73 100644
--- a/man2/removexattr.2
+++ b/man2/removexattr.2
@@ -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 @@
.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
diff --git a/man2/setxattr.2 b/man2/setxattr.2
index 3c03418..3ba886f 100644
--- a/man2/setxattr.2
+++ b/man2/setxattr.2
@@ -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 @@
.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
