exec

README

exec

Usage

import (
    // "os/exec"
    "github.com/k1LoW/exec"
)

Difference between os/exec and k1LoW/exec

• k1LoW/exec.Command returns *os/exec.Cmd with PGID set.
• When context cancelled, k1LoW/exec.CommandContext send signal to process group.

References

• Songmu/timeout: Timeout invocation. Go porting of GNU timeout and able to use as Go package
  • k1LoW/exec is porting source code to handle processes from Songmu/timeout

Documentation

Index

• func Command(name string, arg ...string) *exec.Cmd
• func CommandContext(ctx context.Context, name string, arg ...string) *exec.Cmd
• func KillCommand(cmd *exec.Cmd) error
• func LookPath(file string) (string, error)
• func TerminateCommand(cmd *exec.Cmd, sig os.Signal) error
• type Exec
  • func (e *Exec) CommandContext(ctx context.Context, name string, arg ...string) *exec.Cmd

Functions

func Command

func Command(name string, arg ...string) *exec.Cmd

Command returns *os/exec.Cmd with Setpgid = true

func CommandContext

func CommandContext(ctx context.Context, name string, arg ...string) *exec.Cmd

CommandContext returns *os/exec.Cmd with Setpgid = true When ctx cancelled, `github.com/k1LoW/exec.CommandContext` send signal to process group

func KillCommand

func KillCommand(cmd *exec.Cmd) error

KillCommand send syscall.SIGKILL to cmd.Process.Pid process group KillCommand send taskkill to cmd.Process.Pid ( if runtime.GOOS == 'windows' )

func LookPath

func LookPath(file string) (string, error)

LookPath is os/exec.LookPath

func TerminateCommand

func TerminateCommand(cmd *exec.Cmd, sig os.Signal) error

TerminateCommand send signal to cmd.Process.Pid process group ( if runtime.GOOS != 'windows' ) TerminateCommand send taskkill to cmd.Process.Pid ( if runtime.GOOS == 'windows' )

Types

type Exec

type Exec struct {
	Signal          os.Signal
	KillAfterCancel time.Duration // TODO
}

Exec represents an command executer

func (*Exec) CommandContext

func (e *Exec) CommandContext(ctx context.Context, name string, arg ...string) *exec.Cmd

CommandContext returns *os/exec.Cmd with Setpgid = true When ctx cancelled, `github.com/k1LoW/exec.CommandContext` send signal to process group