GELF_OFFSCN(3)

NAME
gelf_offscn - return descriptor for an ELF section at a given file offset

SYNOPSIS
#include <gelf.h>

Elf_Scn *gelf_offscn(Elf *elf, GElf_Off offset);

DESCRIPTION
gelf_offscn() retrieves the section descriptor for the non-empty section with sh_offset equal to offset. This function will not return descriptors for SHT_NOBITS sections since they are empty by definition.

PARAMETERS

elf Pointer to an ELF descriptor with kind ELF_K_ELF.

offset
    The file offset (in bytes) of the section to be retrieved.

RETURN VALUE
On success, gelf_offscn() returns a pointer to the Elf_Scn of the non-empty section with a sh_offset matching offset.

On failure, NULL is returned and elf_errno is set to indicate the error. If elf is NULL, then NULL is returned without setting elf_errno.

SEE ALSO
elf32_offscn(3), elf64_offscn(3), libelf(3), elf(5)

ATTRIBUTES
Interface | Attribute | Value
 | Thread safety | MT-Safe

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

HISTORY gelf_offscn first appeared in elfutils 0.112. This elfutils libelf function may not be found in other libelf implementations.