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)