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)

Gfarm                                            29 October 2003                                  GFS_OPENDIR(3)