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

NAME

6       lfc_readdirc  -  read  LFC  directory opened by lfc_opendir in the name
7       server
8

SYNOPSIS

10       #include <sys/types.h>
11       #include "lfc_api.h"
12
13       struct lfc_direncomm *lfc_readdirc (lfc_DIR *dirp)
14

DESCRIPTION

16       lfc_readdirc reads the LFC directory opened by lfc_opendir in the  name
17       server.   This  routine returns a pointer to a structure containing the
18       current directory entry including the comment associated.  lfc_readdirc
19       caches  a  variable  number  of such entries, depending on the filename
20       size, to minimize the number of requests to the name server.
21
22       dirp   specifies the pointer value returned by lfc_opendir.
23

RETURN VALUE

25       This routine returns a pointer to a structure  containing  the  current
26       directory  entry  if the operation was successful or NULL if the end of
27       the directory was reached or if the operation failed. When the  end  of
28       the  directory  is encountered, serrno is not changed. If the operation
29       failed, serrno is set appropriately.
30
31       As lfc_readdirc returns a null pointer both at the end of the directory
32       and  on  error,  an  application  wishing to check for error situations
33       should set serrno to 0, then call lfc_readdirc, then check  serrno  and
34       if it is non-zero, assume an error has occurred.
35

ERRORS

37       EBADF        File descriptor in DIR structure is invalid.
38
39       EFAULT       dirp is a NULL pointer.
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       lfc_closedir(3), lfc_opendirg(3), lfc_rewinddir(3), lfc_setcomment (3)
51

AUTHOR

53       LCG Grid Deployment Team
54
55
56
57LFC                      $Date: 2006/03/16 13:02:57 $          LFC_READDIRC(3)
Impressum