rpma_flush3

Usage

      #include <librpma.h>
      struct rpma_conn;
      struct rpma_mr_remote;
      enum rpma_flush_type {
              RPMA_FLUSH_TYPE_PERSISTENT,
              RPMA_FLUSH_TYPE_VISIBILITY,
      };
      int rpma_flush(struct rpma_conn *conn,
                      struct rpma_mr_remote *dst, size_t dst_offset,
                      size_t len, enum rpma_flush_type type, int flags,
                      const void *op_context);

Overview

rpma_flush() initiates the flush operation (finalizing a transfer of data to the remote memory). Possible types of rpma_flush() operation:

•

RPMA_FLUSH_TYPE_PERSISTENT - flush data down to the persistent domain

•

RPMA_FLUSH_TYPE_VISIBILITY - flush data deep enough to make it visible on the remote node

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.

op_context is returned in the wr_id field of the completion (struct ibv_wc).

Return value

The rpma_flush() function returns 0 on success or a negative error code on failure.

Errors

rpma_flush() can fail with the following errors:

•

RPMA_E_INVAL - conn or dst is NULL

•

RPMA_E_INVAL - unknown type value

•

RPMA_E_INVAL - flags are not set

•

RPMA_E_PROVIDER - ibv_post_send(3) failed

•

RPMA_E_NOSUPP - type is RPMA_FLUSH_TYPE_PERSISTENT and the direct write to pmem is not supported