---
name: "ibv_query_gid"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/ibv_query_gid"
---

# ibv\_query\_gid(3)

query an InfiniBand port's GID table

## NAME

ibv\_query\_gid - query an InfiniBand port's GID table

## SYNOPSIS

```
#include <infiniband/verbs.h>

int ibv_query_gid(struct ibv_context *context, uint8_t port_num,
                  int index, union ibv_gid *gid);
```

## DESCRIPTION

**ibv\_query\_gid()** returns the GID value in entry *index* of port *port\_num* for device context *context* through the pointer *gid.*

## RETURN VALUE

**ibv\_query\_gid()** returns 0 on success, and -1 on error.

## SEE ALSO

[**ibv\_open\_device**(3)](/ibv_open_device/3.md), [**ibv\_query\_device**(3)](/ibv_query_device/3.md), [**ibv\_query\_port**(3)](/ibv_query_port/3.md), [**ibv\_query\_pkey**(3)](/ibv_query_pkey/3.md)

## AUTHORS

- Dotan Barak \<dotanba@gmail.com\>