vdev progress

Report when a guest accesses an address in guest-physical memory, or attempts to execute specific instructions.

Synopsis:

vdev progress options

Options:

cpuid instr: x86 only. Generate a report whenever the guest executes a CPUID instruction with the EAX equal to the value specifed by instr.
full: Generate a full register dump on each reference.
loc addr: Report when the guest reads or writes the guest-physical address specified by addr.
smc instr: ARM only. Generate a report whenever the guest executes an SMC instruction with the immediate value specified by instr.

For a list of options available to all vdevs, see “Common vdev options” at the beginning of this chapter.

Description:

The progress vdev can generate reports when any of the loc, smc, or cpuid conditions described above occurs.

For example, the following generates a report when a guest accesses the specified location in its guest physical memory:

vdev progress
	loc 0xffff0000

Similarly, the following generates a report when a guest executes an SMC instruction with a value of 0x01:

vdev progress
	smc 0x01

The hypervisor outputs reports to whatever destination is specified by the logger option's info filter (see logger in the “VM Configuration Reference” chapter).