lfc_readdirc(3) [debian man page]

LFC_READDIRC(3) 					       LFC Library Functions						   LFC_READDIRC(3)

NAME

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

SYNOPSIS

       #include <sys/types.h>
       #include "lfc_api.h"

       struct lfc_direncomm *lfc_readdirc (lfc_DIR *dirp)

DESCRIPTION

       lfc_readdirc  reads  the  LFC directory opened by lfc_opendir in the name server.  This routine returns a pointer to a structure containing
       the current directory entry including the comment associated.  lfc_readdirc caches a variable number of	such  entries,	depending  on  the
       filename size, to minimize the number of requests to the name server.

       dirp   specifies the pointer value returned by lfc_opendir.

RETURN VALUE

       This  routine returns a pointer to a structure containing the current directory entry if the operation was successful or NULL if the end of
       the directory was reached or if the operation failed. When the end of the directory is encountered, serrno is not changed. If the operation
       failed, serrno is set appropriately.

       As  lfc_readdirc returns a null pointer both at the end of the directory and on error, an application wishing to check for error situations
       should set serrno to 0, then call lfc_readdirc, then check serrno and if it is non-zero, assume an error has occurred.

ERRORS

       EBADF	    File descriptor in DIR structure is invalid.

       EFAULT	    dirp is a NULL pointer.

       SECOMERR     Communication error.

       ENSNACT	    Name server is not running or is being shutdown.

SEE ALSO

       lfc_closedir(3), lfc_opendirg(3), lfc_rewinddir(3), lfc_setcomment (3)

AUTHOR

       LCG Grid Deployment Team

LFC
								      $Date$							   LFC_READDIRC(3)

LFC_READDIRXC(3)					       LFC Library Functions						  LFC_READDIRXC(3)

NAME

       lfc_readdirxc - read LFC directory opened by lfc_opendir in the name server

SYNOPSIS

       #include <sys/types.h>
       #include "lfc_api.h"

       struct lfc_direnstatc *lfc_readdirxc (lfc_DIR *dirp)

DESCRIPTION

       lfc_readdirxc  reads  the LFC directory opened by lfc_opendir in the name server.  This routine returns a pointer to a structure containing
       the current directory entry including the stat information and the comment associated.  lfc_readdirxc caches  a	variable  number  of  such
       entries, depending on the filename size, to minimize the number of requests to the name server.

       dirp   specifies the pointer value returned by lfc_opendir.

RETURN VALUE

       This  routine returns a pointer to a structure containing the current directory entry if the operation was successful or NULL if the end of
       the directory was reached or if the operation failed. When the end of the directory is encountered, serrno is not changed. If the operation
       failed, serrno is set appropriately.

       As lfc_readdirxc returns a null pointer both at the end of the directory and on error, an application wishing to check for error situations
       should set serrno to 0, then call lfc_readdirxc, then check serrno and if it is non-zero, assume an error has occurred.

ERRORS

       EBADF	    File descriptor in DIR structure is invalid.

       EFAULT	    dirp is a NULL pointer.

       SECOMERR     Communication error.

       ENSNACT	    Name server is not running or is being shutdown.

SEE ALSO

       lfc_closedir(3), lfc_opendirg(3), lfc_rewinddir(3), lfc_setcomment(3), stat(2)

AUTHOR

       LCG Grid Deployment Team

LFC
								      $Date$							  LFC_READDIRXC(3)