Provided by: librdmacm-dev_1.0.14.1-2_i386 bug

NAME

       rdma_join_multicast - Joins a multicast group.

SYNOPSIS

       #include <rdma/rdma_cma.h>

       int  rdma_join_multicast (struct rdma_cm_id *id, struct sockaddr *addr,
       void *context);

ARGUMENTS

       id          Communication identifier associated with the request.

       addr        Multicast address identifying the group to join.

       context     User-defined context associated with the join request.

DESCRIPTION

       Joins a multicast group and attaches an associated QP to the group.

RETURN VALUE

       Returns 0 on success, or -1 on error.  If an error occurs,  errno  will
       be set to indicate the failure reason.

NOTES

       Before  joining  a  multicast group, the rdma_cm_id must be bound to an
       RDMA device by calling rdma_bind_addr  or  rdma_resolve_addr.   Use  of
       rdma_resolve_addr  requires  the  local  routing  tables to resolve the
       multicast address to an RDMA device, unless a specific  source  address
       is  provided.   The  user  must  call rdma_leave_multicast to leave the
       multicast group and release any multicast resources.   After  the  join
       operation completes, any associated QP is automatically attached to the
       multicast group, and the join context is returned to the  user  through
       the private_data field in the rdma_cm_event.

SEE ALSO

       rdma_leave_multicast(3),    rdma_bind_addr(3),    rdma_resolve_addr(3),
       rdma_create_qp(3), rdma_get_cm_event(3)