Struct PlatformEmergencySignal 

pub struct PlatformEmergencySignal { /* private fields */ }

Opaque, non-reap-capable emergency termination capability.

It can be used while the actor has a pending wait on PlatformLifecycle, but it cannot observe or consume the exit result.

Implementations

impl PlatformEmergencySignal

pub fn kill(&self) -> Result<()>

Request immediate termination without waiting for process reaping.

pub fn terminate_group_soft(&self) -> Result<bool>

Ask the child’s whole process group to shut down gracefully.

Returns Ok(false) when the child was not spawned with SpawnSpec::create_process_group: there is no group to address, and signalling anyway would hit the caller’s own group on POSIX or the caller’s console on Windows. A missing or mismatched launch identity instead reports an unavailable target; it never falls back to a numeric group identifier that might have been reused.

pub fn terminate_group_soft_legacy(&self) -> Result<bool>

Legacy AsyncProcess-only graceful group termination.

Most hosts retain an identity-safe asynchronous signal capability. On macOS there is no pidfd-equivalent for the Tokio child path, while the pre-session AsyncProcess contract historically sent SIGTERM to the launch child’s numeric process group. Preserve that established best-effort behavior only for the legacy actor; sessions keep using Self::terminate_group_soft and therefore remain identity-safe.

pub fn cpu_time(&self) -> Result<Option<Duration>>

Return direct-child CPU time when this host can still verify the launch identity. Unsupported hosts and already-reused identities are reported as None, never as a PID-only best effort.