Expand description
Blessed asynchronous process operations.
This crate is intentionally published as an implementation detail. It is
the only production owner of the Tokio process primitives used by the
async process API. Higher layers receive typed operations and never name
tokio::process::Command directly.
Re-exports§
pub use platform_imp::terminal_input;
Modules§
- platform
- Neutral capability indexes for the eventual workspace-wide host boundary.
Structs§
- Capture
Cancellation - Platform
Child - Owned child handle returned by
SpawnSpec::spawn. - Platform
Emergency Signal - Opaque, non-reap-capable emergency termination capability.
- Platform
Lifecycle - Opaque exit-wait capability owned by a process actor.
- Platform
Output - Opaque stdout or stderr reader owned by a process actor.
- Platform
Stdin - Opaque piped stdin capability owned by a process actor.
- Process
Liveness - A live reference to another process, good for as long as it is held.
- Spawn
Spec - Typed spawn description accepted by the blessed process boundary.
- Traced
Child - Root-process control handle whose wait state is owned by the tracer.
- Windows
JobHandle
Enums§
- Host
Privileged Identity - A privileged system identity this process may be running as.
- Stream
Mode - Stdio policy for one child stream.
Constants§
- EXECUTABLE_
EXTENSION - File-name extension the host requires on a runnable image, if any.
Functions§
- after_
compat_ tokio_ spawn - Complete host-owned setup after a legacy Tokio child has been spawned.
- assign_
child_ to_ windows_ job - autostart_
register - autostart_
render_ registration - Render the unit text without touching the filesystem.
- autostart_
unregister - cancel_
capture_ reader - canonical_
environment_ pairs - capture_
reader_ done - compat_
shell_ command - configure_
compat_ tokio_ command - Apply host-owned setup for the legacy Tokio-command compatibility surface.
- configure_
exact_ trace - Arrange for a successful
execto stop the child before user code runs. No pre-exec SIGSTOP is used: that would deadlockCommand::spawn’s exec error pipe. - configure_
process_ command - configure_
sync_ contained_ command - configure_
sync_ daemon_ command - configure_
sync_ daemon_ command_ with_ inheritance - configure_
trampoline_ command - current_
executable_ build_ id - Return the GNU build ID of the running executable without reading the executable from disk.
- exact_
trace_ capability - executable_
file_ name - Spell
barethe way this host names an executable file. - executable_
sibling_ of_ current_ image - Path to a sibling program installed beside the running image.
- exit_
code - fs_
write_ all_ to_ descriptor - Write every byte of
bytes, or report why not. - host_
boot_ id - An identifier that changes on every boot of this machine.
- host_
current_ process_ privilege - The privileged identity this process is running as, if any.
- host_
environment_ keys_ are_ case_ insensitive - Unix environment variable names compare byte for byte.
- host_
filesystem_ device_ id - The filesystem device this path lives on.
- host_
hostname - This machine’s name as the host reports it.
- host_
login_ environment - The logged-in user’s environment, as a fresh login would see it.
- host_
login_ environment_ block - The login environment in the double-NUL-terminated UTF-16 block form.
- host_
machine_ id - A durable per-machine identifier that survives reboots.
- host_
namespace_ id - The mount and PID namespaces this process is in.
- host_
user_ machine_ identity - A stable identity for this user on this machine.
- kill_
tree - monitor_
console_ windows - parent_
has_ console - prepare_
capture_ reader - process_
can_ replace_ current_ image - This host replaces a running image in place; see the facade for what that means for a caller that cannot accept a successor instead.
- process_
executable_ path - Resolve the on-disk image a running process was started from.
- process_
force_ kill - Stop a process without asking.
- process_
install_ owner_ death_ cleanup - Ask the kernel to signal this process when its owner exits.
- process_
install_ shutdown_ request_ handler - Ask this host to report shutdown requests.
- process_
owner_ death_ cleanup_ target - What this host will attempt, without attempting it.
- process_
replace_ current_ image - Replace this process’s image with
command. - process_
same_ executable_ path - Whether two spellings name the same executable image on this host.
- process_
signal_ terminate - Ask a process to stop.
- process_
snapshot - process_
snapshot_ for_ pid - resources_
fd_ exhaustion_ error - One error this host would report for descriptor exhaustion.
- resources_
inode_ capacity - Probe inode capacity for the filesystem containing
path. - resources_
signals_ fd_ exhaustion - Whether this error means the process or the system is out of descriptors.
- resources_
signals_ storage_ exhaustion - Whether this error means the filesystem is out of space.
- resources_
storage_ exhaustion_ error - One error this host would report for storage exhaustion.
- set_
process_ name - set_
window_ icon_ impl - Write
sourceonto this process’s terminal window. - shell_
command - shell_
spec - Build a shell command using the host platform’s supported shell.
- soft_
terminate_ process_ group - Request a graceful shutdown for a child-owned POSIX process group.
- spawn_
sync - spawn_
sync_ daemon - spawn_
sync_ daemon_ with_ inheritance - start_
descendant_ monitor - start_
exact_ trace - sync_
child_ native_ handle - trampoline_
exit_ code - unix_
mark_ ⚠extra_ fds_ close_ on_ exec - Mark inherited descriptors close-on-exec without breaking std’s exec-error pipe.
- unix_
set_ priority - unix_
signal_ process - unix_
signal_ process_ group - unix_
signal_ raw - window_
icon_ support_ impl - Whether this host can take a real icon.