Crate scoped_task

scoped_task provides wrappers that kill a child process when the wrapper goes out of scope, or the current process exits.

Note that this doesn’t guarantee that the child process will be killed in all cases: if the current process is terminated, or exits with std::process::abort, the child process will not be killed. Panics and std::process::exit are explicitly supported, however.

These wrappers are especially useful for tests that spawn child processes. If an assert fails, the child process can live forever. This can cause the test runner to hang if the child process cloned the test’s stdout or stderr handle, which is often the case.

For this reason, it is recommended that all Rust tests which spawn processes use scoped_task to do so.

Structs

• Scoped
  Scoped wrapper for a process or job backed by a Zircon handle.

Functions

• create_child_job
  Creates and returns a child job of the job returned by job_default.
• install_hooks
  Installs the hooks that ensure scoped tasks are cleaned up on panic and process exit.
• job_default
  Returns the default job for spawning scoped processes.
• spawn
  A convenience wrapper around fdio::spawn that returns a Scoped.
• spawn_etc
  A convenience wrapper around fdio::spawn_etc that returns a Scoped.