getdents.2: Added notes on getdents64()

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-11-21 07:25:25 +01:00
parent 33cf6d369b
commit 8dc79b9cf9
1 changed files with 14 additions and 1 deletions

View File

@ -24,7 +24,7 @@
.\" Modified 22 July 1995 by Michael Chastain <mec@duracef.shout.net>:
.\" Derived from 'readdir.2'.
.\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.TH GETDENTS 2 2009-07-04 "Linux" "Linux Programmer's Manual"
.TH GETDENTS 2 2010-11-21 "Linux" "Linux Programmer's Manual"
.SH NAME
getdents \- get directory entries
.SH SYNOPSIS
@ -168,6 +168,19 @@ structure yourself.
This call supersedes
.BR readdir (2).
The original Linux
.BR getdents ()
system call did not handle large file systems and large file offsets.
Consequently, Linux 2.4 added
.BR getdents64 (),
with wider types for the
.I d_ino
and
.I d_off
fields employed in the
.IR linux_dirent
structure.
.SH EXAMPLE
The program below demonstrates the use of
.BR getdents ().