Struct ucp_dt_remote_sgl_t

struct ucp_dt_remote_sgl_t

Remote SGL descriptor for multi-element operations.

This structure describes per-element remote addresses, lengths, and keys. Element i targets remote address remote_addrs[i] using key rkeys[i].

The descriptor ucp_dt_remote_sgl_t itself is copied by the library, so the caller may release it after the call returns. However, the arrays remote_addrs, lengths, and rkeys are not copied and must remain valid until the data transfer request is completed.

Pass via ucp_request_param_t::remote with ucp_request_param_t::remote_datatype set to ucp_dt_make_sgl().

Public Members

uint64_t field_mask

Valid fields, using bits from ucp_dt_remote_sgl_field

const uint64_t *remote_addrs

Array of remote memory addresses

const size_t *lengths

Array of transfer lengths in bytes

ucp_rkey_h const *rkeys

Array of remote memory keys