Struct Beacon 

pub struct Beacon {
    pub pid: i32,
    pub root: PathBuf,
    pub start_time: u64,
    pub status: String,
    pub last_event_at: u64,
    pub socket_path: Option<PathBuf>,
}

A heartbeat file written by the ixd daemon so other processes can detect a running watcher and query its status.

Fields

pid: i32

PID of the ixd daemon process.

root: PathBuf

Canonical root directory being watched.

start_time: u64

Unix timestamp (seconds) when the daemon started.

status: String

Human-readable status (e.g. "idle", "indexing").

last_event_at: u64

Unix timestamp (seconds) of the last filesystem event.

socket_path: Option<PathBuf>

Path to the Unix domain socket for real-time notifications.

Implementations

impl Beacon

pub fn new(root: &Path) -> Self

Create a new beacon for the current process, anchored at the given root.

pub fn is_live(&self) -> bool

Check whether the daemon described by this beacon is still running.

Verifies the recorded PID still exists, belongs to an ixd binary, and the watched root directory is still accessible.

pub fn write_to(&self, folder: &Path) -> Result<()>

Write the beacon to beacon.json in the given folder.

Errors

Returns an error if the file cannot be created or serialization fails.

pub fn read_from(folder: &Path) -> Result<Self>

Read a beacon from beacon.json in the given folder.

Errors

Returns an error if the file cannot be opened or deserialization fails.

Trait Implementations

impl Clone for Beacon

fn clone(&self) -> Beacon

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Beacon

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Beacon

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Beacon

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

where __S: Serializer,

Serialize this value into the given Serde serializer.