getdents man page on YellowDog

Man page or keyword search:  
man Server   18644 pages
apropos Keyword Search (all sections)
Output format
YellowDog logo
[printable version]

GETDENTS(2)		   Linux Programmer's Manual		   GETDENTS(2)

NAME
       getdents - get directory entries

SYNOPSIS
       #include <unistd.h>
       #include <linux/types.h>
       #include <linux/dirent.h>
       #include <linux/unistd.h>
       #include <errno.h>

       _syscall3(int, getdents, uint, fd, struct dirent *, dirp, uint, count)
	       /* Using syscall(2) may be preferable; see intro(2) */

       int getdents(unsigned int fd, struct dirent *dirp, unsigned int count);

DESCRIPTION
       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.

       The  system  call  getdents()  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.

       The dirent structure is declared as follows:

	      struct dirent
	      {
		  long d_ino;		      /* inode number */
		  off_t d_off;		      /* offset to next dirent */
		  unsigned short d_reclen;    /* length of this dirent */
		  char d_name [NAME_MAX+1];   /* filename (null-terminated) */
	      }

       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 filename.

       This call supersedes readdir(2).

RETURN VALUE
       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  appropriā€
       ately.

ERRORS
       EBADF  Invalid file descriptor fd.

       EFAULT Argument points outside the calling process's address space.

       EINVAL Result buffer is too small.

       ENOENT No such directory.

       ENOTDIR
	      File descriptor does not refer to a directory.

CONFORMING TO
       SVr4.

SEE ALSO
       readdir(2), readdir(3)

Linux 1.3.6			  1995-07-22			   GETDENTS(2)
[top]

List of man pages available for YellowDog

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net