• Start
• Documentation
  • PostgreSQL
  • mnoGoSearch
  • Apache 2.4
  • FreeBSD handbook
  • FreeBSD Manual
  • FreeBSD Source
• Tools
• Search
• Protected Area

plain

FreeBSD manual

keyword 1 2 3 4 5 6 7 8 9 n l

download PDF document: kyua.conf.5.pdf

KYUA.CONF(5) FreeBSD File Formats Manual KYUA.CONF(5)
NAME kyua.conf - Configuration file for the kyua tool
SYNOPSIS syntax(int version);
Variables: architecture, execenvs, platform, test_suites, unprivileged_user.
DESCRIPTION The configuration of Kyua is a simple collection of key/value pairs called configuration variables. There are configuration variables that have a special meaning to the runtime engine implemented by kyua(1), and there are variables that only have meaning in the context of particular test suites.
Configuration files are Lua scripts. In their most basic form, their whole purpose is to assign values to variables, but the user has the freedom to implement any logic he desires to compute such values.
File versioning Every kyua.conf file starts with a call to syntax(int version). This call determines the specific schema used by the file so that future backwards-incompatible modifications to the file can be introduced.
Any new kyua.conf file should set version to `2'.
Runtime configuration variables The following variables are internally recognized by kyua(1):
architecture Name of the system architecture (aka processor type).
execenvs Whitespace-separated list of execution environment names.
Only tests which require one of the given execution environments will be run.
See kyuafile(5) for the list of possible execution environments.
parallelism Maximum number of test cases to execute concurrently.
platform Name of the system platform (aka machine type).
unprivileged_user Name or UID of the unprivileged user.
If set, the given user must exist in the system and his privileges will be used to run test cases that need regular privileges when kyua(1) is executed as root.
Test-suite configuration variables Each test suite is able to recognize arbitrary configuration variables,
test_suites.<test_suite_name>.<variable_name> = <value>
where test_suite_name is the name of the test suite, variable_name is the name of the variable to set, and value is a value. The value can be a string, an integer or a boolean.
FILES /usr/share/examples/kyua/kyua.conf Sample configuration file.
EXAMPLES The following kyua.conf shows a simple configuration file that overrides a bunch of the built-in kyua(1) configuration variables:
syntax(2)
architecture = 'x86_64' platform = 'amd64'
The following is a more complex example that introduces the definition of per-test suite configuration variables:
syntax(2)
-- Assign built-in variables. unprivileged_user = '_tests'
-- Assign test-suite variables. All of these must be strings. test_suites.NetBSD.file_systems = 'ffs ext2fs' test_suites.X11.graphics_driver = 'vesa'
SEE ALSO kyua(1)
FreeBSD 14.2-RELEASE March 22, 2024 FreeBSD 14.2-RELEASE