1 May 2002
gfs_opendir 3 Gfarm
gfs_opendir open a directory

    #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