jcs.org
qemu with hax to log dma reads & writes
jcs.org/2018/11/12/vfio
docs/system: convert managed startup to rST.
Fix one typo in the process and format more option and
command names as literal text, but make no significant
changes to the content.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Message-id: 20200228153619.9906-18-peter.maydell@linaro.org
Message-id: 20200226113034.6741-17-pbonzini@redhat.com
+36
-1
+1
-1
docs/system/index.rst
+1
-1
docs/system/index.rst
+35
docs/system/managed-startup.rst
+35
docs/system/managed-startup.rst
···
1
+
Managed start up options
2
+
========================
3
+
4
+
In system mode emulation, it's possible to create a VM in a paused
5
+
state using the ``-S`` command line option. In this state the machine
6
+
is completely initialized according to command line options and ready
7
+
to execute VM code but VCPU threads are not executing any code. The VM
8
+
state in this paused state depends on the way QEMU was started. It
9
+
could be in:
10
+
11
+
- initial state (after reset/power on state)
12
+
- with direct kernel loading, the initial state could be amended to execute
13
+
code loaded by QEMU in the VM's RAM and with incoming migration
14
+
- with incoming migration, initial state will be amended with the migrated
15
+
machine state after migration completes
16
+
17
+
This paused state is typically used by users to query machine state and/or
18
+
additionally configure the machine (by hotplugging devices) in runtime before
19
+
allowing VM code to run.
20
+
21
+
However, at the ``-S`` pause point, it's impossible to configure options
22
+
that affect initial VM creation (like: ``-smp``/``-m``/``-numa`` ...) or
23
+
cold plug devices. The experimental ``--preconfig`` command line option
24
+
allows pausing QEMU before the initial VM creation, in a "preconfig" state,
25
+
where additional queries and configuration can be performed via QMP
26
+
before moving on to the resulting configuration startup. In the
27
+
preconfig state, QEMU only allows a limited set of commands over the
28
+
QMP monitor, where the commands do not depend on an initialized
29
+
machine, including but not limited to:
30
+
31
+
- ``qmp_capabilities``
32
+
- ``query-qmp-schema``
33
+
- ``query-commands``
34
+
- ``query-status``
35
+
- ``x-exit-preconfig``