DPNS_GETCWD

Section: DPNS Library Functions (3)
Updated: $Date: 2001/10/04 12:12:44 $
Index Return to Main Contents
 

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