elf32_newphdr - Man Page

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

InterfaceAttributeValue
elf32_newphdr(), elf64_newphdr()Thread safetyMT-Safe

Reporting Bugs

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

Referenced By

elf32_getphdr(3).

The man page elf64_newphdr(3) is an alias of elf32_newphdr(3).

2024-08-14 Libelf Programmer's Manual