ELF32_NEWPHDR(3)          Libelf Programmer's Manual          ELF32_NEWPHDR(3)



NAME
       elf32_newphdr, elf64_newphdr - create a new program header table for a
       32-bit or 64-bit ELF object file


SYNOPSIS
       #include <libelf.h>

       Elf32_Phdr *elf32_newphdr(Elf *elf, size_t count);
       Elf64_Phdr *elf64_newphdr(Elf *elf, size_t count);


DESCRIPTION
       Create a new program header table for the ELF object file referred to
       by elf.  The number of entries in the new program header table is
       specified by count.  A count of zero removes the existing program
       header table.

       The function allocates a new array of Elf32_Phdr and makes it the
       program header table for elf.  The new program header contents are set
       to zero and any previous program header table is discarded.  An ELF
       header must exist before creating a program header table.


PARAMETERS
       elf    Pointer to the ELF object for which a new program header table
              is to be created.


       count  The number of entries in the new program header table. A count
              of zero removes the existing program header table.


RETURN VALUE
       On success, return a pointer to the first Elf32_Phdr in the newly
       created program header table.  If elf is NULL then return NULL.  If an
       error occurs, return NULL and set a libelf error code.


SEE ALSO
       elf32_newehdr(3), elf_errno(3), libelf(3), elf(5)


ATTRIBUTES
       For an explanation of the terms used in this section, see
       attributes(7).

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Attribute     | Value   |
       +--------------------------------------------+---------------+---------+
       |elf32_newphdr (), elf64_newphdr ()          | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+

REPORTING BUGS
       Report bugs to <elfutils-devel@sourceware.org> or
       https://sourceware.org/bugzilla/.

Libelf                            2024-08-14                  ELF32_NEWPHDR(3)