Table of Contents
The xfstestsdb list command prints out the xfstests runs that have been added to the xfstests_runs database table.
This command will print output in color by default when running in interactive mode. The "--color=" option can be used to print output in either light or dark color schemes or to disable color altogether. The default color scheme is "dark", but this can be overridden by setting the XFSTESTSDB_COLORS environment variable. The FORCE_COLOR and NO_COLOR environment variables can be used to force or disable color usage, which can be useful when piping to another command such as less -r
The table will be printed with Run, Device, and Timestamp columns by default. The "--tags" and "--xunit" options can be used to also show the list of Tags or Xunits for each run.
The --device=, --tags=, --timestamp=, and --xunit= options are used to narrow down the runs that are printed out to those that have a matching name, tag, timestamp, or xunit. These options can be combined, and take a valid SQLite GLOB pattern.
Invocation
$ xfstestsdb list [--color[={light|dark|none}]] [--device <device>] [--tags[=<tag>]] [--timestamp <timestamp>] [--xunits[=<xunit>]
Options
| Options | Choices | Description |
|---|---|---|
--color[=] |
light, dark, none | The color output choice |
--device= |
Show runs that match the given device pattern | |
--tags[=] |
Show the Tags column and (optionally) filter for the given tag pattern | |
--timestamp= |
Show runs that match the given timestamp pattern | |
--xunits[=] |
Show the Xunits column and (optionally) filter for the given xunit pattern |
Exit
| Exit Code | Description |
|---|---|
0 |
The results have been successfully printed out |
Examples
$ xfstestsdb list --color=none
+-----+-----------+---------------------+
| run | device | timestamp |
+-----+-----------+---------------------+
| 1 | /dev/vda1 | 2023-01-31 11:43:50 |
| 2 | /dev/vda2 | 2023-01-31 11:45:43 |
| 3 | /dev/vda1 | 2023-01-31 11:59:59 |
| 4 | /dev/vdb2 | 2023-01-31 11:59:59 |
+-----+-----------+---------------------+
$ xfstestsdb list --color=none --device=/dev/vda2
+-----+-----------+---------------------+
| run | device | timestamp |
+-----+-----------+---------------------+
| 2 | /dev/vda2 | 2023-01-31 11:45:43 |
+-----+-----------+---------------------+
$ xfstestsdb list --color=none --device "/dev/vd*2"
+-----+-----------+---------------------+
| run | device | timestamp |
+-----+-----------+---------------------+
| 2 | /dev/vda2 | 2023-01-31 11:45:43 |
| 4 | /dev/vdb2 | 2023-01-31 11:59:59 |
+-----+-----------+---------------------+
$ xfstestsdb list --color=none --device=/dev/vda1 --tags=mytag3
+-----+-----------+---------------------+----------------+
| run | device | timestamp | tags |
+-----+-----------+---------------------+----------------+
| 4 | /dev/vdb2 | 2023-01-31 11:59:59 | mytag3 |
+-----+-----------+---------------------+----------------+