elf_getshstrndx3
Retrieve/update the index of the section name string table
Usage
int
int
Library
library “libelf”
Overview
Function elf_getshstrndx() is deprecated. Please use elf_getshdrstrndx(3) instead.
Function elf_getshstrndx() retrieves the section index of the string table containing section names from descriptor elf and stores it into the location pointed to by argument ndxptr.
Function elf_setshstrndx() sets the index of the section name string table to argument ndx.
These routines allow applications to process both normal ELF objects and ELF objects that use extended section numbering uniformly.
Return values
These functions return a non-zero value if successful, or zero in case of an error.
Errors
These functions can fail with the following errors:
- [ELF_E_ARGUMENT]
-
A NULL value was passed in for argument elf.
- [ELF_E_ARGUMENT]
-
Argument elf was not for an ELF file.
- [ELF_E_ARGUMENT]
-
Argument elf lacks an ELF Executable header.
- [ELF_E_ARGUMENT]
-
Argument ndx contained a value in the reserved range of section indices.
History
- FreeBSD 16.0-CURRENT (2026-10-27) to FreeBSD 12.1-RELEASE: the text shown here
- FreeBSD 12.0-RELEASE to FreeBSD 11.0-RELEASE
- FreeBSD 10.4-RELEASE
- FreeBSD 10.3-RELEASE
- FreeBSD 10.2-RELEASE
- FreeBSD 10.1-RELEASE
- FreeBSD 10.0-RELEASE
- FreeBSD 9.3-RELEASE
- FreeBSD 9.2-RELEASE
- FreeBSD 9.1-RELEASE
- FreeBSD 9.0-RELEASE
- FreeBSD 8.4-RELEASE
- FreeBSD 8.3-RELEASE
- FreeBSD 8.2-RELEASE
- FreeBSD 8.1-RELEASE
- FreeBSD 8.0-RELEASE
- FreeBSD 7.4-RELEASE
- FreeBSD 7.3-RELEASE
- FreeBSD 7.2-RELEASE
- FreeBSD 7.1-RELEASE
- FreeBSD 7.0-RELEASE