00001 /* 00002 00003 Copyright (C) 2000, 2001 Silicon Graphics, Inc. All Rights Reserved. 00004 00005 This program is free software; you can redistribute it and/or modify it 00006 under the terms of version 2 of the GNU General Public License as 00007 published by the Free Software Foundation. 00008 00009 This program is distributed in the hope that it would be useful, but 00010 WITHOUT ANY WARRANTY; without even the implied warranty of 00011 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 00012 00013 Further, this software is distributed without any warranty that it is 00014 free of the rightful claim of any third person regarding infringement 00015 or the like. Any license provided herein, whether implied or 00016 otherwise, applies only to this software file. Patent licenses, if 00017 any, provided herein do not apply to combinations of this program with 00018 other software, or any other product whatsoever. 00019 00020 You should have received a copy of the GNU General Public License along 00021 with this program; if not, write the Free Software Foundation, Inc., 59 00022 Temple Place - Suite 330, Boston MA 02111-1307, USA. 00023 00024 Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pky, 00025 Mountain View, CA 94043, or: 00026 00027 http://www.sgi.com 00028 00029 For further information regarding this notice, see: 00030 00031 http://oss.sgi.com/projects/GenInfo/NoticeExplan 00032 00033 */ 00034 00035 00036 /* 00037 dwarf_addr_finder.h 00038 $Source$ 00039 $Date$ 00040 00041 Defines user interface. 00042 00043 */ 00044 00045 /* return codes for functions 00046 */ 00047 #define DW_DLV_NO_ENTRY -1 00048 #define DW_DLV_OK 0 00049 #define DW_DLV_ERROR 1 00050 00051 00052 /* the following are the 'section' number passed to the called-back 00053 function. 00054 The called-back application must translate this to the 00055 appropriate elf section number/pointer. 00056 00057 Putting this burden on the application avoids having to store 00058 the numbers in the Dwarf_Debug structure (thereby saving space 00059 for most consumers). 00060 */ 00061 #define DW_SECTION_INFO 0 00062 #define DW_SECTION_FRAME 1 00063 #define DW_SECTION_ARANGES 2 00064 #define DW_SECTION_LINE 3 00065 #define DW_SECTION_LOC 4 /* .debug_loc */ 00066 00067 /* section is one of the above codes: it specifies a section. 00068 secoff is the offset in the dwarf section. 00069 existingAddr is the value at the specified offset (so the 00070 called back routine can sanity check the proceedings). 00071 It's up to the caller to know the size of an address (4 or 8) 00072 and update the right number of bytes. 00073 */ 00074 typedef int (*Dwarf_addr_callback_func) (int /*section*/, 00075 Dwarf_Off /*secoff*/, Dwarf_Addr /*existingAddr*/); 00076 00077 /* call this to do the work: it calls back thru cb_func 00078 once per each address to be modified. 00079 Once this returns you are done. 00080 Returns DW_DLV_OK if finished ok. 00081 Returns DW_DLV_ERROR if there was some kind of error, in which 00082 the dwarf error number was passed back thu the dwerr ptr. 00083 Returns DW_DLV_NO_ENTRY if there are no relevant dwarf sections, 00084 so there were no addresses to be modified (and none 00085 called back). 00086 */ 00087 int _dwarf_addr_finder(Elf * elf_file_ptr, 00088 Dwarf_addr_callback_func cb_func, 00089 int *dwerr); 00090
1.5.6