Struct Allocation 

pub struct Allocation {
    pub amount: i64,
    pub tag: Option<String>,
}

What a parent hands to a child: an amount out of its own balance, and optionally the unit the child’s ledger names it by.

Not a BudgetGrant, and the difference is where the units come from. A grant is an owner allowing — it raises a balance out of nothing the kernel can see, and only an owner may write one. An allocation moves units that already exist: the parent’s balance falls by exactly what the child’s rises by, in one transaction (super::Session::open_child), so no total is created and none is lost.

There is no desc. What an allocation is for is a supervisor’s vocabulary, and the two events it writes already say the whole of what the kernel knows: which parent, which child, how much.

tag defaults to the parent’s — the units come out of that ledger, so they are counted in that unit unless the caller renames them for the child.

Fields

amount: i64

How much of the parent’s balance to move. Non-negative.

tag: Option<String>

The unit the child’s ledger names, or the parent’s when absent.

Implementations

impl Allocation

pub fn new(amount: i64) -> Self

An allocation of amount, counted in the parent’s own unit.

Trait Implementations

impl Clone for Allocation

fn clone(&self) -> Allocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Allocation

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

Formats the value using the given formatter.

impl Eq for Allocation

impl PartialEq for Allocation

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Allocation