getxattr.2, listxattr.2, removexattr.2, setxattr.2: Put errors under ERRORS secton
The errno values on these pages were listed in a nonstandard
way under the RETURN VALUE section. Put them in ERRORS sections.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
diff --git a/man2/getxattr.2 b/man2/getxattr.2
index 5638080..1300591 100644
--- a/man2/getxattr.2
+++ b/man2/getxattr.2
@@ -105,35 +105,30 @@
On failure, \-1 is returned and
.I errno
is set appropriately.
-.PP
-If the named attribute does not exist, or the process has no access to
-this attribute,
-.I errno
-is set to
-.BR ENOATTR .
+.SH ERRORS
+.TP
+.B ENOATTR
+The named attribute does not exist, or the process has no access to
+this attribute.
.RB ( ENOATTR
is defined to be a synonym for
.BR ENODATA
in
.IR <attr/xattr.h> .)
-.PP
-If the
+.TP
+.B ENOTSUP
+Extended attributes are not supported by the file system, or are disabled.
+.TP
+.B ERANGE
+The
.I size
of the
.I value
-buffer is too small to hold the result,
-.I errno
-is set to
-.BR ERANGE .
+buffer is too small to hold the result.
.PP
-If extended attributes are not supported by the file system, or are disabled,
-.I errno
-is set to
-.BR ENOTSUP .
-.PP
-The errors documented for the
+In addition, the errors documented in
.BR stat (2)
-system call are also applicable here.
+can also occur.
.SH VERSIONS
These system calls have been available on Linux since kernel 2.4;
glibc support is provided since version 2.3.
diff --git a/man2/listxattr.2 b/man2/listxattr.2
index 98507e0..6d41ece 100644
--- a/man2/listxattr.2
+++ b/man2/listxattr.2
@@ -123,24 +123,21 @@
On failure, \-1 is returned and
.I errno
is set appropriately.
-.PP
-If the
+.SH ERRORS
+.TP
+.B ENOTSUP
+Extended attributes are not supported by the file system, or are disabled.
+.TP
+.B ERANGE
+The
.I size
of the
.I list
-buffer is too small to hold the result,
-.I errno
-is set to
-.BR ERANGE .
+buffer is too small to hold the result.
.PP
-If extended attributes are not supported by the file system, or are disabled,
-.I errno
-is set to
-.BR ENOTSUP .
-.PP
-The errors documented for the
+In addition, the errors documented in
.BR stat (2)
-system call are also applicable here.
+can also occur.
.SH VERSIONS
These system calls have been available on Linux since kernel 2.4;
glibc support is provided since version 2.3.
diff --git a/man2/removexattr.2 b/man2/removexattr.2
index c920a73..2ce1503 100644
--- a/man2/removexattr.2
+++ b/man2/removexattr.2
@@ -82,25 +82,22 @@
On failure, \-1 is returned and
.I errno
is set appropriately.
-.PP
-If the named attribute does not exist,
-.I errno
-is set to
-.BR ENOATTR .
+.SH ERRORS
+.TP
+.B ENOATTR
+The named attribute does not exist.
.RB ( ENOATTR
is defined to be a synonym for
.BR ENODATA
in
.IR <attr/xattr.h> .)
+.TP
+.B ENOTSUP
+Extended attributes are not supported by the file system, or are disabled.
.PP
-If extended attributes are not supported by the file system, or are disabled,
-.I errno
-is set to
-.BR ENOTSUP .
-.PP
-The errors documented for the
+In addition, the errors documented in
.BR stat (2)
-system call are also applicable here.
+can also occur.
.SH VERSIONS
These system calls have been available on Linux since kernel 2.4;
glibc support is provided since version 2.3.
diff --git a/man2/setxattr.2 b/man2/setxattr.2
index 3ba886f..2b5e899 100644
--- a/man2/setxattr.2
+++ b/man2/setxattr.2
@@ -109,41 +109,37 @@
On failure, \-1 is returned and
.I errno
is set appropriately.
-.PP
-If
+.SH ERRORS
+.TP
+.B EDQUOT
+Disk quota limits meant that
+there is insufficient space remaining to store the extended attribute.
+.TP
+.B EEXIST
.B XATTR_CREATE
-is specified, and the attribute exists already,
-.I errno
-is set to
-.BR EEXIST .
-If
+was specified, and the attribute exists already.
+.TP
+.B ENOATTR
.B XATTR_REPLACE
-is specified, and the attribute does not exist,
-.I errno
-is set to
-.BR ENOATTR .
+was specified, and the attribute does not exist.
.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
-is set to either
-.BR ENOSPC ,
-or
-.B EDQUOT
-if quota enforcement was the cause.
-.PP
-If extended attributes are not supported by the file system, or are disabled,
+.TP
+.B ENOSPC
+There is insufficient space remaining to store the extended attribute.
+.TP
+.B ENOTSUP
+Extended attributes are not supported by the file system, or are disabled,
.I errno
is set to
.BR ENOTSUP .
.PP
-The errors documented for the
+In addition, the errors documented in
.BR stat (2)
-system call are also applicable here.
+can also occur.
.SH VERSIONS
These system calls have been available on Linux since kernel 2.4;
glibc support is provided since version 2.3.
