GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
GELF_GETREL(3) FreeBSD Library Functions Manual GELF_GETREL(3)

gelf_getrel, gelf_update_rel
read and update ELF relocation entries

ELF Access Library (libelf, -lelf)

#include <gelf.h>

GElf_Rel *
gelf_getrel(Elf_Data *data, int ndx, GElf_Rel *rel);

int
gelf_update_rel(Elf_Data *data, int ndx, GElf_Rel *rel);

These convenience functions are used to retrieve and update class-dependent Elf32_Rel or Elf64_Rel structures in an ELF object.

Argument data is an Elf_Data descriptor associated with a section of type SHT_REL. Argument ndx is the index of the entry being retrieved or updated. The class-independent GElf_Rel structure is described in gelf(3).

Function gelf_getrel() retrieves the class-dependent entry at index ndx in data buffer data and copies it to the destination pointed to by argument rel after translation to class-independent form.

Function gelf_update_rel() converts the class-independent entry pointed to by argument rel to class-dependent form, and writes it to the entry at index ndx in the data buffer described by argument data. Function gelf_update_rel() signals an error if any of the values in the class-independent representation exceeds the representable limits of the target type.

Function gelf_getrel() returns the value of argument rel if successful, or NULL in case of an error. Function gelf_update_rel() returns a non-zero value if successful, or zero in case of an error.

These functions may fail with the following errors:
[]
Arguments data or rel were NULL.
[]
Argument ndx was less than zero or larger than the number of entries in the data descriptor.
[]
Data descriptor data was not associated with a section of type SHT_REL.
[]
A value was not representable in the target type.
[]
The Elf_Data descriptor denoted by argument data is associated with an ELF object with an unsupported version.

elf(3), elf_getdata(3), elf_getscn(3), gelf(3)
April 22, 2019 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.