Open64: osprey/libdwarf/libdwarf/dwarf

00001 /*
00002  * Copyright 2005, 2006 PathScale, Inc.  All Rights Reserved.
00003  */
00004 
00005 /*
00006 
00007   Copyright (C) 2000,2002,2004 Silicon Graphics, Inc.  All Rights Reserved.
00008 
00009   This program is free software; you can redistribute it and/or modify it
00010   under the terms of version 2.1 of the GNU Lesser General Public License 
00011   as published by the Free Software Foundation.
00012 
00013   This program is distributed in the hope that it would be useful, but
00014   WITHOUT ANY WARRANTY; without even the implied warranty of
00015   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
00016 
00017   Further, this software is distributed without any warranty that it is
00018   free of the rightful claim of any third person regarding infringement 
00019   or the like.  Any license provided herein, whether implied or 
00020   otherwise, applies only to this software file.  Patent licenses, if
00021   any, provided herein do not apply to combinations of this program with 
00022   other software, or any other product whatsoever.  
00023 
00024   You should have received a copy of the GNU Lesser General Public 
00025   License along with this program; if not, write the Free Software 
00026   Foundation, Inc., 59 Temple Place - Suite 330, Boston MA 02111-1307, 
00027   USA.
00028 
00029   Contact information:  Silicon Graphics, Inc., 1500 Crittenden Lane,
00030   Mountain View, CA 94043, or:
00031 
00032   http://www.sgi.com
00033 
00034   For further information regarding this notice, see:
00035 
00036   http://oss.sgi.com/projects/GenInfo/NoticeExplan
00037 
00038 */
00039 
00040 
00041 
00042 #include "config.h"
00043 #include "dwarf_incl.h"
00044 #ifdef HAVE_ELF_H
00045 #include <elf.h>
00046 #endif
00047 
00048 #include <stdio.h>
00049 #include <sys/stat.h>
00050 #include <sys/types.h>
00051 #include <stdlib.h>
00052 
00053 /* Array to hold string representation of errors. Any time a 
00054    define is added to the list in libdwarf.h, a string should be 
00055    added to this Array
00056 */
00057 
00058 const char *_dwarf_errmsgs[] = {
00059 
00060     "No error (0)\n",
00061     "DW_DLE_VMM 1 dwarf format/library version mismatch",
00062     "DW_DLE_MAP 2 memory map failure",
00063     "DW_DLE_LEE 3 libelf error",
00064     "DW_DLE_NDS 4 no debug section",
00065     "DW_DLE_NLS    5  no line section ",
00066     "DW_DLE_ID     6  invalid descriptor for query ",
00067     "DW_DLE_IOF    7  I/O failure ",
00068     "DW_DLE_MAF    8  memory allocation failure ",
00069     "DW_DLE_IA     9  invalid argument ",
00070     "DW_DLE_MDE    10  mangled debugging entry ",
00071     "DW_DLE_MLE    11  mangled line number entry ",
00072     "DW_DLE_FNO    12  file not open ",
00073     "DW_DLE_FNR    13  file not a regular file ",
00074     "DW_DLE_FWA    14  file open with wrong access ",
00075     "DW_DLE_NOB    15  not an object file ",
00076     "DW_DLE_MOF    16  mangled object file header ",
00077     "DW_DLE_EOLL   17  end of location list entries ",
00078     "DW_DLE_NOLL   18  no location list section ",
00079     "DW_DLE_BADOFF 19  Invalid offset ",
00080     "DW_DLE_EOS    20  end of section  ",
00081     "DW_DLE_ATRUNC 21  abbreviations section appears truncated",
00082     "DW_DLE_BADBITC  22  Address size passed to dwarf bad",
00083 
00084     "DW_DLE_DBG_ALLOC 23 Unable to malloc a Dwarf_Debug structure",
00085     "DW_DLE_FSTAT_ERROR 24 The file fd passed to dwarf_init "
00086   "cannot be fstat()ed",
00087     "DW_DLE_FSTAT_MODE_ERROR 25 The file mode bits do not "
00088   "indicate that the file being opened via "
00089   "dwarf_init() is a normal file",
00090     "DW_DLE_INIT_ACCESS_WRONG 26 A call to dwarf_init had an "
00091   "access of other than DW_DLC_READ",
00092     "DW_DLE_ELF_BEGIN_ERROR 27 a call to "
00093   "elf_begin(... ELF_C_READ_MMAP... ) failed",
00094     "DW_DLE_ELF_GETEHDR_ERROR 28 a call to "
00095   "elf32_getehdr() or elf64_getehdr() failed",
00096     "DW_DLE_ELF_GETSHDR_ERROR 29 a call to "
00097   "elf32_getshdr() or elf64_getshdr() failed",
00098     "DW_DLE_ELF_STRPTR_ERROR 30 a call to "
00099   "elf_strptr() failed trying to get a section name",
00100     "DW_DLE_DEBUG_INFO_DUPLICATE 31  Only one .debug_info  "
00101   "section is allowed",
00102     "DW_DLE_DEBUG_INFO_NULL 32 .debug_info section present but "
00103   "elf_getdata() failed or section is zero-length",
00104     "DW_DLE_DEBUG_ABBREV_DUPLICATE 33 Only one .debug_abbrev  "
00105   "section is allowed",
00106     "DW_DLE_DEBUG_ABBREV_NULL 34 .debug_abbrev section present but "
00107   "elf_getdata() failed or section is zero-length",
00108     "DW_DLE_DEBUG_ARANGES_DUPLICATE 35 Only one .debug_aranges  "
00109   "section is allowed",
00110     "DW_DLE_DEBUG_ARANGES_NULL 36 .debug_aranges section present but "
00111   "elf_getdata() failed or section is zero-length",
00112     "DW_DLE_DEBUG_LINE_DUPLICATE 37 Only one .debug_line  "
00113   "section is allowed",
00114     "DW_DLE_DEBUG_LINE_NULL (38) .debug_line section present but "
00115   "elf_getdata() failed or section is zero-length",
00116     "DW_DLE_DEBUG_LOC_DUPLICATE (39) Only one .debug_loc  "
00117   "section is allowed",
00118     "DW_DLE_DEBUG_LOC_NULL (40) .debug_loc section present but "
00119   "elf_getdata() failed or section is zero-length",
00120     "DW_DLE_DEBUG_MACINFO_DUPLICATE (41) Only one .debug_macinfo  "
00121   "section is allowed",
00122     "DW_DLE_DEBUG_MACINFO_NULL (42) .debug_macinfo section present but "
00123   "elf_getdata() failed or section is zero-length",
00124     "DW_DLE_DEBUG_PUBNAMES_DUPLICATE (43) Only one .debug_pubnames  "
00125   "section is allowed",
00126     "DW_DLE_DEBUG_PUBNAMES_NULL (44) .debug_pubnames section present but "
00127   "elf_getdata() failed or section is zero-length",
00128     "DW_DLE_DEBUG_STR_DUPLICATE (45)  Only one .debug_str  "
00129   "section is allowed",
00130     "DW_DLE_DEBUG_STR_NULL (46) .debug_str section present but "
00131   "elf_getdata() failed or section is zero-length",
00132     "DW_DLE_CU_LENGTH_ERROR (47)",
00133     "DW_DLE_VERSION_STAMP_ERROR (48)",
00134     "DW_DLE_ABBREV_OFFSET_ERROR (49)",
00135     "DW_DLE_ADDRESS_SIZE_ERROR (50)",
00136     "DW_DLE_DEBUG_INFO_PTR_NULL (51)",
00137     "DW_DLE_DIE_NULL (52)",
00138     "DW_DLE_STRING_OFFSET_BAD (53)",
00139     "DW_DLE_DEBUG_LINE_LENGTH_BAD (54)",
00140     "DW_DLE_LINE_PROLOG_LENGTH_BAD (55)",
00141     "DW_DLE_LINE_NUM_OPERANDS_BAD",
00142     "DW_DLE_LINE_SET_ADDR_ERROR",
00143     "DW_DLE_LINE_EXT_OPCODE_BAD",
00144     "DW_DLE_DWARF_LINE_NULL",
00145     "DW_DLE_INCL_DIR_NUM_BAD",
00146     "DW_DLE_LINE_FILE_NUM_BAD",
00147     "DW_DLE_ALLOC_FAIL",
00148     "DW_DLE_NO_CALLBACK_FUNC",
00149     "DW_DLE_SECT_ALLOC",
00150     "DW_DLE_FILE_ENTRY_ALLOC",
00151     "DW_DLE_LINE_ALLOC",
00152     "DW_DLE_FPGM_ALLOC",
00153     "DW_DLE_INCDIR_ALLOC",
00154     "DW_DLE_STRING_ALLOC",
00155     "DW_DLE_CHUNK_ALLOC",
00156     "DW_DLE_BYTEOFF_ERR",
00157     "DW_DLE_CIE_ALLOC",
00158     "DW_DLE_FDE_ALLOC",
00159     "DW_DLE_REGNO_OVFL",
00160     "DW_DLE_CIE_OFFS_ALLOC",
00161     "DW_DLE_WRONG_ADDRESS",
00162     "DW_DLE_EXTRA_NEIGHBORS",
00163     "DW_DLE_WRONG_TAG",
00164     "DW_DLE_DIE_ALLOC",
00165     "DW_DLE_PARENT_EXISTS",
00166     "DW_DLE_DBG_NULL",
00167     "DW_DLE_DEBUGLINE_ERROR",
00168     "DW_DLE_DEBUGFRAME_ERROR",
00169     "DW_DLE_DEBUGINFO_ERROR",
00170     "DW_DLE_ATTR_ALLOC",
00171     "DW_DLE_ABBREV_ALLOC",
00172     "DW_DLE_OFFSET_UFLW",
00173     "DW_DLE_ELF_SECT_ERR",
00174     "DW_DLE_DEBUG_FRAME_LENGTH_BAD",
00175     "DW_DLE_FRAME_VERSION_BAD",
00176     "DW_DLE_CIE_RET_ADDR_REG_ERROR",
00177     "DW_DLE_FDE_NULL",
00178     "DW_DLE_FDE_DBG_NULL",
00179     "DW_DLE_CIE_NULL",
00180     "DW_DLE_CIE_DBG_NULL",
00181     "DW_DLE_FRAME_TABLE_COL_BAD",
00182     "DW_DLE_PC_NOT_IN_FDE_RANGE",
00183     "DW_DLE_CIE_INSTR_EXEC_ERROR",
00184     "DW_DLE_FRAME_INSTR_EXEC_ERROR",
00185     "DW_DLE_FDE_PTR_NULL",
00186     "DW_DLE_RET_OP_LIST_NULL",
00187     "DW_DLE_LINE_CONTEXT_NULL",
00188     "DW_DLE_DBG_NO_CU_CONTEXT",
00189     "DW_DLE_DIE_NO_CU_CONTEXT",
00190     "DW_DLE_FIRST_DIE_NOT_CU",
00191     "DW_DLE_NEXT_DIE_PTR_NULL",
00192     "DW_DLE_DEBUG_FRAME_DUPLICATE  Only one .debug_frame  "
00193   "section is allowed",
00194     "DW_DLE_DEBUG_FRAME_NULL  .debug_frame section present but "
00195   "elf_getdata() failed or section is zero-length",
00196     "DW_DLE_ABBREV_DECODE_ERROR",
00197     "DW_DLE_DWARF_ABBREV_NULL",
00198     "DW_DLE_ATTR_NULL",
00199     "DW_DLE_DIE_BAD",
00200     "DW_DLE_DIE_ABBREV_BAD",
00201     "DW_DLE_ATTR_FORM_BAD",
00202     "DW_DLE_ATTR_NO_CU_CONTEXT",
00203     "DW_DLE_ATTR_FORM_SIZE_BAD",
00204     "DW_DLE_ATTR_DBG_NULL",
00205     "DW_DLE_BAD_REF_FORM",
00206     "DW_DLE_ATTR_FORM_OFFSET_BAD",
00207     "DW_DLE_LINE_OFFSET_BAD",
00208     "DW_DLE_DEBUG_STR_OFFSET_BAD",
00209     "DW_DLE_STRING_PTR_NULL",
00210     "DW_DLE_PUBNAMES_VERSION_ERROR",
00211     "DW_DLE_PUBNAMES_LENGTH_BAD",
00212     "DW_DLE_GLOBAL_NULL",
00213     "DW_DLE_GLOBAL_CONTEXT_NULL",
00214     "DW_DLE_DIR_INDEX_BAD",
00215     "DW_DLE_LOC_EXPR_BAD",
00216     "DW_DLE_DIE_LOC_EXPR_BAD",
00217     "DW_DLE_ADDR_ALLOC",
00218     "DW_DLE_OFFSET_BAD",
00219     "DW_DLE_MAKE_CU_CONTEXT_FAIL",
00220     "DW_DLE_REL_ALLOC",
00221     "DW_DLE_ARANGE_OFFSET_BAD",
00222     "DW_DLE_SEGMENT_SIZE_BAD",
00223     "DW_DLE_ARANGE_LENGTH_BAD",
00224     "DW_DLE_ARANGE_DECODE_ERROR",
00225     "DW_DLE_ARANGES_NULL",
00226     "DW_DLE_ARANGE_NULL",
00227     "DW_DLE_NO_FILE_NAME",
00228     "DW_DLE_NO_COMP_DIR",
00229     "DW_DLE_CU_ADDRESS_SIZE_BAD",
00230     "DW_DLE_INPUT_ATTR_BAD",
00231     "DW_DLE_EXPR_NULL",
00232     "DW_DLE_BAD_EXPR_OPCODE",
00233     "DW_DLE_EXPR_LENGTH_BAD",
00234     "DW_DLE_MULTIPLE_RELOC_IN_EXPR",
00235     "DW_DLE_ELF_GETIDENT_ERROR",
00236     "DW_DLE_NO_AT_MIPS_FDE",
00237     "DW_DLE_NO_CIE_FOR_FDE",
00238     "DW_DLE_DIE_ABBREV_LIST_NULL",
00239     "DW_DLE_DEBUG_FUNCNAMES_DUPLICATE",
00240     "DW_DLE_DEBUG_FUNCNAMES_NULL .debug_funcnames section present but "
00241   "elf_getdata() failed or section is zero-length",
00242     "DW_DLE_DEBUG_FUNCNAMES_VERSION_ERROR",
00243     "DW_DLE_DEBUG_FUNCNAMES_LENGTH_BAD",
00244     "DW_DLE_FUNC_NULL",
00245     "DW_DLE_FUNC_CONTEXT_NULL",
00246     "DW_DLE_DEBUG_TYPENAMES_DUPLICATE",
00247     "DW_DLE_DEBUG_TYPENAMES_NULL .debug_typenames section present but "
00248   "elf_getdata() failed or section is zero-length",
00249     "DW_DLE_DEBUG_TYPENAMES_VERSION_ERROR",
00250     "DW_DLE_DEBUG_TYPENAMES_LENGTH_BAD",
00251     "DW_DLE_TYPE_NULL",
00252     "DW_DLE_TYPE_CONTEXT_NULL",
00253     "DW_DLE_DEBUG_VARNAMES_DUPLICATE",
00254     "DW_DLE_DEBUG_VARNAMES_NULL .debug_varnames section present but "
00255   "elf_getdata() failed or section is zero-length",
00256     "DW_DLE_DEBUG_VARNAMES_VERSION_ERROR",
00257     "DW_DLE_DEBUG_VARNAMES_LENGTH_BAD",
00258     "DW_DLE_VAR_NULL",
00259     "DW_DLE_VAR_CONTEXT_NULL",
00260     "DW_DLE_DEBUG_WEAKNAMES_DUPLICATE",
00261     "DW_DLE_DEBUG_WEAKNAMES_NULL .debug_weaknames section present but "
00262   "elf_getdata() failed or section is zero-length",
00263 
00264     "DW_DLE_DEBUG_WEAKNAMES_VERSION_ERROR",
00265     "DW_DLE_DEBUG_WEAKNAMES_LENGTH_BAD",
00266     "DW_DLE_WEAK_NULL",
00267     "DW_DLE_WEAK_CONTEXT_NULL (175)",
00268     "DW_DLE_LOCDESC_COUNT_WRONG (176)",
00269     "DW_DLE_MACINFO_STRING_NULL (177)",
00270     "DW_DLE_MACINFO_STRING_EMPTY (178)",
00271     "DW_DLE_MACINFO_INTERNAL_ERROR_SPACE (179)",
00272     "DW_DLE_MACINFO_MALLOC_FAIL (180)",
00273     "DW_DLE_DEBUGMACINFO_ERROR (181)",
00274     "DW_DLE_DEBUG_MACRO_LENGTH_BAD (182)",
00275     "DW_DLE_DEBUG_MACRO_MAX_BAD (183)",
00276     "DW_DLE_DEBUG_MACRO_INTERNAL_ERR (184)",
00277     "DW_DLE_DEBUG_MACRO_MALLOC_SPACE (185)",
00278     "DW_DLE_DEBUG_MACRO_INCONSISTENT (186)",
00279     "DW_DLE_DF_NO_CIE_AUGMENTATION(187)",
00280     "DW_DLE_DF_REG_NUM_TOO_HIGH(188)",
00281     "DW_DLE_DF_MAKE_INSTR_NO_INIT(189)",
00282     "DW_DLE_DF_NEW_LOC_LESS_OLD_LOC(190)",
00283     "DW_DLE_DF_POP_EMPTY_STACK(191)",
00284     "DW_DLE_DF_ALLOC_FAIL(192)",
00285     "DW_DLE_DF_FRAME_DECODING_ERROR(193)",
00286     "DW_DLE_DEBUG_LOC_SECTION_SHORT(194)",
00287     "DW_DLE_LAST_CHILD_ISNT(195)"
00288 
00289 };
00290 
00291 
00292 
00293 
00294 /* 
00295     This function performs error handling as described in the 
00296     libdwarf consumer document section 3.  Dbg is the Dwarf_debug
00297     structure being processed.  Error is a pointer to the pointer
00298     to the error descriptor that will be returned.  Errval is an
00299     error code listed in dwarf_error.h.
00300 */
00301 void
00302 _dwarf_error(Dwarf_Debug dbg, Dwarf_Error * error, Dwarf_Sword errval)
00303 {
00304     Dwarf_Error errptr;
00305 
00306     /* 
00307        Allow NULL dbg on entry, since sometimes that can happen and we
00308        want to report the upper-level error, not this one. */
00309     if (error != NULL) {
00310 
00311   /* 
00312      If dbg is NULL, use the alternate error struct. However,
00313      this will overwrite the earlier error. */
00314   if (dbg != NULL) {
00315       errptr =
00316     (Dwarf_Error) _dwarf_get_alloc(dbg, DW_DLA_ERROR, 1);
00317       if (errptr == NULL) {
00318     fprintf(stderr,
00319       "Could not allocate Dwarf_Error structure, "
00320       "abort() in libdwarf.\n");
00321     abort();
00322       }
00323   } else {
00324       /* We have no dbg to work with. dwarf_init failed. We hack
00325          up a special area. */
00326       errptr = _dwarf_special_no_dbg_error_malloc();
00327       if (errptr == NULL) {
00328     fprintf(stderr,
00329       "Could not allocate Dwarf_Error structure, "
00330       "abort() in libdwarf..\n");
00331     abort();
00332       }
00333   }
00334 
00335   errptr->er_errval = errval;
00336   *error = errptr;
00337   return;
00338     }
00339 
00340     if (dbg != NULL && dbg->de_errhand != NULL) {
00341   errptr = (Dwarf_Error) _dwarf_get_alloc(dbg, DW_DLA_ERROR, 1);
00342   if (errptr == NULL) {
00343       fprintf(stderr, "Could not allocate Dwarf_Error structure,"
00344         " abort() in libdwarf.\n");
00345       abort();
00346   }
00347   errptr->er_errval = errval;
00348   dbg->de_errhand(errptr, dbg->de_errarg);
00349   return;
00350     }
00351     fprintf(stderr,
00352       "abort() in libdwarf. No error argument, no handler.\n");
00353     abort();
00354 }
00355 
00356 
00357 Dwarf_Unsigned
00358 dwarf_errno(Dwarf_Error error)
00359 {
00360     if (error == NULL) {
00361   return (0);
00362     }
00363 
00364     return (error->er_errval);
00365 }
00366 
00367 
00368 /* 
00369 */
00370 char *
00371 dwarf_errmsg(Dwarf_Error error)
00372 {
00373     if (error == NULL) {
00374   return "Dwarf_Error is NULL";
00375     }
00376 
00377     if (error->er_errval > (sizeof(_dwarf_errmsgs) / sizeof(char *))) {
00378   return "Dwarf_Error value out of range";
00379     }
00380 
00381     return ((char *) _dwarf_errmsgs[error->er_errval]);
00382 }
osprey/libdwarf/libdwarf/dwarf_error.c
