exec

Documentation

Overview

Package exec runs external commands with consistent timeout, cancellation, and process-group handling. Run captures combined stdout+stderr; RunStdout captures stdout only (detection parsers depend on a banner-free stdout). On timeout/cancellation the whole process group is killed (see proc_unix.go) and the result is classified as ExitCodeTimeout/ExitCodeCanceled.

Index

• Constants
• func Run(ctx context.Context, args []string, timeout time.Duration) (string, int, time.Duration, error)
• func RunStdout(ctx context.Context, args []string, timeout time.Duration) (string, int, time.Duration, error)

Constants

const (
	// ExitCodeTimeout / ExitCodeCanceled are synthetic exit codes the runner
	// returns when a command is killed by its deadline or by user cancellation.
	ExitCodeTimeout  = 124
	ExitCodeCanceled = 130
)

Functions

func Run

func Run(ctx context.Context, args []string, timeout time.Duration) (string, int, time.Duration, error)

Run executes a command capturing combined stdout+stderr.

func RunStdout

func RunStdout(ctx context.Context, args []string, timeout time.Duration) (string, int, time.Duration, error)

RunStdout executes a command capturing stdout only (stderr discarded).