1RFIO_OPENDIR(3)             Rfio Library Functions             RFIO_OPENDIR(3)
2
3
4

NAME

6       rfio_opendir - open a directory
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "rfio_api.h"
11
12       RDIR *rfio_opendir (const char *path);
13

DESCRIPTION

15       rfio_opendir  opens  a  directory to be used in subsequent rfio_readdir
16       operations.  A RDIR structure and  a  buffer  to  cache  the  directory
17       entries are allocated in the client API.
18
19       path   specifies the logical pathname relative to the current directory
20              or the full pathname.
21

NOTES

23       For LCG directories, a multi-threaded application will need to initial‐
24       ize itself the Cthread (LCG Thread Interface) library ; this is done by
25       including "shift/Cthread_api.h" and calling the function Cthread_init()
26       at  the  beginning.  Otherwise  accessing  LCG  directories will not be
27       thread-safe. See Cthread(3).
28

RETURN VALUE

30       This routine returns a pointer to be used in the  subsequent  directory
31       function calls if the operation was successful or NULL if the operation
32       failed. In the latter case, serrno is set appropriately.
33

ERRORS

35       ENOENT       A component of path prefix does not exist  or  path  is  a
36                    null pathname.
37
38       EACCES       Search  permission  is  denied  on a component of the path
39                    prefix or read permission is denied on path.
40
41       EFAULT       path is a NULL pointer.
42
43       ENOTDIR      A component of path prefix is not a directory.
44
45       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length  of
46                    a path component exceeds CA_MAXNAMELEN.
47
48       SENOSHOST    Host unknown.
49
50       SENOSSERV    Service unknown.
51
52       SECOMERR     Communication error.
53

SEE ALSO

55       Castor_limits(4), rfio_closedir(3), rfio_readdir(3), rfio_rewinddir(3)
56

AUTHOR

58       LCG Grid Deployment Team
59
60
61
62LCG                      $Date: 2005/03/31 13:13:03 $          RFIO_OPENDIR(3)
Impressum