Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Apropos / Subsearch:
optional field

 getdirentries(2)					    getdirentries(2)

      getdirentries() - get entries from a directory in a file-system-
      independent format

      #include <&lt&lt&lt;ndir.h>&gt&gt&gt;

      int getdirentries(
	  int		 fildes,
	  struct direct *buf,
	  size_t	 nbytes,
	  off_t		*basep

      The getdirentries() system call and the <ndir.h> header file have been
      obsoleted starting from HP-UX 10.30 by the functions described in
      directory(3C).  getdirentries() will not be supported for 64-bit

      The getdirentries() system call places directory entries from the
      directory referenced by the file descriptor fildes into the buffer
      pointed to by buf, in a file-system-independent format.  Up to nbytes
      of data are transferred.	nbytes must be greater than or equal to the
      block size associated with the file; see st_blksize in stat(2).
      (Smaller block sizes can cause errors on certain file systems.) nbytes
      must be less than or equal to 65536 (64K).

      The data in the buffer consists of a series of direct structures, each
      containing the following entries:

	   unsigned long  d_fileno;
	   unsigned short d_reclen;
	   unsigned short d_namlen;
	   char		  d_name[MAXNAMLEN + 1];

      The d_fileno entry is a number unique for each distinct file in the
      file system.  Files linked by hard links (see link(2)) have the same
      d_fileno.	 The d_reclen entry identifies the length, in bytes, of the
      directory record.	 The d_name entry contains a null-terminated file
      name.  The d_namlen entry specifies the length of the file name.	Thus
      the actual size of d_name can vary from 2 to MAXNAMLEN + 1.  Note that
      the direct structures in the buffer are not necessarily tightly
      packed.  The d_reclen entry must be used as an offset from the
      beginning of a direct structure to the next structure, if any.

      The return value of the system call is the actual number of bytes
      transferred.  The current position pointer associated with fildes is
      set to point to the next block of entries.  The pointer is not
      necessarily incremented by the number of bytes returned by
      getdirentries().	If the value returned is zero, the end of the

 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000

 getdirentries(2)					    getdirentries(2)

      directory has been reached.

      The current position pointer is set and retrieved by lseek(); see
      lseek(2).	 getdirentries() writes the position of the block read into
      the location pointed to by basep.	 The current position pointer can be
      set safely only to a value previously returned by lseek(), to a value
      previously returned in the location pointed to by basep, or to zero.
      Any other manipulation of the position pointer causes undefined

      getdirentries() returns the following values:

	    n	Successful completion.	n is the number of bytes actually
	   -1	Failure.  errno is set to indicate the error.

      If getdirentries() fails, errno is set to one of the following values:

	   [EBADF]	  fildes is not a valid file descriptor open for

	   [EFAULT]	  Either buf or basep points outside the allocated
			  address space.

	   [EINTR]	  A read from a slow device was interrupted by the
			  delivery of a signal before any data arrived.

	   [EINVAL]	  nbytes is greater than the size of the direct
			  structure pointed to by buf.

	   [EINVAL]	  nbytes is greater than 65536 or is smaller than
			  the size of a single directory entry.

	   [EIO]	  An I/O error occurred while reading from or
			  writing to the file system.

    Obsolescent Interfaces
      getdirentries() is to be obsoleted at a future date.

      getdirentries() was developed by Sun Microsystems, Inc.

      lseek(2), open(2), directory(3C).

 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000