gfs_opendir(3)

gfs_opendir3

Open a directory

Usage

#include <gfarm/gfarm.h>

char *gfs_opendir (const char * gfarm_url, GFS_Dir * dirp);

Overview

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.

Releases

Unchanged in 2 releases since Debian 6.0 (Squeeze).

  1. 6.0–7

From libgfarm-dev 2.4.1-1.1 in Debian 7 (Wheezy). Parsed by carta from the page's man source.