ELF_RAWFILE(3)            Libelf Programmer's Manual            ELF_RAWFILE(3)



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

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Attribute     | Value   |
       +--------------------------------------------+---------------+---------+
       |elf_rawfile ()                              | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+

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

Libelf                            2025-06-30                    ELF_RAWFILE(3)