rdma_resolve_addrinfo(3) — Linux manual page

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHOR | COLOPHON

RDMA_RE...ADDRINFO(3) Librdmacm Programmer's Manual RDMA_RE...ADDRINFO(3)

NAME         top

       RDMA_RESOLVE_ADDRINFO - Resolve RDMA addresses which supports both
       DNS and IB SA.

SYNOPSIS         top

       #include <rdma/rdma_cma.h>

       int rdma_resolve_addrinfo(struct rdma_cm_id *id, const char *node,
       const char *service, const struct rdma_addrinfo *hints);

ARGUMENTS         top

       id      RDMA identifier.

       node    Optional, name, dotted-decimal IPv4, or IPv6 hex address
       to resolve.

       service The service name or port number of address.

       hints   Reference to an rdma_addrinfo structure containing hints
       about the type of service the caller supports.

DESCRIPTION         top

       This call submits an asynchronous address resolution request. The
       behavior is similar to rdma_getaddrinfo(), except that the
       operation is asynchronous, generating an event on the RDMA CM
       event channel that is associated with the specified rdma_cm_id
       when complete. The %node, %service, and %hints parameters are
       defined similarly to rdma_getaddrinfo().

RETURN VALUE         top

       Returns 0 on success. Success indicates that asynchronous address
       resolution was initiated. The result of the resolution, whether
       successful or failed, will be reported as an event on the related
       event channel.

       Returns -1 on error, errno will be set to indicate the failure
       reason. The address resolution was not started, and no event will
       be generated on the event channel.

NOTES         top

       This call supports both DNS and IB SA resolution, depends on the
       hints.ai_flags:

              • RAI_DNS: Performs address resolution using DNS.

              • RAI_SA: Performs address resolution using the Infiniband
                SA. The rdma_cm_id associated with the call must be bound
                to an Infiniband port, or an error will occur. The %node
                parameter must be null (not supported). %Service should
                be an IB service name or ID.

       These 2 flags are mutual-exclusive; If none of them is set then
       DNS is the default.

       The cm event RDMA_CM_EVENT_ADDRINFO_RESOLVED (on success) or
       RDMA_CM_EVENT_ADDRINFO_ERROR (on failure) is generated.

SEE ALSO         top

       rdma_getaddrinfo(3), rdma_query_addrinfo(3)

AUTHOR         top

       Mark Zhang < <markzhang@nvidia.com> >

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2026-01-16.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2026-01-15.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                2025-02-06          RDMA_RE...ADDRINFO(3)

Pages that refer to this page: rdma_getaddrinfo(3)rdma_query_addrinfo(3)rdma_cm(7)