Penguin
Recent Changes
Annotated edit history of getdents(2) version 3, including all changes. View license author blame.
Rev Author # Line
1 perry 1 !!NAME
2
3
4 getdents - get directory entries
5 !!SYNOPSIS
2 PerryLorier 6 __#include <unistd.h>__
7 __#include <linux/types.h>__
8 __#include <linux/dirent.h>__
9 __#include <linux/unistd.h>__
1 perry 10
2 PerryLorier 11 __int getdents(unsigned int__ fd, __struct dirent *__ dirp, __unsigned int__ count __);__
1 perry 12
13 !!DESCRIPTION
3 PerryLorier 14 getdents(2) reads several ''dirent'' structures from the directory pointed at by ''fd'' into the memory area pointed to by ''dirp''. The parameter ''count'' is the size of the memory area.
1 perry 15
2 PerryLorier 16 The ''dirent'' structure is declared as follows:
17 struct dirent
18 {
19 long d_ino; /* inode number */
20 off_t d_off; /* offset to next ''dirent'' */
21 unsigned short d_reclen; /* length of this ''dirent'' */
22 char d_name [[NAME_MAX+1]; /* file name (null-terminated) */
23 }
1 perry 24
2 PerryLorier 25 ''d_ino'' is an inode number. ''d_off'' is the distance from the start of the directory to the start of the next ''dirent''. ''d_reclen'' is the size of this entire ''dirent. d_name'' is a null-terminated file name.
1 perry 26
2 PerryLorier 27 This call supersedes readdir(2).
1 perry 28
29 !!RETURN VALUE
30
2 PerryLorier 31 On success, the number of bytes read is returned. On end of directory, 0 is returned. On error, -1 is returned, and ''errno'' is set appropriately.
1 perry 32
33 !!ERRORS
2 PerryLorier 34 ;[EBADF]: Invalid file descriptor ''fd''.
35 ;[EFAULT]: Argument points outside the calling process's address space.
36 ;[EINVAL]: Result buffer is too small.
37 ;[ENOENT]: No such directory.
38 ;[ENOTDIR]: File descriptor does not refer to a directory.
1 perry 39
40 !!CONFORMING TO
2 PerryLorier 41 SVr4, SVID. SVr4 documents additional [ENOLINK], [EIO] error conditions.
1 perry 42
43 !!SEE ALSO
44 readdir(2), readdir(3)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

PHP Warning

lib/blame.php:177: Warning: Invalid argument supplied for foreach() (...repeated 8 times)