mirror of https://github.com/mkerrisk/man-pages
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:
parent
46fccf2d8e
commit
fec75159e1
18
man2/stat.2
18
man2/stat.2
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue