Struct CitizenRegistry 

pub struct CitizenRegistry { /* private fields */ }

An explicit citizen registry built by naming the citizen types a crate owns.

Inventory remains available for ordinary host binaries, but strict gates and wasm/LTO builds can construct this registry directly with CitizenRegistry::register. That path references each citizen type in ordinary Rust code, so registration does not depend on link-time constructor retention.

Implementations

impl CitizenRegistry

pub fn new() -> Self

Builds an empty explicit registry.

pub fn from_inventory() -> Result<Self>

Builds an explicit registry from the current inventory rows.

This is useful when a caller wants the registry APIs, such as completeness checks or census rendering, while still using inventory as the discovery source.

pub fn register<T>(&mut self) -> Result<&mut Self>

where T: CitizenRuntime,

Registers the citizen metadata generated for T.

Calling this function is the DCE-safe path: the owning crate names every citizen type it expects to ship, and the registry is then loadable as a normal kernel Lib.

pub fn register_info(&mut self, info: CitizenInfo) -> Result<&mut Self>

Registers one citizen metadata row.

Duplicate symbols are rejected so an explicit registry cannot silently shadow two distinct Rust types behind one SIM class symbol.

pub fn citizens(&self) -> impl Iterator<Item = &CitizenInfo>

Iterates the citizen rows in this explicit registry.

pub fn len(&self) -> usize

Returns the number of citizen rows in this explicit registry.

pub fn is_empty(&self) -> bool

Reports whether this explicit registry has no citizen rows.

pub fn missing_symbols<'a>(&self, expected: &'a [&'a str]) -> Vec<&'a str>

Returns every expected symbol missing from this registry.

pub fn ensure_contains_symbols(&self, expected: &[&str]) -> Result<()>

Fails closed unless this registry contains every expected symbol.

pub fn install_all(&self, linker: &mut Linker<'_>) -> Result<()>

Installs every citizen row in this registry into linker.

pub fn install_namespace( &self, linker: &mut Linker<'_>, namespace: &str, ) -> Result<()>

Installs only the citizen rows whose symbols are in namespace.

Trait Implementations

impl Clone for CitizenRegistry

fn clone(&self) -> CitizenRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for CitizenRegistry

fn default() -> CitizenRegistry

Returns the “default value” for a type.

impl Lib for CitizenRegistry

fn manifest(&self) -> LibManifest

Returns the library’s manifest.

fn load(&self, _cx: &mut LoadCx, linker: &mut Linker<'_>) -> Result<()>

Registers the library’s exports against the registry via linker.

fn unload(&self, _cx: &mut Cx, _linker: &mut Linker<'_>) -> Result<(), Error>

Tears down external resources that cannot be represented in the registry’s recorded load delta.