Skip to content

Commit 19cebba

Browse files
committed
Documentation: kvm/sev: separate description of firmware
The description of firmware is included part under the "SEV Key Management" header, part under the KVM_SEV_INIT ioctl. Put these two bits together and and rename "SEV Key Management" to what it actually is, namely a description of the KVM_MEMORY_ENCRYPT_OP API. Reviewed-by: Michael Roth <[email protected]> Signed-off-by: Paolo Bonzini <[email protected]>
1 parent f3c8006 commit 19cebba

File tree

1 file changed

+17
-12
lines changed

1 file changed

+17
-12
lines changed

Documentation/virt/kvm/x86/amd-memory-encryption.rst

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -46,14 +46,8 @@ SEV hardware uses ASIDs to associate a memory encryption key with a VM.
4646
Hence, the ASID for the SEV-enabled guests must be from 1 to a maximum value
4747
defined in the CPUID 0x8000001f[ecx] field.
4848

49-
SEV Key Management
50-
==================
51-
52-
The SEV guest key management is handled by a separate processor called the AMD
53-
Secure Processor (AMD-SP). Firmware running inside the AMD-SP provides a secure
54-
key management interface to perform common hypervisor activities such as
55-
encrypting bootstrap code, snapshot, migrating and debugging the guest. For more
56-
information, see the SEV Key Management spec [api-spec]_
49+
The KVM_MEMORY_ENCRYPT_OP ioctl
50+
===============================
5751

5852
The main ioctl to access SEV is KVM_MEMORY_ENCRYPT_OP. If the argument
5953
to KVM_MEMORY_ENCRYPT_OP is NULL, the ioctl returns 0 if SEV is enabled
@@ -87,10 +81,6 @@ guests, such as launching, running, snapshotting, migrating and decommissioning.
8781
The KVM_SEV_INIT command is used by the hypervisor to initialize the SEV platform
8882
context. In a typical workflow, this command should be the first command issued.
8983

90-
The firmware can be initialized either by using its own non-volatile storage or
91-
the OS can manage the NV storage for the firmware using the module parameter
92-
``init_ex_path``. If the file specified by ``init_ex_path`` does not exist or
93-
is invalid, the OS will create or override the file with output from PSP.
9484

9585
Returns: 0 on success, -negative on error
9686

@@ -434,6 +424,21 @@ issued by the hypervisor to make the guest ready for execution.
434424

435425
Returns: 0 on success, -negative on error
436426

427+
Firmware Management
428+
===================
429+
430+
The SEV guest key management is handled by a separate processor called the AMD
431+
Secure Processor (AMD-SP). Firmware running inside the AMD-SP provides a secure
432+
key management interface to perform common hypervisor activities such as
433+
encrypting bootstrap code, snapshot, migrating and debugging the guest. For more
434+
information, see the SEV Key Management spec [api-spec]_
435+
436+
The AMD-SP firmware can be initialized either by using its own non-volatile
437+
storage or the OS can manage the NV storage for the firmware using
438+
parameter ``init_ex_path`` of the ``ccp`` module. If the file specified
439+
by ``init_ex_path`` does not exist or is invalid, the OS will create or
440+
override the file with PSP non-volatile storage.
441+
437442
References
438443
==========
439444

0 commit comments

Comments
 (0)