proc

Documentation

Overview

Package proc is process utilities

Index

• Variables
• func Command(cmd string, args ...string) *exec.Cmd
• 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 Command

func Command(cmd string, args ...string) *exec.Cmd

Command returns an *exec.Cmd for calling the given cmd with args in cmd /c, with all the needed escapes - see https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/

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

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