table of contents
| ELF_GETDATA_RAWCHUNK(3) | Libelf Programmer's Manual | ELF_GETDATA_RAWCHUNK(3) |
NAME¶
elf_getdata_rawchunk - create a raw data descriptor from a file offset
SYNOPSIS¶
#include <libelf.h>
Elf_Data * elf_getdata_rawchunk("Elf *elf", int64_t offset , size_t size , Elf_Type type );
DESCRIPTION¶
The elf_getdata_rawchunk() function returns an Elf_Data descriptor that refers to a raw region of the ELF file, starting at the given file offset and spanning size bytes. This is used to access arbitrary byte ranges in the ELF file that may not correspond to any section or segment.
The returned Elf_Data d_buf will be properly aligned for the requested type.
If the file’s byte order matches the host, and alignment permits, the raw data is returned as-is. If the file’s byte order differs, the buffer is converted into native byte order and aligned for direct access. This behaves like elf_getdata(), and not elf_rawdata(). The contents of the return value's d_buf are a decoded representation.
The returned data is not associated with any section or update mechanism. It will not be included in any output written by elf_update(3). It is also owned by libelf and is valid until elf_end() is called on elf.
PARAMETERS¶
- elf
- A pointer to an Elf descriptor representing the ELF file.
- offset
- The starting file offset in bytes. This must lie within the bounds of the file.
- size
- The number of bytes to include in the data chunk, starting at offset.
- type
- An Elf_Type enumeration value indicating the intended interpretation of the data. Values include:
- ELF_T_BYTE
- Raw bytes.
- ELF_T_ADDR, ELF_T_OFF, ELF_T_HALF, ELF_T_WORD, ELF_T_XWORD, ELF_T_SWORD, ELF_T_SXWORD
- Integer and pointer types.
- ELF_T_EHDR, ELF_T_SHDR, ELF_T_PHDR
- ELF file, section, and program headers.
- ELF_T_SYM, ELF_T_DYN, ELF_T_REL, ELF_T_RELA, ELF_T_RELR
- Symbols and relocations.
- ELF_T_NHDR, ELF_T_CHDR, ELF_T_NHDR8
- ELF note headers and compressed data headers.
- ELF_T_VDEF, ELF_T_VDAUX, ELF_T_VNEED, ELF_T_VNAUX
- Versioning structures.
- ELF_T_SYMINFO, ELF_T_MOVE, ELF_T_LIB
- Other ELF metadata.
- ELF_T_GNUHASH
- GNU-style hash table.
- ELF_T_AUXV
- Auxiliary vectors.
RETURN VALUE¶
Returns a pointer to an Elf_Data descriptor on success.
Returns NULL if any arguments are invalid, or if memory allocation or file reading fails. An error code is set which can be retrieved with elf_errmsg(). The result is cached and shared between repeated calls using the same arguments.
SEE ALSO¶
elf(3), elf_errmsg(3), elf_getdata(3), elf_getscn(3), elf_rawdata(3), libelf(3), elf(5)
ATTRIBUTES¶
| Interface | Attribute | Value |
| elf_getdata_rawchunk () | Thread safety | MT-Safe |
REPORTING BUGS¶
Report bugs to <elfutils-devel@sourceware.org> or https://sourceware.org/bugzilla/.
HISTORY¶
elf_getdata_rawchunk first appeared in elfutils 0.130. This function is a elfutils libelf extension and may not be available in other libelf implementations.
| 2025-06-30 | Libelf |