NAME¶
gfs_opendir - open a directory
SYNOPSIS¶
#include <gfarm/gfarm.h>
char *gfs_opendir (const char *
gfarm_url, GFS_Dir *
dirp);
DESCRIPTION¶
The
gfs_opendir() function opens a directory stream corresponding to the
directory
gfarm_url, and returns the directory stream to the address
pointed by
dirp. The stream is positioned at the first entry in the
directory.
RETURN VALUES¶
- NULL
- The function terminated successfully.
- GFARM_ERR_NO_MEMORY
- Insufficient memory was available.
- GFARM_ERR_AUTHENTICATION
- User authentication failed when connecting to gfmd(8).
- GFARM_ERR_PERMISSION_DENIED
- gfarm_url points outside your accessible address
space.
- GFARM_ERR_NO_SUCH_OBJECT
- Directory does not exist.
- Others
- An error except the above occurred. The reason is shown by
its pointed strings.
SEE ALSO¶
gfs_closedir(3),
gfs_readdir(3)