Struct ProcessHandle 

pub struct ProcessHandle { /* private fields */ }

A handle to a running process.

This handle can be cloned and shared between threads. It provides methods for sending messages and managing process relationships.

Implementations

impl ProcessHandle

pub fn new( pid: Pid, sender: MailboxSender, state: Arc<RwLock<ProcessState>>, termination_tx: Option<Sender<ExitReason>>, ) -> Self

Creates a new process handle.

pub fn pid(&self) -> Pid

Returns the process identifier.

pub fn send_raw(&self, data: Vec<u8>) -> Result<(), SendError>

Sends a raw message (bytes) to the process.

pub fn send<M: Term>(&self, msg: &M) -> Result<(), SendError>

Sends a typed message to the process.

pub fn is_alive(&self) -> bool

Returns true if the process is still alive.

pub fn is_trapping_exits(&self) -> bool

Returns true if the process is trapping exits.

pub fn set_trap_exit(&self, trap: bool)

Sets the trap_exit flag.

pub fn add_link(&self, other: Pid)

Adds a link to another process.

Links are bidirectional - this only updates our side. The caller must also update the other process.

pub fn remove_link(&self, other: Pid)

Removes a link to another process.

pub fn links(&self) -> Vec<Pid>

Returns all linked processes.

pub fn add_monitor(&self, reference: Ref, target: Pid)

Adds a monitor (we are monitoring target).

pub fn remove_monitor(&self, reference: Ref) -> Option<Pid>

Removes a monitor.

pub fn add_monitored_by(&self, reference: Ref, monitoring_pid: Pid)

Adds a process that is monitoring us.

pub fn remove_monitored_by(&self, reference: Ref) -> Option<Pid>

Removes a process from our monitored_by set.

pub fn monitored_by(&self) -> Vec<(Ref, Pid)>

Returns all processes monitoring this one.

pub fn mark_terminated(&self, reason: ExitReason)

Marks the process as terminated.

pub fn exit_reason(&self) -> Option<ExitReason>

Returns the exit reason if the process has terminated.

Trait Implementations

impl Clone for ProcessHandle

fn clone(&self) -> ProcessHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProcessHandle

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

Formats the value using the given formatter.