Documentation
¶
Overview ¶
Package sys provides cross-platform process management utilities.
This package handles low-level OS-specific operations for process group management, signal handling, and process lifecycle control. It abstracts the differences between Unix (PGID-based) and Windows (taskkill-based) process termination strategies.
The primary purpose is to ensure proper cleanup of CLI processes and their children, preventing zombie processes and resource leaks.
Index ¶
- func AssignProcessToJob(jobHandle uintptr, process *os.Process) error
- func CloseJobHandle(jobHandle uintptr)
- func ConfigDir() string
- func DataDir() string
- func ExpandPath(path string) string
- func IsProcessAlive(process *os.Process) bool
- func KillProcessGroup(cmd *exec.Cmd, jobHandle uintptr)
- func LogDir() string
- func SetupCmdSysProcAttr(cmd *exec.Cmd) (uintptr, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AssignProcessToJob ¶ added in v0.9.3
AssignProcessToJob is a no-op on Unix (only used on Windows).
func CloseJobHandle ¶ added in v0.9.3
func CloseJobHandle(jobHandle uintptr)
CloseJobHandle is a no-op on Unix (only used on Windows).
func ConfigDir ¶ added in v0.27.0
func ConfigDir() string
ConfigDir returns the platform-specific directory for configuration files (XDG_CONFIG_HOME).
func DataDir ¶ added in v0.27.0
func DataDir() string
DataDir returns the platform-specific directory for data files (XDG_DATA_HOME).
func ExpandPath ¶ added in v0.21.0
ExpandPath expands the home directory tilde (~) and environment variables in a path.
func IsProcessAlive ¶
IsProcessAlive checks if the process is still running using Signal(0) (Unix).
func KillProcessGroup ¶
KillProcessGroup terminates the entire process tree using the negative PID (Unix). The jobHandle parameter is ignored on Unix (only used on Windows).
Types ¶
This section is empty.
Source Files