1DPNS_OPENDIR(3)             DPNS Library Functions             DPNS_OPENDIR(3)
2
3
4

NAME

6       dpns_opendir - open a DPNS directory in the name server
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       dpns_DIR *dpns_opendir (const char *path)
13

DESCRIPTION

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

RETURN VALUE

23       This routine returns a pointer to be used in the  subsequent  directory
24       function calls if the operation was successful or NULL if the operation
25       failed. In the latter case, serrno is set appropriately.
26

ERRORS

28       ENOENT       A component of path prefix does not exist  or  path  is  a
29                    null pathname.
30
31       EACCES       Search  permission  is  denied  on a component of the path
32                    prefix or read permission is denied on path.
33
34       EFAULT       path is a NULL pointer.
35
36       ENOTDIR      A component of path prefix is not a directory.
37
38       ENAMETOOLONG The length of path exceeds CA_MAXPATHLEN or the length  of
39                    a path component exceeds CA_MAXNAMELEN.
40
41       SENOSHOST    Host unknown.
42
43       SENOSSERV    Service unknown.
44
45       SECOMERR     Communication error.
46
47       ENSNACT      Name server is not running or is being shutdown.
48

SEE ALSO

50       Castor_limits(4),     dpns_chdir(3),    dpns_closedir(3),    dpns_read‐
51       dir(3), dpns_readdirx(3), dpns_rewinddir(3)
52

AUTHOR

54       LCG Grid Deployment Team
55
56
57
58DPNS                     $Date: 2001/10/04 12:12:46 $          DPNS_OPENDIR(3)