sys

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 IsProcessAlive(process *os.Process) bool
• func KillProcessGroup(cmd *exec.Cmd, jobHandle uintptr)
• func SetupCmdSysProcAttr(cmd *exec.Cmd) (uintptr, error)

Functions

func AssignProcessToJob

func AssignProcessToJob(jobHandle uintptr, process *os.Process) error

AssignProcessToJob is a no-op on Unix (only used on Windows).

func CloseJobHandle

func CloseJobHandle(jobHandle uintptr)

CloseJobHandle is a no-op on Unix (only used on Windows).

func IsProcessAlive

func IsProcessAlive(process *os.Process) bool

IsProcessAlive checks if the process is still running using Signal(0) (Unix).

func KillProcessGroup

func KillProcessGroup(cmd *exec.Cmd, jobHandle uintptr)

KillProcessGroup terminates the entire process tree using the negative PID (Unix). The jobHandle parameter is ignored on Unix (only used on Windows).

func SetupCmdSysProcAttr

func SetupCmdSysProcAttr(cmd *exec.Cmd) (uintptr, error)

SetupCmdSysProcAttr configures the command to run in its own process group (Unix). Returns zero handle (unused on Unix).