[PATCH] getxattr.2, listxattr.2: Document E2BIG errors

[PATCH] getxattr.2, listxattr.2: Document E2BIG errors

[Andreas Gruenbacher]

Signed-off-by: Andreas Gruenbacher <agruenba-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
---
 man2/getxattr.2  | 5 +++++
 man2/listxattr.2 | 6 ++++++
 2 files changed, 11 insertions(+)

diff --git a/man2/getxattr.2 b/man2/getxattr.2
index c06c92f..83945fe 100644
--- a/man2/getxattr.2
+++ b/man2/getxattr.2
@@ -127,6 +127,11 @@ 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)
diff --git a/man2/listxattr.2 b/man2/listxattr.2
index 9c14679..e923af4 100644
--- a/man2/listxattr.2
+++ b/man2/listxattr.2
@@ -149,6 +149,12 @@ The
 of the
 .I list
 buffer is too small to hold the result.
+.TP
+.B E2BIG
+The size of the list of extended attribute names is larger than the maximum
+size allowed; the list cannot be retrieved. This can happen on filesystems that
+support an unlimited number of extended attributes per file such as XFS, for
+example.
 .PP
 In addition, the errors documented in
 .BR stat (2)
-- 
2.7.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] getxattr.2, listxattr.2: Document E2BIG errors

[Michael Kerrisk (man-pages)]

On 02/23/2017 10:56 PM, Andreas Gruenbacher wrote:
> Signed-off-by: Andreas Gruenbacher <agruenba-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>

Thanks, Andreas! Applied.

Cheers,

Michael

> ---
>  man2/getxattr.2  | 5 +++++
>  man2/listxattr.2 | 6 ++++++
>  2 files changed, 11 insertions(+)
> 
> diff --git a/man2/getxattr.2 b/man2/getxattr.2
> index c06c92f..83945fe 100644
> --- a/man2/getxattr.2
> +++ b/man2/getxattr.2
> @@ -127,6 +127,11 @@ 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)
> diff --git a/man2/listxattr.2 b/man2/listxattr.2
> index 9c14679..e923af4 100644
> --- a/man2/listxattr.2
> +++ b/man2/listxattr.2
> @@ -149,6 +149,12 @@ The
>  of the
>  .I list
>  buffer is too small to hold the result.
> +.TP
> +.B E2BIG
> +The size of the list of extended attribute names is larger than the maximum
> +size allowed; the list cannot be retrieved. This can happen on filesystems that
> +support an unlimited number of extended attributes per file such as XFS, for
> +example.
>  .PP
>  In addition, the errors documented in
>  .BR stat (2)
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] getxattr.2, listxattr.2: Document E2BIG errors

[J. Bruce Fields]

Looks good, thanks!--b.

On Thu, Feb 23, 2017 at 10:56:41PM +0100, Andreas Gruenbacher wrote:
> Signed-off-by: Andreas Gruenbacher <agruenba-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
> ---
>  man2/getxattr.2  | 5 +++++
>  man2/listxattr.2 | 6 ++++++
>  2 files changed, 11 insertions(+)
> 
> diff --git a/man2/getxattr.2 b/man2/getxattr.2
> index c06c92f..83945fe 100644
> --- a/man2/getxattr.2
> +++ b/man2/getxattr.2
> @@ -127,6 +127,11 @@ 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)
> diff --git a/man2/listxattr.2 b/man2/listxattr.2
> index 9c14679..e923af4 100644
> --- a/man2/listxattr.2
> +++ b/man2/listxattr.2
> @@ -149,6 +149,12 @@ The
>  of the
>  .I list
>  buffer is too small to hold the result.
> +.TP
> +.B E2BIG
> +The size of the list of extended attribute names is larger than the maximum
> +size allowed; the list cannot be retrieved. This can happen on filesystems that
> +support an unlimited number of extended attributes per file such as XFS, for
> +example.
>  .PP
>  In addition, the errors documented in
>  .BR stat (2)
> -- 
> 2.7.4
> 
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html