NAME

       dpns_getcwd - get DPNS current directory used by the name server

SYNOPSIS

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

       char *dpns_getcwd (char *buf, int size)

DESCRIPTION

       dpns_getcwd gets the DPNS current directory used by the name server.  This current working
       directory is stored in a thread-safe variable in the client.

       If buf is not NULL, the current directory name will be stored there.
       If buf is NULL, dpns_getcwd allocates a buffer of size bytes using malloc.

       size must be at least the length of the directory name to be returned plus one byte.

RETURN VALUE

       This routine returns buf if the operation was successful or NULL if the operation  failed.
       In the latter case, serrno is set appropriately.

ERRORS

       ENOENT       The current directory has not been set yet or does not exist anymore.

       ENOMEM       buf is a NULL pointer and memory could not be allocated.

       EINVAL       size is less than or equal to zero.

       ERANGE       size is greater than 0 and less than size of current directory name plus 1.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT      Name server is not running or is being shutdown.

SEE ALSO

       dpns_chdir(3)

AUTHOR

       LCG Grid Deployment Team