proc

Documentation

Index

• Variables
• func IsAdmin() bool
• func Run(ctx context.Context, env map[string]string, io Stdio, exe string, ...) error
• func Start(ctx context.Context, env map[string]string, io Stdio, exe string, ...) (*dexec.Cmd, error)
• func StartInBackground(args ...string) error
• func StartInBackgroundAsRoot(ctx context.Context, args ...string) error
• func Terminate(p *os.Process) error
• func Wait(ctx context.Context, cancel context.CancelFunc, cmd *dexec.Cmd) error
• type Stdio

Variables

var CommandContext = dexec.CommandContext

var SignalsToForward = []os.Signal{unix.SIGINT, unix.SIGTERM}

Functions

func IsAdmin

func IsAdmin() bool

func Run

func Run(ctx context.Context, env map[string]string, io Stdio, exe string, args ...string) error

Run will run the given executable with given args and env, wait for it to terminate, and return the result. The run will dispatch signals as appropriate for the given platform (SIGTERM and SIGINT on Unix platforms and os.Interrupt on Windows).

func Start

func Start(ctx context.Context, env map[string]string, io Stdio, exe string, args ...string) (*dexec.Cmd, error)

Start will start the given executable with given args and env,, and return the command. The signals are dispatched as appropriate for the given platform (SIGTERM and SIGINT on Unix platforms and os.Interrupt on Windows).

func StartInBackground

func StartInBackground(args ...string) error

func StartInBackgroundAsRoot

func StartInBackgroundAsRoot(ctx context.Context, args ...string) error

func Terminate

func Terminate(p *os.Process) error

func Wait

func Wait(ctx context.Context, cancel context.CancelFunc, cmd *dexec.Cmd) error

Wait will wait for the Process of the command to finish. If cancel is not nil, Wait will listen for os signals and call cancel when it receives one.

Types

type Stdio

type Stdio interface {
	InOrStdin() io.Reader
	OutOrStdout() io.Writer
	ErrOrStderr() io.Writer
}