localipc

Documentation

Overview

Package localipc opens explicitly addressed, current-user-only local IPC connections. It performs no endpoint discovery, PATH lookup, network fallback, authentication, or daemon startup.

Index

• Variables
• func Dial(ctx context.Context, address string) (net.Conn, error)
• func Listen(address string) (net.Listener, error)

Variables

var (
	// ErrUnsafeEndpoint reports an address whose type, ownership, permissions,
	// or platform-specific spelling is not safe for current-user IPC.
	ErrUnsafeEndpoint = errors.New("local IPC endpoint is unsafe")
	// ErrEndpointInUse reports an existing live Unix-domain listener detected
	// while safely distinguishing a stale socket. Listen never removes an
	// endpoint that responds to a connection probe.
	ErrEndpointInUse = errors.New("local IPC endpoint is already in use")
)

Functions

func Dial

func Dial(ctx context.Context, address string) (net.Conn, error)

Dial connects only to an explicitly addressed private Unix socket and honors caller cancellation and deadlines.

func Listen

func Listen(address string) (net.Listener, error)

Listen creates a Unix-domain stream listener at the exact absolute address. Its existing, symlink-free parent directory must be owned by the effective user and grant no group or other access; every ancestor must have a trusted owner and safe write semantics. An owned private stale socket is removed only after a failed active-listener probe; every other existing node is preserved.