Struct L1Table

pub(super) struct L1Table {
    cluster: Option<HostCluster>,
    data: Box<[L1Entry]>,
    cluster_bits: u32,
    modified: AtomicBool,
}

L1 table.

Fields

cluster: Option<HostCluster>

First cluster in the image file.

data: Box<[L1Entry]>

Table data.

cluster_bits: u32

log2 of the cluster size.

modified: AtomicBool

Whether this table has been modified since it was last written.

Implementations

impl L1Table

pub fn clone_and_grow( &self, at_least_index: usize, header: &Header, ) -> Result<Self>

Create a clone that covers at least at_least_index.

pub fn in_bounds(&self, index: usize) -> bool

Check whether index is in bounds.

pub fn enter_l2_table(&mut self, index: usize, l2: &L2Table) -> Result<()>

Enter the given L2 table into this L1 table.

Trait Implementations

impl Debug for L1Table

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Table for L1Table

const MAX_ENTRIES: usize = 4_194_304usize

Maximum number of L1 table entries.

Limit taken from QEMU; if QEMU rejects this, we can, too.

const NAME: &'static str = "L1 table"

User-readable struct name.

type InternalEntry = L1Entry

Internal type for each table entry.

type Entry = L1Entry

Externally visible type for each table entry.

fn from_data(data: Box<[L1Entry]>, header: &Header) -> Self

Create a new table with the given contents

fn entries(&self) -> usize

Number of entries.

fn get_ref(&self, index: usize) -> Option<&L1Entry>

Get the given entry (as reference).

fn get(&self, index: usize) -> L1Entry

Get the given entry (copied).

fn get_cluster(&self) -> Option<HostCluster>

Get this table’s (first) cluster in the image file.

fn get_offset(&self) -> Option<HostOffset>

Get this table’s offset in the image file.

fn set_cluster(&mut self, cluster: HostCluster)

Set this table’s (first) cluster in the image file (for writing).

fn unset_cluster(&mut self)

Remove the table’s association with any cluster in the image file.

fn is_modified(&self) -> bool

Check whether this table has been modified since it was last written.

fn clear_modified(&self)

Clear the modified flag.

fn set_modified(&self)

Set the modified flag.

fn cluster_bits(&self) -> u32

Return log2 of the cluster size.

fn byte_size(&self) -> usize

Table size in bytes.

fn cluster_count(&self) -> ClusterCount

Number of clusters used by this table.

async fn load<S: Storage>( image: &S, header: &Header, cluster: HostCluster, entries: usize, ) -> Result<Self>

Load a table from the image file.

async fn write<S: Storage>(&self, image: &S) -> Result<()>

Write a table to the image file.

async fn write_entry<S: Storage>(&self, image: &S, index: usize) -> Result<()>

Write at least the given single (modified) entry to the image file.