proc

Documentation

Overview

Package proc is process utilities

Index

• Variables
• func GroupKill(pid int, signal os.Signal) error
• func KillWithChildren(p *os.Process, interrupt bool) (err error)
• func Pkill(pid int, signal os.Signal) error
• func RunWithTimeout(timeoutSeconds int, cmd *exec.Cmd) error
• func WithTimeout(timeoutSeconds int, todo func() error, onTimeout func() error) error

Variables

var ErrTimedOut = errors.New("child timed out")

ErrTimedOut is an error for child timeout

var IntTimeout = 3 * time.Second

IntTimeout is the duration to wait before Kill after Int

var Log = func(keyvals ...interface{}) error { return nil }

Log is discarded by default

Functions

func GroupKill

func GroupKill(pid int, signal os.Signal) error

GroupKill kills the process group lead by the given pid

func KillWithChildren

func KillWithChildren(p *os.Process, interrupt bool) (err error)

KillWithChildren kills the process and tries to kill its all children (process group)

func Pkill

func Pkill(pid int, signal os.Signal) error

Pkill kills the process with the given pid, or just -INT if interrupt is true.

func RunWithTimeout

func RunWithTimeout(timeoutSeconds int, cmd *exec.Cmd) error

RunWithTimeout runs cmd, and kills the child on timeout

func WithTimeout

func WithTimeout(timeoutSeconds int, todo func() error, onTimeout func() error) error

WithTimeout starts todo function, executes onTimeout if the todo function does not return before timeoutSeconds elapses, and returns todo's returned error or ErrTimedOut