Definitions for manipulating a guest system
All the functions that guest.h provides are thread safe (see notes for guest_intr_string()).
| Function | When used | Notes |
|---|---|---|
| guest_button_register() | Startup | Only thread safe when used at startup. |
| guest_clock_start() | Running | |
| guest_clock_stop() | Running | |
| guest_cpu_read() | Running | Typically used in vread(). |
| guest_cpu_write() | Running | Typically used in vwrite(). |
| guest_instr_register() | Startup | |
| guest_intr_assign() | Startup | |
| guest_intr_level() | Startup | |
| guest_intr_notify() | Running | |
| guest_intr_num_pins() | Startup | |
| guest_intr_signal() | Running | |
| guest_intr_string() | Startup, running (see notes) | Should not malloc() buffers at running time. |
| guest_msi_register() | Startup | |
| guest_msi_signal() | Running | |
| guest_power_state_current() | Startup, running | |
| guest_power_state_notify_create() | Startup, running | |
| guest_power_state_notify_delete() | Startup, running | |
| guest_power_state_notify_register() | Startup, running | |
| guest_terminate() | Startup, running | Kill the qvm immediately. |
| guest_timer_create() | Startup | |
| guest_timer_notify() | Running | |
| guest_timer_state() | Running | |
| guest_write_all_ones() | Running |
Typically used in vread() and vwrite(). See guest_cpu_write() for more details. |
| guest_write_core_file() | Startup, running |