getxattr.2, listxattr.2, removexattr.2, setxattr.2: Put errors under ERRORS sectonHEADmaster

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>

4 files changed, 52 insertions, 67 deletions

diff --git a/man2/getxattr.2 b/man2/getxattr.2
index 5638080a0b..1300591571 100644
--- a/man2/getxattr.2
+++ b/man2/getxattr.2
@@ -105,35 +105,30 @@ extended attribute value.
 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 .
-.PP
-If extended attributes are not supported by the file system, or are disabled,
-.I errno
-is set to
-.BR ENOTSUP .
+buffer is too small to hold the result.
 .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 98507e01a3..6d41eceb05 100644
--- a/man2/listxattr.2
+++ b/man2/listxattr.2
@@ -123,24 +123,21 @@ extended attribute name list.
 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 .
-.PP
-If extended attributes are not supported by the file system, or are disabled,
-.I errno
-is set to
-.BR ENOTSUP .
+buffer is too small to hold the result.
 .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 c920a7362b..2ce1503189 100644
--- a/man2/removexattr.2
+++ b/man2/removexattr.2
@@ -82,25 +82,22 @@ On success, zero is returned.
 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 3ba886fdd3..2b5e899b5c 100644
--- a/man2/setxattr.2
+++ b/man2/setxattr.2
@@ -109,41 +109,37 @@ On success, zero is returned.
 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.