z/OS Version 2 Release 3 DWARF/ELF Extensions Library Reference IBM SC14-7312-30 Note Before using this information and the product it supports, read the information in “Notices” on page 201. This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-02-15 © Copyright International Business Machines Corporation 2004, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this document.............................................................................................xi Who should use this document...................................................................................................................xi A note about examples...............................................................................................................................xii CDA and related publications.....................................................................................................................xii Softcopy documents..................................................................................................................................xiv Where to find more information................................................................................................................ xiv How to send your comments............................................................................................................... xiv Chapter 1. About Common Debug Architecture.......................................................1 DWARF program information.......................................................................................................................2 IBM extensions to libdwarf..........................................................................................................................3 Changes to DWARF/ELF library extensions........................................................................................... 3 Chapter 2. Debugging Information Entry (DIE) extensions.......................................5 Program scope entries................................................................................................................................. 5 Normal and partial compilation unit entries..........................................................................................5 Byte and bit entries................................................................................................................................ 6 Subroutine and entry point entries........................................................................................................ 6 Source view entries................................................................................................................................ 6 Object oriented COBOL................................................................................................................................7 Data object and object list entries...............................................................................................................7 Data object entries................................................................................................................................. 7 Referencing coordinates..............................................................................................................................8 Base location entries................................................................................................................................... 8 Type entries..................................................................................................................................................9 Base type entries....................................................................................................................................9 Modified type entries............................................................................................................................12 Structure, union, class and interface type entries...............................................................................12 String type entries................................................................................................................................ 13 Condition entries.................................................................................................................................. 14 File description entries.........................................................................................................................15 Bound checking information for type entries...................................................................................... 16 Chapter 3. Consumer APIs for standard DWARF sections......................................19 Error object consumer operations.............................................................................................................19 Error handling macros..........................................................................................................................19 dwarf_error_reset operation................................................................................................................ 29 Initialization and termination consumer operations................................................................................ 29 dwarf_elf_init_b operation................................................................................................................... 29 dwarf_goff_init_with_csvquery_token operation................................................................................ 32 dwarf_goff_init_with_PO_filename operation.....................................................................................33 dwarf_raw_binary_init operation.........................................................................................................34 dwarf_set_codeset operation.............................................................................................................. 35 dwarf_super_elf_init operation............................................................................................................ 36 ELF symbol table and section consumer operations................................................................................37 ELF symbol table.................................................................................................................................. 37 dwarf_elf_symbol_index_list operation.............................................................................................. 38 dwarf_elf_symbol operation.................................................................................................................39 dwarf_elf_section operation.................................................................................................................39 Generalized DIE-section consumer APIs..................................................................................................40 iii IBM Extensions to DWARF DIE-sections.............................................................................................40 Dwarf_section_type enumeration........................................................................................................40 Dwarf_section_content enumeration.................................................................................................. 41 dwarf_debug_section operation.......................................................................................................... 41 dwarf_debug_section_name operation...............................................................................................42 dwarf_next_unit_header operation..................................................................................................... 43 dwarf_reset_unit_header operation....................................................................................................44 DIE locating consumer operations............................................................................................................44 dwarf_rootof operation........................................................................................................................ 44 dwarf_parent operation....................................................................................................................... 45 dwarf_offdie_in_section operation...................................................................................................... 46 dwarf_nthdie operation........................................................................................................................46 dwarf_clone operation..........................................................................................................................47 dwarf_pcfile operation......................................................................................................................... 48 dwarf_pcsubr operation.......................................................................................................................48 dwarf_pcscope operation.................................................................................................................... 49 Multiple DIEs locating consumer operations............................................................................................50 dwarf_tagdies operation.....................................................................................................................