platform

Documentation

Index

• func DetachProcess(cmd *exec.Cmd)
• func HideWindow(_ *exec.Cmd)
• func LockFile(f *os.File) error
• func LooksAbsolutePath(path string) bool
• func NormalizePathForCompare(p string) string
• func SafeRename(src, dst string) error
• func SetProcessGroup(cmd *exec.Cmd)
• func TermSignals() []os.Signal
• func UnlockFile(f *os.File) error

Functions

func DetachProcess

func DetachProcess(cmd *exec.Cmd)

DetachProcess configures cmd to run in a new session, detached from the parent. The child survives the parent exiting.

func HideWindow

func HideWindow(_ *exec.Cmd)

HideWindow is a no-op on Unix. On Windows it suppresses console window creation for subprocess invocations from detached workers.

func LockFile

func LockFile(f *os.File) error

LockFile acquires an exclusive lock on the entire file.

func LooksAbsolutePath

func LooksAbsolutePath(path string) bool

LooksAbsolutePath returns true if path looks like an absolute path on any OS. Unlike filepath.IsAbs, this recognizes POSIX-style absolute paths (/workspace/...) even on Windows, which is needed for file paths from agent payloads that may use POSIX conventions regardless of host OS.

func NormalizePathForCompare

func NormalizePathForCompare(p string) string

NormalizePathForCompare returns a path suitable for case-aware prefix matching. On Windows, paths are lowercased because the filesystem is case-insensitive (C:\Users and c:\Users are the same path). On macOS/Linux, the path is returned unchanged.

func SafeRename

func SafeRename(src, dst string) error

SafeRename moves src to dst, replacing dst if it exists. On Windows, removes dst first (os.Rename cannot overwrite) and retries only on transient sharing-violation errors from antivirus or search indexing. Non-transient errors fail immediately. This is NOT atomic on Windows.

func SetProcessGroup

func SetProcessGroup(cmd *exec.Cmd)

SetProcessGroup configures cmd to run in a new process group.

func TermSignals

func TermSignals() []os.Signal

TermSignals returns the signals to listen for graceful shutdown.

func UnlockFile

func UnlockFile(f *os.File) error

UnlockFile releases the lock on the file.