include/linux/psp-sev.h

File Facts

System

Linux kernel

Corpus path

include/linux/psp-sev.h

Extension

.h

Size

32093 bytes

Lines

1134

Domain

Core OS

Bucket

Core Kernel Interface

Inferred role

Core OS: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.

• Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• uapi/linux/psp-sev.h

Detected Declarations

• struct sev_data_init
• struct sev_data_init_ex
• struct sev_data_pek_csr
• struct sev_data_pek_cert_import
• struct sev_data_download_firmware
• struct sev_data_get_id
• struct sev_data_pdh_cert_export
• struct sev_data_decommission
• struct sev_data_activate
• struct sev_data_deactivate
• struct sev_data_guest_status
• struct sev_data_launch_start
• struct sev_data_launch_update_data
• struct sev_data_launch_update_vmsa
• struct sev_data_launch_measure
• struct sev_data_launch_secret
• struct sev_data_launch_finish
• struct sev_data_send_start
• struct sev_data_send_update_data
• struct sev_data_send_update_vmsa
• struct sev_data_send_finish
• struct sev_data_send_cancel
• struct sev_data_receive_start
• struct sev_data_receive_update_data
• struct sev_data_receive_update_vmsa
• struct sev_data_receive_finish
• struct sev_data_dbg
• struct sev_data_attestation_report
• struct sev_data_snp_download_firmware
• struct sev_data_snp_activate
• struct sev_data_snp_addr
• struct sev_data_snp_launch_start
• struct sev_data_snp_launch_update
• struct sev_data_snp_launch_finish
• struct sev_data_snp_guest_status
• struct sev_data_snp_page_reclaim
• struct sev_data_snp_page_unsmash
• struct sev_data_snp_dbg
• struct sev_data_snp_guest_request
• struct sev_data_snp_init_ex
• struct sev_data_range
• struct sev_data_range_list
• struct sev_data_snp_shutdown_ex
• struct sev_platform_init_args
• struct sev_data_snp_commit
• struct sev_data_snp_feature_info
• struct snp_feature_info
• struct sev_snp_tcb_version_genoa_milan

Annotated Snippet

struct sev_data_init {
	u32 flags;			/* In */
	u32 reserved;			/* In */
	u64 tmr_address;		/* In */
	u32 tmr_len;			/* In */
} __packed;

/**
 * struct sev_data_init_ex - INIT_EX command parameters
 *
 * @length: len of the command buffer read by the PSP
 * @flags: processing flags
 * @tmr_address: system physical address used for SEV-ES
 * @tmr_len: len of tmr_address
 * @nv_address: system physical address used for PSP NV storage
 * @nv_len: len of nv_address
 */
struct sev_data_init_ex {
	u32 length;                     /* In */
	u32 flags;                      /* In */
	u64 tmr_address;                /* In */
	u32 tmr_len;                    /* In */
	u32 reserved;                   /* In */
	u64 nv_address;                 /* In/Out */
	u32 nv_len;                     /* In */
} __packed;

#define SEV_INIT_FLAGS_SEV_ES	0x01

/**
 * struct sev_data_pek_csr - PEK_CSR command parameters
 *
 * @address: PEK certificate chain
 * @len: len of certificate
 */
struct sev_data_pek_csr {
	u64 address;				/* In */
	u32 len;				/* In/Out */
} __packed;

/**
 * struct sev_data_cert_import - PEK_CERT_IMPORT command parameters
 *
 * @pek_address: PEK certificate chain
 * @pek_len: len of PEK certificate
 * @oca_address: OCA certificate chain
 * @oca_len: len of OCA certificate
 */
struct sev_data_pek_cert_import {
	u64 pek_cert_address;			/* In */
	u32 pek_cert_len;			/* In */
	u32 reserved;				/* In */
	u64 oca_cert_address;			/* In */
	u32 oca_cert_len;			/* In */
} __packed;

/**
 * struct sev_data_download_firmware - DOWNLOAD_FIRMWARE command parameters
 *
 * @address: physical address of firmware image
 * @len: len of the firmware image
 */
struct sev_data_download_firmware {
	u64 address;				/* In */
	u32 len;				/* In */
} __packed;

/**
 * struct sev_data_get_id - GET_ID command parameters
 *
 * @address: physical address of region to place unique CPU ID(s)
 * @len: len of the region
 */
struct sev_data_get_id {
	u64 address;				/* In */
	u32 len;				/* In/Out */
} __packed;
/**
 * struct sev_data_pdh_cert_export - PDH_CERT_EXPORT command parameters
 *
 * @pdh_address: PDH certificate address
 * @pdh_len: len of PDH certificate
 * @cert_chain_address: PDH certificate chain
 * @cert_chain_len: len of PDH certificate chain
 */
struct sev_data_pdh_cert_export {
	u64 pdh_cert_address;			/* In */
	u32 pdh_cert_len;			/* In/Out */
	u32 reserved;				/* In */
	u64 cert_chain_address;			/* In */

Annotation

• Immediate include surface: `uapi/linux/psp-sev.h`.
• Detected declarations: `struct sev_data_init`, `struct sev_data_init_ex`, `struct sev_data_pek_csr`, `struct sev_data_pek_cert_import`, `struct sev_data_download_firmware`, `struct sev_data_get_id`, `struct sev_data_pdh_cert_export`, `struct sev_data_decommission`, `struct sev_data_activate`, `struct sev_data_deactivate`.
• Atlas domain: Core OS / Core Kernel Interface.
• Implementation status: integration implementation candidate.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.