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>
This commit is contained in:
Christoph Hellwig 2008-10-29 09:20:44 -05:00 committed by Michael Kerrisk
parent ea45ad970d
commit 17edb54cdc
1 changed files with 6 additions and 5 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-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.