rdma_bind_addr — Bind an RDMA identifier to a source address.

Synopsis

#include <rdma/rdma_cma.h>

int rdma_bind_addr (struct rdma_cm_id *id, struct sockaddr *addr);

Arguments

id

RDMA identifier.

addr

Local address information.  Wildcard values are permitted.

Description

Associates a source address with an rdma_cm_id.  The address may be wildcarded.  If binding to a specific local address, the rdma_cm_id will also be bound to a local RDMA device.

Return Value

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

Notes

Typically, this routine is called before calling rdma_listen to bind to a specific port number, but it may also be called on the active side of a connection before calling rdma_resolve_addr to bind to a specific address.

If used to bind to port 0, the rdma_cm will select an available port, which can be retrieved with rdma_get_src_port(3).

See Also

rdma_create_id(3), rdma_listen(3), rdma_resolve_addr(3), rdma_create_qp(3), rdma_get_local_addr(3), rdma_get_src_port(3)

Referenced By

rdma_cm(7), rdma_create_id(3), rdma_create_qp(3), rdma_create_srq(3), rdma_getaddrinfo(3), rdma_get_local_addr(3), rdma_get_src_port(3), rdma_join_multicast(3), rdma_join_multicast_ex(3), rdma_listen(3), rdma_resolve_addr(3).

2007-05-15 Librdmacm Programmer's Manual