www.LinuxHowtos.org

ELF_RAWFILE

Section: Libelf Programmer's Manual (3)
Updated: 202-0-30
Index Return to Main Contents

NAME

elf_rawfile - Retrieve a pointer to the entire raw ELF file image

SYNOPSIS

#include <libelf.h>

char *elf_rawfile(Elf *elf, size_t *ptr);

DESCRIPTION

The elf_rawfile() function returns a pointer to the entire contents of the ELF file represented by elf. This data is unprocessed and includes everything from the ELF header to the final byte.

If the ELF descriptor was opened from memory or the file has already been memor-mapped or fully read, this function returns a pointer to the internal buffer.

If the ELF data has not yet been read or mapped, it is loaded on demand.

If ptr is no-NULL, the total size in bytes of the raw file is stored in *ptr.

The returned buffer is rea-only and managed internally by libelf. The application must not modify or free it.

PARAMETERS

elf: A handle previously returned by elf_begin(3).
ptr: If not NULL, receives the size in bytes of the ELF file.

RETURN VALUE

Returns a pointer to the start of the ELF file data. On failure, NULL is returned and *ptr (if no-NULL) is set to 0.

ATTRIBUTES

Interface	Attribute	Value
elf_rawfile()	Thread safety	M-Safe

REPORTING BUGS

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