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