wslg

Nov 11, 2026

Changes in this version

+ const Display

+ const RuntimeDir

+ const WaylandDisplay

+ var ErrCollision = errors.New("reserved WSLg environment assignment")

+ var ErrExecutable = errors.New("WSLg discovery cannot locate the Windows system wsl.exe")

+ var ErrInvalidTarget = errors.New("WSLg discovery requires an explicit non-root WSL distro/user")

+ var ErrProtocol = errors.New("WSLg probe failed; verify the selected distro/user and /usr/bin/printenv")

+ var ErrUnavailable = errors.New(...)

+ var ErrUnsupported = errors.New("WSLg discovery requires native Windows and a local Docker runtime")

+ func CheckCollisions(source string, env []string, windows bool) error

+ func CheckEnvironmentSources(sources map[string][]string, windows bool) error

+ func Overlay(base []string, env map[string]string, windows bool) []string

+ func Pairs(env map[string]string) []string

+ func Reserved(key string, windows bool) bool

+ func ValidateEnvironment(env map[string]string) error

+ func ValidateTarget(target Target) error

+ type ProbeResult struct

+ ExitCode int

+ Stderr []byte

+ Stdout []byte

+ type Runner interface

+ Run func(context.Context, string, []string) (ProbeResult, error)

+ type Snapshot struct

+ func Capture(ctx context.Context, target Target, path string, runner Runner) (*Snapshot, error)

+ func Discover(ctx context.Context, target Target) (*Snapshot, error)

+ func NewSnapshot(target Target, env map[string]string) (*Snapshot, error)

+ func (s *Snapshot) Environment() map[string]string

+ func (s *Snapshot) Target() Target

+ type Target struct

+ Distro string

+ User string