freebsd man page for gelf_update_rela

Query: gelf_update_rela

OS: freebsd

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

GELF_GETRELA(3) 					   BSD Library Functions Manual 					   GELF_GETRELA(3)

NAME
gelf_getrela, gelf_update_rela -- read and update ELF relocation entries with addends
LIBRARY
ELF Access Library (libelf, -lelf)
SYNOPSIS
#include <gelf.h> GElf_Rela * gelf_getrela(Elf_Data *data, int ndx, GElf_Rela *rela); int gelf_update_rela(Elf_Data *data, int ndx, GElf_Rela *rela);
DESCRIPTION
These convenience functions are used to retrieve and update class-dependent Elf32_Rela or Elf64_Rela structures in an ELF object. Argument data is an Elf_Data descriptor associated with a section of type SHT_RELA. Argument ndx is the index of the entry being retrieved or updated. The class-independent GElf_Rela structure is described in gelf(3). Function gelf_getrela() retrieves the class-dependent entry at index ndx in data buffer data and copies it to the destination pointed to by argument rela after translation to class-independent form. Function gelf_update_rela() converts the class-independent entry pointed to by argument rela to class-dependent form, and writes it to the entry at index ndx in the data buffer described by argument data. Function gelf_update_rela() signals an error if any of the values in the class-independent representation exceeds the representable limits of the target type.
RETURN VALUES
Function gelf_getrela() returns the value of argument rela if successful, or NULL in case of an error. Function gelf_update_rela() returns a non-zero value if successful, or zero in case of an error.
ERRORS
These functions may fail with the following errors: [ELF_E_ARGUMENT] Arguments data or rela were NULL. [ELF_E_ARGUMENT] Argument ndx was less than zero or larger than the number of entries in the data descriptor. [ELF_E_ARGUMENT] Data descriptor data was not associated with a section of type SHT_RELA. [ELF_E_RANGE] A value was not representable in the target type.
SEE ALSO
elf(3), elf_getdata(3), elf_getscn(3), gelf(3)
BSD
August 29, 2006 BSD
Related Man Pages
gelf_getrel(3) - freebsd
gelf_getrela(3) - netbsd
gelf_update_dyn(3) - netbsd
gelf_update_cap(3) - netbsd
gelf_update_rel(3) - netbsd
Similar Topics in the Unix Linux Community
FreeBSD Kernel Internals, Dr. Marshall Kirk McKusick
Scripts without shebang
Reason for no directory creation date
Valid separator in time and date format