dpns_getcwd man page

DPNS_GETCWD(3)              DPNS Library Functions              DPNS_GETCWD(3)

[1mNAME[0m
      dpns_getcwd - get DPNS current directory used by the name server

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "dpns_api.h"[0m

      [1mchar *dpns_getcwd (char *[4m[22mbuf[24m[1m, int [4m[22msize[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_getcwd  [22mgets  the  DPNS current directory used by the name server.
      This current working directory is stored in a thread-safe  variable  in
      the client.

      If [4mbuf[24m is not NULL, the current directory name will be stored there.
      If [4mbuf[24m is NULL, [1mdpns_getcwd [22mallocates a buffer of [4msize[24m bytes using [1mmal-[0m
      [1mloc[22m.

      [4msize[24m must be at least the length of the directory name to  be  returned
      plus one byte.

[1mRETURN VALUE[0m
      This routine returns [4mbuf[24m if the operation was successful or NULL if the
      operation failed.  In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOENT       [22mThe current directory has not been set  yet  or  does  not
                   exist anymore.

      [1mENOMEM       [4m[22mbuf[24m is a NULL pointer and memory could not be allocated.

      [1mEINVAL       [4m[22msize[24m is less than or equal to zero.

      [1mERANGE       [4m[22msize[24m  is  greater  than  0  and  less than size of current
                   directory name plus 1.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
      [1mdpns_chdir(3)[0m

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

DPNS                     $Date: 2001/10/04 12:12:44 $           DPNS_GETCWD(3)