NAME
elf32_getshdr
,
elf64_getshdr
, gelf_getshdr
— retrieve the class-dependent
section header
LIBRARY
library “libelf”
SYNOPSIS
#include
<libelf.h>
Elf32_Shdr *
elf32_getshdr
(Elf_Scn
*scn);
Elf64_Shdr *
elf64_getshdr
(Elf_Scn
*scn);
#include
<gelf.h>
GElf_Shdr *
gelf_getshdr
(Elf_Scn
*scn, GElf_Shdr
*shdr);
DESCRIPTION
These functions return a pointer to the ELF Section Header data structure associated with section descriptor scn.Function
elf32_getshdr
()
retrieves a pointer to an Elf32_Shdr structure.
Section descriptor scn must be associated with an ELF
descriptor of class ELFCLASS32
.
Function
elf64_getshdr
()
retrieves a pointer to an Elf64_Shdr structure.
Section descriptor scn must be associated with an ELF
descriptor of class ELFCLASS64
.
Function
gelf_getshdr
()
copies the values in the section header associated with argument
scn to the structure pointed to be argument
dst. The GElf_Shdr data
structure is described in
gelf(3).
RETURN VALUES
Functions elf32_getshdr
() and
elf64_getshdr
() return a valid pointer to the
appropriate section header on success or NULL if an error was
encountered.
Function gelf_getshdr
() returns argument
dst if successful, or NULL if an error was
encountered.
ERRORS
These functions may fail with the following errors:
- [
ELF_E_ARGUMENT
] - Arguments scn or shdr were NULL.
- [
ELF_E_ARGUMENT
] - Argument scn was not associated a descriptor for an ELF object.
- [
ELF_E_CLASS
] - The ELF class associated with the section descriptor scn did not match the class expected by the API.