dpns_readlink man page

DPNS_READLINK(3)            DPNS Library Functions            DPNS_READLINK(3)

[1mNAME[0m
      dpns_readlink - read value of a symbolic link in the DPNS Name Server

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

      [1mint dpns_readlink (const char *[4m[22mpath[24m[1m, char *[4m[22mbuf[24m[1m, size_t [4m[22mbufsiz[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_readlink  [22mreads  the  value  of  a  symbolic link in the DPNS Name
      Server.

      [4mpath[24m   specifies the link name relative to the current  DPNS  directory
             or the full DPNS pathname.

      [4mbuf[24m    points at a buffer to receive the value.

      [4mbufsiz[24m gives the buffer size.

[1mRETURN VALUE[0m
      This  routine returns the number of characters put in the buffer if the
      operation was successful or -1 if the operation failed. In  the  latter
      case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOENT       [22mThe named link does not exist or is a null pathname.

      [1mEACCES       [22mSearch  permission  is  denied  on a component of the [4mpath[0m
                   prefix.

      [1mEFAULT       [4m[22mpath[24m or [4mbuf[24m is a NULL pointer.

      [1mENOTDIR      [22mA component of [4mpath[24m prefix is not a directory.

      [1mEINVAL       [4m[22mpath[24m is not a symbolic link.

      [1mENAMETOOLONG [22mThe length of [4mpath[24m exceeds [1mCA_MAXPATHLEN [22mor the length  of
                   a [4mpath[24m component exceeds [1mCA_MAXNAMELEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

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

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m, [1mdpns_chdir(3)[22m, [1mdpns_stat(3), dpns_statg(3)[22m, [1mdpns_sym-[0m
      [1mlink(3)[0m

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

DPNS                     $Date: 2004/06/28 09:46:55 $         DPNS_READLINK(3)