---
name: "gelf_getversym"
section: "3"
platform: "linux"
package: "libelf"
version: "0.197-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gelf_getversym"
---

# gelf\_getversym(3)

retrieve GNU symbol versioning entries

## NAME

gelf\_getversym, gelf\_getverdef, gelf\_getverdaux, gelf\_getverneed, gelf\_getvernaux - retrieve GNU symbol versioning entries

## SYNOPSIS

```
#include <gelf.h>
GElf_Versym  *gelf_getversym (Elf_Data *data, int ndx, GElf_Versym  *dst);
GElf_Verdef  *gelf_getverdef (Elf_Data *data, int offset, GElf_Verdef  *dst);
GElf_Verdaux *gelf_getverdaux(Elf_Data *data, int offset, GElf_Verdaux *dst);
GElf_Verneed *gelf_getverneed(Elf_Data *data, int offset, GElf_Verneed *dst);
GElf_Vernaux *gelf_getvernaux(Elf_Data *data, int offset, GElf_Vernaux *dst);
```

## DESCRIPTION

These functions provide class-independent access to GNU ELF symbol version information. The requested entry is retrieved from *data* and stored in the caller-supplied *dst*.

- **gelf\_getversym**()

  Retrieves the symbol version index at index *ndx* from the **SHT\_GNU\_versym** section associated with *data*.

- **gelf\_getverdef**()

  Retrieves the version definition entry at section offset *offset* from the **SHT\_GNU\_verdef** section associated with *data*.

- **gelf\_getverdaux**()

  Retrieves the version definition auxiliary entry at section offset *offset* from the **SHT\_GNU\_verdef** section associated with *data*.

- **gelf\_getverneed**()

  Retrieves the version needed entry at section offset *offset* from the **SHT\_GNU\_verneed** section associated with *data*.

- **gelf\_getvernaux**()

  Retrieves the version needed auxiliary entry at section offset *offset* from the **SHT\_GNU\_verneed** section associated with *data*.

## PARAMETERS

- *data*

  Pointer to an **Elf\_Data** corresponding to the appropriate GNU versioning section.

- *ndx*

  (For **gelf\_getversym**() only.) Zero-based index of the entry within *data*.

- *offset*

  (For **gelf\_getverdef**(), **gelf\_getverdaux**(), **gelf\_getverneed**(), and **gelf\_getvernaux**().) Section-relative byte offset of the entry within *data*.

- *dst*

  Pointer to a caller-provided entry of the appropriate type: **GElf\_Versym**, **GElf\_Verdef**, **GElf\_Verdaux**, **GElf\_Verneed**, or **GElf\_Vernaux**. This argument must not be NULL.

## RETURN VALUE

On success, these functions store the requested entry in *dst* and return *dst*. On failure, these functions return NULL and set elf\_errno.  If *data* is NULL, then NULL is returned without setting elf\_errno.

## SEE ALSO

[**gelf\_update\_verdaux**(3)](/gelf_update_verdaux/3.md), [**gelf\_update\_verdef**(3)](/gelf_update_verdef/3.md), [**gelf\_update\_vernaux**(3)](/gelf_update_vernaux/3.md), [**gelf\_update\_verneed**(3)](/gelf_update_verneed/3.md), [**gelf\_update\_versym**(3)](/gelf_update_versym/3.md), [**libelf**(3)](/libelf/3.md), [**elf**(5)](/elf/5.md)

## ATTRIBUTES

| | | |
| --- | --- | --- |
| **Interface** | **Attribute** | **Value** |
| **gelf\_getversym**(), **gelf\_getverdef**(), **gelf\_getverdaux(),** **gelf\_getverneed**(), **gelf\_getvernaux**() | Thread safety | MT-Safe |

## REPORTING BUGS

Report bugs to \<elfutils-devel@sourceware.org\> or https://sourceware.org/bugzilla/.