arch/powerpc/kvm/guest-state-buffer.c

Source file repositories/reference/linux-study-clean/arch/powerpc/kvm/guest-state-buffer.c

File Facts

System: Linux kernel
Corpus path: arch/powerpc/kvm/guest-state-buffer.c
Extension: .c
Size: 15045 bytes
Lines: 661
Domain: Architecture Layer
Bucket: arch/powerpc
Inferred role: Architecture Layer: exported/initcall integration point
Status: integration implementation candidate

Why This File Exists

CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.

CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
Allocates kernel memory; connect allocation flags and lifetime to context constraints.
Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

asm/hvcall.h
linux/log2.h
asm/pgalloc.h
asm/guest-state-buffer.h

Detected Declarations

function kvmppc_gsb_new
function kvmppc_gsb_free
function kvmppc_gsb_put
function kvmppc_gsid_class
function kvmppc_gsid_type
function kvmppc_gsid_flags
function kvmppc_gsid_size
function kvmppc_gsid_mask
function __kvmppc_gse_put
function kvmppc_gse_parse
function kvmppc_gsb_for_each_elem
function kvmppc_gse_flatten_iden
function kvmppc_gse_unflatten_iden
function kvmppc_gsp_insert
function kvmppc_gsp_lookup
function kvmppc_gsbm_set
function kvmppc_gsbm_clear
function kvmppc_gsbm_test
function kvmppc_gsbm_next
function kvmppc_gsm_init
function kvmppc_gsm_new
function kvmppc_gsm_size
function kvmppc_gsm_free
function kvmppc_gsm_fill_info
function kvmppc_gsm_refresh_info
function kvmppc_gsb_send
function kvmppc_gsb_recv
export kvmppc_gsb_new
export kvmppc_gsb_free
export kvmppc_gsb_put
export kvmppc_gsid_flags
export kvmppc_gsid_size
export kvmppc_gsid_mask
export __kvmppc_gse_put
export kvmppc_gse_parse
export kvmppc_gsp_insert
export kvmppc_gsp_lookup
export kvmppc_gsbm_set
export kvmppc_gsbm_clear
export kvmppc_gsbm_test
export kvmppc_gsbm_next
export kvmppc_gsm_init
export kvmppc_gsm_new
export kvmppc_gsm_size
export kvmppc_gsm_free
export kvmppc_gsm_fill_info
export kvmppc_gsm_refresh_info
export kvmppc_gsb_send

Annotated Snippet

switch (iden) {
		case KVMPPC_GSID_L0_GUEST_HEAP:
			fallthrough;
		case KVMPPC_GSID_L0_GUEST_HEAP_MAX:
			fallthrough;
		case KVMPPC_GSID_L0_GUEST_PGTABLE_SIZE:
			fallthrough;
		case KVMPPC_GSID_L0_GUEST_PGTABLE_SIZE_MAX:
			fallthrough;
		case KVMPPC_GSID_L0_GUEST_PGTABLE_RECLAIM:
			type = KVMPPC_GSE_BE64;
			break;
		}
		break;
	case KVMPPC_GS_CLASS_GUESTWIDE:
		switch (iden) {
		case KVMPPC_GSID_HOST_STATE_SIZE:
		case KVMPPC_GSID_RUN_OUTPUT_MIN_SIZE:
		case KVMPPC_GSID_TB_OFFSET:
			type = KVMPPC_GSE_BE64;
			break;
		case KVMPPC_GSID_PARTITION_TABLE:
			type = KVMPPC_GSE_PARTITION_TABLE;
			break;
		case KVMPPC_GSID_PROCESS_TABLE:
			type = KVMPPC_GSE_PROCESS_TABLE;
			break;
		case KVMPPC_GSID_LOGICAL_PVR:
			type = KVMPPC_GSE_BE32;
			break;
		}
		break;
	case KVMPPC_GS_CLASS_META:
		switch (iden) {
		case KVMPPC_GSID_RUN_INPUT:
		case KVMPPC_GSID_RUN_OUTPUT:
			type = KVMPPC_GSE_BUFFER;
			break;
		case KVMPPC_GSID_VPA:
			type = KVMPPC_GSE_BE64;
			break;
		}
		break;
	case KVMPPC_GS_CLASS_DWORD_REG:
		type = KVMPPC_GSE_BE64;
		break;
	case KVMPPC_GS_CLASS_WORD_REG:
		type = KVMPPC_GSE_BE32;
		break;
	case KVMPPC_GS_CLASS_VECTOR:
		type = KVMPPC_GSE_VEC128;
		break;
	case KVMPPC_GS_CLASS_INTR:
		switch (iden) {
		case KVMPPC_GSID_HDAR:
		case KVMPPC_GSID_ASDR:
		case KVMPPC_GSID_HEIR:
			type = KVMPPC_GSE_BE64;
			break;
		case KVMPPC_GSID_HDSISR:
			type = KVMPPC_GSE_BE32;
			break;
		}
		break;
	}

	return type;
}

/**
 * kvmppc_gsid_flags() - the flags for a guest state ID
 * @iden: guest state ID
 *
 * Returns any flags for the guest state ID.
 */
unsigned long kvmppc_gsid_flags(u16 iden)
{
	unsigned long flags = 0;

	switch (kvmppc_gsid_class(iden)) {
	case KVMPPC_GS_CLASS_GUESTWIDE:
		flags = KVMPPC_GS_FLAGS_WIDE;
		break;
	case KVMPPC_GS_CLASS_HOSTWIDE:
		flags = KVMPPC_GS_FLAGS_HOST_WIDE;
		break;
	case KVMPPC_GS_CLASS_META:
	case KVMPPC_GS_CLASS_DWORD_REG:
	case KVMPPC_GS_CLASS_WORD_REG:
	case KVMPPC_GS_CLASS_VECTOR:

Annotation

Immediate include surface: `asm/hvcall.h`, `linux/log2.h`, `asm/pgalloc.h`, `asm/guest-state-buffer.h`.
Detected declarations: `function kvmppc_gsb_new`, `function kvmppc_gsb_free`, `function kvmppc_gsb_put`, `function kvmppc_gsid_class`, `function kvmppc_gsid_type`, `function kvmppc_gsid_flags`, `function kvmppc_gsid_size`, `function kvmppc_gsid_mask`, `function __kvmppc_gse_put`, `function kvmppc_gse_parse`.
Atlas domain: Architecture Layer / arch/powerpc.
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.