aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChristoph Hellwig <hch@infradead.org>2008-10-29 09:20:44 -0500
committerMichael Kerrisk <mtk.manpages@gmail.com>2008-10-29 14:54:26 -0500
commit17edb54cdc008a0c3409a9016cf4b3bfe852172b (patch)
treef22f594f190f03092aac3c09a8b51c2ca9501ede
parentea45ad970df66f93b4cc886b59499801f81bcdc8 (diff)
downloadman-pages-17edb54cdc008a0c3409a9016cf4b3bfe852172b.tar.gz
getdents.2: Fix text relating to DT_UNKNOWN and 'd_type' support
Some file systems provide partial support for 'dt_type', returning DT_UNKNOWN for cases they don't support. Update the discussion of 'd_type' and DT_UNKNOWN to support this. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man2/getdents.211
1 files changed, 6 insertions, 5 deletions
diff --git a/man2/getdents.2 b/man2/getdents.2
index 90a3d37bb3..ca434e0f9a 100644
--- a/man2/getdents.2
+++ b/man2/getdents.2
@@ -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-10-02 "Linux" "Linux Programmer's Manual"
+.TH GETDENTS 2 2008-10-28 "Linux" "Linux Programmer's Manual"
.SH NAME
getdents \- get directory entries
.SH SYNOPSIS
@@ -115,12 +115,13 @@ This is a Unix domain socket.
.B DT_UNKNOWN
The file type is unknown.
.PP
-Curently,
+Currently,
.\" kernel 2.6.27
-only ext2, ext3, and ext4 support returning the file type in
+.\" The same sentence is in readdir.2
+only some file systems (among them: ext2, etx3, and ext4)
+have full support returning the file type in
.IR d_type .
-On other file systems,
-this field is always set to
+All applications must properly handle a return of
.BR DT_UNKNOWN .
.SH "RETURN VALUE"
On success, the number of bytes read is returned.