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.