subprocess

Documentation

Index

• func NewCmd(path string, args ...string) *exec.Cmd
• func NewStopper(logger logging.Logger, cmd *exec.Cmd) runtime.Stopper
• type Config
• type Status
  • func Bootstrap(ctx context.Context, listener net.Listener, cmd *exec.Cmd, config *Config) (*Status, runtime.Stopper, error)

Functions

func NewCmd

func NewCmd(path string, args ...string) *exec.Cmd

func NewStopper

func NewStopper(logger logging.Logger, cmd *exec.Cmd) runtime.Stopper

Types

type Config

type Config struct {
	// Stderr of the VM process written to this writer.
	Stderr io.Writer
	// Stdout of the VM process written to this writer.
	Stdout io.Writer
	// Duration engine server will wait for handshake success.
	HandshakeTimeout time.Duration
	Log              logging.Logger
}

type Status

type Status struct {
	// Id of the process.
	Pid int
	// Address of the VM gRPC service.
	Addr string
}

func Bootstrap

func Bootstrap(
	ctx context.Context,
	listener net.Listener,
	cmd *exec.Cmd,
	config *Config,
) (*Status, runtime.Stopper, error)

Bootstrap starts a VM as a subprocess after initialization completes and pipes the IO to the appropriate writers.

The subprocess is expected to be stopped by the caller if a non-nil error is returned. If piping the IO fails then the subprocess will be stopped.

TODO: create the listener inside this method once we refactor the tests