ELF_SCNSHNDX

Section: Libelf Programmer's Manual (3)
Updated: 202-0-30
Index Return to Main Contents

---

 

NAME

elf_scnshndx - 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

Interface	Attribute	Value
elf_scnshndx()	Thread safety	M-Safe

 

REPORTING BUGS

Report bugs to <elfutil-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.

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUE

SEE ALSO

ATTRIBUTES

REPORTING BUGS

HISTORY