NAME¶
ibv_open_xrcd, ibv_close_xrcd - open or close an XRC protection domain (XRCDs)
SYNOPSIS¶
#include <infiniband/verbs.h>
struct ibv_xrcd *ibv_open_xrcd(struct ibv_context *context,
struct ibv_xrcd_init_attr *xrcd_init_attr);
int ibv_close_xrcd(struct ibv_xrcd *xrcd);
DESCRIPTION¶
ibv_open_xrcd() open an XRC domain for the RDMA device context
context xrcd_init_attr is an ibv_xrcd_init_attr struct, as
defined in <infiniband/verbs.h>.
struct ibv_xrcd_init_attr {
uint32_t comp_mask; /* Identifies valid fields */
int fd;
int oflag;
fd is the file descriptor to associate with the XRCD.
oflag
describes the desired creation attributes. It is a bitwise OR of zero or more
of the following flags:
- O_CREAT
- Indicates that an XRCD should be created and associated with the inode
referenced by the given fd. If the XRCD exists, this flag has no effect
except as noted under O_EXCL below.
- O_EXCL
- If O_EXCL and O_CREAT are set, open will fail if an XRCD
associated with the inode exists.
If
fd equals -1, no inode is associated with the XRCD. To indicate that
XRCD should be created, use
oflag =
O_CREAT.
ibv_close_xrcd() closes the XRCD
xrcd. If this is the last
reference, the XRCD will be destroyed.
RETURN VALUE¶
ibv_open_xrcd() returns a pointer to the opened XRCD, or NULL if the
request fails.
ibv_close_xrcd() returns 0 on success, or the value of errno on failure
(which indicates the failure reason).
NOTES¶
ibv_close_xrcd() may fail if any other resource is still associated with
the XRCD being closed.
SEE ALSO¶
ibv_create_srq_ex(3),
ibv_create_qp_ex(3),
AUTHORS¶
- Sean Hefty <sean.hefty@intel.com>