Struct ExecStart 

pub(crate) struct ExecStart {
    container_io: ContainerIO,
    pidfile: TempFile,
    args: ExecArgs,
    runtime: PathBuf,
}

An exec while it gets started. An exec_sync and a streaming exec set it up the same way, they differ in how they wait for the runtime and take the output, see ExecStart::run and ExecStart::watch.

Fields

container_io: ContainerIO

The IO of the process, with the console socket of a terminal.

pidfile: TempFile

Where the runtime writes the PID of the process. Removed once the runtime wrote the PID, see ExecStart::watch, or with a start which failed.

args: ExecArgs

runtime: PathBuf

Implementations

impl ExecStart

pub(crate) fn new( config: &Config, id: &str, tty: bool, command: &[String], cgroup_manager: CgroupManager, pidfile_prefix: &str, ) -> Result<Self>

Set up an exec of command in the container id, with a terminal if tty. The PID file in the runtime directory starts with pidfile_prefix, which tells the kind of exec apart.

pub(crate) fn collect_stdio(&self, stdout: bool, stderr: bool) -> Result<()>

Read the output while the runtime runs, see ContainerIO::collect_stdio.

pub(crate) fn stdio(&self) -> Result<(Receiver<Message>, Receiver<Message>)>

The stdout and stderr channels of the process, see ContainerIO::stdio.

pub(crate) fn terminal(&self) -> Option<&Terminal>

The terminal of the process, none with pipes, see ContainerIO::terminal.

pub(crate) async fn run( &mut self, reaper: &ChildReaper, stdin: bool, deadline: Instant, ) -> Result<StartedChild>

Run the runtime, with stdin for the process, and kill it at the deadline if it hangs, see ChildReaper::create_child. The caller reports a failure with ExecStart::runtime_error.

pub(crate) async fn runtime_error(&self, e: Error) -> Error

The error of a runtime which failed to start the process, with its stderr, see ContainerIO::runtime_error.

pub(crate) fn watch( self, reaper: &ChildReaper, id: Box<str>, started: StartedChild, timeout: Option<Instant>, ) -> Result<WatchedExec>

Register the process the runtime started under the id of its container, the process gets killed at timeout, see ChildReaper::watch_exec.