Skip to content

Commit bd84c8a

Browse files
em-andersson
authored andcommitted
Expand the README to explain what bootrr is about
Inspired by https://github.com/RichardLitt/standard-readme/ Signed-off-by: Emanuele Aina <[email protected]>
1 parent 4de62e9 commit bd84c8a

File tree

2 files changed

+45
-9
lines changed

2 files changed

+45
-9
lines changed

README

-9
This file was deleted.

README.md

+45
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
2+
# Bootrr
3+
4+
A sanity checker for boards under automated test on LAVA.
5+
6+
Before running the tests for your software stack on LAVA, you really want to
7+
ensure that the basics are in place.
8+
9+
Testing that all the expected hardware is detected and that modules and
10+
firmwares can be loaded catches some very common kind of regressions: for
11+
instance, when renaming identifiers it is often the case that firmware blobs no
12+
longer get loaded since their location needs to be updated accordingly.
13+
14+
This repository contains:
15+
* static board descriptions that list what to expect for each specific
16+
board type
17+
* helpers to inspect the current system and compare it against the static board
18+
description for it
19+
* the `bootrr` script to automatically detect the current board and run
20+
the matching tests
21+
22+
The output is in a format meant to be directly parsed by LAVA.
23+
24+
## Install
25+
26+
```sh
27+
$ make prefix=/usr/local DESTDIR=/ install
28+
```
29+
30+
## Usage
31+
32+
```sh
33+
$ bootrr
34+
<LAVA_SIGNAL_TESTCASE TEST_CASE_ID=deferred-probe-empty RESULT=skip>
35+
<LAVA_SIGNAL_TESTCASE TEST_CASE_ID=all-cpus-are-online RESULT=pass>
36+
```
37+
38+
## Related Efforts
39+
40+
- [LAVA](https://lavasoftware.org/) - A continuous integration system for deploying operating systems onto physical and virtual hardware for running tests.
41+
- [KernelCI](https://kernelci.org/) - Community-led test system focused on the upstream Linux kernel.
42+
43+
## License
44+
45+
BSD-3-Clause

0 commit comments

Comments
 (0)