ELF32\_NEWPHDR(3) Libelf Programmer's Manual ELF32\_NEWPHDR(3)

# [NAME](#NAME)

elf32\_newphdr, elf64\_newphdr - create a new program header table for a 32-bit or 64-bit ELF object file

# [SYNOPSIS](#SYNOPSIS)

```
#include <libelf.h>
Elf32_Phdr *elf32_newphdr(Elf *elf, size_t count);
Elf64_Phdr *elf64_newphdr(Elf *elf, size_t count);
```

# [DESCRIPTION](#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](#PARAMETERS)

[*elf*](#elf)

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

[*count*](#count)

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

# [RETURN VALUE](#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](#SEE_ALSO)

[**elf32\_newehdr**(3)](/man/os/elfutils/elf32_newehdr.3), [**elf\_errno**(3)](/man/os/elfutils/elf_errno.3), [**libelf**(3)](/man/os/elfutils/libelf.3), [**elf**(5)](/man/os/elfutils/elf.5)

# [ATTRIBUTES](#ATTRIBUTES)

For an explanation of the terms used in this section, see [**attributes**(7)](/man/os/elfutils/attributes.7).

**Interface** **Attribute** **Value** elf32\_newphdr (), elf64\_newphdr () Thread safety MT-Safe

# [REPORTING BUGS](#REPORTING_BUGS)

Report bugs to &lt;elfutils-devel@sourceware.org&gt; or https://sourceware.org/bugzilla/.

2024-08-14 Libelf

---

Document: elf32_newphdr(3) from elfutils 0.197-r0 (Chainguard OS)
Source: https://sourceware.org/git/elfutils.git
