Struct IgvmLoader 

pub struct IgvmLoader<R: VbsRegister + GuestArch> {

    accepted_ranges: RangeMap<u64, RangeInfo>,
    relocatable_regions: RangeMap<u64, RelocationType>,
    required_memory: Vec<RequiredMemory>,
    page_table_region: Option<PageTableRegion>,
    platform_header: IgvmPlatformHeader,
    initialization_headers: Vec<IgvmInitializationHeader>,
    directives: Vec<IgvmDirectiveHeader>,
    page_data_directives: Vec<IgvmDirectiveHeader>,
    vp_context: Option<Box<dyn VpContextBuilder<Register = R>>>,
    max_vtl: Vtl,
    parameter_areas: BTreeMap<(u64, u32), u32>,
    isolation_type: LoaderIsolationType,
    paravisor_present: bool,
    imported_regions_config_page: Option<u64>,
    expected_page_hashes_config_page: Option<u64>,
    snp_linux_direct: Option<SnpLinuxDirectConfig>,
}

Fields

accepted_ranges: RangeMap<u64, RangeInfo>

relocatable_regions: RangeMap<u64, RelocationType>

required_memory: Vec<RequiredMemory>

page_table_region: Option<PageTableRegion>

platform_header: IgvmPlatformHeader

initialization_headers: Vec<IgvmInitializationHeader>

directives: Vec<IgvmDirectiveHeader>

page_data_directives: Vec<IgvmDirectiveHeader>

vp_context: Option<Box<dyn VpContextBuilder<Register = R>>>

max_vtl: Vtl

parameter_areas: BTreeMap<(u64, u32), u32>

isolation_type: LoaderIsolationType

paravisor_present: bool

imported_regions_config_page: Option<u64>

expected_page_hashes_config_page: Option<u64>

snp_linux_direct: Option<SnpLinuxDirectConfig>

Implementations

impl IgvmLoader<X86Register>

pub fn new_snp_linux_direct(config: SnpLinuxDirectConfig) -> Self

Create a loader for a self-contained SNP Linux-direct image.

impl<R: IgvmLoaderRegister + GuestArch + 'static> IgvmLoader<R>

pub fn new(with_paravisor: bool, isolation_type: LoaderIsolationType) -> Self

fn finalize_snp_linux_direct( &mut self, config: SnpLinuxDirectConfig, ) -> Result<()>

Adds the fixed-memory contract required by a self-contained Linux-direct image.

The generic Linux loader imports only the pages that contain boot data and does not call verify_startup_memory_available. UEFI and paravisor loaders use that callback to emit their required-memory directives, but a direct Linux IGVM must describe its complete startup RAM here. When requested, this also imports every otherwise-unused RAM page as measured zero data. The caller then places the BSP VMSA after those page updates.

fn generate_cryptographic_hashes_of_shared_pages( &mut self, ) -> (Vec<u8>, Vec<ExpectedPageHash>)

Compute both the combined SHA-384 over all shared (unmeasured) pages (matching the value stored in ImportedRegionsPageHeader::sha384_hash) and a per-page array of SHA-384s (one entry per 4 KB shared page, in ascending-GPA order) suitable for the expected-page-hashes region.

The per-page array is what the boot shim uses to identify which individual pages diverged from the measured baseline on a hash mismatch.

pub fn finalize(self) -> Result<IgvmOutput>

Finalize the loader state, returning an IGVM file.

fn accept_new_range( &mut self, page_base: u64, page_count: u64, tag: &str, acceptance: BootPageAcceptance, ) -> Result<()>

Accept a new page range with a given acceptance into the map of accepted ranges.

fn imported_regions(&self) -> Vec<ImportedRegionDescriptor>

pub fn arch(&self) -> GuestArchKind

The guest architecture used by this loader.

pub fn next_available_gpa(&self) -> Result<u64>

Returns the first GPA after all imported page-data directives.

pub fn unimported_ram_ranges( &self, additional_imported_pages: impl IntoIterator<Item = u64>, ) -> Result<Vec<Range<u64>>>

Returns unimported RAM page ranges for an SNP Linux-direct image.

pub fn loader(&mut self) -> IgvmVtlLoader<'_, R>

fn import_pages( &mut self, page_base: u64, page_count: u64, debug_tag: &'static str, acceptance: BootPageAcceptance, data: &[u8], ) -> Result<(), Error>