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 // findDynamicLinkingInfo, getSharedObjects, addSharedObject,
  53 // isDynamic
  54 //
  55 class dynamic_linking {
  56
  57 public:
  58
  59     dynamic_linking(){ link_map_addr = 0; dynlinked = false; }
  60     ~dynamic_linking(){}
  61
  62     // findDynamicLinkingInfo: This routine is called on exit point of
  63     // of the exec system call. It checks if the a.out is dynamically linked,
  64     // and if so, it inserts any initial instrumentation that is necessary
  65     // for collecting run-time linking info.
  66     bool findDynamicLinkingInfo(process *p);
  67
  68     // getSharedObjects: This routine is called before main() to get and
  69     // process all shared objects that have been mapped into the process's
  70     // address space
  71     // returns 0
  72     vector< shared_object *> *getSharedObjects(process *p);
  73
  74     // addASharedObject: This routine is called whenever a new shared object
  75     // has been loaded by the run-time linker
  76     // It processes the image, creates new resources
  77     // Currently, this is not implemented, because we are not handleing
  78     // adding shared objects after the executable starts executing main()
  79     shared_object *addSharedObject(process *){ return 0;}
  80
  81     // returns true if the executable is dynamically linked
  82     bool isDynamic(){ return(dynlinked);}
  83
  84
  85 private:
  86    u_int link_map_addr;
  87    bool  dynlinked;
  88 };
  89
  90 #endif
  91
  92