1RDMA_JOIN_MULTICAST(3) Librdmacm Programmer's Manual RDMA_JOIN_MULTICAST(3)
2
3
4
6 rdma_join_multicast - Joins a multicast group.
7
9 #include <rdma/rdma_cma.h>
10
11 int rdma_join_multicast (struct rdma_cm_id *id, struct sockaddr *addr,
12 void *context);
13
15 id Communication identifier associated with the request.
16
17 addr Multicast address identifying the group to join.
18
19 context User-defined context associated with the join request.
20
22 Joins a multicast group and attaches an associated QP to the group.
23
25 Before joining a multicast group, the rdma_cm_id must be bound to an
26 RDMA device by calling rdma_bind_addr or rdma_resolve_addr. Use of
27 rdma_resolve_addr requires the local routing tables to resolve the mul‐
28 ticast address to an RDMA device, unless a specific source address is
29 provided. The user must call rdma_leave_multicast to leave the multi‐
30 cast group and release any multicast resources. After the join opera‐
31 tion completes, any associated QP is automatically attached to the mul‐
32 ticast group, and the join context is returned to the user through the
33 private_data field in the rdma_cm_event.
34
36 rdma_leave_multicast(3), rdma_bind_addr(3), rdma_resolve_addr(3),
37 rdma_create_qp(3), rdma_get_cm_event(3)
38
39
40
41librdmacm 2008-01-02 RDMA_JOIN_MULTICAST(3)