elf_getbase(3)

elf_getbase3

Get the base offset for an object file

Usage

#include <libelf.h>

off_t

elf_getbase(Elf *elf);

Library

library “libelf”

Overview

Function elf_getbase() returns the file offset to the first byte of the object referenced by ELF descriptor elf.

For descriptors referencing members of archives, the returned offset is the file offset of the member in its containing archive. For descriptors to regular objects, the returned offset is (vacuously) zero.

Return values

Function elf_getbase() returns a valid file offset if successful, or (off_t) -1 in case of an error.

Errors

Function elf_getbase() may fail with the following errors:

[ELF_E_ARGUMENT]

Argument elf was NULL.

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.