VM Configuration file¶
Number of available options can easily get quite high, especially when different devices come into play, and setting all of them on command line is not very clear. To ease this part of VM processes, user can create a configuration file. Syntax is based on Python’s ConfigParser (or Windows .ini) configuration files. It consists of sections, setting options for different subsystems (VM, CPUs, ...). You can find few configuration files in examples/ directory.
When option takes an address as an argument, address can be specified either using decimal or hexadecimal base. Usually, the absolute address is necessary when option is not binary-aware, yet some options are tied closely to particular binary, such options can also accept name of a symbol. Option handling code will try to find corresponding address in binary’s symbol table. This is valid for both command-line options and configuration files.
[machine]¶
[memory]¶
[cpu]¶
control-coprocessor¶
When set, each CPU core will have its own control coprocessor.
bool, default yes
check-frame¶
When set, CPU cores will check if stack frames were cleaned properly when ret or iret is executed.
bool, default yes
[device-N]¶
Each section starting with device- tells VM to create virtual device, and provide it to running binaries. Device sections have few options, common for all kinds of devices, and a set of options, specific for each different device or driver.
klass¶
Device class - arbitrary string, describing family of devices. E.g. I use input for devices processing user input (e.g. keyboard controllers).
str, required
master¶
If set, master is superior device, with some responsibilities over its subordinates.
str, optional