pub struct RunRequest {
pub program: AbsolutePath,
pub args: Vec<OsString>,
pub env: BTreeMap<OsString, OsString>,
pub cwd: AbsolutePath,
pub stdin: Option<Vec<u8>>,
pub capture: CaptureMode,
pub echo: bool,
pub tree: bool,
pub terminal: bool,
}Expand description
One command for a Tracer to run.
The request is exact: the tracer adds nothing to it and looks nothing up.
Fields§
§program: AbsolutePathThe exact path of the program to run. The engine has already resolved a
bare program name through the task’s PATH.
args: Vec<OsString>The argument vector the program receives, starting with its argv[0].
env: BTreeMap<OsString, OsString>The exact environment of the process; nothing else is inherited.
cwd: AbsolutePathThe absolute working directory of the process.
stdin: Option<Vec<u8>>The content written to standard input, or None to connect /dev/null;
a request that keeps the terminal (RunRequest::terminal) connects
neither, and its command reads the standard input of the process that runs
the tracer.
capture: CaptureModeHow standard output and standard error are captured.
echo: boolWhether output is also echoed live, through the EchoSink given to
Tracer::run, while it is captured.
tree: boolWhether the result also holds the ProcessTree of the run, and a failed
start the tree of its one process. Off unless set: builds never set it, so the
tracer does not read the arguments of exec calls or keep each program’s
observations for them.
terminal: boolWhether the command keeps the terminal: it uses the standard input, output
and error of the process that runs the tracer, and stays in that process’s
process group and session, so a terminal’s input and signals reach it as they
would without kizz. Nothing is captured or echoed, the result’s output is
empty, and RunRequest::stdin, RunRequest::capture and
RunRequest::echo mean nothing: the output stays in the empty shape of the
capture mode. Off unless set: builds never set it, so a command of a build
runs in a process group of its own, with pipes or /dev/null as its
standard streams, and a terminal’s Ctrl-C reaches only kizz.