Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


ELF_GETSHNUM(3)            Library Functions Manual            ELF_GETSHNUM(3)

NAME
     elf_getshnum - return the number of sections in an ELF file

LIBRARY
     ELF Access Library (libelf, -lelf)

SYNOPSIS
     #include <libelf.h>

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

DESCRIPTION
     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.

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 5, 2009                    NetBSD 10.99