.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "IBV_QUERY_GID_EX" "3" "2020-04-24" "libibverbs" "Libibverbs Programmer\[cq]s Manual"
.hy
.SH NAME
.PP
ibv_query_gid_ex - Query an InfiniBand port\[cq]s GID table entry
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <infiniband/verbs.h>

int ibv_query_gid_ex(struct ibv_context *context,
                     uint32_t port_num,
                     uint32_t gid_index,
                     struct ibv_gid_entry *entry,
                     uint32_t flags);
\f[R]
.fi
.SH DESCRIPTION
.PP
\f[B]ibv_query_gid_ex()\f[R] returns the GID entry at \f[I]entry\f[R]
for \f[I]gid_index\f[R] of port \f[I]port_num\f[R] for device context
\f[I]context\f[R].
.SH ARGUMENTS
.TP
\f[I]context\f[R]
The context of the device to query.
.TP
\f[I]port_num\f[R]
The number of port to query its GID table.
.TP
\f[I]gid_index\f[R]
The index of the GID table entry to query.
.TP
## \f[I]entry\f[R] Argument
An ibv_gid_entry struct, as defined in <infiniband/verbs.h>.
.RS
.IP
.nf
\f[C]
struct ibv_gid_entry {
    union ibv_gid gid;
    uint32_t gid_index;
    uint32_t port_num;
    uint32_t gid_type;
    uint32_t ndev_ifindex;
};
\f[R]
.fi
.PP
\f[I]gid\f[R]
.RE
.IP
.nf
\f[C]
    The GID entry.
\f[R]
.fi
.RS
.PP
\f[I]gid_index\f[R]
.RE
.IP
.nf
\f[C]
    The GID table index of this entry.
\f[R]
.fi
.RS
.PP
\f[I]port_num\f[R]
.RE
.IP
.nf
\f[C]
    The port number that this GID belongs to.
\f[R]
.fi
.RS
.PP
\f[I]gid_type\f[R]
.RE
.IP
.nf
\f[C]
    enum ibv_gid_type, can be one of IBV_GID_TYPE_IB, IBV_GID_TYPE_ROCE_V1 or IBV_GID_TYPE_ROCE_V2.
\f[R]
.fi
.RS
.PP
\f[I]ndev_ifindex\f[R]
.RE
.IP
.nf
\f[C]
    The interface index of the net device associated with this GID.
    It is 0 if there is no net device associated with it.
\f[R]
.fi
.TP
\f[I]flags\f[R]
Extra fields to query post \f[I]ndev_ifindex\f[R], for now must be 0.
.SH RETURN VALUE
.PP
\f[B]ibv_query_gid_ex()\f[R] returns 0 on success or errno value on
error.
.SH ERRORS
.TP
ENODATA
\f[I]gid_index\f[R] is within the GID table size of port
\f[I]port_num\f[R] but there is no data in this index.
.SH SEE ALSO
.PP
\f[B]ibv_open_device\f[R](3), \f[B]ibv_query_device\f[R](3),
\f[B]ibv_query_pkey\f[R](3), \f[B]ibv_query_port\f[R](3),
\f[B]ibv_query_gid_table\f[R](3)
.SH AUTHOR
.PP
Parav Pandit <parav@nvidia.com>
