1 /* SPDX-License-Identifier: GPL-2.0 */
3 * AMD Encrypted Register State Support
5 * Author: Joerg Roedel <jroedel@suse.de>
8 #ifndef __ASM_ENCRYPTED_STATE_H
9 #define __ASM_ENCRYPTED_STATE_H
11 #include <linux/types.h>
12 #include <linux/sev-guest.h>
15 #include <asm/sev-common.h>
17 #include <asm/set_memory.h>
20 #define GHCB_PROTOCOL_MIN 1ULL
21 #define GHCB_PROTOCOL_MAX 2ULL
22 #define GHCB_DEFAULT_USAGE 0ULL
24 #define VMGEXIT() { asm volatile("rep; vmmcall\n\r"); }
30 ES_UNSUPPORTED, /* Requested operation not supported */
31 ES_VMM_ERROR, /* Unexpected state from the VMM */
32 ES_DECODE_FAILED, /* Instruction decoding failed */
33 ES_EXCEPTION, /* Instruction caused exception */
34 ES_RETRY, /* Retry instruction emulation */
37 struct es_fault_info {
39 unsigned long error_code;
45 /* ES instruction emulation context */
49 struct es_fault_info fi;
53 * AMD SEV Confidential computing blob structure. The structure is
54 * defined in OVMF UEFI firmware header:
55 * https://github.com/tianocore/edk2/blob/master/OvmfPkg/Include/Guid/ConfidentialComputingSevSnpBlob.h
57 #define CC_BLOB_SEV_HDR_MAGIC 0x45444d41
58 struct cc_blob_sev_info {
70 void do_vc_no_ghcb(struct pt_regs *regs, unsigned long exit_code);
72 static inline u64 lower_bits(u64 val, unsigned int bits)
74 u64 mask = (1ULL << bits) - 1;
79 struct real_mode_header;
82 /* Early IDT entry points for #VC handler */
83 extern void vc_no_ghcb(void);
84 extern void vc_boot_ghcb(void);
85 extern bool handle_vc_boot_ghcb(struct pt_regs *regs);
88 * Individual entries of the SNP CPUID table, as defined by the SNP
89 * Firmware ABI, Revision 0.9, Section 7.1, Table 14.
104 * SNP CPUID table, as defined by the SNP Firmware ABI, Revision 0.9,
105 * Section 8.14.2.6. Also noted there is the SNP firmware-enforced limit
106 * of 64 entries per CPUID table.
108 #define SNP_CPUID_COUNT_MAX 64
110 struct snp_cpuid_table {
114 struct snp_cpuid_fn fn[SNP_CPUID_COUNT_MAX];
117 /* PVALIDATE return codes */
118 #define PVALIDATE_FAIL_SIZEMISMATCH 6
120 /* Software defined (when rFlags.CF = 1) */
121 #define PVALIDATE_FAIL_NOUPDATE 255
123 /* RMUPDATE detected 4K page and 2MB page overlap. */
124 #define RMPUPDATE_FAIL_OVERLAP 4
126 /* PSMASH failed due to concurrent access by another CPU */
127 #define PSMASH_FAIL_INUSE 3
130 #define RMP_PG_SIZE_4K 0
131 #define RMP_PG_SIZE_2M 1
132 #define RMP_TO_PG_LEVEL(level) (((level) == RMP_PG_SIZE_4K) ? PG_LEVEL_4K : PG_LEVEL_2M)
133 #define PG_LEVEL_TO_RMP(level) (((level) == PG_LEVEL_4K) ? RMP_PG_SIZE_4K : RMP_PG_SIZE_2M)
144 #define RMPADJUST_VMSA_PAGE_BIT BIT(16)
146 /* SNP Guest message request */
147 struct snp_req_data {
148 unsigned long req_gpa;
149 unsigned long resp_gpa;
150 unsigned long data_gpa;
151 unsigned int data_npages;
154 #define MAX_AUTHTAG_LEN 32
155 #define AUTHTAG_LEN 16
157 #define MSG_HDR_VER 1
159 #define SNP_REQ_MAX_RETRY_DURATION (60*HZ)
160 #define SNP_REQ_RETRY_DELAY (2*HZ)
162 /* See SNP spec SNP_GUEST_REQUEST section for the structure */
164 SNP_MSG_TYPE_INVALID = 0,
180 SNP_MSG_TSC_INFO_REQ = 17,
181 SNP_MSG_TSC_INFO_RSP,
188 SNP_AEAD_AES_256_GCM,
191 struct snp_guest_msg_hdr {
192 u8 authtag[MAX_AUTHTAG_LEN];
206 struct snp_guest_msg {
207 struct snp_guest_msg_hdr hdr;
208 u8 payload[PAGE_SIZE - sizeof(struct snp_guest_msg_hdr)];
211 #define SNP_TSC_INFO_REQ_SZ 128
213 struct snp_tsc_info_req {
214 u8 rsvd[SNP_TSC_INFO_REQ_SZ];
217 struct snp_tsc_info_resp {
227 * Obtain the mean TSC frequency by decreasing the nominal TSC frequency with
228 * TSC_FACTOR as documented in the SNP Firmware ABI specification:
230 * GUEST_TSC_FREQ * (1 - (TSC_FACTOR * 0.00001))
232 * which is equivalent to:
234 * GUEST_TSC_FREQ -= (GUEST_TSC_FREQ * TSC_FACTOR) / 100000;
236 #define SNP_SCALE_TSC_FREQ(freq, factor) ((freq) - (freq) * (factor) / 100000)
238 struct snp_guest_req {
246 unsigned int vmpck_id;
250 struct snp_req_data input;
255 * The secrets page contains 96-bytes of reserved field that can be used by
256 * the guest OS. The guest OS uses the area to save the message sequence
257 * number for each VMPCK.
259 * See the GHCB spec section Secret page layout for the format for this area.
261 struct secrets_os_area {
266 u64 ap_jump_table_pa;
271 #define VMPCK_KEY_LEN 32
273 /* See the SNP spec version 0.9 for secrets page format */
274 struct snp_secrets_page {
281 u8 vmpck0[VMPCK_KEY_LEN];
282 u8 vmpck1[VMPCK_KEY_LEN];
283 u8 vmpck2[VMPCK_KEY_LEN];
284 u8 vmpck3[VMPCK_KEY_LEN];
285 struct secrets_os_area os_area;
287 u8 vmsa_tweak_bitmap[64];
293 u32 svsm_max_version;
297 /* The percentage decrease from nominal to mean TSC frequency. */
300 /* Remainder of page */
304 struct snp_msg_desc {
305 /* request and response are in unencrypted memory */
306 struct snp_guest_msg *request, *response;
309 * Avoid information leakage by double-buffering shared messages
310 * in fields that are in regular encrypted memory.
312 struct snp_guest_msg secret_request, secret_response;
314 struct snp_secrets_page *secrets;
316 struct aesgcm_ctx *ctx;
318 u32 *os_area_msg_seqno;
324 * The SVSM Calling Area (CA) related structures.
331 u8 svsm_buffer[PAGE_SIZE - 8];
334 #define SVSM_SUCCESS 0
335 #define SVSM_ERR_INCOMPLETE 0x80000000
336 #define SVSM_ERR_UNSUPPORTED_PROTOCOL 0x80000001
337 #define SVSM_ERR_UNSUPPORTED_CALL 0x80000002
338 #define SVSM_ERR_INVALID_ADDRESS 0x80000003
339 #define SVSM_ERR_INVALID_FORMAT 0x80000004
340 #define SVSM_ERR_INVALID_PARAMETER 0x80000005
341 #define SVSM_ERR_INVALID_REQUEST 0x80000006
342 #define SVSM_ERR_BUSY 0x80000007
343 #define SVSM_PVALIDATE_FAIL_SIZEMISMATCH 0x80001006
346 * The SVSM PVALIDATE related structures
348 struct svsm_pvalidate_entry {
356 struct svsm_pvalidate_call {
362 struct svsm_pvalidate_entry entry[];
365 #define SVSM_PVALIDATE_MAX_COUNT ((sizeof_field(struct svsm_ca, svsm_buffer) - \
366 offsetof(struct svsm_pvalidate_call, entry)) / \
367 sizeof(struct svsm_pvalidate_entry))
370 * The SVSM Attestation related structures
372 struct svsm_loc_entry {
378 struct svsm_attest_call {
379 struct svsm_loc_entry report_buf;
380 struct svsm_loc_entry nonce;
381 struct svsm_loc_entry manifest_buf;
382 struct svsm_loc_entry certificates_buf;
384 /* For attesting a single service */
386 u32 service_manifest_ver;
390 /* PTE descriptor used for the prepare_pte_enc() operations. */
391 struct pte_enc_desc {
395 /* pfn of the kpte above */
397 /* physical address of @pfn */
399 /* virtual address of @pfn */
401 /* memory covered by the pte */
407 * SVSM protocol structure
423 #define SVSM_CORE_CALL(x) ((0ULL << 32) | (x))
424 #define SVSM_CORE_REMAP_CA 0
425 #define SVSM_CORE_PVALIDATE 1
426 #define SVSM_CORE_CREATE_VCPU 2
427 #define SVSM_CORE_DELETE_VCPU 3
429 #define SVSM_ATTEST_CALL(x) ((1ULL << 32) | (x))
430 #define SVSM_ATTEST_SERVICES 0
431 #define SVSM_ATTEST_SINGLE_SERVICE 1
433 #define SVSM_VTPM_CALL(x) ((2ULL << 32) | (x))
434 #define SVSM_VTPM_QUERY 0
435 #define SVSM_VTPM_CMD 1
437 #ifdef CONFIG_AMD_MEM_ENCRYPT
441 extern void __sev_es_ist_enter(struct pt_regs *regs);
442 extern void __sev_es_ist_exit(void);
443 static __always_inline void sev_es_ist_enter(struct pt_regs *regs)
445 if (cc_vendor == CC_VENDOR_AMD &&
446 cc_platform_has(CC_ATTR_GUEST_STATE_ENCRYPT))
447 __sev_es_ist_enter(regs);
449 static __always_inline void sev_es_ist_exit(void)
451 if (cc_vendor == CC_VENDOR_AMD &&
452 cc_platform_has(CC_ATTR_GUEST_STATE_ENCRYPT))
455 extern int sev_es_setup_ap_jump_table(struct real_mode_header *rmh);
456 extern void __sev_es_nmi_complete(void);
457 static __always_inline void sev_es_nmi_complete(void)
459 if (cc_vendor == CC_VENDOR_AMD &&
460 cc_platform_has(CC_ATTR_GUEST_STATE_ENCRYPT))
461 __sev_es_nmi_complete();
463 extern int __init sev_es_efi_map_ghcbs(pgd_t *pgd);
464 extern void sev_enable(struct boot_params *bp);
467 * RMPADJUST modifies the RMP permissions of a page of a lesser-
468 * privileged (numerically higher) VMPL.
470 * If the guest is running at a higher-privilege than the privilege
471 * level the instruction is targeting, the instruction will succeed,
472 * otherwise, it will fail.
474 static inline int rmpadjust(unsigned long vaddr, bool rmp_psize, unsigned long attrs)
478 /* "rmpadjust" mnemonic support in binutils 2.36 and newer */
479 asm volatile(".byte 0xF3,0x0F,0x01,0xFE\n\t"
481 : "a"(vaddr), "c"(rmp_psize), "d"(attrs)
486 static inline int pvalidate(unsigned long vaddr, bool rmp_psize, bool validate)
491 /* "pvalidate" mnemonic support in binutils 2.36 and newer */
492 asm volatile(".byte 0xF2, 0x0F, 0x01, 0xFF\n\t"
494 : CC_OUT(c) (no_rmpupdate), "=a"(rc)
495 : "a"(vaddr), "c"(rmp_psize), "d"(validate)
499 return PVALIDATE_FAIL_NOUPDATE;
504 struct snp_guest_request_ioctl;
506 void setup_ghcb(void);
507 void early_snp_set_memory_private(unsigned long vaddr, unsigned long paddr,
508 unsigned long npages);
509 void early_snp_set_memory_shared(unsigned long vaddr, unsigned long paddr,
510 unsigned long npages);
511 void snp_set_memory_shared(unsigned long vaddr, unsigned long npages);
512 void snp_set_memory_private(unsigned long vaddr, unsigned long npages);
513 void snp_set_wakeup_secondary_cpu(void);
514 bool snp_init(struct boot_params *bp);
515 void __noreturn snp_abort(void);
516 void snp_dmi_setup(void);
517 int snp_issue_svsm_attest_req(u64 call_id, struct svsm_call *call, struct svsm_attest_call *input);
518 void snp_accept_memory(phys_addr_t start, phys_addr_t end);
519 u64 snp_get_unsupported_features(u64 status);
520 u64 sev_get_status(void);
521 void sev_show_status(void);
522 void snp_update_svsm_ca(void);
523 int prepare_pte_enc(struct pte_enc_desc *d);
524 void set_pte_enc_mask(pte_t *kpte, unsigned long pfn, pgprot_t new_prot);
525 void snp_kexec_finish(void);
526 void snp_kexec_begin(void);
528 int snp_msg_init(struct snp_msg_desc *mdesc, int vmpck_id);
529 struct snp_msg_desc *snp_msg_alloc(void);
530 void snp_msg_free(struct snp_msg_desc *mdesc);
531 int snp_send_guest_request(struct snp_msg_desc *mdesc, struct snp_guest_req *req,
532 struct snp_guest_request_ioctl *rio);
534 int snp_svsm_vtpm_send_command(u8 *buffer);
536 void __init snp_secure_tsc_prepare(void);
537 void __init snp_secure_tsc_init(void);
539 static __always_inline void vc_ghcb_invalidate(struct ghcb *ghcb)
541 ghcb->save.sw_exit_code = 0;
542 __builtin_memset(ghcb->save.valid_bitmap, 0, sizeof(ghcb->save.valid_bitmap));
545 void vc_forward_exception(struct es_em_ctxt *ctxt);
547 /* I/O parameters for CPUID-related helpers */
557 int snp_cpuid(struct ghcb *ghcb, struct es_em_ctxt *ctxt, struct cpuid_leaf *leaf);
559 void __noreturn sev_es_terminate(unsigned int set, unsigned int reason);
560 enum es_result sev_es_ghcb_hv_call(struct ghcb *ghcb,
561 struct es_em_ctxt *ctxt,
562 u64 exit_code, u64 exit_info_1,
565 extern struct ghcb *boot_ghcb;
567 #else /* !CONFIG_AMD_MEM_ENCRYPT */
570 static inline void sev_es_ist_enter(struct pt_regs *regs) { }
571 static inline void sev_es_ist_exit(void) { }
572 static inline int sev_es_setup_ap_jump_table(struct real_mode_header *rmh) { return 0; }
573 static inline void sev_es_nmi_complete(void) { }
574 static inline int sev_es_efi_map_ghcbs(pgd_t *pgd) { return 0; }
575 static inline void sev_enable(struct boot_params *bp) { }
576 static inline int pvalidate(unsigned long vaddr, bool rmp_psize, bool validate) { return 0; }
577 static inline int rmpadjust(unsigned long vaddr, bool rmp_psize, unsigned long attrs) { return 0; }
578 static inline void setup_ghcb(void) { }
579 static inline void __init
580 early_snp_set_memory_private(unsigned long vaddr, unsigned long paddr, unsigned long npages) { }
581 static inline void __init
582 early_snp_set_memory_shared(unsigned long vaddr, unsigned long paddr, unsigned long npages) { }
583 static inline void snp_set_memory_shared(unsigned long vaddr, unsigned long npages) { }
584 static inline void snp_set_memory_private(unsigned long vaddr, unsigned long npages) { }
585 static inline void snp_set_wakeup_secondary_cpu(void) { }
586 static inline bool snp_init(struct boot_params *bp) { return false; }
587 static inline void snp_abort(void) { }
588 static inline void snp_dmi_setup(void) { }
589 static inline int snp_issue_svsm_attest_req(u64 call_id, struct svsm_call *call, struct svsm_attest_call *input)
593 static inline void snp_accept_memory(phys_addr_t start, phys_addr_t end) { }
594 static inline u64 snp_get_unsupported_features(u64 status) { return 0; }
595 static inline u64 sev_get_status(void) { return 0; }
596 static inline void sev_show_status(void) { }
597 static inline void snp_update_svsm_ca(void) { }
598 static inline int prepare_pte_enc(struct pte_enc_desc *d) { return 0; }
599 static inline void set_pte_enc_mask(pte_t *kpte, unsigned long pfn, pgprot_t new_prot) { }
600 static inline void snp_kexec_finish(void) { }
601 static inline void snp_kexec_begin(void) { }
602 static inline int snp_msg_init(struct snp_msg_desc *mdesc, int vmpck_id) { return -1; }
603 static inline struct snp_msg_desc *snp_msg_alloc(void) { return NULL; }
604 static inline void snp_msg_free(struct snp_msg_desc *mdesc) { }
605 static inline int snp_send_guest_request(struct snp_msg_desc *mdesc, struct snp_guest_req *req,
606 struct snp_guest_request_ioctl *rio) { return -ENODEV; }
607 static inline int snp_svsm_vtpm_send_command(u8 *buffer) { return -ENODEV; }
608 static inline void __init snp_secure_tsc_prepare(void) { }
609 static inline void __init snp_secure_tsc_init(void) { }
611 #endif /* CONFIG_AMD_MEM_ENCRYPT */
613 #ifdef CONFIG_KVM_AMD_SEV
614 bool snp_probe_rmptable_info(void);
615 int snp_rmptable_init(void);
616 int snp_lookup_rmpentry(u64 pfn, bool *assigned, int *level);
617 void snp_dump_hva_rmpentry(unsigned long address);
619 int rmp_make_private(u64 pfn, u64 gpa, enum pg_level level, u32 asid, bool immutable);
620 int rmp_make_shared(u64 pfn, enum pg_level level);
621 void snp_leak_pages(u64 pfn, unsigned int npages);
622 void kdump_sev_callback(void);
623 void snp_fixup_e820_tables(void);
625 static inline bool snp_probe_rmptable_info(void) { return false; }
626 static inline int snp_rmptable_init(void) { return -ENOSYS; }
627 static inline int snp_lookup_rmpentry(u64 pfn, bool *assigned, int *level) { return -ENODEV; }
628 static inline void snp_dump_hva_rmpentry(unsigned long address) {}
629 static inline int psmash(u64 pfn) { return -ENODEV; }
630 static inline int rmp_make_private(u64 pfn, u64 gpa, enum pg_level level, u32 asid,
635 static inline int rmp_make_shared(u64 pfn, enum pg_level level) { return -ENODEV; }
636 static inline void snp_leak_pages(u64 pfn, unsigned int npages) {}
637 static inline void kdump_sev_callback(void) { }
638 static inline void snp_fixup_e820_tables(void) {}