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, const union ibv_gid *gid, uint16_t lid);
13
14              int ibv_detach_mcast(struct ibv_qp *qp, const union ibv_gid *gid, uint16_t lid);
15

DESCRIPTION

17       ibv_attach_mcast() attaches the QP qp to  the  multicast  group  having
18       MGID gid and MLID lid.
19
20       ibv_detach_mcast()  detaches  the  QP  qp to the multicast group having
21       MGID gid and MLID lid.
22

RETURN VALUE

24       ibv_attach_mcast() and ibv_detach_mcast() returns 0 on success, or  the
25       value of errno on failure (which indicates the failure reason).
26

NOTES

28       Only QPs of Transport Service Type IBV_QPT_UD may be attached to multi‐
29       cast groups.
30
31       If a QP is attached to the same multicast group multiple times, the  QP
32       will still receive a single copy of a multicast message.
33
34       In  order  to receive multicast messages, a join request for the multi‐
35       cast group must be sent to the subnet administrator (SA), so  that  the
36       fabric's multicast routing is configured to deliver messages to the lo‐
37       cal port.
38

SEE ALSO

40       ibv_create_qp(3)
41

AUTHOR

43       Dotan Barak <dotanba@gmail.com>
44
45
46
47libibverbs                        2006-10-31               IBV_ATTACH_MCAST(3)