Struct BpfMapWrite 

pub struct BpfMapWrite { /* private fields */ }

Host-side BPF map write performed during VM execution.

Applied by the host thread freeze_coord::start_bpf_map_write in three phases: build the guest-memory BPF-map accessor, resolve the field NAME to a byte offset via the target map’s program BTF, then write. After the writes the host pushes SIGNAL_BPF_WRITE_DONE through virtio-console (host_comms::request_bpf_map_write_done) so a guest scenario gated on Ctx::wait_for_map_write unblocks.

Construct with BpfMapWrite::new, which const-asserts the map_name_suffix format at compile time. Direct struct-literal construction is rejected (fields are crate-private) so every constructed BpfMapWrite passes through the format gate.

Implementations

impl BpfMapWrite

pub const fn new( map_name_suffix: &'static str, field: &'static str, value: u32, ) -> Self

Const constructor for use in static/const context.

Panics

Panics at compile time (or const-eval time) when:

• map_name_suffix is empty
• map_name_suffix does not start with . (BPF map names are derived from ELF section names like .bss, .data, .rodata; a suffix without the leading . would never match any loaded map and is almost certainly a typo)
• map_name_suffix is a bare . or starts with .. (no real BPF section name has that shape)
• map_name_suffix contains whitespace, /, \, or any non-printable / control byte (no real BPF map name carries those characters; NULL would truncate libbpf C-string comparison)
• field is empty (it names the VAR to write — a bare .bss/.data global like "crash", or a dot-path into the value struct; the byte offset is resolved from the map’s BTF value type at write time, so a raw offset can never land in struct padding)
• field starts or ends with ., or contains .. (an empty path segment the BTF resolver could never match)
• field contains whitespace, /, \, or any non-printable / control byte (no real BTF VAR name carries those characters)

pub const fn map_name_suffix(&self) -> &'static str

The validated map-name suffix to match against loaded BPF maps (e.g. ".bss").

pub const fn field(&self) -> &'static str

The field to write within the matched map’s value region: a bare BTF VAR name (e.g. "crash") or a dot-path into the value struct (e.g. "sys_stat.avg_lat_cri"). The byte offset is resolved from the map’s BTF value type at write time.

pub const fn value(&self) -> u32

u32 value to write into field inside the matched map.

Trait Implementations

impl Clone for BpfMapWrite

fn clone(&self) -> BpfMapWrite

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BpfMapWrite

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

Formats the value using the given formatter.

impl Hash for BpfMapWrite

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BpfMapWrite

fn eq(&self, other: &BpfMapWrite) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for BpfMapWrite

impl Eq for BpfMapWrite

impl StructuralPartialEq for BpfMapWrite