1 /*
   2  * Copyright 2012, 2013 SAP AG. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20  * or visit www.oracle.com if you need additional information or have any
  21  * questions.
  22  *
  23  */
  24 
  25 
  26 // Loadlib_aix.cpp contains support code for analysing the memory
  27 // layout of loaded binaries in ones own process space.
  28 //
  29 // It is needed, among other things, to provide a  dladdr() emulation, because
  30 // that one is not provided by AIX
  31 
  32 #ifndef OS_AIX_VM_LOADLIB_AIX_HPP
  33 #define OS_AIX_VM_LOADLIB_AIX_HPP
  34 
  35 class outputStream;
  36 
  37 // This class holds information about a single loaded library module.
  38 // Note that on AIX, a single library can be spread over multiple
  39 // uintptr_t range on a module base, eg.
  40 // libC.a(shr3_64.o) or libC.a(shrcore_64.o).
  41 class LoadedLibraryModule {
  42 
  43     friend class LoadedLibraries;
  44 
  45     char fullpath[512];  // eg /usr/lib/libC.a
  46     char shortname[30];  // eg libC.a
  47     char membername[30]; // eg shrcore_64.o
  48     const unsigned char* text_from;
  49     const unsigned char* text_to;
  50     const unsigned char* data_from;
  51     const unsigned char* data_to;
  52 
  53   public:
  54 
  55     const char* get_fullpath() const {
  56       return fullpath;
  57     }
  58     const char* get_shortname() const {
  59       return shortname;
  60     }
  61     const char* get_membername() const {
  62       return membername;
  63     }
  64 
  65     // text_from, text_to: returns the range of the text (code)
  66     // segment for that module
  67     const unsigned char* get_text_from() const {
  68       return text_from;
  69     }
  70     const unsigned char* get_text_to() const {
  71       return text_to;
  72     }
  73 
  74     // data_from/data_to: returns the range of the data
  75     // segment for that module
  76     const unsigned char* get_data_from() const {
  77       return data_from;
  78     }
  79     const unsigned char* get_data_to() const {
  80       return data_to;
  81     }
  82 
  83     // returns true if the
  84     bool is_in_text(const unsigned char* p) const {
  85       return p >= text_from && p < text_to ? true : false;
  86     }
  87 
  88     bool is_in_data(const unsigned char* p) const {
  89       return p >= data_from && p < data_to ? true : false;
  90     }
  91 
  92     // output debug info
  93     void print(outputStream* os) const;
  94 
  95 }; // end LoadedLibraryModule
  96 
  97 // This class is a singleton holding a map of all loaded binaries
  98 // in the AIX process space.
  99 class LoadedLibraries
 100 // : AllStatic (including allocation.hpp just for AllStatic is overkill.)
 101 {
 102 
 103   private:
 104 
 105     enum {MAX_MODULES = 100};
 106     static LoadedLibraryModule tab[MAX_MODULES];
 107     static int num_loaded;
 108 
 109   public:
 110 
 111     // rebuild the internal table of LoadedLibraryModule objects
 112     static void reload();
 113 
 114     // checks whether the address p points to any of the loaded code segments.
 115     // If it does, returns the LoadedLibraryModule entry. If not, returns NULL.
 116     static const LoadedLibraryModule* find_for_text_address(const  unsigned char* p);
 117 
 118     // checks whether the address p points to any of the loaded data segments.
 119     // If it does, returns the LoadedLibraryModule entry. If not, returns NULL.
 120     static const LoadedLibraryModule* find_for_data_address(const  unsigned char* p);
 121 
 122     // output debug info
 123     static void print(outputStream* os);
 124 
 125 }; // end LoadedLibraries
 126 
 127 
 128 #endif // OS_AIX_VM_LOADLIB_AIX_HPP