elf_scnshndx - Man Page

Find the index of the SHT_SYMTAB_SHNDX section associated with a symbol table

Synopsis

#include <libelf.h>

int elf_scnshndx(Elf_Scn *scn);

Description

The elf_scnshndx() function searches for the SHT_SYMTAB_SHNDX section associated with a given symbol table section. It returns the section index of the corresponding SHT_SYMTAB_SHNDX section, or zero if none is found.

This function is used for retrieving extended section indices in ELF files with many sections, where standard symbol table entries cannot store all possible section references directly.

The function only returns a valid result if scn refers to a section of type SHT_SYMTAB. Otherwise, the function returns 0.

Parameters

scn

An Elf_Scn pointer referencing a symbol table section.

Return Value

Returns the section index of the SHT_SYMTAB_SHNDX section if found. If no such section is found, returns 0. On error, returns -1.

See Also

libelf(3), elf(5)

Attributes

InterfaceAttributeValue
elf_scnshndx()Thread safetyMT-Safe

Reporting Bugs

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

History

elf_scnshndx first appeared in elfutils 0.132.  This function is a elfutils libelf extension and may not be available in other libelf implementations.

Info

2025-06-30 Libelf Programmer's Manual