stat.2: Clarify description of EOVERFLOW error

The EOVERFLOW error is not only for st_size, but also
inode and block size fields. See glibc source file
sysdeps/unix/sysv/linux/xstatconv.c and kernel source
file fs/stat.c. Also, fix bit/byte confusion
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Simon Paillard 2012-11-11 11:37:03 +01:00 committed by Michael Kerrisk
parent 46fccf2d8e
commit fec75159e1
1 changed files with 12 additions and 6 deletions

View File

@ -37,7 +37,7 @@
.\" 2007-06-08 mtk: Added example program
.\" 2007-07-05 mtk: Added details on underlying system call interfaces
.\"
.TH STAT 2 2012-05-07 "Linux" "Linux Programmer's Manual"
.TH STAT 2 2012-11-11 "Linux" "Linux Programmer's Manual"
.SH NAME
stat, fstat, lstat \- get file status
.SH SYNOPSIS
@ -341,17 +341,23 @@ A component of the path prefix of
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
or
.I fd
refers to a file whose size, inode number,
or number of blocks cannot be represented in, respectively, the types
.IR off_t ,
.IR ino_t ,
or
.IR blkcnt_t .
This error can occur when, for example,
an application compiled on a 32-bit platform without
.I -D_FILE_OFFSET_BITS=64
calls
.BR stat ()
on a file whose size exceeds
.I (1<<31)-1
bits.
bytes.
.SH "CONFORMING TO"
These system calls conform to SVr4, 4.3BSD, POSIX.1-2001.
.\" SVr4 documents additional