| Message ID | 20250120164316.31473-3-alexandru.elisei@arm.com (mailing list archive) |
|---|---|
| State | New |
| Headers | show |
| Series | arm/arm64: Add kvmtool to the runner script | expand |
On Mon, Jan 20, 2025 at 04:43:00PM +0000, Alexandru Elisei wrote: > Document the environment variables that influence how a test is executed > by the run_tests.sh test runner. > > Suggested-by: Andrew Jones <drjones@redhat.com> > Signed-off-by: Alexandru Elisei <alexandru.elisei@arm.com> > --- > docs/unittests.txt | 5 ++++- > run_tests.sh | 12 +++++++++--- > 2 files changed, 13 insertions(+), 4 deletions(-) > > diff --git a/docs/unittests.txt b/docs/unittests.txt > index c4269f6230c8..dbc2c11e3b59 100644 > --- a/docs/unittests.txt > +++ b/docs/unittests.txt > @@ -88,7 +88,8 @@ timeout > ------- > timeout = <duration> > > -Optional timeout in seconds, after which the test will be killed and fail. > +Optional timeout in seconds, after which the test will be killed and fail. Can > +be overwritten with the TIMEOUT=<duration> environment variable. > > check > ----- > @@ -99,3 +100,5 @@ can contain multiple files to check separated by a space, but each check > parameter needs to be of the form <path>=<value> > > The path and value cannot contain space, =, or shell wildcard characters. > + > +Can be overwritten with the CHECK environment variable with the same syntax. > diff --git a/run_tests.sh b/run_tests.sh > index f30b6dbd131c..23d81b2caaa1 100755 > --- a/run_tests.sh > +++ b/run_tests.sh > @@ -27,9 +27,15 @@ Usage: $0 [-h] [-v] [-a] [-g group] [-j NUM-TASKS] [-t] [-l] > -l, --list Only output all tests list > --probe-maxsmp Update the maximum number of VCPUs supported by host > > -Set the environment variable QEMU=/path/to/qemu-system-ARCH to > -specify the appropriate qemu binary for ARCH-run. > - > +The following environment variables are used: > + > + QEMU Path to QEMU binary for ARCH-run > + ACCEL QEMU accelerator to use, e.g. 'kvm', 'hvf' or 'tcg' > + ACCEL_PROPS Extra argument to ACCEL > + MACHINE QEMU machine type > + TIMEOUT Timeout duration for the timeout(1) command > + CHECK Overwrites the 'check' unit test parameter (see > + docs/unittests.txt) > EOF > } > > -- > 2.47.1 > Reviewed-by: Andrew Jones <andrew.jones@linux.dev>
diff --git a/docs/unittests.txt b/docs/unittests.txt index c4269f6230c8..dbc2c11e3b59 100644 --- a/docs/unittests.txt +++ b/docs/unittests.txt @@ -88,7 +88,8 @@ timeout ------- timeout = <duration> -Optional timeout in seconds, after which the test will be killed and fail. +Optional timeout in seconds, after which the test will be killed and fail. Can +be overwritten with the TIMEOUT=<duration> environment variable. check ----- @@ -99,3 +100,5 @@ can contain multiple files to check separated by a space, but each check parameter needs to be of the form <path>=<value> The path and value cannot contain space, =, or shell wildcard characters. + +Can be overwritten with the CHECK environment variable with the same syntax. diff --git a/run_tests.sh b/run_tests.sh index f30b6dbd131c..23d81b2caaa1 100755 --- a/run_tests.sh +++ b/run_tests.sh @@ -27,9 +27,15 @@ Usage: $0 [-h] [-v] [-a] [-g group] [-j NUM-TASKS] [-t] [-l] -l, --list Only output all tests list --probe-maxsmp Update the maximum number of VCPUs supported by host -Set the environment variable QEMU=/path/to/qemu-system-ARCH to -specify the appropriate qemu binary for ARCH-run. - +The following environment variables are used: + + QEMU Path to QEMU binary for ARCH-run + ACCEL QEMU accelerator to use, e.g. 'kvm', 'hvf' or 'tcg' + ACCEL_PROPS Extra argument to ACCEL + MACHINE QEMU machine type + TIMEOUT Timeout duration for the timeout(1) command + CHECK Overwrites the 'check' unit test parameter (see + docs/unittests.txt) EOF }
Document the environment variables that influence how a test is executed by the run_tests.sh test runner. Suggested-by: Andrew Jones <drjones@redhat.com> Signed-off-by: Alexandru Elisei <alexandru.elisei@arm.com> --- docs/unittests.txt | 5 ++++- run_tests.sh | 12 +++++++++--- 2 files changed, 13 insertions(+), 4 deletions(-)