Add dyninstAPI/Movement-adhoc.h

dyninst · Apr 3, 2024 · d3d617e · d3d617e
1 parent c716557
commit d3d617e
Show file tree

Hide file tree

Showing 2 changed files with 29 additions and 2 deletions.
diff --git a/docs/dyninstAPI/developer/Relocation/Transformers/Movement-adhoc.h.rst b/docs/dyninstAPI/developer/Relocation/Transformers/Movement-adhoc.h.rst
@@ -4,3 +4,31 @@ Movement-adhoc.h
 ################
 
 .. cpp:namespace:: Dyninst::Relocation
+
+.. cpp:class:: adhocMovementTransformer : public Transformer
+
+  Identify PC-relative memory accesses and replace them with a dedicated Widget
+
+  .. cpp:type:: private boost::shared_ptr<RelocInsn> RelocInsnPtr
+  .. cpp:type:: private boost::shared_ptr<InstructionAPI::Instruction> InsnPtr
+
+  .. cpp:function:: virtual bool process(RelocBlock *, RelocGraph *)
+  .. cpp:function:: adhocMovementTransformer(AddressSpace *as)
+  .. cpp:function:: virtual ~adhocMovementTransformer()
+  .. cpp:function:: private bool isPCDerefCF(WidgetPtr ptr, InstructionAPI::Instruction insn, Address &destPtr)
+  .. cpp:function:: private bool isPCRelData(WidgetPtr ptr, InstructionAPI::Instruction insn, Address &target)
+  .. cpp:function:: private bool isGetPC(WidgetPtr ptr, InstructionAPI::Instruction insn, Absloc &aloc, Address &thunkAddr)
+
+    Records where PC was stored
+
+  .. cpp:function:: private bool isStackFrameSensitive(Offset& origOffset, signed long& delta,\
+                                                       const Accesses* accesses, OffsetVector*& offVec,\
+                                                       TMap*& tMap, ParseAPI::Block* block, Address addr)
+  .. cpp:member:: private AddressSpace *addrSpace
+
+    Used for finding call targets
+
+  .. cpp:member:: private std::map<Address, std::pair<Offset, signed long> > definitionDeltas
+
+    Map of definition addresses to (origDisp, delta) pairs
+
diff --git a/dyninstAPI/src/Relocation/Transformers/Movement-adhoc.h b/dyninstAPI/src/Relocation/Transformers/Movement-adhoc.h
@@ -48,8 +48,7 @@ namespace Dyninst {
 
 namespace Relocation {
 class RelocInsn;
-// Identify PC-relative memory accesses and replace
-// them with a dedicated Widget
+
 class adhocMovementTransformer : public Transformer {
   typedef boost::shared_ptr<RelocInsn> RelocInsnPtr;
   typedef boost::shared_ptr<InstructionAPI::Instruction> InsnPtr;