table of contents
rpma_mr_advise(3) | RPMA Programmer's Manual | rpma_mr_advise(3) |
NAME¶
rpma_mr_advise - give advice about an address range in a memory registration
SYNOPSIS¶
#include <librpma.h>
struct rpma_mr_local *mr;
int rpma_mr_advise(struct rpma_mr_local *mr, size_t offset, size_t len, int advice,
uint32_t flags);
DESCRIPTION¶
rpma_mr_advise() gives advice about an address range in a memory registration. The usage parameter specifies the operations that can be performed on the given memory address range. For available advice and flags values please see ibv_advise_mr(3).
RETURN VALUE¶
The rpma_mr_advise() function returns 0 on success or a negative error code on failure.
ERRORS¶
rpma_mr_advise() can fail with the following errors:
- •
- RPMA_E_INVAL - in one of the following:
- the requested range is out of the memory registration bounds
- the memory registration usage does not allow the specific advice
- the flags are invalid
- RPMA_E_NOSUPP - the operation is not supported by the system
- RPMA_E_PROVIDER - ibv_mr_advise(3) failed for other errors
SEE ALSO¶
rpma_mr_reg(3), ibv_mr_advise(3), librpma(7) and https://pmem.io/rpma/
29 October 2024 | RPMA |