Struct Metadata 

pub struct Metadata { /* private fields */ }

The daemon’s daemon.json record as this image holds it, and the writes of it: the start write, Self::publish (reload, and the restore after a failed exec), Self::heal (Ping) and Self::cleanup (shutdown).

One metadata lock serializes them all: each changes the held record and writes the files inside the same critical section, so a heal can never write a record older than the one held, and after the cleanup nothing writes the files back. Lock order: a caller that also holds the daemon’s lock_fd mutex (heal, cleanup) takes that first. The lock is never held across an await.

Implementations

impl Metadata

pub fn start(paths: DaemonPaths, info: DaemonInfo) -> Result<Self>

Hold info and write it (the start write).

pub fn info(&self) -> DaemonInfo

The record this image holds (a copy).

pub fn publish(&self, info: DaemonInfo) -> Result<()>

Hold info and write it, under the metadata lock. After the cleanup it is only held.

pub fn heal(&self, lock: &DaemonLock) -> Result<Healed>

heal_daemon_json with the held record, under the metadata lock; counts the heal for the INFO line’s rate limit.

pub fn cleanup(&self, lock: &DaemonLock) -> bool

[cleanup_metadata] (shutdown), under the metadata lock; no later publish or heal writes the files.