gfs_pio_recvfile - receive a Gfarm file to local machine
Contents
Description
Receives len bytes of data from the position specified by the offset r_off in a Gfarm file r_gf, to the
position specified by the offset w_off of a local file which is pointed by a file descriptor w_fd. If len
is -1, this function transfers until the end of the file. The transfered bytes will be stored to the
memory pointed by recvp when recvp is not NULL. If len is a positive value, and the value pointed by
recvp is less than len, that means the transfer reached EOF.
Name
gfs_pio_recvfile - receive a Gfarm file to local machine
Return Values
GFARM_ERR_NO_ERROR
The function terminated successfully.
GFARM_ERR_OPERATION_NOT_PERMITTEDgf does not specify a regular file.
GFARM_ERR_BAD_FILE_DESCRIPTOR
The file descripter specified by gf is not a valid or is not open for reading.
GFARM_ERR_NO_FILE_SYSTEM_NODE
There is no available file system node.
GFARM_ERR_NO_MEMORY
Insufficient memory was available.
Others
An error except the above occurred. The reason is shown by gfarm_error_string(3).
See Also
gfs_pio_create(3), gfs_pio_open(3), gfs_pio_read(3), gfs_pio_sendfile(3) Gfarm 12 Aug 2015 GFS_PIO_RECVFILE(3)
Synopsis
#include<gfarm/gfarm.h>gfarm_error_tgfs_pio_recvfile(GFS_Filer_gf,gfarm_off_tr_off,intw_fd,gfarm_off_tw_off,gfarm_off_tlen,gfarm_off_t*recvp);
