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)