Struct PidFileGuard 

pub struct PidFileGuard { /* private fields */ }

Removes the pid file on drop — but only while the file still holds this guard’s INCARNATION, so a lingering guard can never delete a successor’s claim.

Implementations

impl PidFileGuard

pub fn reconciliation(&self) -> &StaleReconciliation

What the birth claim found and reconciled when this guard was created.

pub fn record(&self) -> Result<PidRecord, ServerError>

A copy of this incarnation’s record as last written.

Errors

Returns ServerError::PidFile when the in-process record lock is poisoned — a panic inside a previous update, which leaves the copy’s agreement with the file unproven.

pub fn holds_claim(&self) -> bool

Whether this guard’s incarnation holds the home’s claim. False for a server that booted UNCLAIMED over another live claimant’s record (StaleReconciliation::LiveIncarnationElsewhere): the control verbs address the recorded server, not this one.

pub fn update_own( &self, change: impl FnOnce(&mut PidRecord), ) -> Result<RecordUpdate, ServerError>

Apply change to this incarnation’s own record and write it.

Errors

Returns ServerError::PidFile when the mutation lock cannot be taken, the file cannot be read, or the write fails. A record that no longer belongs to this incarnation is NOT an error — it is RecordUpdate::NotOurs, reported and skipped.

pub fn stage_reporter(&self) -> StageReporter

A cheap, cloneable handle for reporting boot stages from anywhere — including a blocking closure on another thread.

Trait Implementations

impl Debug for PidFileGuard

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

Formats the value using the given formatter.

impl Drop for PidFileGuard

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.