www.LinuxHowtos.org

GELF_OFFSCN

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

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 no-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 no-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.

ATTRIBUTES

Interface	Attribute	Value
gelf_offscn()	Thread safety	M-Safe

REPORTING BUGS

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