1IBV_ATTACH_MCAST(3)     Libibverbs Programmer's Manual     IBV_ATTACH_MCAST(3)
2
3
4

NAME

6       ibv_attach_mcast,  ibv_detach_mcast  -  attach  and detach a queue pair
7       (QPs) to/from a multicast group
8

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

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

NOTES

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

SEE ALSO

41       ibv_create_qp(3)
42

AUTHORS

44       Dotan Barak <dotanb@mellanox.co.il>
45
46
47
48libibverbs                        2006-10-31               IBV_ATTACH_MCAST(3)