Struct PoolSection 

pub struct PoolSection {
    pub name: String,
    pub zones: Vec<String>,
    pub labels: Option<String>,
    pub names: Option<String>,
}

One named source of names: the zones and labels it holds, and how it makes a name. See plan/pools.md.

A pool says how names are made, never who may take them: that is the operator’s account.create policy. With no [[pool]], each zone in [zone] zones is a pool named after itself, in zone order.

Reasonable range: 1 to 20 pools. Each create with no pool of its own asks policy about each pool’s zones in turn, so a long list is a longer walk before a refusal.

Reload: needs a restart. A changed pool applies to later creates; a DID already minted keeps its name.

Fields

name: String

What a create’s pool and a policy’s resource.pool call this pool. One DNS label, and no two pools share one.

zones: Vec<String>

The zones the pool holds names under, each one of [zone] zones, in the order it fills them: a create lands in the first one policy permits.

Reasonable range: 1 to 20 zones, and never more than the server serves.

labels: Option<String>

Which labels under those zones the pool holds: one *, with optional literal text on either side. ci-* holds ci-7 and not kestrel, and wraps each name the pool makes: ci-basalt-otter. Unset is *, every label.

Reasonable values: *, or a short prefix or suffix such as ci-*. Every character of literal text is one fewer for the scheme in a 63-byte label.

names: Option<String>

How the pool makes a name, in the spellings [names] spec takes. A braced part, such as {repo} in {repo}+n, is a slot each create fills with a fragment. Unset takes [names] spec, or mineral+creature when that is hostname.

Reasonable values: a word-list spec for names people say aloud, or a spec with n for a pool that must never run out. --help says what each spelling discloses.

Trait Implementations

impl Clone for PoolSection

fn clone(&self) -> PoolSection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PoolSection

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

Formats the value using the given formatter.

impl Default for PoolSection

fn default() -> PoolSection

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PoolSection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PoolSection

fn eq(&self, other: &PoolSection) -> 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 Serialize for PoolSection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PoolSection

impl StructuralPartialEq for PoolSection