iconv.1, locale.1, memusage.1, memusagestat.1, pldd.1, sprof.1, _syscall.2, add_key...

[thirdparty/man-pages.git] / man2 / getxattr.2

diff --git a/man2/getxattr.2 b/man2/getxattr.2
index 83945fed104978e3be3d2ffbe25787f1421e0d93..5e3c54bf1562eadbcba25822287f6945775d62bd 100644 (file)
--- a/man2/getxattr.2
+++ b/man2/getxattr.2
@@ -22,7 +22,7 @@
 .\" <http://www.gnu.org/licenses/>.
 .\" %%%LICENSE_END
 .\"
-.TH GETXATTR 2 2015-05-07 "Linux" "Linux Programmer's Manual"
+.TH GETXATTR 2 2020-06-09 "Linux" "Linux Programmer's Manual"
 .SH NAME
 getxattr, lgetxattr, fgetxattr \- retrieve an extended attribute value
 .SH SYNOPSIS
@@ -30,7 +30,7 @@ getxattr, lgetxattr, fgetxattr \- retrieve an extended attribute value
 .nf
 .B #include <sys/types.h>
 .B #include <sys/xattr.h>
-.sp
+.PP
 .BI "ssize_t getxattr(const char\ *" path ", const char\ *" name ,
 .BI "                 void\ *" value ", size_t " size );
 .BI "ssize_t lgetxattr(const char\ *" path ", const char\ *" name ,
@@ -109,14 +109,20 @@ On failure, \-1 is returned and
 is set appropriately.
 .SH ERRORS
 .TP
-.B ENOATTR
+.B E2BIG
+The size of the attribute value is larger than the maximum size allowed; the
+attribute cannot be retrieved.
+This can happen on filesystems that support
+very large attribute values such as NFSv4, for example.
+.TP
+.B ENODATA
 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> .)
+.\" .RB ( ENOATTR
+.\" is defined to be a synonym for
+.\" .BR ENODATA
+.\" in
+.\" .IR <attr/attributes.h> .)
 .TP
 .B ENOTSUP
 Extended attributes are not supported by the filesystem, or are disabled.
@@ -127,11 +133,6 @@ The
 of the
 .I value
 buffer is too small to hold the result.
-.TP
-.B E2BIG
-The size of the attribute value is larger than the maximum size allowed; the
-attribute cannot be retrieved. This can happen on filesystems that support
-very large attribute values such as NFSv4, for example.
 .PP
 In addition, the errors documented in
 .BR stat (2)
@@ -147,7 +148,7 @@ These system calls are Linux-specific.
 .\" and the SGI XFS development team,
 .\" .RI < linux-xfs@oss.sgi.com >.
 .\" Please send any bug reports or comments to these addresses.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR listxattr (2).
 .SH SEE ALSO