gelf_update_rela man page on FreeBSD

Printed from http://www.polarhome.com/service/man/?qf=gelf_update_rela&af=0&tf=2&of=FreeBSD

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
     library “libelf”

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-depen‐
     dent 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 argu‐
     ment 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 num‐
		       ber 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
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net