|
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
RDMA_RE...ADDRINFO(3) Librdmacm Programmer's Manual RDMA_RE...ADDRINFO(3)
RDMA_RESOLVE_ADDRINFO - Resolve RDMA addresses which supports both
DNS and IB SA.
#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);
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.
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().
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.
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.
rdma_getaddrinfo(3), rdma_query_addrinfo(3)
Mark Zhang < <markzhang@nvidia.com> >
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)