Home | History | Annotate | Download | only in docs
      1 ANDROID ELFF LIBRARY
      2 
      3 The docs/ANDROID-ELFF.TXT document contains notes about the ELFF library used
      4 by the emulator to extract debugging information from symbol files of the
      5 emulated system.
      6 
      7 The ELFF library has been introduced to provide the emulator's memory checker
      8 subsystem with information about routine name, source file name and location
      9 when a memory access violation detected at runtime. This requires parsing symbol
     10 files corresponding to the libraries of the emulated system, in order to extract
     11 relevant information from them.
     12 
     13 Due to lack of windows support on available open source projects, this is a
     14 full new implementation of an ELF/DWARF parser.
     15 
     16 The library exposes a simple API that at this point allows:
     17 - Extract information about routine, containing given PC address in the emulated
     18   system. Routine information, collected by the library includes:
     19   * Routine name
     20   * Source file name and line corresponded to the given emulated PC.
     21   * If routine happens to be inlined, library traces inclusion up to the first
     22     routine that is not inlined, providing names and source file location
     23     information for all inlined routines in that chain.
     24