RFIO_RCP(3)						      Rfio Library Functions						       RFIO_RCP(3)

NAME

       rfio_rcp - third party copy of a file

SYNOPSIS

       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_rcp (char *source, char *destination, int timeout);

DESCRIPTION

       rfio_rcp triggers a third party copy of a file.

       source specifies the physical path of the source file.

       destination
	      specifies the physical path of the file at destination.

       timeout
	      specifies the time after which the copy is cancelled if not completed.

RETURN VALUE

       This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, serrno is set appropriately.

ERRORS

       ENOENT	    The source file does not exist or a component of destination prefix does not exist.

       EACCES	    Search permission is denied on a component of the source or destination prefix or read permission is not granted on the source
		    file or write permission on the destination parent directory is denied.

       EFAULT	    source or destination is a NULL pointer.

       ENOSPC	    No space to store the new file copy.

       ENAMETOOLONG The length of source or destination exceeds CA_MAXPATHLEN or the length of a path component exceeds CA_MAXNAMELEN.

       SENOSHOST    Host unknown.

       SETIMEDOUT   Has timed out.

       SECOMERR     Communication error.

SEE ALSO

       Castor_limits(4)

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