qemu-e2k/docs
David Gibson 651615d92d s390: Recognize confidential-guest-support option
At least some s390 cpu models support "Protected Virtualization" (PV),
a mechanism to protect guests from eavesdropping by a compromised
hypervisor.

This is similar in function to other mechanisms like AMD's SEV and
POWER's PEF, which are controlled by the "confidential-guest-support"
machine option.  s390 is a slightly special case, because we already
supported PV, simply by using a CPU model with the required feature
(S390_FEAT_UNPACK).

To integrate this with the option used by other platforms, we
implement the following compromise:

 - When the confidential-guest-support option is set, s390 will
   recognize it, verify that the CPU can support PV (failing if not)
   and set virtio default options necessary for encrypted or protected
   guests, as on other platforms.  i.e. if confidential-guest-support
   is set, we will either create a guest capable of entering PV mode,
   or fail outright.

 - If confidential-guest-support is not set, guests might still be
   able to enter PV mode, if the CPU has the right model.  This may be
   a little surprising, but shouldn't actually be harmful.

To start a guest supporting Protected Virtualization using the new
option use the command line arguments:
    -object s390-pv-guest,id=pv0 -machine confidential-guest-support=pv0

Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
Tested-by: Christian Borntraeger <borntraeger@de.ibm.com>
Reviewed-by: Christian Borntraeger <borntraeger@de.ibm.com>
2021-02-08 16:57:38 +11:00
..
_templates
config
devel trace: update docs with meson build information 2021-02-01 11:23:04 +00:00
interop docs/interop/qmp-spec: Document the request queue limit 2021-02-04 13:20:29 +01:00
specs pvpanic : update pvpanic spec document 2021-01-29 10:47:28 +00:00
sphinx Revert "docs: temporarily disable the kernel-doc extension" 2020-12-10 12:15:25 -05:00
spin
system s390: Recognize confidential-guest-support option 2021-02-08 16:57:38 +11:00
tools docs: Build and install all the docs in a single manual 2021-01-19 15:45:14 +00:00
user docs: Build and install all the docs in a single manual 2021-01-19 15:45:14 +00:00
amd-memory-encryption.txt confidential guest support: Update documentation 2021-02-08 16:57:38 +11:00
barrier.txt
block-replication.txt
bootindex.txt
can.txt
ccid.txt
COLO-FT.txt
colo-proxy.txt
conf.py docs: Build and install all the docs in a single manual 2021-01-19 15:45:14 +00:00
confidential-guest-support.txt s390: Recognize confidential-guest-support option 2021-02-08 16:57:38 +11:00
defs.rst.inc
generic-loader.txt
hyperv.txt
igd-assign.txt
image-fuzzer.txt
index.rst
memory-hotplug.txt
meson.build docs: Build and install all the docs in a single manual 2021-01-19 15:45:14 +00:00
multi-thread-compression.txt
multiseat.txt
nvdimm.txt nvdimm: check -object memory-backend-file, readonly=on option 2021-02-01 17:07:34 -05:00
papr-pef.txt spapr: Add PEF based confidential guest support 2021-02-08 16:57:38 +11:00
pci_expander_bridge.txt
pcie_pci_bridge.txt
pcie.txt
pvrdma.txt
qcow2-cache.txt
qdev-device-use.txt
qemu_logo.pdf
qemu-option-trace.rst.inc
qemupciserial.inf
rdma.txt
replay.txt
spice-port-fqdn.txt
throttle.txt
u2f.txt
usb2.txt
usb-storage.txt
virtio-balloon-stats.txt
xbzrle.txt
xen-save-devices-state.txt