rr(1) record and replay application execution

SYNOPSIS

rr dump [<options>] [<trace-dir>] [<event-specs>]
rr gdbinit
rr help [<command>]
rr ps [<trace-dir>]
rr record [<options>] <executable> [<exe-args>]
rr replay [<options>] [<trace-dir>]

DESCRIPTION

Common options

-A <name>, --microarch=<name>
force rr to assume it's running on a CPU with microarch name even if runtime detection says otherwise. name should be a string like `Ivy Bridge'.
-C {on-syscalls,on-all-events,<from-time>}, --checksum={on-syscalls,on-all-events,<from-time>}
compute and store (during recording) or read and verify (during replay) checksums of each of a tracee's memory mappings either at the end of all syscalls (on-syscalls), at all events (on-all-events), or starting from a global timepoint from-time.
-D {<syscall-num,-<signal-num>}, --dump-on={<syscall-num,-<signal-num>}
dump memory at syscall or signal to the file tid.time_{rec,rep} in trace-dir; _rec for dumps during recording, _rep for dumps during replay.
-F, --force-things
force rr to do some things that don't seem like good ideas, such as launching an interactive emergency debugger if stderr isn't a tty.
-K, --check-cached-mmaps
verify that cached task mmaps match /proc/maps.
-E, --fatal-errors
any warning or error that is printed is treated as fatal.
-M, --mark-stdio
mark stdio writes with [rr <pid> <ev>] where ev is the global trace time at which the write occurs and pid is the pid of the process it occurs in.
-N, --version
print the version number and exit.
-S, --suppress-environment-warnings
suppress warnings about issues in the environment that rr has no control over.
-T <time>, --dump-at=<time>
dump memory at global timepoint time
-V, --verbose
log messages that may not be urgently critical to the user
-W <num-secs>, --wait-secs=<num-secs>
wait num-secs seconds just after startup, before initiating recording or replaying.

Syntax for `record'

rr record [<options>] <executable> [<exe-args>]
-b, --force-syscall-buffer
force the systall buffer preload library to be used, even if that's probably a bad idea
-c <num>, --num-cpu-ticks=<num>
maximum number of `CPU ticks' (currently retired conditional branches) to allow a task to run before interrupting it
-e <num>, --num-events=<num>
maximum number of events (syscall enter/exit, signal, CPU interrupt, ...) to allow a task before descheduling it
-i <signal>, --ignore-signal=<signal>
block signal from being delivered to tracees; probably only useful for unit tests
-n, --no-syscall-buffer
disable the syscall buffer preload library even if it would otherwise be used
-u, --cpu-unbound
allow tracees to run on any virtual CPU (default is to bind to CPU 0); this option can cause replay divergence: use with caution
-v <name>=<value>, --env=<name>=<value>
value to add to the environment of the tracee; there can be any number of these

Syntax for `replay'

rr replay [<options>] [<trace-dir>]
-a, --autopilot
replay without debug server
-d <command>, --debugger=<command>
use command as the gdb(1) command
-f <pid>, --onfork=<pid>
start a debug server when pid has been forked, and the target event has been reached
-g <event-num>, --goto=<event-num>
start a debug server on reaching event-num in the trace; see -M in the general options
-p {<pid>,<command>}, --onprocess={<pid>,<command>}
start a debug server when pid or command has been exec'd, and the target event has been reached
-q, --no-redirect-output
don't replay writes to stdout/stderr
-s <port>, --dbgport=<port>
only start a debug server on port; don't automatically launch the debugger client too
-t <event>, --trace=<event>
singlestep instructions and dump register states when replaying towards event or later
-x <file>, --gdb-x=<file>
execute gdb(1) commands from file

Syntax for `dump`

rr dump [<options>] [<trace-dir>] [<event-specs>]

Event specs can be either an event number like `127', or a range like `1000-5000'. By default, all events are dumped.

-b, --syscallbuf
dump syscallbuf contents
-m, --recorded-metadata
dump recorded metadata
-p, --mmaps
dump mmap data
-r, --raw
dump trace frames in a more easily machine-parseable format instead of the default human-readable format
-s, --statistics
dump statistics about the trace

AUTHORS

rr was written by Robert O'Callahan, Chris Jones, Nathan Froyd and others.

This manual page was adapted from the help output by Stephen Kitt <[email protected]>, for the Debian GNU/Linux system (but may be used by others). It was last modified for rr version 4.0.1.