1IBV_ATTACH_MCAST(3) Libibverbs Programmer's Manual IBV_ATTACH_MCAST(3)
2
3
4
6 ibv_attach_mcast, ibv_detach_mcast - attach and detach a queue pair
7 (QPs) to/from a multicast group
8
10 #include <infiniband/verbs.h>
11
12 int ibv_attach_mcast(struct ibv_qp *qp, union ibv_gid *gid,
13 uint16_t lid);
14 int ibv_detach_mcast(struct ibv_qp *qp, union ibv_gid *gid,
15 uint16_t lid);
16
18 ibv_attach_mcast() attaches the QP qp to the multicast group having
19 MGID gid and MLID lid.
20
21 ibv_detach_mcast() detaches the QP qp to the multicast group having
22 MGID gid and MLID lid.
23
25 ibv_attach_mcast() and ibv_detach_mcast() returns 0 on success, or the
26 value of errno on failure (which indicates the failure reason).
27
29 Only QPs of Transport Service Type IBV_QPT_UD may be attached to multi‐
30 cast groups.
31
32 If a QP is attached to the same multicast group multiple times, the QP
33 will still receive a single copy of a multicast message.
34
35 In order to receive multicast messages, a join request for the multi‐
36 cast group must be sent to the subnet administrator (SA), so that the
37 fabric's multicast routing is configured to deliver messages to the
38 local port.
39
41 ibv_create_qp(3)
42
44 Dotan Barak <dotanb@mellanox.co.il>
45
46
47
48libibverbs 2006-10-31 IBV_ATTACH_MCAST(3)