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
DWARF_TRANSFORM_TO_DISK_FORM(3) FreeBSD Library Functions Manual DWARF_TRANSFORM_TO_DISK_FORM(3)

dwarf_transform_to_disk_form
transform DWARF information into byte streams

DWARF Access Library (libdwarf, -ldwarf)

#include <libdwarf.h>

Dwarf_Signed
dwarf_transform_to_disk_form(Dwarf_P_Debug dbg, Dwarf_Error *err);

Function dwarf_transform_to_disk_form() transforms the DWARF information gathered by the producer into byte streams for the application to write out as ELF sections. If the flag DW_DLC_SYMBOLIC_RELOCATIONS is set on the producer, the function will also generate the associated relocation arrays.

Argument dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3).

If argument err is not NULL, it will be used to store error information in case of an error.

After a call to this function, the application can call the function dwarf_get_section_bytes(3) to retrieve the byte streams for each ELF section. If the flag DW_DLC_SYMBOLIC_RELOCATIONS was set on the descriptor, the application can also call the function dwarf_get_relocation_info(3) to retrieve the generated relocation arrays.

On success, function dwarf_transform_to_disk_form() returns the total number of ELF sections generated. In case of an error, function dwarf_transform_to_disk_form() returns DW_DLV_NOCOUNT and sets the argument err.

Function dwarf_transform_to_disk_form() can fail with:
[]
Argument dbg was NULL.
[]
An out of memory condition was encountered during execution.

dwarf(3), dwarf_get_relocation_info(3), dwarf_get_section_bytes(3), dwarf_producer_init(3), dwarf_producer_init_b(3)
August 25, 2011 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.