ELF_GETDATA_RAWCHUNK

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

---

 

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 a-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

GN-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	M-Safe

 

REPORTING BUGS

Report bugs to <elfutil-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.

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

PARAMETERS

RETURN VALUE

SEE ALSO

ATTRIBUTES

REPORTING BUGS

HISTORY