ibv_gid_reachable - will contact the SA to do a path record lookup from the device,port specified by 'context','port' to the remote 'gid_p'. It finds the status of the remote GID (reachable or unreachable).
#include <infiniband/verbs.h> int ibv_gid_reachable(struct ibv_context *context, uint port, union ibv_gid *gid_p, int timeout) gid_p A pointer to the gid to check context A device context obtained from a call to ibv_open_device(). This identifies the device to use in order to contact the remote 'gid_p'. port Specifies the port on the device associated with 'context'. If '0' then the implementation will choose a port. timeout It is currently set to '0' and reserved for future enhancement. ibv_gid_reachable() will block until a response (success, fail or no path found) is obtained.
Libibverbs Programmer's Manual IBV_GID_REACHABLE(3)
NAME
ibv_gid_reachable - will contact the SA to do a path record lookup from
the device,port specified by 'context','port' to the remote 'gid_p'.
It finds the status of the remote GID (reachable or unreachable).
SYNOPSIS
#include <infiniband/verbs.h>
int ibv_gid_reachable(struct ibv_context *context, uint port,
union ibv_gid *gid_p, int timeout)
gid_p
A pointer to the gid to check
context
A device context obtained from a call to ibv_open_device().
This identifies the device to use in order to contact the
remote 'gid_p'.
port Specifies the port on the device associated with 'context'.
If '0' then the implementation will choose a port.
timeout
It is currently set to '0' and reserved for future enhancement.
ibv_gid_reachable() will block until a response
(success, fail or no path found) is obtained.
DESCRIPTION
ibv_gid_reachable() will contact the SA from the device,port specified
by 'context','port' to the remote 'gid_p'. It finds the status of the
remote 'gid_p' (reachable or not).
ibv_gid_reachable() returns 0 on success, -1 on failure with errno set
as follows:
EINVAL Invalid argument.
ENXIO No Path Found
EIO I/O Error
ENOMEM Could not allocate kernel resource
required to perform the lookup.
EINTR Abort due to interrupted system call.
RETURN VALUE
ibv_gid_reachable() returns 0 on success, and -1 on error.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | network/open-fabrics |
+---------------+-----------------------+
|Stability | Pass-through volatile |
+---------------+-----------------------+
NOTES
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 commu-
nity source was downloaded from ['https://www.openfab-
rics.org/downloads/ibutils/ibutils-1.5.7-0.2.gbd7e502.tar.gz',
'https://www.openfabrics.org/downloads/libibverbs/libib-
verbs-1.1.8.tar.gz', 'https://www.openfabrics.org/down-
loads/libmlx4/libmlx4-1.0.6.tar.gz', 'https://www.openfab-
rics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz',
'https://www.openfabrics.org/downloads/management/infiniband-
diags-1.6.5.tar.gz', 'https://www.openfabrics.org/downloads/man-
agement/libibmad-1.3.12.tar.gz', 'https://www.openfab-
rics.org/downloads/management/libibumad-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.openfabrics.org/down-
loads/qperf/qperf-0.4.9.tar.gz', 'https://www.openfab-
rics.org/downloads/rdmacm/librdmacm-1.0.21.tar.gz',
'https://www.openfabrics.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/.
libibverbs 2012-08-08 IBV_GID_REACHABLE(3)