NAME¶
rpma_read - initiate the read operation
SYNOPSIS¶
#include <librpma.h>
struct rpma_conn;
struct rpma_mr_local;
struct rpma_mr_remote;
int rpma_read(struct rpma_conn *conn,
struct rpma_mr_local *dst, size_t dst_offset,
const struct rpma_mr_remote *src, size_t src_offset,
size_t len, int flags, const void *op_context);
DESCRIPTION¶
rpma_read() initiates transferring data from the remote memory to the
local memory. The attribute flags set the completion notification indicator:
- RPMA_F_COMPLETION_ON_ERROR - generate the completion on error
- RPMA_F_COMPLETION_ALWAYS - generate the completion regardless of result of
the operation
RETURN VALUE¶
The rpma_read() function returns 0 on success or a negative error code on
failure.
ERRORS¶
rpma_read() can fail with the following errors:
- RPMA_E_INVAL - conn, dst or src is NULL
- RPMA_E_INVAL - flags are not set
- RPMA_E_PROVIDER - ibv_post_send(3) failed