Manual Pages — GELF_GETSHDR

NAME

elf32_getshdr, elf64_getshdr, gelf_getshdr – retrieve the class-dependent section header

LIBRARY
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

LIBRARY

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.

Ken Thompson has an automobile which he helped design. Unlike most automobiles, it has neither speedometer, nor gas gauge, nor any of the other numerous idiot lights which plague the modern driver. Rather, if the driver makes a mistake, a giant “?” lights up in the center of the dashboard. “The experienced driver,” says Thompson, “will usually know what's wrong.”

”