rfio_readlink man page

RFIO_READLINK(3)            Rfio Library Functions            RFIO_READLINK(3)

[1mNAME[0m
      rfio_readlink - get the content of a symbolic link

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

      [1mint rfio_readlink (const char *[4m[22mpath[24m[1m, char *[4m[22mbuf[24m[1m, int [4m[22mlength[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mrfio_readlink [22mgets the content of the symbolic link identified by [4mpath[24m.

      [4mbuf[24m content is not null terminated.
      Symbolic link content can be truncated to [4mlength[24m if [4mbuf[24m is too small.

[1mRETURN VALUE[0m
      This  routine returns the count of bytes placed in [4mbuf[24m if the operation
      was successful or -1 if the operation failed.  In the latter case, [1mser-[0m
      [1mrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOENT       [4m[22mpath[24m does not exist.

      [1mENOMEM       [22mInsufficient memory.

      [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 the [4mpath[24m prefix is not a directory.

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

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

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mSEOPNOTSUP   [22mNot supported on Windows.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m, [1mrfio_symlink(3)[22m, [1mrfio_unlink(3)[0m

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

LCG                      $Date: 2005/03/31 13:13:03 $         RFIO_READLINK(3)