elf32_newehdr3

Usage

#include <libelf.h>
Elf32_Ehdr *elf32_newehdr(Elf *elf);
Elf64_Ehdr *elf64_newehdr(Elf *elf);

Overview

This function initializes a new ELF header and associates it with elf. If elf already has an ELF header associated with it, no new header will be created and the existing header will be returned. An ELF header must be present before calling elf_newscn or elf_newphdr.

Parameters

elf

ELF descriptor for which a new ELF header is to be created.

Return value

On success, return a pointer to the newly created ELF header. If elf already has an ELF header associated with it, this pre-existing header is returned and no new header is created. On failure, return NULL and set a libelf error code.

Attributes

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