lfc_getcomment man page

LFC_GETCOMMENT(3)            LFC Library Functions           LFC_GETCOMMENT(3)

[1mNAME[0m
      lfc_getcomment  -  get the comment associated with a LFC file/directory
      in the name server

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

      [1mint lfc_getcomment (const char *[4m[22mpath[24m[1m, char *[4m[22mcomment[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mlfc_getcomment [22mgets the comment associated with a LFC file/directory in
      the name server.

      [4mpath[24m   specifies  the  logical  pathname  relative  to  the current LFC
             directory or the full LFC pathname.

      [4mcomment[0m
             points at a buffer to receive the comment.  The buffer  must  be
             at least CA_MAXCOMMENTLEN+1 characters long.

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

[1mERRORS[0m
      [1mENOENT       [22mThe named directory does not exist or is a  null  pathname
                   or there is no comment associated with this path.

      [1mEACCES       [22mSearch  permission  is  denied  on a component of the [4mpath[0m
                   prefix or the caller effective user ID does not match  the
                   owner ID of the file or read permission on the file/direc-
                   tory itself is denied.

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

      [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, [1mlfc_chdir(3)[0m

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

LFC          $Date: 2010-12-13 11:48:43 +0100 (Mon, 13 Dec 201L0F)C_$GETCOMMENT(3)