Merge branch 'master' into patchapi_snippet
[dyninst.git] / dyninstAPI / src / BPatch_addressSpace.C
1 /*
2  * Copyright (c) 1996-2011 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  * By your use of Paradyn, you understand and agree that we (or any
12  * other person or entity with proprietary rights in Paradyn) are
13  * under no obligation to provide either maintenance services,
14  * update services, notices of latent defects, or correction of
15  * defects for Paradyn.
16  *
17  * This library is free software; you can redistribute it and/or
18  * modify it under the terms of the GNU Lesser General Public
19  * License as published by the Free Software Foundation; either
20  * version 2.1 of the License, or (at your option) any later version.
21  *
22  * This library is distributed in the hope that it will be useful,
23  * but WITHOUT ANY WARRANTY; without even the implied warranty of
24  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
25  * Lesser General Public License for more details.
26  *
27  * You should have received a copy of the GNU Lesser General Public
28  * License along with this library; if not, write to the Free Software
29  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
30  */
31
32 #define BPATCH_FILE
33
34 #include "process.h"
35 #include "binaryEdit.h"
36 #include "EventHandler.h"
37 #include "mailbox.h"
38 #include "signalgenerator.h"
39 #include "inst.h"
40 #include "instP.h"
41 #include "function.h" // Dyninst::PatchAPI::PatchFunction
42 #include "codeRange.h"
43 #include "dyn_thread.h"
44 #include "addressSpace.h"
45
46 #include "mapped_module.h"
47
48 #include "BPatch_libInfo.h"
49 #include "BPatch_asyncEventHandler.h"
50 #include "BPatch.h"
51 #include "BPatch_thread.h"
52 #include "BPatch_function.h"
53 #include "BPatch_point.h"
54 #include "callbacks.h"
55
56 #include "BPatch_private.h"
57
58 #include "ast.h"
59
60 #include "BPatch_addressSpace.h"
61
62 #include "BPatch_instruction.h"
63
64 #include "mapped_object.h"
65
66 #include <sstream>
67 #include "Parsing.h"
68
69 #include "Command.h"
70 #include "Relocation/DynInstrumenter.h"
71
72 #include "PatchMgr.h"
73
74 using Dyninst::PatchAPI::Patcher;
75 using Dyninst::PatchAPI::DynInsertSnipCommand;
76 using Dyninst::PatchAPI::DynReplaceFuncCommand;
77 using Dyninst::PatchAPI::DynModifyCallCommand;
78 using Dyninst::PatchAPI::DynRemoveCallCommand;
79
80 BPatch_addressSpace::BPatch_addressSpace() :
81    image(NULL)
82 {
83 }
84
85 BPatch_addressSpace::~BPatch_addressSpace()
86 {}
87
88
89 BPatch_function *BPatch_addressSpace::findOrCreateBPFunc(Dyninst::PatchAPI::PatchFunction* ifunc,
90                                                          BPatch_module *bpmod)
91 {
92    func_instance *fi = static_cast<func_instance *>(ifunc);
93    if (!bpmod)
94       bpmod = image->findOrCreateModule(fi->mod());
95    assert(bpmod);
96    if (bpmod->func_map.count(ifunc)) {
97       BPatch_function *bpf = bpmod->func_map[ifunc];
98       assert(bpf);
99       assert(bpf->func == ifunc);
100       return bpf;
101    }
102
103    // Find the module that contains the function
104    if (bpmod == NULL && fi->mod() != NULL) {
105       bpmod = getImage()->findModule(fi->mod()->fileName().c_str());
106    }
107
108    // findModule has a tendency to make new function objects... so
109    // check the map again
110    if (bpmod->func_map.count(ifunc)) {
111       BPatch_function *bpf = bpmod->func_map[ifunc];
112       assert(bpf);
113       assert(bpf->func == ifunc);
114       return bpf;
115    }
116
117    BPatch_function *ret = new BPatch_function(this, fi, bpmod);
118    assert( ret != NULL );
119    assert(ret->func == ifunc);
120    return ret;
121 }
122
123
124
125
126 BPatch_point *BPatch_addressSpace::findOrCreateBPPoint(BPatch_function *bpfunc,
127                                                        Dyninst::PatchAPI::Point *p,
128                                                        BPatch_procedureLocation pointType)
129 {
130    instPoint *ip = static_cast<instPoint *>(p);
131    assert(ip);
132    func_instance *fi = static_cast<func_instance *>(ip->func());
133    if (!fi) return NULL; // PatchAPI can create function-less points, but we can't represent them as BPatch_points
134
135    BPatch_module *mod = image->findOrCreateModule(fi->mod());
136    assert(mod);
137
138    if (mod->instp_map.count(ip))
139       return mod->instp_map[ip];
140
141    if (pointType == BPatch_locUnknownLocation) {
142       cerr << "Error: point type not specified!" << endl;
143       assert(0);
144       return NULL;
145    }
146
147    AddressSpace *lladdrSpace = fi->proc();
148    if (!bpfunc)
149       bpfunc = findOrCreateBPFunc(fi, mod);
150
151    assert(bpfunc->func == ip->func());
152    std::pair<instPoint *, instPoint *> pointsToUse = instPoint::getInstpointPair(ip);
153
154    BPatch_point *pt = new BPatch_point(this, bpfunc,
155                                        pointsToUse.first, pointsToUse.second,
156                                        pointType, lladdrSpace);
157    mod->instp_map[ip] = pt;
158
159    return pt;
160 }
161
162 BPatch_variableExpr *BPatch_addressSpace::findOrCreateVariable(int_variable *v,
163                                                                BPatch_type *type)
164 {
165    BPatch_module *mod = image->findOrCreateModule(v->mod());
166    assert(mod);
167    if (mod->var_map.count(v))
168       return mod->var_map[v];
169
170    if (!type) {
171       SymtabAPI::Type *stype = v->ivar()->svar()->getType();
172
173       if (stype){
174          type = BPatch_type::findOrCreateType(stype);
175       }else{
176          type = BPatch::bpatch->type_Untyped;
177       }
178    }
179
180    BPatch_variableExpr *var = BPatch_variableExpr::makeVariableExpr(this, v, type);
181    mod->var_map[v] = var;
182    return var;
183 }
184
185
186
187 BPatch_function *BPatch_addressSpace::createBPFuncCB(AddressSpace *a, Dyninst::PatchAPI::PatchFunction *f)
188 {
189    BPatch_addressSpace *aS = (BPatch_addressSpace *)a->up_ptr();
190    assert(aS);
191    return aS->findOrCreateBPFunc(f, NULL);
192 }
193
194 BPatch_point *BPatch_addressSpace::createBPPointCB(AddressSpace *a,
195                                                    Dyninst::PatchAPI::PatchFunction *pf,
196                                                    Dyninst::PatchAPI::Point *p, int type)
197 {
198    func_instance *fi = static_cast<func_instance *>(pf);
199    instPoint *ip  = static_cast<instPoint *>(p);
200    BPatch_addressSpace *aS = (BPatch_addressSpace *)a->up_ptr();
201    assert(aS);
202
203    BPatch_module *bpmod = aS->getImageInt()->findOrCreateModule(fi->mod());
204    assert(bpmod);
205
206    BPatch_function *func = aS->findOrCreateBPFunc(fi, bpmod);
207    assert(func);
208
209    return aS->findOrCreateBPPoint(func, ip, (BPatch_procedureLocation) type);
210 }
211
212
213
214 /***************************************************************************
215  * Bpatch_snippetHandle
216  ***************************************************************************/
217
218 /*
219  * BPatchSnippetHandle::BPatchSnippetHandle
220  *
221  * Constructor for BPatchSnippetHandle.  Delete the snippet instance(s)
222  * associated with the BPatchSnippetHandle.
223  */
224 BPatchSnippetHandle::BPatchSnippetHandle(BPatch_addressSpace * addSpace) :
225    addSpace_(addSpace)
226 {
227 }
228
229 /*
230  * BPatchSnippetHandle::~BPatchSnippetHandle
231  *
232  * Destructor for BPatchSnippetHandle.  Delete the snippet instance(s)
233  * associated with the BPatchSnippetHandle.
234  */
235 void BPatchSnippetHandle::BPatchSnippetHandle_dtor()
236 {
237    // don't delete inst instances since they are might have been copied
238 }
239
240 BPatch_addressSpace *BPatchSnippetHandle::getAddressSpaceInt()
241 {
242    return addSpace_;
243 }
244
245 BPatch_process *BPatchSnippetHandle::getProcessInt()
246 {
247    return dynamic_cast<BPatch_process *>(addSpace_);
248 }
249
250 BPatch_Vector<BPatch_thread *> &BPatchSnippetHandle::getCatchupThreadsInt()
251 {
252    return catchup_threads;
253 }
254
255 BPatch_function * BPatchSnippetHandle::getFuncInt()
256 {
257     if (!instances_.empty()) {
258        Dyninst::PatchAPI::PatchFunction *func = instances_.back()->point()->func();
259        BPatch_function *bpfunc = addSpace_->findOrCreateBPFunc(func,NULL);
260        return bpfunc;
261     }
262     return NULL;
263 }
264
265
266 BPatch_image * BPatch_addressSpace::getImageInt()
267 {
268    return image;
269 }
270
271
272 /*
273  * BPatch_addressSpace::deleteSnippet
274  *
275  * Deletes an instance of a snippet.
276  *
277  * handle       The handle returned by insertSnippet when the instance to
278  *              deleted was created.
279  */
280
281 bool BPatch_addressSpace::deleteSnippetInt(BPatchSnippetHandle *handle)
282 {
283    if (getTerminated()) return true;
284
285    if (handle == NULL) {
286        bperr("Request to delete NULL snippet handle, returning false\n");
287        return false;
288    }
289
290    if (handle->addSpace_ != this) {
291      bperr("Error: wrong address space in deleteSnippet\n");
292      return false;
293    }
294
295    mal_printf("deleting snippet handle from func at %lx, point at %lx of type %d\n",
296               (Address)handle->getFunc()->getBaseAddr(), 
297               handle->instances_.empty() ? 0 : handle->instances_[0]->point()->addr(),
298               handle->instances_.empty() ? -1 : handle->instances_[0]->point()->type());
299
300    // if this is a process, check to see if the instrumentation is
301    // executing on the call stack
302    instPoint *ip = static_cast<instPoint *>(handle->instances_[0]->point());
303
304    if ( handle->getProcess() && handle->instances_.size() > 0 &&
305        BPatch_normalMode !=
306         ip->func()->obj()->hybridMode())
307    {
308        if (handle->instances_.size() > 1) {
309            mal_printf("ERROR: Removing snippet that is installed in "
310                           "multiple miniTramps %s[%d]\n",FILE__,__LINE__);
311      }
312    }
313
314    // uninstrument and remove snippet handle from point datastructures
315    for (unsigned int i=0; i < handle->instances_.size(); i++)
316      {
317         uninstrument(handle->instances_[i]);
318         Dyninst::PatchAPI::Point *iPoint = handle->instances_[i]->point();
319         BPatch_point *bPoint = findOrCreateBPPoint(NULL, iPoint,
320                                                    BPatch_point::convertInstPointType_t(iPoint->type()));
321         assert(bPoint);
322         bPoint->removeSnippet(handle);
323      }
324
325    handle->instances_.clear();
326
327    if (pendingInsertions == NULL) {
328      // Trigger it now
329      bool tmp;
330      finalizeInsertionSet(false, &tmp);
331    }
332
333    //delete handle;
334    return true;
335 }
336
337 /*
338  * BPatch_addressSpace::replaceCode
339  *
340  * Replace a given instruction with a BPatch_snippet.
341  *
342  * point       Represents the instruction to be replaced
343  * snippet     The replacing snippet
344  */
345
346 bool BPatch_addressSpace::replaceCodeInt(BPatch_point * /*point*/,
347                                          BPatch_snippet * /*snippet*/)
348 {
349    // Need to reevaluate how this code works. I don't think it should be
350    // point-based, though.
351
352    assert(0);
353    return false;
354 }
355
356 /*
357  * BPatch_addressSpace::replaceFunctionCall
358  *
359  * Replace a function call with a call to a different function.  Returns true
360  * upon success, false upon failure.
361  *
362  * point        The call site that is to be changed.
363  * newFunc      The function that the call site will now call.
364  */
365 bool BPatch_addressSpace::replaceFunctionCallInt(BPatch_point &point,
366       BPatch_function &newFunc)
367 {
368    char name[1024];
369    newFunc.getName(name, 1024);
370
371    // Can't make changes to code when mutations are not active.
372    if (!getMutationsActive())
373       return false;
374
375    assert(point.point && newFunc.lowlevel_func());
376
377   /* PatchAPI stuffs */
378    AddressSpace* addr_space = point.getAS();
379    DynModifyCallCommand* rep_call = DynModifyCallCommand::create(addr_space,
380       point.point->block(), newFunc.lowlevel_func(), point.point->func());
381   addr_space->patcher()->add(rep_call);
382   /* End of PatchAPI */
383
384    if (pendingInsertions == NULL) {
385      // Trigger it now
386      bool tmp;
387      finalizeInsertionSet(false, &tmp);
388    }
389    return true;
390 }
391
392 /*
393  * BPatch_addressSpace::removeFunctionCall
394  *
395  * Replace a function call with a NOOP.  Returns true upon success, false upon
396  * failure.
397  *
398  * point        The call site that is to be NOOPed out.
399  */
400 bool BPatch_addressSpace::removeFunctionCallInt(BPatch_point &point)
401 {
402    // Can't make changes to code when mutations are not active.
403    if (!getMutationsActive())
404       return false;
405
406    assert(point.point);
407
408   /* PatchAPI stuffs */
409    AddressSpace* addr_space = point.getAS();
410    DynRemoveCallCommand* remove_call = DynRemoveCallCommand::create(addr_space,
411       point.point->block(), point.point->func());
412   addr_space->patcher()->add(remove_call);
413   /* End of PatchAPI */
414
415    if (pendingInsertions == NULL) {
416      // Trigger it now
417      bool tmp;
418      finalizeInsertionSet(false, &tmp);
419    }
420
421    return true;
422 }
423
424
425 /*
426  * BPatch_addressSpace::replaceFunction
427  *
428  * Replace all calls to function OLDFUNC with calls to NEWFUNC.
429  * Returns true upon success, false upon failure.
430  *
431  * oldFunc      The function to replace
432  * newFunc      The replacement function
433  */
434 bool BPatch_addressSpace::replaceFunctionInt(BPatch_function &oldFunc,
435       BPatch_function &newFunc)
436 {
437   assert(oldFunc.lowlevel_func() && newFunc.lowlevel_func());
438   if (!getMutationsActive())
439     return false;
440
441   // Self replacement is a nop
442   // We should just test direct equivalence here...
443   if (oldFunc.lowlevel_func() == newFunc.lowlevel_func()) {
444     return true;
445   }
446
447   /* PatchAPI stuffs */
448   AddressSpace* addr_space = oldFunc.lowlevel_func()->proc();
449   DynReplaceFuncCommand* rep_func = DynReplaceFuncCommand::create(addr_space,
450      oldFunc.lowlevel_func(), newFunc.lowlevel_func());
451   addr_space->patcher()->add(rep_func);
452   /* End of PatchAPI */
453
454   if (pendingInsertions == NULL) {
455     // Trigger it now
456     bool tmp;
457     finalizeInsertionSet(false, &tmp);
458   }
459   return true;
460 }
461
462 /*
463  * BPatch_addressSpace::revertReplaceFunction
464  *
465  * Undoes a replaceFunction operation
466  */
467 bool BPatch_addressSpace::revertReplaceFunctionInt(BPatch_function &oldFunc)
468 {
469   assert(oldFunc.lowlevel_func());
470   if (!getMutationsActive())
471     return false;
472
473   func_instance *func = oldFunc.lowlevel_func();
474
475   func->proc()->revertReplacedFunction(func);
476
477   if (pendingInsertions == NULL) {
478     // Trigger it now
479     bool tmp;
480     finalizeInsertionSet(false, &tmp);
481   }
482   return true;
483 }
484
485 bool BPatch_addressSpace::wrapFunctionInt(BPatch_function *original,
486                                           BPatch_function *wrapper,
487                                           Dyninst::SymtabAPI::Symbol *clone)
488 {
489    assert(original->lowlevel_func() && wrapper->lowlevel_func());
490    if (!getMutationsActive())
491       return false;
492
493    // Self replacement is a nop
494    // We should just test direct equivalence here...
495    if (original->lowlevel_func() == wrapper->lowlevel_func()) {
496       return true;
497    }
498
499    if (!original->lowlevel_func()->proc()->wrapFunction(original->lowlevel_func(), 
500                                                       wrapper->lowlevel_func(),
501                                                       clone))
502       return false;
503
504    if (pendingInsertions == NULL) {
505       // Trigger it now
506       bool tmp;
507       finalizeInsertionSet(false, &tmp);
508    }
509    return true;
510 }
511
512 bool BPatch_addressSpace::revertWrapFunctionInt(BPatch_function *original)
513 {
514    assert(original->lowlevel_func());
515
516    func_instance *func = original->lowlevel_func();
517    assert(func);
518
519    func->proc()->revertWrapFunction(func);
520    
521    if (pendingInsertions == NULL) {
522       // Trigger it now
523       bool tmp;
524       finalizeInsertionSet(false, &tmp);
525    }
526    return true;
527 }
528
529
530 bool BPatch_addressSpace::getAddressRangesInt( const char * fileName,
531       unsigned int lineNo,
532       std::vector< std::pair< unsigned long, unsigned long > > & ranges )
533 {
534    unsigned int originalSize = ranges.size();
535    BPatch_Vector< BPatch_module * > * modules = image->getModules();
536
537    /* Iteratate over the modules, looking for addr in each. */
538    for ( unsigned int i = 0; i < modules->size(); i++ ) {
539       BPatch_module *m = (*modules)[i];
540       m->getAddressRanges(fileName, lineNo, ranges);
541    }
542
543    if ( ranges.size() != originalSize ) { return true; }
544
545    return false;
546 } /* end getAddressRangesInt() */
547
548 bool BPatch_addressSpace::getSourceLinesInt( unsigned long addr,
549       BPatch_Vector< BPatch_statement > & lines )
550 {
551    return image->getSourceLinesInt(addr, lines);
552 } /* end getLineAndFile() */
553
554
555 /*
556  * BPatch_process::malloc
557  *
558  * Allocate memory in the thread's address space.
559  *
560  * n    The number of bytes to allocate.
561  *
562  * Returns:
563  *      A pointer to a BPatch_variableExpr representing the memory.
564  *
565  * If otherwise unspecified when binary rewriting, then the allocation
566  * happens in the original object.
567  */
568
569 BPatch_variableExpr *BPatch_addressSpace::mallocInt(int n, std::string name)
570 {
571    std::vector<AddressSpace *> as;
572    assert(BPatch::bpatch != NULL);
573    getAS(as);
574    assert(as.size());
575    void *ptr = (void *) as[0]->inferiorMalloc(n, dataHeap);
576    if (!ptr) return NULL;
577    if(name.empty()){
578       std::stringstream namestr;
579       namestr << "dyn_malloc_0x" << std::hex << ptr << "_" << n << "_bytes";
580       name = namestr.str();
581    }
582    BPatch_type *type = BPatch::bpatch->createScalar(name.c_str(), n);
583
584    return BPatch_variableExpr::makeVariableExpr(this, as[0], name, ptr,
585                                                 type);
586 }
587
588
589 /*
590  * BPatch_process::malloc
591  *
592  * Allocate memory in the thread's address space for a variable of the given
593  * type.
594  *
595  * type         The type of variable for which to allocate space.
596  *
597  * Returns:
598  *      A pointer to a BPatch_variableExpr representing the memory.
599  *
600  * XXX Should return NULL on failure, but the function which it calls,
601  *     inferiorMalloc, calls exit rather than returning an error, so this
602  *     is not currently possible.
603  */
604
605 BPatch_variableExpr *BPatch_addressSpace::mallocByType(const BPatch_type &type, std::string name)
606 {
607    std::vector<AddressSpace *> as;
608    assert(BPatch::bpatch != NULL);
609    getAS(as);
610    assert(as.size());
611    BPatch_type &t = const_cast<BPatch_type &>(type);
612    void *mem = (void *) as[0]->inferiorMalloc(t.getSize(), dataHeap);
613    if (!mem) return NULL;
614    if(name.empty()){
615       std::stringstream namestr;
616       namestr << "dyn_malloc_0x" << std::hex << mem << "_" << type.getName();
617       name = namestr.str();
618    }
619    BPatch_variableExpr *varExpr = BPatch_variableExpr::makeVariableExpr(this, as[0], name, mem, &t);
620    return varExpr;
621 }
622
623
624 /*
625  * BPatch_process::free
626  *
627  * Free memory that was allocated with BPatch_process::malloc.
628  *
629  * ptr          A BPatch_variableExpr representing the memory to free.
630  */
631
632 bool BPatch_addressSpace::freeInt(BPatch_variableExpr &ptr)
633 {
634   if(ptr.intvar)
635   {
636     // kill the symbols
637
638   }
639
640    ptr.getAS()->inferiorFree((Address)ptr.getBaseAddr());
641    return true;
642 }
643
644 BPatch_variableExpr *BPatch_addressSpace::createVariableInt(std::string name,
645                                                             Dyninst::Address addr,
646                                                             BPatch_type *type) {
647     assert(BPatch::bpatch != NULL);
648     std::vector<AddressSpace *> as;
649     getAS(as);
650     assert(as.size());
651
652 //dynC added feature
653     if(strstr(name.c_str(), "dynC") == name.c_str()){
654        void *mem = (void *) as[0]->inferiorMalloc(type->getSize(), dataHeap);
655        if (!mem) return NULL;
656        BPatch_variableExpr *varExpr = BPatch_variableExpr::makeVariableExpr(this, as[0], name, mem, type);
657        BPatch_module *mod = image->findOrCreateModule(varExpr->intvar->mod());
658        assert(mod);
659        mod->var_map[varExpr->intvar] = varExpr;
660        return varExpr;
661     }
662
663     BPatch_variableExpr *varExpr = BPatch_variableExpr::makeVariableExpr(this,
664                                                  as[0],
665                                                  name,
666                                                  (void *)addr,
667                                                  type);
668
669     return varExpr;
670 }
671
672 /*
673  * BPatch_addressSpace::findFunctionByAddr
674  *
675  * Returns the function that contains the specified address, or NULL if the
676  * address is not within a function.
677  *
678  * addr         The address to use for the lookup.
679  */
680 BPatch_function *BPatch_addressSpace::findFunctionByAddrInt(void *addr)
681 {
682    std::vector<AddressSpace *> as;
683
684    getAS(as);
685    assert(as.size());
686    std::set<func_instance *> funcs;
687    if (!as[0]->findFuncsByAddr((Address) addr, funcs)) {
688       // if it's a mapped_object that has yet to be analyzed,
689       // trigger analysis and re-invoke this function
690        mapped_object *obj = as[0]->findObject((Address) addr);
691        if (obj &&
692            !obj->isAnalyzed()) {
693          obj->analyze();
694          return findFunctionByAddrInt(addr);
695       }
696       return NULL;
697    }
698    if (funcs.empty()) return NULL;
699
700    if (funcs.size() > 1) {
701        bpwarn("Warning: deprecated function findFunctionByAddr found "
702               "multiple functions sharing address 0x%lx, picking one at "
703               "random.  Use findFunctionByEntry or findFunctionsByAddr\n",
704               addr);
705    }
706
707    return findOrCreateBPFunc((*(funcs.begin())), NULL);
708 }
709
710 /*
711  *  BPatch_addressSpace::findFunctionByEntry
712  *
713  *  Returns the function starting at the given address, or NULL if the
714  *  address is not within a function.
715  *
716  *  entry       The address to use for the lookup.
717  */
718 BPatch_function *BPatch_addressSpace::findFunctionByEntryInt(Address entry)
719 {
720     vector<BPatch_function*> funcs;
721     findFunctionsByAddr(entry, funcs);
722     vector<BPatch_function*>::iterator fit;
723     for (fit = funcs.begin(); fit != funcs.end(); fit++) {
724         if (entry == (Address)(*fit)->getBaseAddrInt()) {
725             return *fit;
726         }
727     }
728     return NULL;
729 }
730
731 bool BPatch_addressSpace::findFuncsByRange(Address startAddr,
732                                            Address endAddr,
733                                            std::set<BPatch_function*> &bpFuncs)
734 {
735     std::vector<AddressSpace *> as;
736     getAS(as);
737     assert(as.size());
738
739     // find the first code range in the region
740     mapped_object* mobj = as[0]->findObject(startAddr);
741     assert(mobj);
742     set<func_instance*> intFuncs;
743     mobj->findFuncsByRange(startAddr,endAddr,intFuncs);
744     set<func_instance*>::iterator fIter = intFuncs.begin();
745     for (; fIter != intFuncs.end(); fIter++) {
746         BPatch_function * bpfunc = findOrCreateBPFunc(*fIter,NULL);
747         bpFuncs.insert(bpfunc);
748     }
749     return 0 != bpFuncs.size();
750 }
751
752
753 /*
754  * BPatch_addressSpace::findFunctionsByAddr
755  *
756  * Returns the functions that contain the specified address, or NULL if the
757  * address is not within a function. (there could be multiple functions
758  * because of the possibility of shared code)
759  *
760  * addr         The address to use for the lookup.
761  * returns false if there were no functions that matched the address
762  */
763 bool BPatch_addressSpace::findFunctionsByAddrInt
764     (Address addr, std::vector<BPatch_function*> &funcs)
765 {
766     std::vector<AddressSpace *> as;
767     getAS(as);
768     assert(as.size());
769
770     // grab the funcs, return false if there aren't any
771     std::set<func_instance*> intfuncs;
772     if (!as[0]->findFuncsByAddr( addr, intfuncs )) {
773         return false;
774     }
775     // convert to BPatch_functions
776     for (std::set<func_instance *>::iterator fiter=intfuncs.begin();
777          fiter != intfuncs.end(); fiter++)
778     {
779         funcs.push_back(findOrCreateBPFunc(*fiter, NULL));
780     }
781     return 0 < funcs.size();
782 }
783
784
785 /*
786  * BPatch_addressSpace::findModuleByAddr
787  *
788  * Returns the module that contains the specified address, or NULL if the
789  * address is not within a module.  Does NOT trigger parsing
790  *
791  * addr         The address to use for the lookup.
792  */
793 BPatch_module *BPatch_addressSpace::findModuleByAddr(Address addr)
794 {
795    std::vector<AddressSpace *> as;
796    getAS(as);
797    assert(as.size());
798
799    mapped_object *obj = as[0]->findObject(addr);
800    if ( ! obj )
801        return NULL;
802
803    const pdvector<mapped_module*> mods = obj->getModules();
804    if (mods.size()) {
805        return getImage()->findOrCreateModule(mods[0]);
806    }
807    return NULL;
808 }
809
810
811 /*
812  * BPatch_addressSpace::insertSnippet
813  *
814  * Insert a code snippet at a given instrumentation point.  Upon success,
815  * returns a handle to the created instance of the snippet, which can be used
816  * to delete it.  Otherwise returns NULL.
817  *
818  * expr         The snippet to insert.
819  * point        The point at which to insert it.
820  */
821
822 BPatchSnippetHandle *BPatch_addressSpace::insertSnippetInt(const BPatch_snippet &expr,
823       BPatch_point &point,
824       BPatch_snippetOrder order)
825 {
826    BPatch_callWhen when;
827    if (point.getPointType() == BPatch_exit)
828       when = BPatch_callAfter;
829    else
830       when = BPatch_callBefore;
831
832    return insertSnippetWhen(expr, point, when, order);
833 }
834
835 /*
836  * BPatch_addressSpace::insertSnippet
837  *
838  * Insert a code snippet at a given instrumentation point.  Upon succes,
839  * returns a handle to the created instance of the snippet, which can be used
840  * to delete it.  Otherwise returns NULL.
841  *
842  * expr         The snippet to insert.
843  * point        The point at which to insert it.
844  */
845
846 // This handles conversion without requiring inst.h in a header file...
847 extern bool BPatchToInternalArgs(BPatch_point *point,
848       BPatch_callWhen when,
849       BPatch_snippetOrder order,
850       callWhen &ipWhen,
851       callOrder &ipOrder);
852
853
854 BPatchSnippetHandle *BPatch_addressSpace::insertSnippetWhen(const BPatch_snippet &expr,
855       BPatch_point &point,
856       BPatch_callWhen when,
857       BPatch_snippetOrder order)
858 {
859    BPatch_Vector<BPatch_point *> points;
860    points.push_back(&point);
861    return insertSnippetAtPointsWhen(expr,
862          points,
863          when,
864          order);
865 }
866
867 extern int dyn_debug_ast;
868
869 /*
870  * BPatch_addressSpace::insertSnippet
871  *
872  * Insert a code snippet at each of a list of instrumentation points.  Upon
873  * success, Returns a handle to the created instances of the snippet, which
874  * can be used to delete them (as a unit).  Otherwise returns NULL.
875  *
876  * expr         The snippet to insert.
877  * points       The list of points at which to insert it.
878  */
879
880 // A lot duplicated from the single-point version. This is unfortunate.
881 BPatchSnippetHandle *BPatch_addressSpace::insertSnippetAtPointsWhen(const BPatch_snippet &expr,
882                                                                     const BPatch_Vector<BPatch_point *> &points,
883                                                                     BPatch_callWhen when,
884                                                                     BPatch_snippetOrder order)
885 {
886   BPatchSnippetHandle *retHandle = new BPatchSnippetHandle(this);
887
888   if (dyn_debug_inst) {
889       BPatch_function *f;
890       for (unsigned i=0; i<points.size(); i++) {
891          f = points[i]->getFunction();
892          const char *sname = f->func->prettyName().c_str();
893          inst_printf("[%s:%u] - %d. Insert instrumentation at function %s, "
894                "address %p, when %d, order %d\n",
895                FILE__, __LINE__, i,
896                sname, points[i]->getAddress(), (int) when, (int) order);
897
898       }
899   }
900
901   if (BPatch::bpatch->isTypeChecked()) {
902       if (expr.ast_wrapper->checkType() == BPatch::bpatch->type_Error) {
903         fprintf(stderr, "[%s:%u] - Type error inserting instrumentation\n",
904                 FILE__, __LINE__);
905          expr.ast_wrapper->debugPrint();
906          return false;
907       }
908    }
909
910    if (!points.size()) {
911      fprintf(stderr, "%s[%d]:  request to insert snippet at zero points!\n", FILE__, __LINE__);
912       return false;
913    }
914
915    for (unsigned i = 0; i < points.size(); i++) {
916       BPatch_point *bppoint = points[i];
917
918       if (bppoint->addSpace == NULL) {
919          fprintf(stderr, "Error: attempt to use point with no process info\n");
920          continue;
921       }
922
923       if (dynamic_cast<BPatch_addressSpace *>(bppoint->addSpace) != this) {
924          fprintf(stderr, "Error: attempt to use point specific to a different process\n");
925          continue;
926       }
927
928       callWhen ipWhen;
929       callOrder ipOrder;
930
931       if (!BPatchToInternalArgs(bppoint, when, order, ipWhen, ipOrder)) {
932         fprintf(stderr, "[%s:%u] - BPatchToInternalArgs failed for point %d\n",
933                FILE__, __LINE__, i);
934          return retHandle;
935       }
936
937       /* PatchAPI stuffs */
938       instPoint *ipoint = static_cast<instPoint *>(bppoint->getPoint(when));
939       Dyninst::PatchAPI::InstancePtr instance = (ipOrder == orderFirstAtPoint) ?
940          ipoint->pushFront(expr.ast_wrapper) :
941          ipoint->pushBack(expr.ast_wrapper);
942       /* End of PatchAPI stuffs */
943       if (instance) {
944          if (BPatch::bpatch->isTrampRecursive()) {
945             instance->disableRecursiveGuard();
946          }
947          retHandle->addInstance(instance);
948          bppoint->recordSnippet(when, order, retHandle);
949       }
950    }
951    if (pendingInsertions == NULL) {
952      // There's no insertion set, instrument now
953      bool tmp;
954      finalizeInsertionSet(false, &tmp);
955    }   
956
957    return retHandle;
958 }
959
960
961 /*
962  * BPatch_addressSpace::insertSnippet
963  *
964  * Insert a code snippet at each of a list of instrumentation points.  Upon
965  * success, Returns a handle to the created instances of the snippet, which
966  * can be used to delete them (as a unit).  Otherwise returns NULL.
967  *
968  * expr         The snippet to insert.
969  * points       The list of points at which to insert it.
970  */
971
972 BPatchSnippetHandle *BPatch_addressSpace::insertSnippetAtPoints(
973       const BPatch_snippet &expr,
974       const BPatch_Vector<BPatch_point *> &points,
975       BPatch_snippetOrder order)
976 {
977    return insertSnippetAtPointsWhen(expr,
978          points,
979          BPatch_callUnset,
980          order);
981 }
982
983 /*
984  * BPatch_addressSpace::isStaticExecutable
985  *
986  * Returns true if the underlying image represents a statically-linked executable, false otherwise.
987  */
988 bool BPatch_addressSpace::isStaticExecutableInt() {
989    std::vector<AddressSpace *> as;
990    getAS(as);
991
992    if( !as.size() ) return false;
993
994    AddressSpace *aout = as[0];
995    return aout->getAOut()->isStaticExec();
996 }
997
998 #include "registerSpace.h"
999
1000 #if defined(cap_registers)
1001 bool BPatch_addressSpace::getRegistersInt(std::vector<BPatch_register> &regs) {
1002    if (registers_.size()) {
1003        regs = registers_;
1004        return true;
1005    }
1006
1007    std::vector<AddressSpace *> as;
1008
1009    getAS(as);
1010    assert(as.size());
1011
1012    registerSpace *rs = registerSpace::getRegisterSpace(as[0]);
1013
1014    for (unsigned i = 0; i < rs->realRegs().size(); i++) {
1015        // Let's do just GPRs for now
1016        registerSlot *regslot = rs->realRegs()[i];
1017        registers_.push_back(BPatch_register(regslot->name, regslot->number));
1018    }
1019    regs = registers_;
1020    return true;
1021 }
1022 #else
1023 bool BPatch_addressSpace::getRegistersInt(std::vector<BPatch_register> &) {
1024     // Empty vector since we're not supporting register objects on
1025     // these platforms (yet)
1026    return false;
1027 }
1028 #endif
1029
1030 #if defined(cap_registers)
1031 bool BPatch_addressSpace::createRegister_NPInt(std::string regName,
1032                                                BPatch_register &reg) {
1033     // Build the register list.
1034     std::vector<BPatch_register> dontcare;
1035     getRegisters(dontcare);
1036
1037     for (unsigned i = 0; i < registers_.size(); i++) {
1038         if (registers_[i].name() == regName) {
1039             reg = registers_[i];
1040             return true;
1041         }
1042     }
1043     return false;
1044 }
1045 #else
1046 bool BPatch_addressSpace::createRegister_NPInt(std::string,
1047                                                BPatch_register &)
1048 {
1049    return false;
1050 }
1051 #endif
1052
1053 BPatch_module *BPatch_addressSpace::loadLibraryInt(const char * /*libname*/, bool /*reload*/)
1054 {
1055         return NULL;
1056 }
1057
1058 void BPatch_addressSpace::allowTrapsInt(bool allowtraps)
1059 {
1060    std::vector<AddressSpace *> as;
1061    getAS(as);
1062
1063    for (std::vector<AddressSpace *>::iterator i = as.begin(); i != as.end(); i++)
1064    {
1065       (*i)->setUseTraps(allowtraps);
1066    }
1067 }
1068
1069 BPatch_variableExpr *BPatch_addressSpace::createVariableInt(
1070                         Dyninst::Address at_addr,
1071                         BPatch_type *type, std::string var_name,
1072                         BPatch_module *in_module)
1073 {
1074    BPatch_binaryEdit *binEdit = dynamic_cast<BPatch_binaryEdit *>(this);
1075    if (binEdit && !in_module) {
1076       //Address alone isn't unique when binary rewriting
1077       return NULL;
1078    }
1079    if (!type) {
1080       //Required for size information.
1081       return NULL;
1082    }
1083    AddressSpace *ll_addressSpace = NULL;
1084
1085    std::vector<AddressSpace *> as;
1086    getAS(as);
1087    if (binEdit) {
1088       std::vector<AddressSpace *>::iterator as_i;
1089       for (as_i = as.begin(); as_i != as.end(); as_i++)
1090       {
1091          BinaryEdit *b = dynamic_cast<BinaryEdit *>(*as_i);
1092          assert(b);
1093          if (in_module->mod->obj() == b->getMappedObject()) {
1094             ll_addressSpace = *as_i;
1095             break;
1096          }
1097       }
1098    }
1099    else {
1100       assert(as.size() == 1);
1101       ll_addressSpace = as[0];
1102    }
1103
1104    if (!ll_addressSpace) {
1105       //in_module doesn't belong to 'this'
1106       return NULL;
1107    }
1108
1109    if (!var_name.size()) {
1110       std::stringstream namestream;
1111       namestream << "dyninst_var_" << std::hex << at_addr;
1112       var_name = namestream.str();
1113    }
1114
1115    return BPatch_variableExpr::makeVariableExpr(this, ll_addressSpace, var_name,
1116                                                 (void *) at_addr, type);
1117 }
1118
1119 Dyninst::PatchAPI::PatchMgrPtr Dyninst::PatchAPI::convert(const BPatch_addressSpace *a) {
1120    const BPatch_binaryEdit *edit = dynamic_cast<const BPatch_binaryEdit *>(a);
1121    if (edit) {
1122       return edit->lowlevel_edit()->mgr();
1123    }
1124    else {
1125       const BPatch_process *proc = dynamic_cast<const BPatch_process *>(a);
1126       return proc->lowlevel_process()->mgr();
1127    }
1128 }
1129