Struct DaemonProcess 

pub struct DaemonProcess {
    pub pid: u32,
    pub exe_path: PathBuf,
    pub exe_hash: [u8; 32],
    pub legacy_exe_sha256: [u8; 32],
    pub boot_id: String,
    pub ipc_endpoint: Endpoint,
    pub started_at_unix_ms: u64,
    pub idle_timeout_secs: Option<u32>,
}

A backend daemon identity with fixed-width fields suitable for verification.

This mirrors CacheManifest.current_daemon, but normalizes protobuf strings and byte vectors into path and digest types that are harder to misuse.

Persist this value only after the daemon has selected its final IPC endpoint and executable. Later consumers can pass the same identity to crate::broker::backend_handle::BackendHandle::probe or store it as CacheManifest.current_daemon.

use running_process::broker::backend_handle::DaemonProcess;
use running_process::broker::protocol::{CacheManifest, Endpoint};

let endpoint = Endpoint {
    namespace_id: "host-namespace".to_owned(),
    path: "running-process-backend.sock".to_owned(),
};
let daemon = DaemonProcess::current_process(endpoint, Some(600))?;

manifest.current_daemon = Some(daemon.to_proto());

Fields

pid: u32

Operating-system process ID.

exe_path: PathBuf

Executable path recorded when the daemon identity was written.

exe_hash: [u8; 32]

BLAKE3 content hash of the daemon executable.

legacy_exe_sha256: [u8; 32]

SHA-256 digest retained on the v1 wire for pre-BLAKE3 stable brokers.

boot_id: String

Host boot ID observed when the daemon started.

ipc_endpoint: Endpoint

IPC endpoint used to connect to the daemon.

started_at_unix_ms: u64

Daemon start timestamp in Unix milliseconds.

idle_timeout_secs: Option<u32>

Optional idle timeout advertised by the daemon.

Implementations

impl DaemonProcess

pub fn current_process( ipc_endpoint: Endpoint, idle_timeout_secs: Option<u32>, ) -> Result<Self, IdentityError>

Build a daemon identity for the current process.

This is primarily useful for tests and direct-daemon consumers that have just spawned a backend and need to persist a manifest entry.

The executable digest is taken from std::env::current_exe() at the time this method runs. If a daemon relocates or replaces its executable after startup, record the final identity after relocation instead.

pub fn to_proto(&self) -> DaemonProcess

Convert this identity into the protobuf form stored in CacheManifest.

The conversion preserves the fixed-width BLAKE3 value as bytes and names its algorithm explicitly on the wire.

pub fn encode_probe_identity( &self, output: &mut Vec<u8>, ) -> Result<(), EncodeError>

Encode a daemon identity for an endpoint probe.

Tag 3 remains reserved in the current protobuf schema, but stable pre-BLAKE3 brokers still decode it as the executable SHA-256. Preserve their read path by appending that historical unknown field after the canonical BLAKE3 message. Current protobuf readers safely ignore it.

pub fn from_manifest_current_daemon( manifest: &CacheManifest, ) -> Result<Option<Self>, IdentityError>

Read and normalize CacheManifest.current_daemon.

Returns Ok(None) when the manifest has no daemon entry. Malformed entries, such as a missing endpoint or non-32-byte executable digest, return an IdentityError.

Trait Implementations

impl Clone for DaemonProcess

fn clone(&self) -> DaemonProcess

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DaemonProcess

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DaemonProcess

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DaemonProcess

impl From<&DaemonProcess> for DaemonProcess

fn from(value: &DaemonProcess) -> Self

Converts to this type from the input type.

impl PartialEq for DaemonProcess

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DaemonProcess

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 DaemonProcess

impl TryFrom<DaemonProcess> for DaemonProcess

type Error = IdentityError

The type returned in the event of a conversion error.

fn try_from(value: DaemonProcess) -> Result<Self, Self::Error>

Performs the conversion.