dyninstAPI/src/solarisDL.h

   1 /*
   2  * Copyright (c) 1996 Barton P. Miller
   3  *
   4  * We provide the Paradyn Parallel Performance Tools (below
   5  * described as Paradyn") on an AS IS basis, and do not warrant its
   6  * validity or performance.  We reserve the right to update, modify,
   7  * or discontinue this software at any time.  We shall have no
   8  * obligation to supply such updates or modifications or any other
   9  * form of support to you.
  10  *
  11  * This license is for research uses.  For such uses, there is no
  12  * charge. We define "research use" to mean you may freely use it
  13  * inside your organization for whatever purposes you see fit. But you
  14  * may not re-distribute Paradyn or parts of Paradyn, in any form
  15  * source or binary (including derivatives), electronic or otherwise,
  16  * to any other organization or entity without our permission.
  17  *
  18  * (for other uses, please contact us at paradyn@cs.wisc.edu)
  19  *
  20  * All warranties, including without limitation, any warranty of
  21  * merchantability or fitness for a particular purpose, are hereby
  22  * excluded.
  23  *
  24  * By your use of Paradyn, you understand and agree that we (or any
  25  * other person or entity with proprietary rights in Paradyn) are
  26  * under no obligation to provide either maintenance services,
  27  * update services, notices of latent defects, or correction of
  28  * defects for Paradyn.
  29  *
  30  * Even if advised of the possibility of such damages, under no
  31  * circumstances shall we (or any other person or entity with
  32  * proprietary rights in the software licensed hereunder) be liable
  33  * to you or any third party for direct, indirect, or consequential
  34  * damages of any character regardless of type of action, including,
  35  * without limitation, loss of profits, loss of use, loss of good
  36  * will, or computer failure or malfunction.  You agree to indemnify
  37  * us (and any other person or entity with proprietary rights in the
  38  * software licensed hereunder) for any and all liability it may
  39  * incur to third parties resulting from your use of Paradyn.
  40  */
  41
  42 #if !defined(solaris_dl_hdr)
  43 #define solaris_dl_hdr
  44
  45 #include "util/h/Vector.h"
  46 #include "paradynd/src/sharedobject.h"
  47 class process;
  48
  49 //
  50 // All platform specific dynamic linking info. is in this class
  51 // each version of this class must have the following funcitons:
  52 // getSharedObjects, addSharedObject, isDynamic
  53 //
  54 class dynamic_linking {
  55
  56 public:
  57
  58     dynamic_linking(){ dynlinked = false; r_debug_addr = 0;}
  59     ~dynamic_linking(){}
  60
  61     // getProcessSharedObjects: This routine is called after attaching to
  62     // an already running process p, or when a process reaches the breakpoint at
  63     // the entry point of main().  It gets all shared objects that have been
  64     // mapped into the process's address space
  65     // returns 0 on error or if there are no shared objects
  66     vector< shared_object *> *getSharedObjects(process *p);
  67
  68     // addASharedObject: This routine is called whenever a new shared object
  69     // has been loaded by the run-time linker
  70     // It processes the image, creates new resources
  71     // Currently, this is not implemented, because we are not handleing
  72     // adding shared objects after the executable starts executing main()
  73     shared_object *addSharedObject(process *){ return 0;}
  74
  75     // returns true if the executable is dynamically linked
  76     bool isDynamic(){ return(dynlinked);}
  77
  78
  79 private:
  80    bool  dynlinked;
  81    u_int r_debug_addr;
  82
  83    // get_ld_base_addr: This routine returns the base address of ld.so.1
  84    // it returns true on success, and false on error
  85    bool dynamic_linking::get_ld_base_addr(u_int &addr, int proc_fd);
  86
  87    // find_r_debug: this routine finds the symbol table for ld.so.1, and
  88    // parses it to find the address of symbol r_debug
  89    // it returns false on error
  90    bool find_r_debug(u_int ld_fd,u_int ld_base_addr);
  91
  92    // processLinkMaps: This routine is called by getSharedObjects to
  93    // process all shared objects that have been mapped into the process's
  94    // address space.  This routine reads the link maps from the application
  95    // process to find the shared object file base mappings. returns 0 on error
  96    vector<shared_object *> *processLinkMaps(process *p);
  97
  98 };
  99
 100 #endif
 101
 102