Struct DaemonProcess 

pub struct DaemonProcess {
    pub pid: u32,
    pub exe_path: PathBuf,
    pub 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_sha256: [u8; 32]

SHA-256 of the daemon executable.

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 SHA-256 value as bytes for the wire schema.

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.