xref: /qemu/include/system/confidential-guest-support.h (revision 8916c373a3fd56938f1b7d57010491a0b9662b1e)
1f91f9f25SDavid Gibson /*
2f91f9f25SDavid Gibson  * QEMU Confidential Guest support
3f91f9f25SDavid Gibson  *   This interface describes the common pieces between various
4f91f9f25SDavid Gibson  *   schemes for protecting guest memory or other state against a
5f91f9f25SDavid Gibson  *   compromised hypervisor.  This includes memory encryption (AMD's
6f91f9f25SDavid Gibson  *   SEV and Intel's MKTME) or special protection modes (PEF on POWER,
7f91f9f25SDavid Gibson  *   or PV on s390x).
8f91f9f25SDavid Gibson  *
9f91f9f25SDavid Gibson  * Copyright Red Hat.
10f91f9f25SDavid Gibson  *
11f91f9f25SDavid Gibson  * Authors:
12f91f9f25SDavid Gibson  *  David Gibson <david@gibson.dropbear.id.au>
13f91f9f25SDavid Gibson  *
14f91f9f25SDavid Gibson  * This work is licensed under the terms of the GNU GPL, version 2 or
15f91f9f25SDavid Gibson  * later.  See the COPYING file in the top-level directory.
16f91f9f25SDavid Gibson  *
17f91f9f25SDavid Gibson  */
18f91f9f25SDavid Gibson #ifndef QEMU_CONFIDENTIAL_GUEST_SUPPORT_H
19f91f9f25SDavid Gibson #define QEMU_CONFIDENTIAL_GUEST_SUPPORT_H
20f91f9f25SDavid Gibson 
21f91f9f25SDavid Gibson #include "qom/object.h"
22f91f9f25SDavid Gibson 
23f91f9f25SDavid Gibson #define TYPE_CONFIDENTIAL_GUEST_SUPPORT "confidential-guest-support"
2441a60594SXiaoyao Li OBJECT_DECLARE_TYPE(ConfidentialGuestSupport,
2541a60594SXiaoyao Li                     ConfidentialGuestSupportClass,
2641a60594SXiaoyao Li                     CONFIDENTIAL_GUEST_SUPPORT)
2741a60594SXiaoyao Li 
28f91f9f25SDavid Gibson 
29f91f9f25SDavid Gibson struct ConfidentialGuestSupport {
30f91f9f25SDavid Gibson     Object parent;
31abc27d42SDavid Gibson 
32abc27d42SDavid Gibson     /*
33*dc0d28caSPaolo Bonzini      * True if the machine should use guest_memfd for RAM.
34*dc0d28caSPaolo Bonzini      */
35*dc0d28caSPaolo Bonzini     bool require_guest_memfd;
36*dc0d28caSPaolo Bonzini 
37*dc0d28caSPaolo Bonzini     /*
38abc27d42SDavid Gibson      * ready: flag set by CGS initialization code once it's ready to
39abc27d42SDavid Gibson      *        start executing instructions in a potentially-secure
40abc27d42SDavid Gibson      *        guest
41abc27d42SDavid Gibson      *
42abc27d42SDavid Gibson      * The definition here is a bit fuzzy, because this is essentially
43abc27d42SDavid Gibson      * part of a self-sanity-check, rather than a strict mechanism.
44abc27d42SDavid Gibson      *
45abc27d42SDavid Gibson      * It's not feasible to have a single point in the common machine
46abc27d42SDavid Gibson      * init path to configure confidential guest support, because
47abc27d42SDavid Gibson      * different mechanisms have different interdependencies requiring
48abc27d42SDavid Gibson      * initialization in different places, often in arch or machine
49abc27d42SDavid Gibson      * type specific code.  It's also usually not possible to check
50abc27d42SDavid Gibson      * for invalid configurations until that initialization code.
51abc27d42SDavid Gibson      * That means it would be very easy to have a bug allowing CGS
52abc27d42SDavid Gibson      * init to be bypassed entirely in certain configurations.
53abc27d42SDavid Gibson      *
54abc27d42SDavid Gibson      * Silently ignoring a requested security feature would be bad, so
55abc27d42SDavid Gibson      * to avoid that we check late in init that this 'ready' flag is
56abc27d42SDavid Gibson      * set if CGS was requested.  If the CGS init hasn't happened, and
57abc27d42SDavid Gibson      * so 'ready' is not set, we'll abort.
58abc27d42SDavid Gibson      */
59abc27d42SDavid Gibson     bool ready;
60f91f9f25SDavid Gibson };
61f91f9f25SDavid Gibson 
62f91f9f25SDavid Gibson typedef struct ConfidentialGuestSupportClass {
63f91f9f25SDavid Gibson     ObjectClass parent;
6441a60594SXiaoyao Li 
6541a60594SXiaoyao Li     int (*kvm_init)(ConfidentialGuestSupport *cgs, Error **errp);
6641a60594SXiaoyao Li     int (*kvm_reset)(ConfidentialGuestSupport *cgs, Error **errp);
67f91f9f25SDavid Gibson } ConfidentialGuestSupportClass;
68f91f9f25SDavid Gibson 
confidential_guest_kvm_init(ConfidentialGuestSupport * cgs,Error ** errp)6941a60594SXiaoyao Li static inline int confidential_guest_kvm_init(ConfidentialGuestSupport *cgs,
7041a60594SXiaoyao Li                                               Error **errp)
7141a60594SXiaoyao Li {
7241a60594SXiaoyao Li     ConfidentialGuestSupportClass *klass;
7341a60594SXiaoyao Li 
7441a60594SXiaoyao Li     klass = CONFIDENTIAL_GUEST_SUPPORT_GET_CLASS(cgs);
7541a60594SXiaoyao Li     if (klass->kvm_init) {
7641a60594SXiaoyao Li         return klass->kvm_init(cgs, errp);
7741a60594SXiaoyao Li     }
7841a60594SXiaoyao Li 
7941a60594SXiaoyao Li     return 0;
8041a60594SXiaoyao Li }
8141a60594SXiaoyao Li 
confidential_guest_kvm_reset(ConfidentialGuestSupport * cgs,Error ** errp)8241a60594SXiaoyao Li static inline int confidential_guest_kvm_reset(ConfidentialGuestSupport *cgs,
8341a60594SXiaoyao Li                                                Error **errp)
8441a60594SXiaoyao Li {
8541a60594SXiaoyao Li     ConfidentialGuestSupportClass *klass;
8641a60594SXiaoyao Li 
8741a60594SXiaoyao Li     klass = CONFIDENTIAL_GUEST_SUPPORT_GET_CLASS(cgs);
8841a60594SXiaoyao Li     if (klass->kvm_reset) {
8941a60594SXiaoyao Li         return klass->kvm_reset(cgs, errp);
9041a60594SXiaoyao Li     }
9141a60594SXiaoyao Li 
9241a60594SXiaoyao Li     return 0;
9341a60594SXiaoyao Li }
9441a60594SXiaoyao Li 
95f91f9f25SDavid Gibson #endif /* QEMU_CONFIDENTIAL_GUEST_SUPPORT_H */
96