3 .TH IBV_OPEN_XRC_DOMAIN 3 2008-02-10 libibverbs "Libibverbs Programmer's Manual"
5 ibv_open_xrc_domain, ibv_close_xrc_domain \- open or close an eXtended Reliable Connection (XRC) domain
9 .B #include <infiniband/verbs.h>
11 .BI "struct ibv_xrc_domain *ibv_open_xrc_domain(struct ibv_context " "*context" ","
12 .BI " int " "fd" ", int " "oflag" );
14 .BI "int ibv_close_xrc_domain(struct ibv_xrc_domain " "*d" );
17 .B ibv_open_xrc_domain()
18 open an XRC domain for the InfiniBand device context
20 or return a reference to an opened one\fR.
22 is the file descriptor to be associated with the XRC domain.
25 describes the desired file creation attributes; it is either 0 or the bitwise OR of one or more of the following flags:
29 If a domain belonging to device named by context is already associated with the inode, this flag has
30 no effect, except as noted under
32 below. Otherwise, a new XRC domain is created and is associated with inode specified by
40 are set, open will fail if a domain associated with the inode exists.
41 The check for the existence of the domain and creation
42 of the domain if it does not exist is atomic with respect to other
43 processes executing open with
45 naming the same inode.
49 equals -1, no inode is is associated with the domain, and the only valid value for
54 .B ibv_close_xrc_domain()
57 If this is the last reference, the XRC domain will be destroyed.
59 .B ibv_open_xrc_domain()
60 returns a pointer to an opened XRC, or NULL if the request fails.
62 .B ibv_close_xrc_domain()
63 returns 0 on success, or the value of errno on failure (which indicates the failure reason).
65 Not all devices support XRC. To check if a device supports it, check if the
67 bit is set in the device capabilities flags.
69 .B ibv_close_xrc_domain()
70 may fail if any QP or SRQ are still associated with the XRC domain being closed.
72 .BR ibv_create_xrc_srq (3),
73 .BR ibv_create_qp (3),
74 .BR ibv_create_xrc_rcv_qp (3),
75 .BR ibv_modify_xrc_rcv_qp (3),
76 .BR ibv_query_xrc_rcv_qp (3),
77 .BR ibv_reg_xrc_rcv_qp (3)
80 Dotan Barak <dotanb@mellanox.co.il>