blob: c0d2bb1845822409d84ca045459dc604ecd71703 [file] [log] [blame] [view] [edit]
# Runtests
Runtests is a command line tool that runs tests.
The most complete documentation of its capabilities and interface is the usage
string it prints.
It may be useful to developers working with the bringup
[product configuration](/products/README.md#bringup), since `fx test` does not
support running tests in that configuration. In this configuration, it can be
invoked from the serial console as `runtests`. To see a list of all the tests
are on the device's Boot FS, run `runtests --all -d`.
It is used in continuous integration infrastructure in the following ways:
* In coverage profile builders it is used since it knows how to set up
collection of coverage profiles. See
[fuchsia-run-test.cc](/zircon/system/ulib/runtests-utils/fuchsia-run-test.cc).
* In bringup builders it is used to run one test at a time. It's useful (vs
just invoking the tests directly) because it enforces timeouts and
translates exit codes into predictable strings that are written to the
serial console, which are then interpreted by testrunner.