changed the way we are getting shared objects on Solaris platforms. We are no
[dyninst.git] / 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