GFS_OPENDIR(3)

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)