136 lines
3.5 KiB
Go
136 lines
3.5 KiB
Go
// Copyright 2009 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
//go:build aix || darwin || dragonfly || freebsd || hurd || (js && wasm) || linux || netbsd || openbsd || solaris || windows
|
|
|
|
package os
|
|
|
|
import (
|
|
"internal/itoa"
|
|
"internal/syscall/execenv"
|
|
"runtime"
|
|
"syscall"
|
|
)
|
|
|
|
// The only signal values guaranteed to be present in the os package on all
|
|
// systems are os.Interrupt (send the process an interrupt) and os.Kill (force
|
|
// the process to exit). On Windows, sending os.Interrupt to a process with
|
|
// os.Process.Signal is not implemented; it will return an error instead of
|
|
// sending a signal.
|
|
var (
|
|
Interrupt Signal = syscall.SIGINT
|
|
Kill Signal = syscall.SIGKILL
|
|
)
|
|
|
|
func startProcess(name string, argv []string, attr *ProcAttr) (p *Process, err error) {
|
|
// If there is no SysProcAttr (ie. no Chroot or changed
|
|
// UID/GID), double-check existence of the directory we want
|
|
// to chdir into. We can make the error clearer this way.
|
|
if attr != nil && attr.Sys == nil && attr.Dir != "" {
|
|
if _, err := Stat(attr.Dir); err != nil {
|
|
pe := err.(*PathError)
|
|
pe.Op = "chdir"
|
|
return nil, pe
|
|
}
|
|
}
|
|
|
|
sysattr := &syscall.ProcAttr{
|
|
Dir: attr.Dir,
|
|
Env: attr.Env,
|
|
Sys: attr.Sys,
|
|
}
|
|
if sysattr.Env == nil {
|
|
sysattr.Env, err = execenv.Default(sysattr.Sys)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
}
|
|
sysattr.Files = make([]uintptr, 0, len(attr.Files))
|
|
for _, f := range attr.Files {
|
|
sysattr.Files = append(sysattr.Files, f.Fd())
|
|
}
|
|
|
|
pid, h, e := syscall.StartProcess(name, argv, sysattr)
|
|
|
|
// Make sure we don't run the finalizers of attr.Files.
|
|
runtime.KeepAlive(attr)
|
|
|
|
if e != nil {
|
|
return nil, &PathError{Op: "fork/exec", Path: name, Err: e}
|
|
}
|
|
|
|
return newProcess(pid, h), nil
|
|
}
|
|
|
|
func (p *Process) kill() error {
|
|
return p.Signal(Kill)
|
|
}
|
|
|
|
// ProcessState stores information about a process, as reported by Wait.
|
|
type ProcessState struct {
|
|
pid int // The process's id.
|
|
status syscall.WaitStatus // System-dependent status info.
|
|
rusage *syscall.Rusage
|
|
}
|
|
|
|
// Pid returns the process id of the exited process.
|
|
func (p *ProcessState) Pid() int {
|
|
return p.pid
|
|
}
|
|
|
|
func (p *ProcessState) exited() bool {
|
|
return p.status.Exited()
|
|
}
|
|
|
|
func (p *ProcessState) success() bool {
|
|
return p.status.ExitStatus() == 0
|
|
}
|
|
|
|
func (p *ProcessState) sys() any {
|
|
return p.status
|
|
}
|
|
|
|
func (p *ProcessState) sysUsage() any {
|
|
return p.rusage
|
|
}
|
|
|
|
func (p *ProcessState) String() string {
|
|
if p == nil {
|
|
return "<nil>"
|
|
}
|
|
status := p.Sys().(syscall.WaitStatus)
|
|
res := ""
|
|
switch {
|
|
case status.Exited():
|
|
code := status.ExitStatus()
|
|
if runtime.GOOS == "windows" && uint(code) >= 1<<16 { // windows uses large hex numbers
|
|
res = "exit status " + uitox(uint(code))
|
|
} else { // unix systems use small decimal integers
|
|
res = "exit status " + itoa.Itoa(code) // unix
|
|
}
|
|
case status.Signaled():
|
|
res = "signal: " + status.Signal().String()
|
|
case status.Stopped():
|
|
res = "stop signal: " + status.StopSignal().String()
|
|
if status.StopSignal() == syscall.SIGTRAP && status.TrapCause() != 0 {
|
|
res += " (trap " + itoa.Itoa(status.TrapCause()) + ")"
|
|
}
|
|
case status.Continued():
|
|
res = "continued"
|
|
}
|
|
if status.CoreDump() {
|
|
res += " (core dumped)"
|
|
}
|
|
return res
|
|
}
|
|
|
|
// ExitCode returns the exit code of the exited process, or -1
|
|
// if the process hasn't exited or was terminated by a signal.
|
|
func (p *ProcessState) ExitCode() int {
|
|
// return -1 if the process hasn't started.
|
|
if p == nil {
|
|
return -1
|
|
}
|
|
return p.status.ExitStatus()
|
|
}
|