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.

 

SEE ALSO

libelf(3), elf(5)

 

ATTRIBUTES

Interface	Attribute	Value
elf_rawfile()	Thread safety	M-Safe

 

REPORTING BUGS

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

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUE

SEE ALSO

ATTRIBUTES

REPORTING BUGS