process

Documentation

Overview

Package process implements an simple alternative to os/exec built above os.Process. It adds the possibility to asynchronously monitor the state of the child process.

Index

• type Process
  • func Start(bin string, argv []string) (p *Process, err error)
  • func (p *Process) C() chan int
  • func (p *Process) ExitCode() int
  • func (p *Process) Kill() error
  • func (p *Process) Pid() int
  • func (p *Process) Running() bool
  • func (p *Process) Signal(sig os.Signal) error
  • func (p *Process) Uptime() time.Duration

Types

type Process

type Process struct {
	// contains filtered or unexported fields
}

Process represents a child process whose state is monitored.

func Start

func Start(bin string, argv []string) (p *Process, err error)

Start creates a new child process and starts a monitoring routine to keep track of its state.

func (*Process) C

func (p *Process) C() chan int

C retuns a channel which will be notified of the process exit code on its termination.

func (*Process) ExitCode

func (p *Process) ExitCode() int

ExitCode returns the exit code of the process if it exited and panics if the process is still running.

func (*Process) Kill

func (p *Process) Kill() error

Kill forces the process to exit imediately.

func (*Process) Pid

func (p *Process) Pid() int

Pid returns the ID assigned to the process.

func (*Process) Running

func (p *Process) Running() bool

Running returns true if the process has not exited yet.

func (*Process) Signal

func (p *Process) Signal(sig os.Signal) error

Signal sends the given signal to the process.

func (*Process) Uptime

func (p *Process) Uptime() time.Duration

Uptime returns the time since the process started. If the process already exited, Uptime returns the time until termination.