Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

rdma_bind_addr (3)

Name

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);

Description

Librdmacm Programmer's Manual                                RDMA_BIND_ADDR(3)



NAME
       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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | network/open-fabrics  |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

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).

       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source   was   downloaded   from    ['https://www.openfabrics.org/down-
       loads/ibutils/ibutils-1.5.7-0.2.gbd7e502.tar.gz', 'https://www.openfab-
       rics.org/downloads/libibverbs/libibverbs-1.1.8.tar.gz',
       'https://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.6.tar.gz',
       'https://www.openfabrics.org/downloads/libsdp/lib-
       sdp-1.1.108-0.15.gd7fdb72.tar.gz',   'https://www.openfabrics.org/down-
       loads/management/infiniband-diags-1.6.5.tar.gz',  'https://www.openfab-
       rics.org/downloads/management/libibmad-1.3.12.tar.gz',
       'https://www.openfabrics.org/downloads/management/libibu-
       mad-1.3.10.2.tar.gz',    'https://www.openfabrics.org/downloads/manage-
       ment/opensm-3.3.19.tar.gz',          'https://www.openfabrics.org/down-
       loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'https://www.open-
       fabrics.org/downloads/qperf/qperf-0.4.9.tar.gz',  'https://www.openfab-
       rics.org/downloads/rdmacm/librdmacm-1.0.21.tar.gz',  'https://www.open-
       fabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz'].

       Further information about this software can be found on the open source
       community website at http://www.openfabrics.org/.

SEE ALSO
       rdma_create_id(3),   rdma_listen(3),   rdma_resolve_addr(3),  rdma_cre-
       ate_qp(3), rdma_get_local_addr(3), rdma_get_src_port(3)




librdmacm                         2007-05-15                 RDMA_BIND_ADDR(3)