Module child_reaper 

Child process reaping and management.

Modules

orphan_sweep 🔒

Reaping the zombies nobody claimed.

runtime_call 🔒

Running a runtime for a call: its output, its process group and the cleanup after a failure.

watcher 🔒

Watching a registered child until it exited, and what follows.

Structs

Call 🔒

A runtime call in progress, see Calls.

Calls 🔒

The runtime calls in progress, numbered in the order they started.

Candidate 🔒

A zombie which nobody claimed, see ChildReaper::sweep_orphans.

Child 🔒

A container or exec, as it gets registered with the child reaper.

ChildReaper 🔒

Watches the containers and execs of the server until they exit and reaps them.

ExitChannelData 🔒

The exit of a child, which its waiters get.

InFlight 🔒

Counts a runtime call as in progress until dropped. A successful ChildReaper::create_child hands it to the caller, which passes it to ChildReaper::watch_grandchild, so the call ends with the registration of its child, or wherever the caller gives up.

PendingPid 🔒

Marks a PID as pending for the lifetime of the guard. The marks get counted: a call keeps the mark of its runtime until it reaped it, and the PID of a runtime which got reaped may already be in use by the process of another call, whose mark must stay.

ReapableChild 🔒

A registered child, until its watcher ended. What only the watcher needs moves into it, see ExitHandling.

RegisteredContainer 🔒

A registered container, see ChildReaper::get.

WatchedExec 🔒

An exec which got registered, see ChildReaper::watch_exec.

Enums

ChildKind 🔒

What kind of process a child is. Execs are registered under the id of their container, but only the container itself is the target of container level operations like attach or log reopening.

Constants

CONTAINER_NOT_FOUND 🔒

The start of the error of a request for a container the server does not know, clients match it, see ErrContainerNotFound of the Go client. The message of older servers is “child not available”.

EXIT_CODE_NOT_STARTED 🔒

The exit code of an exec which could not be started, for example because the runtime failed.

EXIT_CODE_TIMED_OUT 🔒

The exit code of a process which did not exit before its timeout. Clients take -3 for a timeout, no other failure may report it, except for EXIT_CODE_WAIT_FAILED, which always did.

Functions

kill_grandchild 🔒

Signal a grandchild and its process group, unless it got reaped already, see Process::signal_group. The grandchildren got reparented to this subreaper, so the PID refers to a child.

Type Aliases

PendingPids 🔒

The pending PIDs with the number of their marks, see PendingPid.