[llvm-commits] CVS: reopt/lib/README

[Brian Gaeke]

Changes in directory reopt/lib:

README updated: 1.8 -> 1.9
---
Log message:

Updates based on changes in the last 6mos.


---
Diffs of the changes:  (+32 -36)

Index: reopt/lib/README
diff -u reopt/lib/README:1.8 reopt/lib/README:1.9
--- reopt/lib/README:1.8	Thu Jul  8 01:25:19 2004
+++ reopt/lib/README	Sun Dec  5 20:20:12 2004
@@ -15,42 +15,31 @@
 directories, ScratchMemory, LightWtProfiling, and Mapping
 subdirectories.
 
-Inst
- - Joel Stanley's project.
- - The mkexcl tool that used to be here was moved to reopt/tools/mkexcl.
- - Portability notes:
-   Inst/lib/ElfReader - Depends on libelf from Solaris.
-   Inst/lib/InstManip - Unportable assumptions about pointer sizes.
-   Inst/lib/SparcInstManip - Unportable assumptions about pointer sizes.
-   Inst/lib/Phases - Uses getexecname(), presumably from Solaris.
-
-Optimizations (formerly named SSAPRE)
- - Contains a project by Tanya Brethour that does loop invariant
-   code motion for traces.
-
-Trigger
- - Anand's OLD reoptimizer.
- - Uses the Ball & Larus path profiling implementation (I think?).
 
 Mapping
- - Functions to query the mapping between LLVM Instructions and MachineInstrs
-   which can be generated by opt and output as part of the SPARC
-   assembly by LLC. 
+ - Functions to query the mapping between LLVM (Functions,BasicBlocks) and
+   (MachineFunctions,MachineBasicBlocks) which can be output as part of
+   the SPARC assembly by LLC.
  - Here is a list of the exported functions and the users of each function:
+  - getLLVMinfo.cpp:
    - unsigned getLLVMFunctionPositionInfo (Function *F) 
      - Used by LightWtProfiling/UnpackTraceFunction only
-   - std::vector<unsigned> getLLVMInstrPositionInfo (Instruction *LI)
-     - Used by Trigger/TriggerAuxiliary and BinInterface/LLVMTrace 
    - std::pair<uint64_t, uint64_t> getBasicBlockInfo(BasicBlock *BB)
-     - Used by BinInterface/LLVMTrace, LightWtProfiling/SLI,
-       LightWtProfiling/UnpackTraceFunction, Trigger/Trigger, and
-       Trigger/TriggerAuxillary
+     - Used by LightWtProfiling/SLI and LightWtProfiling/UnpackTraceFunction
    - bool getReverseBBMap(uint64_t addr, Module *M, BasicBlock* &bb)
      - Used by LightWtProfiling/SLI, and LightWtProfiling/SecondTrigger
    - bool isInlinable (Function *F) 
      - Used by LightWtProfiling/SLI, and LightWtProfiling/SecondTrigger
    - Function *getRevFunction(Module *M, uint64_t addr)
      - Used by LightWtProfiling/SLI, and LightWtProfiling/SecondTrigger
+  - ValueAllocState.cpp:
+   - AllocInfo GetTraceFnValueAllocState (TraceFunction *TF, Value *V,
+                                          bool preferLiveIn)
+   - AllocInfo GetMatrixFnValueAllocState (TraceFunction *TF, Value *V,
+                                           bool preferLiveIn)
+   - std::pair<AllocInfo, AllocInfo> GetValueAllocState (TraceFunction *TF,
+                                               Value *V, bool preferLiveIn)
+     - These three functions are only used by UnpackTraceFunction.
 
 LightWtProfiling
  - Anand's redesigned tracing framework. Uses first-level and second-level
@@ -68,9 +57,9 @@
    - Uses SPARC inline assembly.
 
 TraceCache
- - Manages traces for the reoptimizers.
+ - Manages traces for the reoptimizer.
  - Classes TraceCache, VirtualMem, MemoryManager.
- - Used by: Trigger, LightWtProfiling, Inst/lib, BinInterface
+ - Used by: LightWtProfiling, Inst/lib
 
 ScratchMemory
  - Contains two functions containing nothing but empty text-segment space.
@@ -78,15 +67,6 @@
    the trace cache.
  - Used by: LightWtProfiling, TraceCache/MemoryManager.cpp
 
-BinInterface
- - Analyze SPARC instructions, construct pseudo-SSA form, and manipulate
-   traces. Also includes a SPARC disassembler. Primarily done by
-   Cameron Buschardt.
- - Used by: Trigger, Optimizations/RuntimeLICM.cpp (only LLVMTrace),
-   Inst/lib/SparcInstManip.{cpp,h}
- - Portability notes: Supports SPARC binaries only. Should compile &
-   link fine on X86.
-
 TraceIO
  - Trace reading/writing library.
  - Requires bcreader, bcwriter libraries.
@@ -102,5 +82,21 @@
  - Pass written by Brian which turns Trace objects into Functions.
  - Test program in tools/ttftest.
 
-Last updated $Date: 2004/07/08 06:25:19 $
+WholeReoptimizer
+ - Used to make an archive containing the entire Reoptimizer runtime library
+   (~14MB in a Release build; ~160MB in a Debug build).
+
+Inst
+ - Joel Stanley's project - this does not, strictly speaking, pertain to
+   the Reoptimizer.
+ - The pieces of BinInterface which are still used have been integrated
+   into this directory.
+ - The mkexcl tool that used to be here was moved to reopt/tools/mkexcl.
+ - Portability notes:
+   Inst/lib/ElfReader - Depends on libelf from Solaris.
+   Inst/lib/InstManip - Unportable assumptions about pointer sizes.
+   Inst/lib/SparcInstManip - Unportable assumptions about pointer sizes.
+   Inst/lib/Phases - Uses getexecname(), presumably from Solaris.
+
+Last updated $Date: 2004/12/06 02:20:12 $