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 memory-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 non-NULL, the total size in bytes of the raw file is stored in *ptr.

The returned buffer is read-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 non-NULL) is set to 0.

SEE ALSO¶

libelf(3), elf(5)

ATTRIBUTES¶

REPORTING BUGS¶

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