Qemu

Manage QEMU virtual machines.

Attribute	Type	Required	Default	Description
`cmd`	`const`	Yes	`qemu`	Command Name
`name`	`string`	Yes		Name to uniquely identify the teststep. This name will show up in reports, logs and the WebUI
`options`	`OptionsObject`	No		Additional command options
`parameters`	`QemuOptions`	Yes		Options passed into the `qemu` cmd

Qemu Options

Attribute	Type	Required	Description
`mode`	`string`	Yes	Supported modes are start, run and stop.
`executable`	`string`	Conditional (see below)	The executable that should be executed.
`firmware`	`string`	Conditional (see below)	The firmware that should be used.
`image`	`string`	No	The image that should be booted.
`nproc`	`integer`	No	The number of processors that should be used.
`mem`	`integer`	No	The amount of memory that should be used.
`variable`	`string`	Conditional (see below)	Name a variable to store the qemu PID for later session return.
`serial`	`QemuStepsOptions`	Yes	Steps to interact with during test execution.

The run mode can be used to attach to an already running QEMU instance. In this case, variable must be set to the PID of the QEMU process.
If variable is not set, the run mode will behave like the start mode, launching a new QEMU instance.
The stop mode will send a termination signal to the QEMU process identified by variable.

Conditional rules:

start: requires executable, firmware, and variable. The step launches QEMU and stores its PID in variable. If QEMU prints a PTY path it is stored in <variable>_pty.
run: if variable is provided the step attaches to the recorded PID/PTY and runs serial steps; if variable is empty, run requires both executable and firmware and will launch QEMU and run serial steps.
stop: requires variable and must not include executable, args, firmware or serial.

Attribute	Type	Required	Description
`send`	`string`	No	A string that should be sent as input.
`timeout`	`string`	No	Timeout for the interaction. Format: h for hours, m for minutes, s for seconds (e.g., 1h30m20s).
`expect`	`QemuExpectOptions`	No	Expectation for the interaction output.

Attribute	Type	Required	Default	Description
`regex`	`string`	Yes	`expect`	Regular expression that should be matched against the output of the interaction.