radare2/man/r2r.1

79 lines
1.7 KiB
Groff

.Dd Mar 17, 2024
.Dt R2R 1
.Sh NAME
.Nm r2r
.Nd radare2 regression testsuite
.Sh SYNOPSIS
.Nm r2r
.Op Fl h
.Op Fl H
.Op Fl i
.Op Fl n
.Op Fl L
.Op Fl q
.Op Fl v
.Op Fl V
.Op Fl j Ar threads
.Op Fl f Ar bin-for-json-tests
.Op Fl F Ar fuzzbindir
.Op Fl C Ar chdir
.Op Fl o Ar file
.Op Fl s Ar ignore
.Op Fl t Ar seconds
.Op [test-(dir|file) ...]
.Sh DESCRIPTION
Run all the radare2 regression tests matching a specific word in the name.
.Pp
You need radare2 to be available in $PATH.
.Sh OPTIONS
.Bl -tag -width Fl
.It Fl h
Show the help/usage message
.It Fl H
Display the list of environment variables and their default values
.It Fl i
Interactive mode
.It Fl n
Do not run any test, just load/parse them
.It Fl L
Log mode (better printing for CI, logfiles, etc.)
.It Fl q
Quiet mode (use like this: r2r -qv)
.It Fl v
Show version number
.It Fl V
Be verbose
.It Fl j Ar threads
Specify the number of tasks to run in parallel
.It Fl n
Do not run any test, just parse them for linting purposes
.It Fl f Ar bin-for-json-tests
Load the given binary when running the JSON tests
.It Fl C Ar directory
Early chdir before running any test
.It Fl F Ar directory
Specify the path where the fuzzed binaries are
.It Fl o Ar file
Output test run information in JSON format to file
.It Fl s Ar test
Set R2R_SKIP_(TEST)=1 to skip running that test type
.It Fl t Ar seconds
Timeout per test (default is (30*60))
.El
.Sh USAGE
.Pp
Use the -n flag to not run any test. Just load them.
.Pp
$ r2r -n
[r2r] Loading tests...
.Pp
Run the tests contained in a directory interactively, if any of those tests fail to run, prompt the user to autofix, edit the commands, etc.
.Pp
$ r2r -i test/db/cmd/cmd_pdf
.Sh SEE ALSO
.Pp
.Xr radare2(1)
.Sh AUTHORS
.Pp
Written by pancake <pancake@nopcode.org>.