getdirentri man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

getdirentries(2)					      getdirentries(2)

       getdirentries()	-  get entries from a directory in a file-system-inde‐
       pendent format

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

       The 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 in stat(2).  (Smaller block sizes	can  cause  errors  on
       certain	file  systems.)	  nbytes  must	be less than or equal to 65536

       The data in the buffer consists of a series of  structures,  each  con‐
       taining the following entries:

	      ino32_t	     d_ino;
	      unsigned short d_reclen;
	      unsigned short d_namlen;
	      char	     d_name[MAXNAMLEN + 1];

       The entry is a number unique for each distinct file in the file system.
       Files linked by hard links (see link(2)) have the same The entry	 iden‐
       tifies  the  length, in bytes, of the directory record.	The entry con‐
       tains a null-terminated file name.  The entry specifies the  length  of
       the  file  name.	 Thus the actual size of can vary from 2 to + 1.  Note
       that the structures in the buffer are not necessarily  tightly  packed.
       The  entry  must be used as an offset from the beginning of a 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	neces‐
       sarily  incremented  by	the  number  of bytes returned by If the value
       returned is zero, the end of the directory has been reached.

       The current position pointer is set  and	 retrieved  by	see  lseek(2).
       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 to a value previously returned in the location
       pointed to by basep, or to zero.	 Any other manipulation of  the	 posi‐
       tion pointer causes undefined results.

       returns the following values:

	      Successful completion.
		     n is the number of bytes actually transferred.
		     is set to indicate the error.

       If fails, 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  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 writ‐
			     ing to the file system.

   Obsolescent Interfaces
       is to be obsoleted at a future date.

       The  call  can  encounter truncated d_ino values when it is used with a
       64-bit filesystem.

       was developed by Sun Microsystems, Inc.

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

				TO BE OBSOLETED		      getdirentries(2)

List of man pages available for HP-UX

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]
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