rfio_rcp man page

RFIO_RCP(3)                 Rfio Library Functions                 RFIO_RCP(3)

[1mNAME[0m
      rfio_rcp - third party copy of a file

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

      [1mint rfio_rcp (char *[4m[22msource[24m[1m, char *[4m[22mdestination[24m[1m, int [4m[22mtimeout[24m[1m);[0m

[1mDESCRIPTION[0m
      [1mrfio_rcp [22mtriggers a third party copy of a file.

      [4msource[24m specifies the physical path of the source file.

      [4mdestination[0m
             specifies the physical path of the file at destination.

      [4mtimeout[0m
             specifies the time after which the copy is cancelled if not com-
             pleted.

[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  source file does not exist or a component of [4mdestina-[0m
                   [4mtion[24m prefix does not exist.

      [1mEACCES       [22mSearch permission is denied on a component of  the  [4msource[0m
                   or [4mdestination[24m prefix or read permission is not granted on
                   the source file or write  permission  on  the  destination
                   parent directory is denied.

      [1mEFAULT       [4m[22msource[24m or [4mdestination[24m is a NULL pointer.

      [1mENOSPC       [22mNo space to store the new file copy.

      [1mENAMETOOLONG [22mThe  length of [4msource[24m or [4mdestination[24m exceeds [1mCA_MAXPATHLEN[0m
                   or the length of a path component exceeds [1mCA_MAXNAMELEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSETIMEDOUT   [22mHas timed out.

      [1mSECOMERR     [22mCommunication error.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[0m

LCG          $Date: 2010-09-07 09:21:01 +0200 (Tue, 07 Sep 2010) $ RFIO_RCP(3)