i#7832: Add random layout drmemtrace scheduler feature (#7833)

Adds a new drmemtrace scheduler option and command-line flag to use a
random assignment of inputs to outputs instead of the default round
robin, to provide more variety in scheduling.

Adds a unit test of the option. The command-line flag was tested
manually (it is not easy to make automated tests of randomness).

Run round-robin default:

```
$ bin64/drrun -t drmemtrace -indir ../src/clients/drcachesim/tests/drmemtrace.threadsig.x64.tracedir -cores 6 -tool schedule_stats
Core #0 schedule: CB_____CB______
Core #1 schedule: DF_____D_F_D_F
Core #2 schedule: EA__A_A__A_A_E_A______
Core #3 schedule: G____________________________________
Core #4 schedule: H__H______________________________
Core #5 schedule: I_____________________________________
```

Now run twice with a clock seed, showing the varying layout each time:
```
$ bin64/drrun -t drmemtrace -indir ../src/clients/drcachesim/tests/drmemtrace.threadsig.x64.tracedir -cores 6 -tool schedule_stats -sched_random_initial_layout 0
Core #0 schedule: A__A_A__A_A__A______________
Core #1 schedule: CB_____CB
Core #2 schedule: HI__H__________________________
Core #3 schedule: E_____E______________
Core #4 schedule: GF_____F__F_________
Core #5 schedule: D_____D_D_______________
$ bin64/drrun -t drmemtrace -indir ../src/clients/drcachesim/tests/drmemtrace.threadsig.x64.tracedir -cores 6 -tool schedule_stats -sched_random_initial_layout 0
Core #0 schedule: C_____C_____________________
Core #1 schedule: H__H________________________________
Core #2 schedule: A__A_A__A_A__A__________________
Core #3 schedule: EI_____E____________________
Core #4 schedule: DF_____D_F_D_F
Core #5 schedule: GB_____B________________________
```

Now run twice with the same seed, showing repeatable randomness (though
we have record-replay for repeating the entire scheme, there can be
times where we want to fix a particular random outcome while varying
other unrelated parameters, so it is useful to be able to set the seed):
```
$ bin64/drrun -t drmemtrace -indir ../src/clients/drcachesim/tests/drmemtrace.threadsig.x64.tracedir -cores 6 -tool schedule_stats -sched_random_initial_layout 1
Core #0 schedule: DE_____D_E_D
Core #1 schedule: CG_____C________________
Core #2 schedule: HF__H____F__F______
Core #3 schedule: A__A_A__A_A__A______________
Core #4 schedule: I______________________________
Core #5 schedule: B_____B__________________
$ bin64/drrun -t drmemtrace -indir ../src/clients/drcachesim/tests/drmemtrace.threadsig.x64.tracedir -cores 6 -tool schedule_stats -sched_random_initial_layout 1
Core #0 schedule: DE_____D_E_D
Core #1 schedule: CG_____C_______________
Core #2 schedule: HF__H____F__F________
Core #3 schedule: A__A_A__A_A__A______________
Core #4 schedule: I______________________________
Core #5 schedule: B_____B__________________
```

Fixes #7832
7 files changed
tree: 439a7f4d83a34c786f55eedeffe1d9560ac6277e
  1. .github/
  2. api/
  3. clients/
  4. core/
  5. ext/
  6. libutil/
  7. make/
  8. suite/
  9. third_party/
  10. tools/
  11. .clang-format
  12. .gitignore
  13. .gitmodules
  14. ACKNOWLEDGEMENTS
  15. CMakeLists.txt
  16. CONTRIBUTING.md
  17. CTestConfig.cmake
  18. License.txt
  19. README
  20. README.md
README.md

DynamoRIO

DynamoRIO logo

About DynamoRIO

DynamoRIO is a runtime code manipulation system that supports code transformations on any part of a program, while it executes. DynamoRIO exports an interface for building dynamic tools for a wide variety of uses: program analysis and understanding, profiling, instrumentation, optimization, translation, etc. Unlike many dynamic tool systems, DynamoRIO is not limited to insertion of callouts/trampolines and allows arbitrary modifications to application instructions via a powerful IA-32/AMD64/ARM/AArch64 instruction manipulation library. DynamoRIO provides efficient, transparent, and comprehensive manipulation of unmodified applications running on stock operating systems (Windows, Linux, or Android) and commodity IA-32, AMD64, ARM, and AArch64 hardware. Mac OSX support is in progress.

Existing DynamoRIO-based tools

DynamoRIO is the basis for some well-known external tools:

Tools built on DynamoRIO and available in the release package include:

  • The memory debugging tool Dr. Memory
  • The tracing and analysis framework drmemtrace with multiple tools that operate on both online (with multi-process support) and offline instruction and memory address traces:
  • The legacy processor emulator drcpusim
  • The “strace for Windows” tool drstrace
  • The code coverage tool drcov
  • The library tracing tool drltrace
  • The memory address tracing tool memtrace (drmemtrace's offline traces are faster with more surrounding infrastructure, but this is a simpler starting point for customized memory address tracing)
  • The memory value tracing tool memval
  • The instruction tracing tool instrace (drmemtrace's offline traces are faster with more surrounding infrastructure, but this is a simpler starting point for customized instruction tracing)
  • The basic block tracing tool bbbuf
  • The instruction counting tool inscount
  • The dynamic fuzz testing tool Dr. Fuzz
  • The disassembly tool drdisas
  • And more, including opcode counts, branch instrumentation, etc.: see API samples

Building your own custom tools

DynamoRIO‘s powerful API abstracts away the details of the underlying infrastructure and allows the tool builder to concentrate on analyzing or modifying the application’s runtime code stream. API documentation is included in the release package and can also be browsed online. Slides from our past tutorials are also available.

Downloading DynamoRIO

DynamoRIO is available free of charge as a binary package for both Windows and Linux. DynamoRIO's source code is available primarily under a BSD license.

Obtaining Help

Use the discussion list to ask questions.

To report a bug, use the issue tracker.

See also the DynamoRIO home page: http://dynamorio.org/