Struct PidRecord 

pub struct PidRecord {
    pub pid: u32,
    pub started_at_unix_secs: u64,
    pub binary_sha256: String,
    pub version: String,
    pub commit: String,
    pub http_address: SocketAddr,
    pub grpc_address: SocketAddr,
    pub drain_timeout_seconds: u64,
}

The pid file’s content: one JSON object describing the server incarnation that claimed the home.

Fields

pid: u32

Operating-system process id of the serving process.

started_at_unix_secs: u64

The process start instant in whole seconds since the Unix epoch, read through the process-table instrument (sysinfo) at boot. Verifiers compare this against the SAME instrument’s answer for the live pid, so the check is exact equality, not clock arithmetic: a reused pid wears a different start instant.

binary_sha256: String

SHA-256 of the serving binary’s bytes, hashed from the executable path at boot. This records WHICH build claimed the home; it is not a liveness discriminator (an upgrade that swaps the binary by rename changes the file on disk while the process keeps its old image).

version: String

Crate version of the serving binary (CARGO_PKG_VERSION at build).

commit: String

Source commit of the serving binary, from crate::build_identity::BuildIdentity.

http_address: SocketAddr

HTTP address the server actually bound — recorded so status probes the running server’s own listener even when the config file has been edited since boot.

grpc_address: SocketAddr

gRPC address the server actually bound, recorded for the same reason.

drain_timeout_seconds: u64

The drain window this incarnation is actually running with, in whole seconds — recorded for the same reason as the addresses: the running server’s window may have come from its own command line (--drain-timeout) or from a config file edited since boot, and a stop verb that waited out a re-derived value would misreport a healthy long drain as “still draining” (or force it on a second invocation). Defaulted on read (module-header ruling): a record written by a build that predates this field reads as 0, which patience resolution treats as “no recorded window” and falls through to config.

Trait Implementations

impl Clone for PidRecord

fn clone(&self) -> PidRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PidRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PidRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PidRecord

impl PartialEq for PidRecord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PidRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PidRecord