elf_getshnum(3)

elf_getshnum3

Return the number of sections in an elf file

Usage

#include <libelf.h>

int

elf_getshnum(Elf *elf, size_t *shnum);

Library

library “libelf”

Overview

This function is deprecated. Please use elf_getshdrnum(3) instead.

Function elf_getshnum() retrieves the number of ELF sections associated with descriptor elf and stores it into the location pointed to by argument shnum.

This routine allows applications to uniformly process both normal ELF objects, and ELF objects that use extended section numbering.

Return values

Function elf_getshnum() returns a non-zero value if successful, or zero in case of an error.

Errors

Function elf_getshnum() 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.

Releases

44 releases since FreeBSD 7.0-RELEASE; the text changed 20 times.

  1. 7.0
  2. 7.1
  3. 7.2
  4. 7.3
  5. 7.4
  6. 8.0
  7. 8.1
  8. 8.2
  9. 8.3
  10. 8.4
  11. 9.0
  12. 9.1
  13. 9.2
  14. 9.3
  15. 10.0
  16. 10.1
  17. 10.2
  18. 10.3
  19. 10.4
  20. 11.0–12.0
  21. 12.1–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.