1 /*

     2 

     3   Copyright (C) 2000,2001,2002,2005,2006 Silicon Graphics, Inc.  All Rights Reserved.

     4   Portions Copyright 2007 Sun Microsystems, Inc. All rights reserved.

     5 

     6   This program is free software; you can redistribute it and/or modify it

     7   under the terms of version 2.1 of the GNU Lesser General Public License

     8   as published by the Free Software Foundation.

     9 

    10   This program is distributed in the hope that it would be useful, but

    11   WITHOUT ANY WARRANTY; without even the implied warranty of

    12   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

    13 

    14   Further, this software is distributed without any warranty that it is

    15   free of the rightful claim of any third person regarding infringement

    16   or the like.  Any license provided herein, whether implied or

    17   otherwise, applies only to this software file.  Patent licenses, if

    18   any, provided herein do not apply to combinations of this program with

    19   other software, or any other product whatsoever.

    20 

    21   You should have received a copy of the GNU Lesser General Public

    22   License along with this program; if not, write the Free Software

    23   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston MA 02110-1301,

    24   USA.

    25 

    26   Contact information:  Silicon Graphics, Inc., 1500 Crittenden Lane,

    27   Mountain View, CA 94043, or:

    28 

    29   http://www.sgi.com

    30 

    31   For further information regarding this notice, see:

    32 

    33   http://oss.sgi.com/projects/GenInfo/NoticeExplan

    34 

    35 */

    36 

    37 

    38 #ifndef _LIBDWARF_H

    39 #define _LIBDWARF_H

    40 #ifdef __cplusplus

    41 extern "C" {

    42 #endif

    43 /*

    44 	libdwarf.h  

    45 	$Revision: 1.88 $ $Date: 2006/04/18 04:46:07 $

    46 

    47 	For libdwarf producers and consumers

    48 

    49 	The interface is defined as having 8-byte signed and unsigned

    50 	values so it can handle 64-or-32bit target on 64-or-32bit host.

    51 	Addr is the native size: it represents pointers on

    52 	the host machine (not the target!).

    53 

    54 	This contains declarations for types and all producer

    55 	and consumer functions.

    56 

    57 	Function declarations are written on a single line each here

    58 	so one can use grep  to each declaration in its entirety.

    59 	The declarations are a little harder to read this way, but...

    60 

    61 */

    62 

    63 #ifdef __SGI_FAST_LIBELF

    64 struct elf_sgi;

    65 typedef struct elf_sgi* dwarf_elf_handle;

    66 #else

    67 struct Elf;

    68 typedef struct Elf* dwarf_elf_handle;

    69 #endif

    70 

    71 #if (_MIPS_SZLONG == 64)

    72 /* Special case for MIPS, so -64 (LP64) build gets simple -long-.

    73    Non-MIPS LP64 or ILP64 environments should probably ensure

    74    _MIPS_SZLONG set to 64 everywhere this header is #included.

    75 */

    76 typedef int             Dwarf_Bool;         /* boolean type */

    77 typedef unsigned long   Dwarf_Off;          /* 4 or 8 byte file offset */

    78 typedef unsigned long   Dwarf_Unsigned;     /* 4 or 8 byte unsigned value */

    79 typedef unsigned short  Dwarf_Half;         /* 2 byte unsigned value */

    80 typedef unsigned char   Dwarf_Small;        /* 1 byte unsigned value */

    81 typedef signed   long   Dwarf_Signed;       /* 4 or 8 byte signed value */

    82 typedef unsigned long   Dwarf_Addr;         /* target memory address */

    83 #else /* 32-bit */

    84 /* This is for ILP32, allowing i/o of 64bit dwarf info.

    85    Also should be fine for LP64 and ILP64 cases.

    86 */

    87 typedef int                 Dwarf_Bool;     /* boolean type */

    88 typedef unsigned long long  Dwarf_Off;      /* 8 byte file offset */

    89 typedef unsigned long long  Dwarf_Unsigned; /* 8 byte unsigned value*/

    90 typedef unsigned short      Dwarf_Half;     /* 2 byte unsigned value */

    91 typedef unsigned char       Dwarf_Small;    /* 1 byte unsigned value */

    92 typedef signed   long long  Dwarf_Signed;   /* 8 byte signed value */

    93 typedef unsigned long long  Dwarf_Addr;     /* target memory address */

    94 #endif

    95 typedef void*		Dwarf_Ptr;          /* host machine pointer */

    96 

    97 /* Contains info on an uninterpreted block of data

    98 */

    99 typedef struct {

   100         Dwarf_Unsigned  bl_len;         /* length of block */

   101         Dwarf_Ptr       bl_data;        /* uninterpreted data */

   102 	Dwarf_Small     bl_from_loclist; /*non-0 if loclist, else debug_info*/

   103 	Dwarf_Unsigned  bl_section_offset; /* Section (not CU) offset

   104                                         which 'data' comes from. */

   105 } Dwarf_Block;

   106 

   107 

   108 /* location record

   109 */

   110 typedef struct {

   111         Dwarf_Small     lr_atom;        /* location operation */

   112         Dwarf_Unsigned  lr_number;      /* operand */

   113 	Dwarf_Unsigned  lr_number2;     /* for OP_BREGx */

   114 	Dwarf_Unsigned  lr_offset;      /* offset in locexpr for OP_BRA etc */

   115 } Dwarf_Loc;

   116 

   117 

   118 /* location description

   119 */

   120 typedef struct {

   121         Dwarf_Addr      ld_lopc;        /* beginning of active range */ 

   122         Dwarf_Addr      ld_hipc;        /* end of active range */

   123         Dwarf_Half      ld_cents;       /* count of location records */

   124         Dwarf_Loc*      ld_s;           /* pointer to list of same */

   125 	Dwarf_Small     ld_from_loclist; 

   126 				      /* non-0 if loclist, else debug_info*/

   127 

   128 	Dwarf_Unsigned  ld_section_offset; /* Section (not CU) offset

   129 					where loc-expr begins*/

   130 } Dwarf_Locdesc;

   131 

   132 /* Frame description instructions expanded.

   133 */

   134 typedef struct {

   135         Dwarf_Small     fp_base_op;

   136         Dwarf_Small     fp_extended_op;

   137         Dwarf_Half      fp_register;

   138 

   139 	/* Value may be signed, depends on op. 

   140            Any applicable data_alignment_factor has

   141            not been applied, this is the  raw offset. */

   142         Dwarf_Unsigned  fp_offset;

   143         Dwarf_Off       fp_instr_offset;

   144 } Dwarf_Frame_Op; /* DWARF2 */

   145 

   146 typedef struct {

   147         Dwarf_Small     fp_base_op;

   148         Dwarf_Small     fp_extended_op;

   149         Dwarf_Half      fp_register;

   150 

   151 	/* Value may be signed, depends on op. 

   152            Any applicable data_alignment_factor has

   153            not been applied, this is the  raw offset. */

   154         Dwarf_Unsigned  fp_offset_or_block_len; 

   155 	Dwarf_Small     *fp_expr_block;

   156 

   157         Dwarf_Off       fp_instr_offset;

   158 } Dwarf_Frame_Op3;  /* DWARF3 and DWARF2 compatible */

   159 

   160 /*  ***IMPORTANT NOTE, TARGET DEPENDENCY ****

   161    DW_REG_TABLE_SIZE must be at least as large as

   162    the number of registers

   163    (DW_FRAME_LAST_REG_NUM) as defined in dwarf.h

   164    Preferably identical to DW_FRAME_LAST_REG_NUM.

   165    Ensure [0-DW_REG_TABLE_SIZE] does not overlap 

   166    DW_FRAME_UNDEFINED_VAL or DW_FRAME_SAME_VAL. 

   167    Also ensure DW_FRAME_REG_INITIAL_VALUE is set to what

   168    is appropriate to your cpu.

   169    For various CPUs  DW_FRAME_UNDEFINED_VAL is correct

   170    as the value for DW_FRAME_REG_INITIAL_VALUE.

   171 

   172    For consumer apps, this can be set dynamically: see

   173    dwarf_set_frame_rule_table_size();

   174  */

   175 #ifndef DW_REG_TABLE_SIZE

   176 #define DW_REG_TABLE_SIZE  66

   177 #endif

   178 

   179 /* For MIPS, DW_FRAME_SAME_VAL is the correct default value 

   180    for a frame register value. For other CPUS another value

   181    may be better, such as DW_FRAME_UNDEFINED_VAL.

   182    See dwarf_set_frame_rule_table_size

   183 */

   184 #ifndef DW_FRAME_REG_INITIAL_VALUE

   185 #define DW_FRAME_REG_INITIAL_VALUE DW_FRAME_SAME_VAL

   186 #endif

   187 

   188 /* Taken as meaning 'undefined value', this is not

   189    a column or register number.

   190    Only present at libdwarf runtime. Never on disk.

   191    DW_FRAME_* Values present on disk are in dwarf.h

   192    Ensure this is > DW_REG_TABLE_SIZE.

   193 */

   194 #define DW_FRAME_UNDEFINED_VAL          1034

   195 

   196 /* Taken as meaning 'same value' as caller had, not a column

   197    or register number

   198    Only present at libdwarf runtime. Never on disk.

   199    DW_FRAME_* Values present on disk are in dwarf.h

   200    Ensure this is > DW_REG_TABLE_SIZE.

   201 */

   202 #define DW_FRAME_SAME_VAL               1035

   203 

   204 /* For DWARF3 interfaces, make the CFA a column with no

   205    real table number.  This is what should have been done

   206    for the DWARF2 interfaces.  This actually works for

   207    both DWARF2 and DWARF3, but see the libdwarf documentation

   208    on Dwarf_Regtable3 and  dwarf_get_fde_info_for_reg3()

   209    and  dwarf_get_fde_info_for_all_regs3()  

   210    Do NOT use this with the older dwarf_get_fde_info_for_reg()

   211    or dwarf_get_fde_info_for_all_regs() consumer interfaces.

   212 */

   213 #define DW_FRAME_CFA_COL3               1036

   214 

   215 /* The following are all needed to evaluate DWARF3 register rules.

   216 */

   217 #define DW_EXPR_OFFSET 0  /* DWARF2 only sees this. */

   218 #define DW_EXPR_VAL_OFFSET 1

   219 #define DW_EXPR_EXPRESSION 2

   220 #define DW_EXPR_VAL_EXPRESSION 3

   221 

   222 typedef struct Dwarf_Regtable_Entry_s {

   223 	/*  For each index i (naming a hardware register with dwarf number

   224             i) the following is true and defines the value of that register:

   225 

   226            If dw_regnum is Register DW_FRAME_UNDEFINED_VAL  

   227 	     it is not DWARF register number but

   228 		a place holder indicating the register has no defined value.

   229            If dw_regnum is Register DW_FRAME_SAME_VAL 

   230   	     it  is not DWARF register number but

   231 		a place holder indicating the register has the same

   232                 value in the previous frame.

   233 	   DW_FRAME_UNDEFINED_VAL, DW_FRAME_SAME_VAL are

   234            only present at libdwarf runtime. Never on disk.

   235            DW_FRAME_* Values present on disk are in dwarf.h

   236 

   237           Otherwise: the register number is a DWARF register number

   238           (see ABI documents for how this translates to hardware/

   239            software register numbers in the machine hardware)

   240 	  and the following applies:

   241 

   242           if dw_value_type == DW_EXPR_OFFSET (the only  possible case for dwarf2):

   243 	    If dw_offset_relevant is non-zero, then

   244 	     the value is stored at at the address CFA+N where N is a signed offset. 

   245 	     Rule: Offset(N)

   246             If dw_offset_relevant is zero, then the value of the register

   247              is the value of (DWARF) register number dw_regnum.

   248              Rule: register(F)

   249           Other values of dw_value_type are an error.

   250         */

   251 	Dwarf_Small         dw_offset_relevant;

   252 

   253 	/* For DWARF2, always 0 */

   254         Dwarf_Small         dw_value_type; 

   255 

   256 	Dwarf_Half          dw_regnum;

   257 

   258 	/* The data type here should  the larger of Dwarf_Addr

   259            and Dwarf_Unsigned and Dwarf_Signed. */

   260 	Dwarf_Addr          dw_offset;

   261 } Dwarf_Regtable_Entry;

   262 

   263 typedef struct Dwarf_Regtable_s {

   264     struct Dwarf_Regtable_Entry_s rules[DW_REG_TABLE_SIZE];

   265 } Dwarf_Regtable;

   266 

   267 /* opaque type. Functional interface shown later. */

   268 struct Dwarf_Reg_value3_s;

   269 typedef struct Dwarf_Reg_value3_s Dwarf_Reg_Value3; 

   270 

   271 typedef struct Dwarf_Regtable_Entry3_s {

   272 	/*  For each index i (naming a hardware register with dwarf number

   273             i) the following is true and defines the value of that register:

   274 

   275            If dw_regnum is Register DW_FRAME_UNDEFINED_VAL  

   276 	     it is not DWARF register number but

   277 		a place holder indicating the register has no defined value.

   278            If dw_regnum is Register DW_FRAME_SAME_VAL 

   279   	     it  is not DWARF register number but

   280 		a place holder indicating the register has the same

   281                 value in the previous frame.

   282 	   DW_FRAME_UNDEFINED_VAL, DW_FRAME_SAME_VAL are

   283            only present at libdwarf runtime. Never on disk.

   284            DW_FRAME_* Values present on disk are in dwarf.h

   285 

   286           Otherwise: the register number is a DWARF register number

   287           (see ABI documnets for how this translates to hardware/

   288            software register numbers in the machine hardware)

   289 	  and the following applies:

   290 

   291           if dw_value_type == DW_EXPR_OFFSET (the only  possible case for 

   292 		dwarf2):

   293 	    If dw_offset_relevant is non-zero, then

   294 	     the value is stored at at the address 

   295 	     CFA+N where N is a signed offset. 

   296 	     Rule: Offset(N)

   297             If dw_offset_relevant is zero, then the value of the register

   298              is the value of (DWARF) register number dw_regnum.

   299              Rule: register(R)

   300           if dw_value_type  == DW_EXPR_VAL_OFFSET

   301             the  value of this register is CFA +N where N is a signed offset.

   302             Rule: val_offset(N)

   303 

   304           if dw_value_type  == DW_EXPR_EXPRESSION

   305 	    The value of the register is the value at the address

   306             computed by evaluating the DWARF expression E.

   307             Rule: expression(E)

   308             The expression E byte stream is pointed to by dw_block_ptr.

   309             The expression length in bytes is given by

   310             dw_offset_or_block_len.

   311           if dw_value_type  == DW_EXPR_VAL_EXPRESSION

   312 	    The value of the register is the value

   313             computed by evaluating the DWARF expression E.

   314             Rule: val_expression(E)

   315             The expression E byte stream is pointed to by dw_block_ptr.

   316             The expression length in bytes is given by

   317             dw_offset_or_block_len.

   318           Other values of dw_value_type are an error.

   319         */

   320 	Dwarf_Small         dw_offset_relevant;

   321         Dwarf_Small         dw_value_type; 

   322 	Dwarf_Half          dw_regnum;

   323 	Dwarf_Unsigned      dw_offset_or_block_len;

   324 	Dwarf_Ptr           dw_block_ptr;

   325 

   326 }Dwarf_Regtable_Entry3;

   327 

   328 /* For the DWARF3 version, moved the DW_FRAME_CFA_COL

   329    out of the array and into its own struct.  

   330    Having it part of the array is not very easy to work

   331    with from a portability point of view: changing

   332    the number for every architecture is a pain (if one fails

   333    to set it correctly a register rule gets clobbered when

   334    setting CFA).

   335    With MIPS it just happened to be easy to use DW_FRAME_CFA_COL.

   336 

   337    rt3_rules and rt3_reg_table_size must be filled in 

   338     before calling libdwarf.

   339     Filled in with a pointer to an array (pointer and

   340     array  set up by the calling application) of rt3_reg_table_size 

   341     Dwarf_Regtable_Entry3_s structs.   

   342     libdwarf does not allocate or deallocate space for the

   343     rules, you must do so.   libdwarf will initialize the

   344     contents rules array, you do not need to do so (though

   345     if you choose to initialize the array somehow that is ok:

   346     libdwarf will overwrite your initializations with its own).

   347 

   348 */

   349 typedef struct Dwarf_Regtable3_s {

   350     struct Dwarf_Regtable_Entry3_s   rt3_cfa_rule;

   351 

   352     Dwarf_Half                       rt3_reg_table_size;

   353     struct Dwarf_Regtable_Entry3_s * rt3_rules;

   354 } Dwarf_Regtable3;

   355 

   356 

   357 /* Use for DW_EPXR_STANDARD., DW_EXPR_VAL_OFFSET. 

   358    Returns DW_DLV_OK if the value is available.

   359    If DW_DLV_OK returns the regnum and offset thru the pointers

   360    (which the consumer must use appropriately). 

   361 */

   362 int dwarf_frame_get_reg_register(struct Dwarf_Regtable_Entry3_s *reg_in,

   363 	Dwarf_Small *offset_relevant,

   364 	Dwarf_Half *regnum_out,

   365 	Dwarf_Signed *offset_out);

   366 

   367 /* Use for DW_EXPR_EXPRESSION, DW_EXPR_VAL_EXPRESSION.

   368    Returns DW_DLV_OK if the value is available.

   369    The caller must pass in the address of a valid

   370    Dwarf_Block (the caller need not initialize it).

   371 */

   372 int dwarf_frame_get_reg_expression(struct Dwarf_Regtable_Entry3_s *reg_in,

   373 	Dwarf_Block *block_out);

   374 

   375 

   376 /* for DW_DLC_SYMBOLIC_RELOCATIONS output to caller 

   377    v2, adding drd_length: some relocations are 4 and

   378    some 8 bytes (pointers are 8, section offsets 4) in

   379    some dwarf environments. (MIPS relocations are all one

   380    size in any given ABI.) Changing drd_type to an unsigned char

   381    to keep struct size down.

   382 */

   383 enum Dwarf_Rel_Type {

   384 		dwarf_drt_none, /* should not get to caller */

   385                 dwarf_drt_data_reloc, /* simple normal relocation */

   386                 dwarf_drt_segment_rel, /* special reloc, exceptions*/

   387                 dwarf_drt_first_of_length_pair,/* this and drt_second 

   388 				for .word end - begin

   389 			 	case */

   390                 dwarf_drt_second_of_length_pair

   391 };

   392 

   393 typedef struct Dwarf_P_Marker_s * Dwarf_P_Marker;

   394 struct Dwarf_P_Marker_s {

   395     Dwarf_Unsigned ma_marker;

   396     Dwarf_Unsigned ma_offset;

   397 };

   398 

   399 typedef struct Dwarf_Relocation_Data_s  * Dwarf_Relocation_Data;

   400 struct Dwarf_Relocation_Data_s {

   401         unsigned char drd_type; /* cast to/from Dwarf_Rel_Type

   402 					  to keep size small in struct */

   403 	unsigned char drd_length; /* length in bytes

   404 			         of data being relocated. 4 for 32bit.

   405 				 8 for 64bit data */

   406         Dwarf_Unsigned       drd_offset; /* where the data to reloc is */

   407         Dwarf_Unsigned       drd_symbol_index;

   408 };

   409 

   410 typedef struct Dwarf_P_String_Attr_s  * Dwarf_P_String_Attr;

   411 struct Dwarf_P_String_Attr_s {

   412     Dwarf_Unsigned        sa_offset;  /* Offset of string attribute data */

   413     Dwarf_Unsigned        sa_nbytes;  

   414 };

   415     

   416 

   417 /* Opaque types for Consumer Library. */

   418 typedef struct Dwarf_Debug_s*      Dwarf_Debug;

   419 typedef struct Dwarf_Die_s*        Dwarf_Die;

   420 typedef struct Dwarf_Line_s*       Dwarf_Line;

   421 typedef struct Dwarf_Global_s*     Dwarf_Global;

   422 typedef struct Dwarf_Func_s*       Dwarf_Func;

   423 typedef struct Dwarf_Type_s*       Dwarf_Type;

   424 typedef struct Dwarf_Var_s*        Dwarf_Var;

   425 typedef struct Dwarf_Weak_s*       Dwarf_Weak;

   426 typedef struct Dwarf_Error_s*      Dwarf_Error;

   427 typedef struct Dwarf_Attribute_s*  Dwarf_Attribute;

   428 typedef struct Dwarf_Abbrev_s*	   Dwarf_Abbrev;

   429 typedef struct Dwarf_Fde_s*  	   Dwarf_Fde;

   430 typedef struct Dwarf_Cie_s*  	   Dwarf_Cie;

   431 typedef struct Dwarf_Arange_s*	   Dwarf_Arange;

   432 

   433 /* Opaque types for Producer Library. */

   434 typedef struct Dwarf_P_Debug_s*	   	Dwarf_P_Debug;

   435 typedef struct Dwarf_P_Die_s*	   	Dwarf_P_Die;

   436 typedef struct Dwarf_P_Attribute_s*	Dwarf_P_Attribute;

   437 typedef struct Dwarf_P_Fde_s*		Dwarf_P_Fde;

   438 typedef struct Dwarf_P_Expr_s*		Dwarf_P_Expr;

   439 typedef Dwarf_Unsigned 		   	Dwarf_Tag;

   440 

   441 

   442 /* error handler function

   443 */

   444 typedef void  (*Dwarf_Handler)(Dwarf_Error /*error*/, Dwarf_Ptr /*errarg*/); 

   445 

   446 

   447 /* 

   448     Dwarf_dealloc() alloc_type arguments.

   449     Argument points to:

   450 */

   451 #define DW_DLA_STRING      	0x01     /* char* */

   452 #define DW_DLA_LOC         	0x02     /* Dwarf_Loc */

   453 #define DW_DLA_LOCDESC     	0x03     /* Dwarf_Locdesc */

   454 #define DW_DLA_ELLIST      	0x04     /* Dwarf_Ellist (not used)*/

   455 #define DW_DLA_BOUNDS      	0x05     /* Dwarf_Bounds (not used) */

   456 #define DW_DLA_BLOCK       	0x06     /* Dwarf_Block */

   457 #define DW_DLA_DEBUG       	0x07     /* Dwarf_Debug */

   458 #define DW_DLA_DIE         	0x08     /* Dwarf_Die */

   459 #define DW_DLA_LINE        	0x09     /* Dwarf_Line */

   460 #define DW_DLA_ATTR        	0x0a     /* Dwarf_Attribute */

   461 #define DW_DLA_TYPE        	0x0b     /* Dwarf_Type  (not used) */

   462 #define DW_DLA_SUBSCR      	0x0c     /* Dwarf_Subscr (not used) */

   463 #define DW_DLA_GLOBAL      	0x0d     /* Dwarf_Global */

   464 #define DW_DLA_ERROR       	0x0e     /* Dwarf_Error */

   465 #define DW_DLA_LIST        	0x0f     /* a list */

   466 #define DW_DLA_LINEBUF     	0x10     /* Dwarf_Line* (not used) */

   467 #define DW_DLA_ARANGE      	0x11     /* Dwarf_Arange */

   468 #define DW_DLA_ABBREV		0x12 	 /* Dwarf_Abbrev */

   469 #define DW_DLA_FRAME_OP		0x13 	 /* Dwarf_Frame_Op */

   470 #define DW_DLA_CIE		0x14	 /* Dwarf_Cie */

   471 #define DW_DLA_FDE		0x15	 /* Dwarf_Fde */

   472 #define DW_DLA_LOC_BLOCK	0x16	 /* Dwarf_Loc Block (not used) */

   473 #define DW_DLA_FRAME_BLOCK	0x17	 /* Dwarf_Frame Block (not used) */

   474 #define DW_DLA_FUNC		0x18	 /* Dwarf_Func */

   475 #define DW_DLA_TYPENAME		0x19	 /* Dwarf_Type */

   476 #define DW_DLA_VAR		0x1a	 /* Dwarf_Var */

   477 #define DW_DLA_WEAK		0x1b	 /* Dwarf_Weak */

   478 #define DW_DLA_ADDR		0x1c	 /* Dwarf_Addr sized entries */

   479 

   480 /* The augmenter string for CIE */

   481 #define DW_CIE_AUGMENTER_STRING_V0              "z"

   482 

   483 /* dwarf_init() access arguments

   484 */

   485 #define DW_DLC_READ        0        /* read only access */

   486 #define DW_DLC_WRITE       1        /* write only access */

   487 #define DW_DLC_RDWR        2        /* read/write access NOT SUPPORTED*/

   488 

   489 /* dwarf_init() access flag modifiers

   490 */

   491 #define DW_DLC_SIZE_64     0x40000000 /* 32-bit target */

   492 #define DW_DLC_SIZE_32     0x20000000 /* 64-bit target */

   493 

   494 /* dwarf_init() access flag modifiers

   495 */

   496 #define DW_DLC_ISA_MIPS             0x00000000 /* MIPS target */

   497 #define DW_DLC_ISA_IA64             0x01000000 /* IA64 target */

   498 #define DW_DLC_STREAM_RELOCATIONS   0x02000000 /* old style binary relocs */

   499 #define DW_DLC_SYMBOLIC_RELOCATIONS 0x04000000 /* usable with assem output */

   500 #define DW_DLC_TARGET_BIGENDIAN     0x08000000 /* big    endian target */

   501 #define DW_DLC_TARGET_LITTLEENDIAN  0x00100000 /* little endian target */

   502 

   503 #if 0

   504   /*

   505    The libdwarf producer interfaces jumble these two semantics together in

   506    confusing ways.  We *should* have flags like these...

   507    But changing the code means a lot of diffs.  So for now,

   508    we leave things as they are 

   509   */

   510   #define DW_DLC_SUN_OFFSET32	    0x00010000 /* use 32-bit sec offsets */

   511   #define DW_DLC_SUN_OFFSET64	    0x00020000 /* use 64-bit sec offsets */

   512   #define DW_DLC_SUN_POINTER32	    0x00040000 /* use 4 for address_size */

   513   #define DW_DLC_SUN_POINTER64	    0x00080000 /* use 8 for address_size */

   514 #endif

   515 

   516 /* dwarf_pcline() slide arguments

   517 */

   518 #define DW_DLS_BACKWARD   -1       /* slide backward to find line */

   519 #define DW_DLS_NOSLIDE     0       /* match exactly without sliding */ 

   520 #define DW_DLS_FORWARD     1       /* slide forward to find line */

   521 

   522 /* libdwarf error numbers

   523 */

   524 #define DW_DLE_NE          0     /* no error */ 

   525 #define DW_DLE_VMM         1     /* dwarf format/library version mismatch */

   526 #define DW_DLE_MAP         2     /* memory map failure */

   527 #define DW_DLE_LEE         3     /* libelf error */

   528 #define DW_DLE_NDS         4     /* no debug section */

   529 #define DW_DLE_NLS         5     /* no line section */

   530 #define DW_DLE_ID          6     /* invalid descriptor for query */

   531 #define DW_DLE_IOF         7     /* I/O failure */

   532 #define DW_DLE_MAF         8     /* memory allocation failure */

   533 #define DW_DLE_IA          9     /* invalid argument */ 

   534 #define DW_DLE_MDE         10     /* mangled debugging entry */

   535 #define DW_DLE_MLE         11     /* mangled line number entry */

   536 #define DW_DLE_FNO         12     /* file not open */

   537 #define DW_DLE_FNR         13     /* file not a regular file */

   538 #define DW_DLE_FWA         14     /* file open with wrong access */

   539 #define DW_DLE_NOB         15     /* not an object file */

   540 #define DW_DLE_MOF         16     /* mangled object file header */

   541 #define DW_DLE_EOLL        17     /* end of location list entries */

   542 #define DW_DLE_NOLL        18     /* no location list section */

   543 #define DW_DLE_BADOFF      19     /* Invalid offset */

   544 #define DW_DLE_EOS         20     /* end of section  */

   545 #define DW_DLE_ATRUNC      21     /* abbreviations section appears truncated*/

   546 #define DW_DLE_BADBITC     22     /* Address size passed to dwarf bad*/

   547 				    /* It is not an allowed size (64 or 32) */

   548     /* Error codes defined by the current Libdwarf Implementation. */

   549 #define DW_DLE_DBG_ALLOC                        23

   550 #define DW_DLE_FSTAT_ERROR                      24

   551 #define DW_DLE_FSTAT_MODE_ERROR                 25

   552 #define DW_DLE_INIT_ACCESS_WRONG                26

   553 #define DW_DLE_ELF_BEGIN_ERROR                  27

   554 #define DW_DLE_ELF_GETEHDR_ERROR                28

   555 #define DW_DLE_ELF_GETSHDR_ERROR                29

   556 #define DW_DLE_ELF_STRPTR_ERROR                 30

   557 #define DW_DLE_DEBUG_INFO_DUPLICATE             31

   558 #define DW_DLE_DEBUG_INFO_NULL                  32

   559 #define DW_DLE_DEBUG_ABBREV_DUPLICATE           33

   560 #define DW_DLE_DEBUG_ABBREV_NULL                34

   561 #define DW_DLE_DEBUG_ARANGES_DUPLICATE          35

   562 #define DW_DLE_DEBUG_ARANGES_NULL               36

   563 #define DW_DLE_DEBUG_LINE_DUPLICATE             37

   564 #define DW_DLE_DEBUG_LINE_NULL                  38

   565 #define DW_DLE_DEBUG_LOC_DUPLICATE              39

   566 #define DW_DLE_DEBUG_LOC_NULL                   40

   567 #define DW_DLE_DEBUG_MACINFO_DUPLICATE          41

   568 #define DW_DLE_DEBUG_MACINFO_NULL               42

   569 #define DW_DLE_DEBUG_PUBNAMES_DUPLICATE         43

   570 #define DW_DLE_DEBUG_PUBNAMES_NULL              44

   571 #define DW_DLE_DEBUG_STR_DUPLICATE              45

   572 #define DW_DLE_DEBUG_STR_NULL                   46

   573 #define DW_DLE_CU_LENGTH_ERROR                  47

   574 #define DW_DLE_VERSION_STAMP_ERROR              48

   575 #define DW_DLE_ABBREV_OFFSET_ERROR              49

   576 #define DW_DLE_ADDRESS_SIZE_ERROR               50

   577 #define DW_DLE_DEBUG_INFO_PTR_NULL              51

   578 #define DW_DLE_DIE_NULL                         52

   579 #define DW_DLE_STRING_OFFSET_BAD                53

   580 #define DW_DLE_DEBUG_LINE_LENGTH_BAD            54

   581 #define DW_DLE_LINE_PROLOG_LENGTH_BAD           55

   582 #define DW_DLE_LINE_NUM_OPERANDS_BAD            56

   583 #define DW_DLE_LINE_SET_ADDR_ERROR              57

   584 #define DW_DLE_LINE_EXT_OPCODE_BAD              58

   585 #define DW_DLE_DWARF_LINE_NULL                  59

   586 #define DW_DLE_INCL_DIR_NUM_BAD                 60

   587 #define DW_DLE_LINE_FILE_NUM_BAD                61

   588 #define DW_DLE_ALLOC_FAIL                       62

   589 #define DW_DLE_NO_CALLBACK_FUNC		    	63

   590 #define DW_DLE_SECT_ALLOC		    	64

   591 #define DW_DLE_FILE_ENTRY_ALLOC		    	65

   592 #define DW_DLE_LINE_ALLOC		    	66

   593 #define DW_DLE_FPGM_ALLOC		    	67

   594 #define DW_DLE_INCDIR_ALLOC		    	68

   595 #define DW_DLE_STRING_ALLOC		    	69

   596 #define DW_DLE_CHUNK_ALLOC		    	70

   597 #define DW_DLE_BYTEOFF_ERR		    	71

   598 #define	DW_DLE_CIE_ALLOC		    	72

   599 #define DW_DLE_FDE_ALLOC		    	73

   600 #define DW_DLE_REGNO_OVFL		    	74

   601 #define DW_DLE_CIE_OFFS_ALLOC		    	75

   602 #define DW_DLE_WRONG_ADDRESS		    	76

   603 #define DW_DLE_EXTRA_NEIGHBORS		    	77

   604 #define	DW_DLE_WRONG_TAG		    	78

   605 #define DW_DLE_DIE_ALLOC		    	79

   606 #define DW_DLE_PARENT_EXISTS		    	80

   607 #define DW_DLE_DBG_NULL                         81

   608 #define DW_DLE_DEBUGLINE_ERROR		    	82

   609 #define DW_DLE_DEBUGFRAME_ERROR		    	83

   610 #define DW_DLE_DEBUGINFO_ERROR		    	84

   611 #define DW_DLE_ATTR_ALLOC		    	85

   612 #define DW_DLE_ABBREV_ALLOC		    	86

   613 #define DW_DLE_OFFSET_UFLW		    	87

   614 #define DW_DLE_ELF_SECT_ERR		    	88

   615 #define DW_DLE_DEBUG_FRAME_LENGTH_BAD	    	89

   616 #define DW_DLE_FRAME_VERSION_BAD	    	90

   617 #define DW_DLE_CIE_RET_ADDR_REG_ERROR	    	91

   618 #define DW_DLE_FDE_NULL			    	92

   619 #define DW_DLE_FDE_DBG_NULL		    	93

   620 #define DW_DLE_CIE_NULL			    	94

   621 #define DW_DLE_CIE_DBG_NULL		    	95

   622 #define DW_DLE_FRAME_TABLE_COL_BAD	    	96

   623 #define DW_DLE_PC_NOT_IN_FDE_RANGE	    	97

   624 #define DW_DLE_CIE_INSTR_EXEC_ERROR	    	98

   625 #define DW_DLE_FRAME_INSTR_EXEC_ERROR	    	99

   626 #define DW_DLE_FDE_PTR_NULL		    	100

   627 #define DW_DLE_RET_OP_LIST_NULL		    	101

   628 #define DW_DLE_LINE_CONTEXT_NULL	    	102

   629 #define DW_DLE_DBG_NO_CU_CONTEXT	    	103

   630 #define DW_DLE_DIE_NO_CU_CONTEXT	    	104

   631 #define DW_DLE_FIRST_DIE_NOT_CU		    	105

   632 #define DW_DLE_NEXT_DIE_PTR_NULL	    	106

   633 #define DW_DLE_DEBUG_FRAME_DUPLICATE	    	107

   634 #define DW_DLE_DEBUG_FRAME_NULL		    	108

   635 #define DW_DLE_ABBREV_DECODE_ERROR	    	109

   636 #define DW_DLE_DWARF_ABBREV_NULL		110

   637 #define DW_DLE_ATTR_NULL		    	111

   638 #define DW_DLE_DIE_BAD			    	112

   639 #define DW_DLE_DIE_ABBREV_BAD		    	113

   640 #define DW_DLE_ATTR_FORM_BAD		    	114

   641 #define DW_DLE_ATTR_NO_CU_CONTEXT	    	115

   642 #define DW_DLE_ATTR_FORM_SIZE_BAD	    	116

   643 #define DW_DLE_ATTR_DBG_NULL		    	117

   644 #define DW_DLE_BAD_REF_FORM		    	118

   645 #define DW_DLE_ATTR_FORM_OFFSET_BAD	    	119

   646 #define DW_DLE_LINE_OFFSET_BAD		    	120

   647 #define DW_DLE_DEBUG_STR_OFFSET_BAD	    	121

   648 #define DW_DLE_STRING_PTR_NULL		    	122

   649 #define DW_DLE_PUBNAMES_VERSION_ERROR	    	123

   650 #define DW_DLE_PUBNAMES_LENGTH_BAD	    	124

   651 #define DW_DLE_GLOBAL_NULL		    	125

   652 #define DW_DLE_GLOBAL_CONTEXT_NULL	    	126

   653 #define DW_DLE_DIR_INDEX_BAD		    	127

   654 #define DW_DLE_LOC_EXPR_BAD		    	128

   655 #define DW_DLE_DIE_LOC_EXPR_BAD		    	129

   656 #define DW_DLE_ADDR_ALLOC		    	130

   657 #define DW_DLE_OFFSET_BAD		    	131

   658 #define DW_DLE_MAKE_CU_CONTEXT_FAIL	    	132

   659 #define DW_DLE_REL_ALLOC		    	133

   660 #define DW_DLE_ARANGE_OFFSET_BAD	    	134

   661 #define DW_DLE_SEGMENT_SIZE_BAD		    	135

   662 #define DW_DLE_ARANGE_LENGTH_BAD	    	136

   663 #define DW_DLE_ARANGE_DECODE_ERROR	    	137

   664 #define DW_DLE_ARANGES_NULL		    	138

   665 #define DW_DLE_ARANGE_NULL		    	139

   666 #define DW_DLE_NO_FILE_NAME		    	140

   667 #define DW_DLE_NO_COMP_DIR		    	141

   668 #define DW_DLE_CU_ADDRESS_SIZE_BAD	    	142

   669 #define DW_DLE_INPUT_ATTR_BAD		    	143

   670 #define DW_DLE_EXPR_NULL		    	144

   671 #define DW_DLE_BAD_EXPR_OPCODE		    	145

   672 #define DW_DLE_EXPR_LENGTH_BAD		    	146

   673 #define DW_DLE_MULTIPLE_RELOC_IN_EXPR	    	147

   674 #define DW_DLE_ELF_GETIDENT_ERROR	    	148

   675 #define DW_DLE_NO_AT_MIPS_FDE		    	149

   676 #define DW_DLE_NO_CIE_FOR_FDE		    	150

   677 #define DW_DLE_DIE_ABBREV_LIST_NULL	    	151

   678 #define DW_DLE_DEBUG_FUNCNAMES_DUPLICATE    	152

   679 #define DW_DLE_DEBUG_FUNCNAMES_NULL	    	153

   680 #define DW_DLE_DEBUG_FUNCNAMES_VERSION_ERROR    154

   681 #define DW_DLE_DEBUG_FUNCNAMES_LENGTH_BAD       155

   682 #define DW_DLE_FUNC_NULL		    	156

   683 #define DW_DLE_FUNC_CONTEXT_NULL	    	157

   684 #define DW_DLE_DEBUG_TYPENAMES_DUPLICATE    	158

   685 #define DW_DLE_DEBUG_TYPENAMES_NULL	    	159

   686 #define DW_DLE_DEBUG_TYPENAMES_VERSION_ERROR    160

   687 #define DW_DLE_DEBUG_TYPENAMES_LENGTH_BAD       161

   688 #define DW_DLE_TYPE_NULL		    	162

   689 #define DW_DLE_TYPE_CONTEXT_NULL	    	163

   690 #define DW_DLE_DEBUG_VARNAMES_DUPLICATE	    	164

   691 #define DW_DLE_DEBUG_VARNAMES_NULL	    	165

   692 #define DW_DLE_DEBUG_VARNAMES_VERSION_ERROR     166

   693 #define DW_DLE_DEBUG_VARNAMES_LENGTH_BAD        167

   694 #define DW_DLE_VAR_NULL			    	168

   695 #define DW_DLE_VAR_CONTEXT_NULL		    	169

   696 #define DW_DLE_DEBUG_WEAKNAMES_DUPLICATE    	170

   697 #define DW_DLE_DEBUG_WEAKNAMES_NULL	    	171

   698 #define DW_DLE_DEBUG_WEAKNAMES_VERSION_ERROR    172

   699 #define DW_DLE_DEBUG_WEAKNAMES_LENGTH_BAD       173

   700 #define DW_DLE_WEAK_NULL		    	174

   701 #define DW_DLE_WEAK_CONTEXT_NULL	    	175

   702 #define DW_DLE_LOCDESC_COUNT_WRONG              176

   703 #define DW_DLE_MACINFO_STRING_NULL              177

   704 #define DW_DLE_MACINFO_STRING_EMPTY             178

   705 #define DW_DLE_MACINFO_INTERNAL_ERROR_SPACE     179

   706 #define DW_DLE_MACINFO_MALLOC_FAIL              180

   707 #define DW_DLE_DEBUGMACINFO_ERROR		181

   708 #define DW_DLE_DEBUG_MACRO_LENGTH_BAD		182

   709 #define DW_DLE_DEBUG_MACRO_MAX_BAD		183

   710 #define DW_DLE_DEBUG_MACRO_INTERNAL_ERR		184

   711 #define DW_DLE_DEBUG_MACRO_MALLOC_SPACE	        185

   712 #define DW_DLE_DEBUG_MACRO_INCONSISTENT	        186

   713 #define DW_DLE_DF_NO_CIE_AUGMENTATION          	187

   714 #define DW_DLE_DF_REG_NUM_TOO_HIGH  		188 

   715 #define DW_DLE_DF_MAKE_INSTR_NO_INIT          	189 

   716 #define DW_DLE_DF_NEW_LOC_LESS_OLD_LOC         	190

   717 #define DW_DLE_DF_POP_EMPTY_STACK              	191

   718 #define DW_DLE_DF_ALLOC_FAIL                   	192

   719 #define DW_DLE_DF_FRAME_DECODING_ERROR         	193

   720 #define DW_DLE_DEBUG_LOC_SECTION_SHORT         	194

   721 #define DW_DLE_FRAME_AUGMENTATION_UNKNOWN       195

   722 #define DW_DLA_PUBTYPE_CONTEXT                  196

   723 #define DW_DLE_DEBUG_PUBTYPES_LENGTH_BAD        197

   724 #define DW_DLE_DEBUG_PUBTYPES_VERSION_ERROR     198

   725 #define DW_DLE_DEBUG_PUBTYPES_DUPLICATE         199

   726 #define DW_DLE_FRAME_CIE_DECODE_ERROR           200

   727 #define DW_DLE_FRAME_REGISTER_UNREPRESENTABLE   201

   728 #define DW_DLE_FRAME_REGISTER_COUNT_MISMATCH    202

   729 #define DW_DLE_LINK_LOOP                        203

   730 

   731 

   732 

   733     /* DW_DLE_LAST MUST EQUAL LAST ERROR NUMBER */

   734 #define DW_DLE_LAST        			203

   735 #define DW_DLE_LO_USER     0x10000

   736 

   737         /* taken as meaning 'undefined value', this is not

   738            a column or register number.

   739            Only present at libdwarf runtime. Never on disk.

   740 	   DW_FRAME_* Values present on disk are in dwarf.h

   741         */

   742 #define DW_FRAME_UNDEFINED_VAL          1034

   743 

   744         /* taken as meaning 'same value' as caller had, not a column

   745            or register number

   746            Only present at libdwarf runtime. Never on disk.

   747 	   DW_FRAME_* Values present on disk are in dwarf.h

   748         */

   749 #define DW_FRAME_SAME_VAL               1035

   750 

   751 

   752 

   753 /* error return values  

   754 */

   755 #define DW_DLV_BADADDR     (~(Dwarf_Addr)0)   

   756 	/* for functions returning target address */

   757 

   758 #define DW_DLV_NOCOUNT     ((Dwarf_Signed)-1) 

   759 	/* for functions returning count */

   760 

   761 #define DW_DLV_BADOFFSET   (~(Dwarf_Off)0)    

   762 	/* for functions returning offset */

   763 

   764 /* standard return values for functions */

   765 #define DW_DLV_NO_ENTRY -1

   766 #define DW_DLV_OK        0

   767 #define DW_DLV_ERROR     1

   768 

   769 /* Special values for offset_into_exception_table field of dwarf fde's. */

   770 /* The following value indicates that there is no Exception table offset

   771    associated with a dwarf frame. */

   772 #define DW_DLX_NO_EH_OFFSET  	   (-1LL)

   773 /* The following value indicates that the producer was unable to analyse the

   774    source file to generate Exception tables for this function. */

   775 #define DW_DLX_EH_OFFSET_UNAVAILABLE  (-2LL)

   776 

   777 

   778 /*===========================================================================*/

   779 /*  Dwarf consumer interface initialization and termination operations */

   780 

   781 /* non-elf initialization */

   782 int dwarf_init(int 	/*fd*/, 

   783     Dwarf_Unsigned 	/*access*/, 

   784     Dwarf_Handler 	/*errhand*/, 

   785     Dwarf_Ptr 		/*errarg*/, 

   786     Dwarf_Debug      *  /*dbg*/,

   787     Dwarf_Error* 	/*error*/);

   788 

   789 /* elf intialization */

   790 int dwarf_elf_init(dwarf_elf_handle /*elf*/,

   791     Dwarf_Unsigned 	/*access*/, 

   792     Dwarf_Handler 	/*errhand*/, 

   793     Dwarf_Ptr 		/*errarg*/, 

   794     Dwarf_Debug      *  /*dbg*/,

   795     Dwarf_Error* 	/*error*/);

   796 

   797 /* Undocumented function for memory allocator. */

   798 void dwarf_print_memory_stats(Dwarf_Debug  /*dbg*/);

   799 

   800 

   801 int dwarf_get_elf(Dwarf_Debug /*dbg*/,

   802     dwarf_elf_handle*   /*return_elfptr*/,

   803     Dwarf_Error*	/*error*/);

   804 

   805 int dwarf_finish(Dwarf_Debug /*dbg*/, Dwarf_Error* /*error*/);

   806 

   807 /* die traversal operations */

   808 int dwarf_next_cu_header(Dwarf_Debug /*dbg*/, 

   809     Dwarf_Unsigned* 	/*cu_header_length*/, 

   810     Dwarf_Half*     	/*version_stamp*/, 

   811     Dwarf_Off*  	/*abbrev_offset*/, 

   812     Dwarf_Half* 	/*address_size*/, 

   813     Dwarf_Unsigned*     /*next_cu_header_offset*/,

   814     Dwarf_Error* 	/*error*/);

   815 

   816 int dwarf_siblingof(Dwarf_Debug /*dbg*/, 

   817     Dwarf_Die 		/*die*/, 

   818     Dwarf_Die*          /*return_siblingdie*/,

   819     Dwarf_Error* 	/*error*/);

   820 

   821 int dwarf_child(Dwarf_Die /*die*/, 

   822     Dwarf_Die*          /*return_childdie*/,

   823     Dwarf_Error* 	/*error*/);

   824 

   825 /* finding die given offset */

   826 int dwarf_offdie(Dwarf_Debug /*dbg*/, 

   827     Dwarf_Off 		/*offset*/, 

   828     Dwarf_Die*          /*return_die*/,

   829     Dwarf_Error* 	/*error*/);

   830 

   831 /* higher level functions (Unimplemented) */

   832 int dwarf_pcfile(Dwarf_Debug /*dbg*/, 

   833     Dwarf_Addr 		/*pc*/, 

   834     Dwarf_Die*          /*return_die*/,

   835     Dwarf_Error* 	/*error*/);

   836 

   837 /* Unimplemented */

   838 int dwarf_pcsubr(Dwarf_Debug /*dbg*/, 

   839     Dwarf_Addr 		/*pc*/, 

   840     Dwarf_Die*          /*return_die*/,

   841     Dwarf_Error* 	/*error*/);

   842 

   843 /* Unimplemented */

   844 int dwarf_pcscope(Dwarf_Debug /*dbg*/, 

   845     Dwarf_Addr 		/*pc*/, 

   846     Dwarf_Die*          /*return_die*/,

   847     Dwarf_Error* 	/*error*/);

   848 

   849 /* operations on DIEs */

   850 int dwarf_tag(Dwarf_Die /*die*/, 

   851     Dwarf_Half*	        /*return_tag*/,

   852     Dwarf_Error* 	/*error*/);

   853 

   854 /* utility? */

   855 int dwarf_dieoffset(Dwarf_Die /*die*/, 

   856     Dwarf_Off*          /*return_offset*/,

   857     Dwarf_Error* 	/*error*/);

   858 

   859 int dwarf_die_CU_offset(Dwarf_Die /*die*/,

   860     Dwarf_Off*          /*return_offset*/,

   861     Dwarf_Error*	/*error*/);

   862 

   863 int dwarf_attr (Dwarf_Die /*die*/, 

   864     Dwarf_Half 		/*attr*/, 

   865     Dwarf_Attribute *   /*returned_attr*/,

   866     Dwarf_Error* 	/*error*/);

   867 

   868 int dwarf_diename(Dwarf_Die /*die*/, 

   869     char   **           /*diename*/,

   870     Dwarf_Error* 	/*error*/);

   871 

   872 /* convenience functions, alternative to using dwarf_attrlist() */

   873 int dwarf_hasattr(Dwarf_Die /*die*/, 

   874     Dwarf_Half 		/*attr*/, 

   875     Dwarf_Bool     *    /*returned_bool*/,

   876     Dwarf_Error* 	/*error*/);

   877 

   878 /* dwarf_loclist_n preferred over dwarf_loclist */

   879 int dwarf_loclist_n(Dwarf_Attribute /*attr*/,  

   880     Dwarf_Locdesc***	/*llbuf*/, 

   881     Dwarf_Signed *      /*locCount*/,

   882     Dwarf_Error* 	/*error*/);

   883 

   884 int dwarf_loclist(Dwarf_Attribute /*attr*/,  /* inflexible! */

   885     Dwarf_Locdesc** 	/*llbuf*/, 

   886     Dwarf_Signed *      /*locCount*/,

   887     Dwarf_Error* 	/*error*/);

   888 

   889 /* Extracts a dwarf expression from an expression byte stream.

   890    Useful to get expressions from DW_CFA_def_cfa_expression

   891    DW_CFA_expression DW_CFA_val_expression expression bytes.

   892 */

   893 int 

   894 dwarf_loclist_from_expr(Dwarf_Debug dbg,

   895               Dwarf_Ptr expression_in,

   896               Dwarf_Unsigned expression_length,

   897               Dwarf_Locdesc ** llbuf,

   898               Dwarf_Signed * listlen, Dwarf_Error * error);

   899 

   900 /* Unimplemented */

   901 int dwarf_stringlen(Dwarf_Die /*die*/, 

   902     Dwarf_Locdesc **    /*returned_locdesc*/,

   903     Dwarf_Error* 	/*error*/);

   904 

   905 /* Unimplemented */

   906 int dwarf_subscrcnt(Dwarf_Die /*die*/, 

   907     Dwarf_Signed *      /*returned_count*/,

   908     Dwarf_Error* 	/*error*/);

   909 

   910 /* Unimplemented */

   911 int dwarf_nthsubscr(Dwarf_Die /*die*/, 

   912     Dwarf_Unsigned 	/*ssndx*/, 

   913     Dwarf_Die *         /*returned_die*/,

   914     Dwarf_Error* 	/*error*/);

   915 

   916 int dwarf_lowpc(Dwarf_Die /*die*/, 

   917     Dwarf_Addr  *       /*returned_addr*/,

   918     Dwarf_Error* 	/*error*/);

   919 

   920 int dwarf_highpc(Dwarf_Die /*die*/, 

   921     Dwarf_Addr  *       /*returned_addr*/,

   922     Dwarf_Error* 	/*error*/);

   923 

   924 int dwarf_bytesize(Dwarf_Die /*die*/, 

   925     Dwarf_Unsigned *    /*returned_size*/,

   926     Dwarf_Error* 	/*error*/);

   927 

   928 /* Unimplemented */

   929 int dwarf_isbitfield(Dwarf_Die /*die*/, 

   930     Dwarf_Bool  *       /*returned_bool*/,

   931     Dwarf_Error* 	/*error*/);

   932 

   933 int dwarf_bitsize(Dwarf_Die /*die*/, 

   934     Dwarf_Unsigned *    /*returned_size*/,

   935     Dwarf_Error* 	/*error*/);

   936 

   937 int dwarf_bitoffset(Dwarf_Die /*die*/, 

   938     Dwarf_Unsigned *    /*returned_offset*/,

   939     Dwarf_Error* 	/*error*/);

   940 

   941 int dwarf_srclang(Dwarf_Die /*die*/, 

   942     Dwarf_Unsigned *    /*returned_lang*/,

   943     Dwarf_Error* 	/*error*/);

   944 

   945 int dwarf_arrayorder(Dwarf_Die /*die*/, 

   946     Dwarf_Unsigned *    /*returned_order*/,

   947     Dwarf_Error* 	/*error*/);

   948 

   949 /* end of convenience function list */

   950 

   951 /* this is the main interface to attributes of a DIE */

   952 int dwarf_attrlist(Dwarf_Die /*die*/, 

   953     Dwarf_Attribute** 	/*attrbuf*/, 

   954     Dwarf_Signed   *    /*attrcount*/,

   955     Dwarf_Error* 	/*error*/);

   956 

   957 /* query operations for attributes */

   958 int dwarf_hasform(Dwarf_Attribute /*attr*/, 

   959     Dwarf_Half 		/*form*/, 

   960     Dwarf_Bool *        /*returned_bool*/,

   961     Dwarf_Error* 	/*error*/);

   962 

   963 int dwarf_whatform(Dwarf_Attribute /*attr*/, 

   964     Dwarf_Half *        /*returned_form*/,

   965     Dwarf_Error* 	/*error*/);

   966 

   967 int dwarf_whatform_direct(Dwarf_Attribute /*attr*/, 

   968     Dwarf_Half *        /*returned_form*/,

   969     Dwarf_Error* 	/*error*/);

   970 

   971 int dwarf_whatattr(Dwarf_Attribute /*attr*/, 

   972     Dwarf_Half *        /*returned_attr_num*/,

   973     Dwarf_Error* 	/*error*/);

   974 

   975 /* 

   976     The following are concerned with the Primary Interface: getting

   977     the actual data values. One function per 'kind' of FORM.

   978 */

   979 	/*dwarf_formref returns, thru return_offset, a CU-relative offset

   980 	** and does not allow DW_FORM_ref_addr*/

   981 int dwarf_formref(Dwarf_Attribute /*attr*/, 

   982     Dwarf_Off*          /*return_offset*/,

   983     Dwarf_Error* 	/*error*/);

   984 	/*dwarf_global_formref returns, thru return_offset, 

   985 	 a debug_info-relative offset and does allow all reference forms*/

   986 int dwarf_global_formref(Dwarf_Attribute /*attr*/, 

   987     Dwarf_Off*          /*return_offset*/,

   988     Dwarf_Error* 	/*error*/);

   989 

   990 int dwarf_formaddr(Dwarf_Attribute /*attr*/, 

   991     Dwarf_Addr   *      /*returned_addr*/,

   992     Dwarf_Error* 	/*error*/);

   993 

   994 int dwarf_formflag(Dwarf_Attribute /*attr*/,

   995     Dwarf_Bool *        /*returned_bool*/,

   996     Dwarf_Error*	/*error*/);

   997 

   998 int dwarf_formudata(Dwarf_Attribute /*attr*/, 

   999     Dwarf_Unsigned  *   /*returned_val*/,

  1000     Dwarf_Error* 	/*error*/);

  1001 

  1002 int dwarf_formsdata(Dwarf_Attribute 	/*attr*/, 

  1003     Dwarf_Signed  *     /*returned_val*/,

  1004     Dwarf_Error* 	/*error*/);

  1005 

  1006 int dwarf_formblock(Dwarf_Attribute /*attr*/, 

  1007     Dwarf_Block    **   /*returned_block*/,

  1008     Dwarf_Error* 	/*error*/);

  1009 

  1010 int dwarf_formstring(Dwarf_Attribute /*attr*/, 

  1011     char   **           /*returned_string*/,

  1012     Dwarf_Error* 	/*error*/);

  1013 

  1014 /* end attribute query operations. */

  1015 

  1016 /* line number operations */

  1017 /* dwarf_srclines  is the normal interface */

  1018 int dwarf_srclines(Dwarf_Die /*die*/, 

  1019     Dwarf_Line** 	/*linebuf*/, 

  1020     Dwarf_Signed *      /*linecount*/,

  1021     Dwarf_Error* 	/*error*/);

  1022 

  1023 /* dwarf_srclines_dealloc, created July 2005, is the new

  1024    method for deallocating what dwarf_srclines returns.

  1025    More complete free than using dwarf_dealloc directly. */

  1026 void dwarf_srclines_dealloc(Dwarf_Debug /*dbg*/, 

  1027    Dwarf_Line*  /*linebuf*/,

  1028    Dwarf_Signed /*count */);

  1029 

  1030 

  1031 int dwarf_srcfiles(Dwarf_Die /*die*/, 

  1032     char*** 		/*srcfiles*/, 

  1033     Dwarf_Signed *      /*filecount*/,

  1034     Dwarf_Error* 	/*error*/);

  1035 

  1036 /* Unimplemented. */

  1037 int dwarf_dieline(Dwarf_Die /*die*/, 

  1038     Dwarf_Line  *       /*returned_line*/,

  1039     Dwarf_Error *       /*error*/);

  1040 

  1041 int dwarf_linebeginstatement(Dwarf_Line /*line*/, 

  1042     Dwarf_Bool  *       /*returned_bool*/,

  1043     Dwarf_Error* 	/*error*/);

  1044 

  1045 int dwarf_lineendsequence(Dwarf_Line /*line*/,

  1046     Dwarf_Bool  *       /*returned_bool*/,

  1047     Dwarf_Error*        /*error*/);

  1048 

  1049 int dwarf_lineno(Dwarf_Line /*line*/, 

  1050     Dwarf_Unsigned *    /*returned_lineno*/,

  1051     Dwarf_Error* 	/*error*/);

  1052 

  1053 int dwarf_line_srcfileno(Dwarf_Line /*line*/,

  1054     Dwarf_Unsigned * /*ret_fileno*/, 

  1055     Dwarf_Error *    /*error*/);

  1056 

  1057 int dwarf_lineaddr(Dwarf_Line /*line*/, 

  1058     Dwarf_Addr *        /*returned_addr*/,

  1059     Dwarf_Error* 	/*error*/);

  1060 

  1061 int dwarf_lineoff(Dwarf_Line /*line*/, 

  1062     Dwarf_Signed  *     /*returned_lineoffset*/,

  1063     Dwarf_Error* 	/*error*/);

  1064 

  1065 int dwarf_linesrc(Dwarf_Line /*line*/, 

  1066     char   **           /*returned_name*/,

  1067     Dwarf_Error* 	/*error*/);

  1068 

  1069 int dwarf_lineblock(Dwarf_Line /*line*/, 

  1070     Dwarf_Bool  *       /*returned_bool*/,

  1071     Dwarf_Error* 	/*error*/);

  1072 

  1073 /* tertiary interface to line info */

  1074 /* Unimplemented */

  1075 int dwarf_pclines(Dwarf_Debug /*dbg*/, 

  1076     Dwarf_Addr 		/*pc*/, 

  1077     Dwarf_Line** 	/*linebuf*/, 

  1078     Dwarf_Signed *      /*linecount*/,

  1079     Dwarf_Signed 	/*slide*/, 

  1080     Dwarf_Error* 	/*error*/);

  1081 /* end line number operations */

  1082 

  1083 /* global name space operations (.debug_pubnames access) */

  1084 int dwarf_get_globals(Dwarf_Debug /*dbg*/, 

  1085     Dwarf_Global** 	/*globals*/, 

  1086     Dwarf_Signed *      /*number_of_globals*/,

  1087     Dwarf_Error* 	/*error*/);

  1088 void dwarf_globals_dealloc(Dwarf_Debug /*dbg*/,

  1089     Dwarf_Global* /*globals*/,

  1090     Dwarf_Signed /*number_of_globals*/);

  1091 

  1092 int dwarf_globname(Dwarf_Global /*glob*/, 

  1093     char   **           /*returned_name*/,

  1094     Dwarf_Error* 	/*error*/);

  1095 

  1096 int dwarf_global_die_offset(Dwarf_Global /*global*/, 

  1097     Dwarf_Off*          /*return_offset*/,

  1098     Dwarf_Error * 	/*error*/);

  1099 

  1100 int dwarf_get_cu_die_offset_given_cu_header_offset(

  1101 	Dwarf_Debug     /*dbg*/,

  1102 	Dwarf_Off       /*in_cu_header_offset*/,

  1103         Dwarf_Off *     /*out_cu_die_offset*/, 

  1104 	Dwarf_Error *   /*err*/);

  1105 #ifdef __sgi /* pragma is sgi MIPS only */

  1106 #pragma optional dwarf_get_cu_die_offset_given_cu_header_offset

  1107 #endif

  1108 

  1109 int dwarf_global_cu_offset(Dwarf_Global /*global*/, 

  1110     Dwarf_Off*          /*return_offset*/,

  1111     Dwarf_Error* 	/*error*/);

  1112 

  1113 int dwarf_global_name_offsets(Dwarf_Global /*global*/, 

  1114     char   **           /*returned_name*/,

  1115     Dwarf_Off* 		/*die_offset*/, 

  1116     Dwarf_Off* 		/*cu_offset*/, 

  1117     Dwarf_Error* 	/*error*/);

  1118 

  1119 /* Static function name operations.  */

  1120 int dwarf_get_funcs(Dwarf_Debug	/*dbg*/,

  1121     Dwarf_Func**	/*funcs*/,

  1122     Dwarf_Signed *      /*number_of_funcs*/,

  1123     Dwarf_Error*	/*error*/);

  1124 void dwarf_funcs_dealloc(Dwarf_Debug /*dbg*/,

  1125     Dwarf_Func* /*funcs*/,

  1126     Dwarf_Signed /*number_of_funcs*/);

  1127 

  1128 int dwarf_funcname(Dwarf_Func /*func*/,

  1129     char   **           /*returned_name*/,

  1130     Dwarf_Error*	/*error*/);

  1131 

  1132 int dwarf_func_die_offset(Dwarf_Func /*func*/,

  1133     Dwarf_Off*          /*return_offset*/,

  1134     Dwarf_Error*	/*error*/);

  1135