1LFC_OPENDIR(3)               LFC Library Functions              LFC_OPENDIR(3)
2
3
4

NAME

6       lfc_opendir - open a LFC directory in the name server
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "lfc_api.h"
11
12       lfc_DIR *lfc_opendir (const char *path)
13

DESCRIPTION

15       lfc_opendir opens a LFC directory in the name server to be used in sub‐
16       sequent lfc_readdir operations.  A lfc_DIR structure and  a  buffer  to
17       cache the directory entries are allocated in the client API.
18
19       path   specifies  the  logical  pathname  relative  to  the current LFC
20              directory or the full LFC 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),      lfc_chdir(3),     lfc_closedir(3),     lfc_read‐
51       dir(3), lfc_readdirg(3), lfc_rewinddir(3)
52

AUTHOR

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