Skip to content

Process

Process objects are returned by Container::CreateProcess() and Container::InitProcess().

Methods / events

  • Start()
  • Signal(Signal signal)
  • GetOutputStream(ProcessOutputHandle outputHandle)
  • GetInputStream()
  • Pid()
  • State()
  • ExitCode()
  • event OutputReceived
  • event ErrorReceived
  • event Exited
  • Close()

Behavior notes

  • Start() cannot be called on the init process.
  • Start() requires a non-empty ProcessSettings::CommandLine().
  • GetOutputStream() requires ProcessOutputMode::Stream.
  • OutputReceived and ErrorReceived require ProcessOutputMode::Event.
  • Exited is raised by the exit callback in event mode, and by waiting on the process exit event in stream/discard mode.

Examples

auto proc = container.CreateProcess(procSettings);
proc.Exited([](int32_t exitCode)
{
    printf("process exited: %d\n", exitCode);
});
proc.Start();

auto pid = proc.Pid();
auto state = proc.State();

proc.Signal(static_cast<Signal>(2)); // SIGINT

auto stdinStream = proc.GetInputStream();

ProcessSettings streamSettings;
streamSettings.OutputMode(ProcessOutputMode::Stream);
// ... set CommandLine ...
auto streamProc = container.CreateProcess(streamSettings);
streamProc.Start();
auto stdoutStream = streamProc.GetOutputStream(static_cast<ProcessOutputHandle>(1));
auto stderrStream = streamProc.GetOutputStream(static_cast<ProcessOutputHandle>(2));

ProcessSettings eventSettings;
eventSettings.OutputMode(ProcessOutputMode::Event);
// ... set CommandLine ...
auto eventProc = container.CreateProcess(eventSettings);
eventProc.OutputReceived([](auto const& data)
{
    printf("stdout bytes: %zu\n", data.size());
});
eventProc.ErrorReceived([](auto const& data)
{
    printf("stderr bytes: %zu\n", data.size());
});
eventProc.Exited([](int32_t exitCode)
{
    printf("done: %d\n", exitCode);
});
eventProc.Start();

auto exitCode = proc.ExitCode();