Enum SystemMessage 

pub enum SystemMessage {
    Exit {
        from: Pid,
        reason: ExitReason,
    },
    Down {
        monitor_ref: Ref,
        pid: Pid,
        reason: ExitReason,
    },
    Timeout,
}

System-level messages delivered to processes.

These messages are generated by the runtime in response to process lifecycle events. They are distinct from user-defined messages and are handled specially by abstractions like GenServer.

Examples

use starlang_core::{SystemMessage, ExitReason, Pid, Ref};

// Exit signal from a linked process
let exit = SystemMessage::Exit {
    from: Pid::new(),
    reason: ExitReason::Normal,
};

// DOWN notification from a monitored process
let down = SystemMessage::Down {
    monitor_ref: Ref::from_raw(42),
    pid: Pid::new(),
    reason: ExitReason::Error("crashed".to_string()),
};

// Timeout notification
let timeout = SystemMessage::Timeout;

Variants

Exit

Exit signal from a linked process.

When a linked process terminates, an Exit message is sent to all processes linked to it (if they have trap_exit enabled).

If trap_exit is disabled, the receiving process will also terminate with the same reason (unless the reason is Normal).

Fields

from: Pid

The process that exited.

reason: ExitReason

The reason for termination.

Down

Monitor notification that a monitored process terminated.

Unlike exit signals, DOWN messages are always delivered as messages and never cause the receiving process to terminate.

Fields

monitor_ref: Ref

The reference returned when the monitor was created.

pid: Pid

The process that was being monitored.

reason: ExitReason

The reason for termination.

Timeout

Timeout notification.

Delivered when a receive timeout expires or when a GenServer’s timeout period elapses without receiving any messages.

Implementations

impl SystemMessage

pub fn exit(from: Pid, reason: ExitReason) -> SystemMessage

Creates a new Exit message.

pub fn down(monitor_ref: Ref, pid: Pid, reason: ExitReason) -> SystemMessage

Creates a new Down message.

pub fn is_exit(&self) -> bool

Returns true if this is an Exit message.

pub fn is_down(&self) -> bool

Returns true if this is a Down message.

pub fn is_timeout(&self) -> bool

Returns true if this is a Timeout message.

Trait Implementations

impl Clone for SystemMessage

fn clone(&self) -> SystemMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SystemMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SystemMessage

fn deserialize<__D>( __deserializer: __D, ) -> Result<SystemMessage, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SystemMessage

impl PartialEq for SystemMessage

fn eq(&self, other: &SystemMessage) -> 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 SystemMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SystemMessage