mirrors/reverie
1
0
Fork 0
mirror of https://github.com/facebookexperimental/reverie.git synced 2024-12-01 04:14:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
reverie/reverie-examples
History
Vladimir Makaev 03cbd6044d update hermetic_infra/** files with correct license header - 1/x 
Summary:
Followed guide here https://www.internalfb.com/intern/wiki/Linting/License_Lint/ to add fbcode/hermetic_infra/** code to license linter. As we have parts of our code shipped as Open Source it's important to get this automated

This diff is updating existing file's licenses to not get conflict after lint rule enablement

Reviewed By: jasonwhite

Differential Revision: D40674080

fbshipit-source-id: da6ecac036f8964619cf7912058f3a911558e7b1
2022-10-26 12:18:14 -07:00
..
chrome-trace update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
strace update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
Cargo.toml bump tokio version to 1.21.2 2022-10-14 15:24:20 -07:00
chaos.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
chunky_print.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
counter1.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
counter2.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
debug.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
noop.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
pedigree.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00
README.md Initial commit 2021-12-29 16:14:27 -08:00
strace_minimal.rs update hermetic_infra/** files with correct license header - 1/x 2022-10-26 12:18:14 -07:00

README.md

Examples

Example tools built on top of Reverie.

Copying one of these examples is the recommended way to get started using Reverie.

chrome-trace: Generates a chrome trace file

This tool is like strace, but generates a trace file that can be loaded in chrome://tracing/.

counter1: Reverie Counter Tool (1)

This is a basic example of event counting. It counts the number of system calls and reports that single integer at exit.

This version of tool uses a single, centralized piece of global state.

counter2: Reverie Counter Tool (2)

This is a basic example of event counting. This tool counts the number of system calls and reports that single integer at exit.

This implementation of the tool uses a distributed notion of state, maintaining a per-thread, per-process, and global state. Basically, this is an example of "MapReduce" style tracing of a process tree.

noop: Identity Function Tool

This instrumentation tool intercepts events but does nothing with them. It is useful for observing the overhead of interception, and as a starting point.

chunky_print: Print-gating Tool

This example tool intercepts write events on stdout and stderr and manipulates either when those outputs are released, or the scheduling order that determines the order of printed output.

pedigree: Deterministic virtual process IDs

This tool monitors the spawning of new processes and maps each new PID to a deterministic virtual PID. The new virtual PID is reported after each process-spawning syscall.

This tool is a work-in-progress and is not yet functioning.

pedigree.rs is an implementation of pedigree / virtual PID generation using local state. virtual_process_tree.rs is an implementation which uses global state.

strace: Reverie Echo Tool

This instrumentation tool simply echos intercepted events, like strace.

chaos: Chaos Tool

This tool is meant to emulate a pathological kernel where:

  1. read and recvfrom calls return only one byte at a time. This is intended to catch errors in parsers that assume multiple bytes will be returned at a time.
  2. EINTR is returned instead of running the real syscall for every other read.