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)