mirror of https://github.com/mkerrisk/man-pages
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:
parent
ea45ad970d
commit
17edb54cdc
|
@ -24,7 +24,7 @@
|
||||||
.\" Modified 22 July 1995 by Michael Chastain <mec@duracef.shout.net>:
|
.\" Modified 22 July 1995 by Michael Chastain <mec@duracef.shout.net>:
|
||||||
.\" Derived from 'readdir.2'.
|
.\" Derived from 'readdir.2'.
|
||||||
.\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
|
.\" 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
|
.SH NAME
|
||||||
getdents \- get directory entries
|
getdents \- get directory entries
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
|
@ -115,12 +115,13 @@ This is a Unix domain socket.
|
||||||
.B DT_UNKNOWN
|
.B DT_UNKNOWN
|
||||||
The file type is unknown.
|
The file type is unknown.
|
||||||
.PP
|
.PP
|
||||||
Curently,
|
Currently,
|
||||||
.\" kernel 2.6.27
|
.\" 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 .
|
.IR d_type .
|
||||||
On other file systems,
|
All applications must properly handle a return of
|
||||||
this field is always set to
|
|
||||||
.BR DT_UNKNOWN .
|
.BR DT_UNKNOWN .
|
||||||
.SH "RETURN VALUE"
|
.SH "RETURN VALUE"
|
||||||
On success, the number of bytes read is returned.
|
On success, the number of bytes read is returned.
|
||||||
|
|
Loading…
Reference in New Issue