proc

Documentation

Overview

Package process wraps up the os.Process interface and also provides os-specific process lookup functions

Package process wraps up the os.Process interface and also provides os-specific process lookup functions

Index

• func FormArgv(channelName string) []string
• func IsProcessExists(log log.T, pid int, createTime time.Time) bool
• func ParseArgv(argv []string) (string, string, error)
• type OSProcess
  • func StartProcess(name string, argv []string) (OSProcess, error)
• type WorkerProcess
  • func (p *WorkerProcess) Kill() error
  • func (p *WorkerProcess) Pid() int
  • func (p *WorkerProcess) StartTime() time.Time
  • func (p *WorkerProcess) Wait() error

Functions

func FormArgv

func FormArgv(channelName string) []string

func IsProcessExists

func IsProcessExists(log log.T, pid int, createTime time.Time) bool

os.FindProcess() doesn't work on Linux: https://groups.google.com/forum/#!topic/golang-nuts/hqrp0UHBK9k what we can only do is check whether it exists

func ParseArgv

func ParseArgv(argv []string) (string, string, error)

TODO figure out why sometimes argv does not contain program name

Types

type OSProcess

type OSProcess interface {
	//generic ssm visible fields
	Pid() int
	StartTime() time.Time
	//kill the attached child process
	Kill() error
	//wait for the child to finish, if parent dies halfway, the child process is detached and becomes orphan
	//On Unix system, orphan is not be killed by systemd or upstart by default
	//On Windows service controller, stop service does not kill orphan by default
	//TODO confirm MSI Installer does not kill the child process
	Wait() error
}

OSProcess is an abstracted interface of os.Process

func StartProcess

func StartProcess(name string, argv []string) (OSProcess, error)

start a child process, with the resources attached to its parent

type WorkerProcess

type WorkerProcess struct {
	*exec.Cmd
	// contains filtered or unexported fields
}

impl of OSProcess with os.Process embed

func (*WorkerProcess) Kill

func (p *WorkerProcess) Kill() error

TODO use the kill functions provided in executes package

func (*WorkerProcess) Pid

func (p *WorkerProcess) Pid() int

func (*WorkerProcess) StartTime

func (p *WorkerProcess) StartTime() time.Time

func (*WorkerProcess) Wait

func (p *WorkerProcess) Wait() error