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

DESCRIPTION

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

RETURN VALUE

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

NOTES

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

SEE ALSO

42       ibv_create_qp(3)
43

AUTHORS

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