diff options
Diffstat (limited to 'reference/C/MAN/readdir.htm')
| -rw-r--r-- | reference/C/MAN/readdir.htm | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/reference/C/MAN/readdir.htm b/reference/C/MAN/readdir.htm new file mode 100644 index 0000000..39b3d23 --- /dev/null +++ b/reference/C/MAN/readdir.htm @@ -0,0 +1,164 @@ +<TITLE>readdir</TITLE> +<body bgcolor="#ffffcc"> +<hr> +<pre> + + + +<h3>READDIR(2) Linux Programmer's Manual READDIR(2) +</h3> + +<h3>NAME +</h3> readdir - read directory entry + +<h3>SYNOPSIS +</h3> #include <unistd.h> + #include <linux/dirent.h> + #include <linux/unistd.h> + + _syscall3(int, readdir, uint, fd, struct dirent *, dirp, uint, count); + + int readdir(unsigned int fd, struct dirent *dirp, unsigned int count); + +<h3>DESCRIPTION +</h3> This is not the function you are interested in. Look at + readdir(3) for the POSIX conforming C library interface. + This page documents the bare kernel system call interface, + which can change, and which is superseded by getdents(2). + + readdir reads one dirent structure from the directory + pointed at by fd into the memory area pointed to by dirp. + The parameter count is ignored; at most one dirent struc- + ture is read. + + The dirent structure is declared as follows: + + struct dirent + { + long d_ino; /* inode number */ + off_t d_off; /* offset to this dirent */ + unsigned short d_reclen; /* length of this d_name */ + char d_name [NAME_MAX+1]; /* file name (null-terminated) */ + } + + d_ino is an inode number. d_off is the distance from the + start of the directory to this dirent. d_reclen is the + size of d_name, not counting the null terminator. d_name + is a null-terminated file name. + + +<h3>RETURN VALUE +</h3> On success, 1 is returned. On end of directory, 0 is + returned. On error, -1 is returned, and errno is set + appropriately. + +<h3>ERRORS +</h3> EBADF Invalid file descriptor fd. + + ENOTDIR + File descriptor does not refer to a directory. + +<h3>CONFORMING TO +</h3> This system call is Linux specific. + + + + + +<h3>Linux 1.3.6 22 July 1995 1 +</h3> + + + + +<h3>READDIR(2) Linux Programmer's Manual READDIR(2) +</h3> + +</pre> +<hr> +<h3>SEE ALSO +</h3><p> +<a href=getdents.htm>getdents</a>, +<a href=readdir.htm>readdir</a>, +<pre> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +<h3>Linux 1.3.6 22 July 1995 2 +</h3> + +
</pre> +<P> +<hr> +<p> +<center> +<table border=2 width=80%> +<tr align=center> +<td width=25%> +<a href=../cref.html>Top</a> +</td><td width=25%> +<a href=../master_index.html>Master Index</a> +</td><td width=25%> +<a href=../SYNTAX/keywords.html>Keywords</a> +</td><td width=25%> +<a href=../FUNCTIONS/funcref.htm>Functions</a> +</td> +</tr> +</table> +</center> +<p> +<hr> + +This manual page was brought to you by <i>mjl_man V-2.0</i> |