class sys::Process

sys::Obj
  sys::Process

Source

Process manages spawning external OS processes.

command

Str[] command

Source

Command argument list used to launch process. The first item is the executable itself, then rest are the parameters.

dir

File? dir

Source

Working directory of process.

env

Str:Str env()

Source

Environment variables to pass to new process as a mutable map of string key/value pairs. This map is initialized with the current process environment.

err

OutStream? err := Env.cur().err

Source

The output stream used to sink the process stderr. Default is to send to Env.err. If set to null, then output is silently consumed like /dev/null. Note this field is ignored if mergeErr is set true, in which case stderr goes to the stream configured via out.

in

InStream? in := null

Source

The input stream used to source the process stdin. If null, then the new process will block if it attempts to read stdin. Default is null.

join

Int join()

Source

Wait for this process to exit and return the exit code. This method may only be called once after run.

kill

This kill()

Source

Kill this process. Returns this.

make

new make(Str[] cmd := Str[,], File? dir := null)

Source

Construct a Process instance used to launch an external OS process with the specified command arguments. The first item in the cmd list is the executable itself, then rest are the parameters.

mergeErr

Bool mergeErr := true

Source

If true, then stderr is redirected to the output stream configured via the out field, and the err field is ignored. The default is true.

out

OutStream? out := Env.cur().out

Source

The output stream used to sink the process stdout. Default is to send to Env.out. If set to null, then output is silently consumed like /dev/null.

run

This run()

Source

Spawn this process. See join to wait until the process finishes and to get the exit code. Return this.