Struct ServiceRecord 

pub struct ServiceRecord {

    pub protocol_major: u32,
    pub protocol_minor: u32,
    pub service: String,
    pub role: String,
    pub rank: u8,
    pub pid: u32,
    pub endpoint: String,
    pub version: String,
    pub started_ms: u64,
    pub process_started_ms: u64,
    pub engine_version: String,
    pub heartbeat_ms: u64,
    pub state: String,
}

<suite>/runtime/<service>/service.json.

A superset of HeardRight’s ServiceRecord (protocol_major, protocol_minor, role, pid, endpoint, engine_version): the fields HeardRight does not write default on read, and engine_version is written alongside version so an unchanged HeardRight client still parses a record written here.

Fields

protocol_major: u32

protocol_minor: u32

service: String

role: String

Product label of the host (HeardRight: heard_right_shell, …).

rank: u8

Lower rank wins the service. RANK_UNKNOWN when the writer gave none.

pid: u32

endpoint: String

Unix socket path or named-pipe name.

version: String

started_ms: u64

Publication time (ms since epoch) of this record. HeardRight-compatible meaning; never used to validate the PID.

process_started_ms: u64

Birth time of the owning process (ms since epoch), when the writer knows it. Only when present is it compared against the live process to reject a reused PID; records without it fall back to plain PID liveness.

engine_version: String

HeardRight’s name for version; mirrored so either reader works.

heartbeat_ms: u64

Last heartbeat of the host (ms since epoch), rewritten by ticker::spawn_record_heartbeat so a reader tells a live host from a dead one without connecting (rightkit#404). Zero when the host never beats; a reader then falls back to pid liveness.

state: String

The host’s coarse state ("ready", "draining", …), whatever the host publishes with its heartbeat. Empty when it publishes none. A label, never content.

Implementations

impl ServiceRecord

pub fn heartbeat_age_ms(&self, now_ms: u64) -> Option<u64>

Milliseconds since this host last beat, as of now_ms; None when it never beat.

pub fn host_version(&self) -> &str

The host version, from whichever field the writer used.

Trait Implementations

impl Clone for ServiceRecord

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServiceRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ServiceRecord

impl PartialEq for ServiceRecord

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ServiceRecord

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 ServiceRecord