Crate rightkit_child_process 

OwnedCommand::inherit_handles_only restricts inheritance to caller handles/fds plus stdio; Windows requires windows_spawn_config for opaque Command settings.

Modules

reveal

Reveal a file or folder in the system file manager, or open it with its default handler, through OwnedCommand, and only inside caller-supplied roots.

Structs

Ack

Handed to the watched party; calling Ack::done proves it is alive.

AdoptedIdentity

A pid together with the start time and executable path that make it a name for exactly one process. See the module documentation.

AdoptedProcess

BreakawayDenied

The error source returned (inside an io::Error of kind PermissionDenied) by OwnedCommand::spawn_uncontained_detached_strict on Windows when the caller’s job object denies CREATE_BREAKAWAY_FROM_JOB. The OS reports this as ERROR_ACCESS_DENIED, which this crate cannot tell apart from other access-denied launch failures; a job that forbids breakaway is the cause this crate expects.

BudgetLabels

Names and scale of the load behind an IdleObservation, for IdleObservation::result_lines.

CapturedOutput

What a capture holds.

ConsecutiveFailures

Cap on restarts granted in a row without the replacement ever reporting ready.

Cooldown

Minimum spacing between expensive actions (HeardRight samples stacks at most once a minute). Pure; the caller supplies now.

Generation

HealthPolicy

HealthTracker

IdleObservation

What a process did over a quiet window: the idle figures a runtime budget names.

JobAssignmentFailure

Every failed assignment in a best-effort Windows spawn is retained.

MatchSweepOptions

How sweep_matching behaves.

MatchSweepReport

The result of sweep_matching.

MatchedProcess

A process that satisfied a ProcessQuery.

OutputCapture

A background drain of one output stream into a bounded byte buffer. See the module documentation.

OwnedChild

OwnedCommand

PowerAssertion

A live keep-awake request. Released on drop.

ProcessHandle

An independent exit reader. On Unix it shares the owner’s cached reap state; on Windows it owns a duplicated process handle, never a borrowed handle value. Keeping this reader alive does not keep an owned process tree alive.

ProcessQuery

Which processes to find. All criteria that are set must hold. Built with the methods below; at least one criterion is required.

ProcessUsage

One snapshot of the current process’s resource usage.

RestartPermit

RestartPolicy

RestartTracker

StallConfig

StallWatchdog

A running watchdog. Dropping it stops and joins the thread.

StartToken

When a process started, in the host’s own unit (macOS: seconds and microseconds; Linux: clock ticks since boot and 0; Windows: 100 ns ticks since 1601 and 0). Comparable only on the host that produced it.

StderrTail

A background drain of one stderr stream. Keeps the most recent lines whose total size is at most max_bytes; older lines fall off the front. A single line that alone exceeds the budget is cut to its last bytes, so snapshot never returns more than max_bytes bytes.

SweepReport

The result of sweep, as pids.

TerminateAllReport

The result of terminate_all_owned, as pids.

TerminationOptions

TreeTermination

The result of OwnedChild::terminate_tree_deep.

UnixChild

A spawned Unix child. The same API as Windows’ WindowsChild: public stdio fields, id, try_wait, wait and kill. It does not expose the std Child, because a std reap the crate cannot see would make later group signals unsafe (see the module documentation).

UsageRates

Rates between two snapshots. Each rate is None when either snapshot lacks the counter.

Enums

AdoptedSignal

How hard to stop a process. Windows has one way to stop a process, so both are the same there.

HealthOutcome

HealthProbe

IdentityCheck

What a pid names now, compared with a remembered identity.

JobAssignmentMode

PowerKind

What to keep awake.

ProcessPriority

Scheduling priority requested for the child. Normal (the default) means “inherit”: it leaves the spawn exactly as it was before this option existed, so the child keeps the parent’s priority class (Windows) or nice value (Unix). It does not reset a lowered parent back to normal. The other values only lower priority, which needs no privilege and never raises a value the child already inherits above a lower one.

ReapOutcome

RestartMode

RestartOutcome

SignalResult

The outcome of AdoptedIdentity::signal.

StallEvent

UnixContainment

WaitOutcome

Constants

CREATE_NO_WINDOW

The Windows CREATE_NO_WINDOW creation flag, exposed on every platform so a caller that composes its own flags can OR it in.

DEFAULT_DROP_REAP_TIMEOUT

How long Drop waits for a killed leader to be reaped before handing the reap to a background thread.

DEFAULT_ENV_ALLOWLIST

Traits

NoWindow

Suppresses the child’s console window on Windows. A no-op elsewhere.

Functions

find_processes

Every process that satisfies query, newest first (children tend to come before the parents that started them). Nothing is signalled. Processes that cannot be inspected (they exited, or belong to another user, or deny access) are skipped, never an error.

observe_idle

Sleeps duration on the calling thread and reports the process’s usage over it. Run it after the load has stopped; it is for benches and tests, so a host reads process_usage instead.

owned_count

How many owned children are listed and still alive (their OwnedChild has not been dropped). A child that exited but was not dropped is still counted.

process_usage

Resource usage of the current process, computed now.

read_bounded

Reads reader to its end on the calling thread, keeping the first max_bytes bytes. The rest is read and discarded. Use this when the caller can block until the stream closes.

sweep

Stops every process in targets that is still the process it was remembered as: a graceful signal to each, up to grace for them to leave, then a forced signal to those still present. A target whose pid names a different process is refused, never signalled. Targets are signalled in the order given; pass leaves first (the reverse of AdoptedIdentity::descendants).

sweep_descendants

sweep of root’s current descendants, leaves first. The root itself is left alone.

sweep_matching

find_processes, then stop what was found with the identity-checked sweep (unless options ask for a dry run).

terminate_all_owned

Stops every child this process owns (everything started with OwnedCommand::spawn whose OwnedChild has not been dropped), tree and all, in one call: for an application’s shutdown path, replacing an app-kept list of running children.

Type Aliases

RawHandleOrFd