Re: stat(2) can return EOVERFLOW

Re: stat(2) can return EOVERFLOW

[Michael Kerrisk]

[CC += linux-man@]

Hi Andre,

Thanks for the bug report.

On Thu, Dec 4, 2008 at 10:53 AM, Andre Majorel <aym-xunil-Bi/FLWfhfolQFI55V6+gNQ@public.gmane.org> wrote:
> Michael,
>
> On my system, stat(2) can return EOVERFLOW when stat'ing a file
> larger than 4 (or 2 ?) GB.

2!

> The ERRORS section of stat(2) does not
> mention EOVERFLOW.

I made the change below, for man-pages-3.15.

Thanks,

Michael

--- a/man2/stat.2
+++ b/man2/stat.2
@@ -319,6 +319,19 @@ Out of memory (i.e., kernel memory).
 .TP
 .B ENOTDIR
 A component of the path is not a directory.
+.TP
+.B EOVERFLOW
+.RB ( stat ())
+.I path
+refers to a file whose size cannot be represented in the type
+.IR off_t .
+This can occur when an application compiled on a 32-bit platform without
+.I -D_FILE_OFF_SET_BITS=64
+calls
+.BR stat ()
+on a file whose size exceeds
+.I (2<<31)-1
+bits.
 .SH "CONFORMING TO"
 These system calls conform to SVr4, 4.3BSD, POSIX.1-2001.
 .\" SVr4 documents additional
--
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: stat(2) can return EOVERFLOW

[Chris "ク" Heath]

Michael,

> +This can occur when an application compiled on a 32-bit platform without
> +.I -D_FILE_OFF_SET_BITS=64
> +calls
> +.BR stat ()
> +on a file whose size exceeds
> +.I (2<<31)-1
> +bits.

That should be _FILE_OFFSET_BITS.  :-)

Chris

--
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: stat(2) can return EOVERFLOW

[Michael Kerrisk]

On Thu, Dec 4, 2008 at 2:41 PM, Chris "ク" Heath <chris-FSXMH2gLahXJKwlM9GxbOw@public.gmane.org> wrote:
> Michael,
>
>> +This can occur when an application compiled on a 32-bit platform without
>> +.I -D_FILE_OFF_SET_BITS=64
>> +calls
>> +.BR stat ()
>> +on a file whose size exceeds
>> +.I (2<<31)-1
>> +bits.
>
> That should be _FILE_OFFSET_BITS.  :-)

Thanks Chris!

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
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