pSOSystem System Calls - Read

ead_dir pHILE+ System Calls
read_dir Reads directory entries in a file system independent format.
#include
unsigned long read_dir(
XDIR *dir, /* a directory handle */
struct dirent *buf /* user structure to hold returned contents */
)
Volume Types
Description
Arguments
Return Value
All volume types.
read_dir() reads one directory entry at a time from a directory file in a file
system-independent format. The directory handle is first obtained with
open_dir().
dir Points to the handle for the directory file, which has been returned by
open_dir().
buf Points to the memory area that receives the data. The data returned
in *buf is a dirent structure defined in , as follows:
struct dirent {
unsigned long d_filno;
char d_name [MAXNAMLEN+1];
}
This structure cannot be packed. d_fileno contains a number that
is unique for each distinct file in the file system, and d_name
contains a null-terminated filename, where the size is in the range of
1 through MAXNAMLEN+1. MAXNAMLEN is set to 255.
When the last entry has been read, an end-of-file error is returned.
This system call returns 0 on success or an error code on failure.
2-90 pSOSystem System Calls