elf_getshdrnum(3) - NetBSD Manual Pages

ELF_GETSHDRNUM(3)       NetBSD Library Functions Manual      ELF_GETSHDRNUM(3)


NAME

     elf_getshdrnum -- return the number of sections in an ELF file


LIBRARY

     ELF Object Manipulation Library (libelf, -lelf)


SYNOPSIS

     #include <libelf.h>

     int
     elf_getshdrnum(Elf *elf, size_t *shnum);


DESCRIPTION

     Function elf_getshdrnum() retrieves the number of ELF sections associated
     with descriptor elf and stores it into the location pointed to by argu-
     ment shnum.

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


RETURN VALUES

     Function elf_getshdrnum() returns zero value if successful, or -1 in case
     of an error.


ERRORS

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


SEE ALSO

     elf(3), elf32_getehdr(3), elf64_getehdr(3), elf_getident(3),
     elf_getphdrnum(3), elf_getshdrstrndx(3), gelf(3), gelf_getehdr(3)

NetBSD 10.99                    August 4, 2009                    NetBSD 10.99