osutil

Documentation

Overview

Package osutil contains utilities for functions requiring system calls and other OS-specific APIs. OS-specific network handling should go to github.com/AdguardTeam/golibs/netutil instead.

Index

• func IsReconfigureSignal(sig os.Signal) (ok bool)
• func IsShutdownSignal(sig os.Signal) (ok bool)
• func NotifyReconfigureSignal(n SignalNotifier, c chan<- os.Signal)
• func NotifyShutdownSignal(n SignalNotifier, c chan<- os.Signal)
• func RootDirFS() (fsys fs.FS)
• type DefaultSignalNotifier
  • func (n DefaultSignalNotifier) Notify(c chan<- os.Signal, sig ...os.Signal)
  • func (n DefaultSignalNotifier) Stop(c chan<- os.Signal)
• type ExitCode
• type SignalNotifier

Examples

• RootDirFS

Functions

func IsReconfigureSignal

func IsReconfigureSignal(sig os.Signal) (ok bool)

IsReconfigureSignal returns true if sig is a reconfigure signal.

NOTE: It always returns false on Windows.

func IsShutdownSignal

func IsShutdownSignal(sig os.Signal) (ok bool)

IsShutdownSignal returns true if sig is a shutdown signal.

func NotifyReconfigureSignal

func NotifyReconfigureSignal(n SignalNotifier, c chan<- os.Signal)

NotifyReconfigureSignal notifies c on receiving reconfigure signals using n.

NOTE: It does nothing on Windows.

func NotifyShutdownSignal

func NotifyShutdownSignal(n SignalNotifier, c chan<- os.Signal)

NotifyShutdownSignal notifies c on receiving shutdown signals using n.

func RootDirFS

func RootDirFS() (fsys fs.FS)

RootDirFS returns a filesystem rooted at the system's root directory.

Example

Output:

is dir: true

Types

type DefaultSignalNotifier

type DefaultSignalNotifier struct{}

DefaultSignalNotifier is a SignalNotifier that uses signal.Notify and signal.Stop.

func (DefaultSignalNotifier) Notify

func (n DefaultSignalNotifier) Notify(c chan<- os.Signal, sig ...os.Signal)

Notify implements the SignalNotifier interface for DefaultSignalNotifier.

func (DefaultSignalNotifier) Stop

func (n DefaultSignalNotifier) Stop(c chan<- os.Signal)

Stop implements the SignalNotifier interface for DefaultSignalNotifier.

type ExitCode

type ExitCode = int

ExitCode is a semantic alias for int when it's used as an exit code.

const (
	ExitCodeSuccess       ExitCode = 0
	ExitCodeFailure       ExitCode = 1
	ExitCodeArgumentError ExitCode = 2
)

Exit status constants.

type SignalNotifier

type SignalNotifier interface {
	// Notify starts relaying incoming signals to c.  If no signals are
	// provided, all incoming signals are relayed to c.  Otherwise, just the
	// provided signals are.
	//
	// Implementations will not block sending to c: the caller must ensure that
	// c has sufficient buffer space to keep up with the expected signal rate.
	// For a channel used for notification of just one signal value, a buffer of
	// size 1 is sufficient.
	//
	// It is allowed to call Notify multiple times with the same channel: each
	// call expands the set of signals sent to that channel.  The only way to
	// remove signals from the set is to call Stop.
	//
	// It is allowed to call Notify multiple times with different channels and
	// the same signals: each channel receives copies of incoming signals
	// independently.
	//
	// See also [signal.Notify].
	Notify(c chan<- os.Signal, sig ...os.Signal)

	// Stop causes the SignalNotifier to stop relaying incoming signals to c.
	// It undoes the effect of all prior calls to Notify using c.  When Stop
	// returns, it c must not receive any more signals.
	//
	// See also [signal.Stop].
	Stop(c chan<- os.Signal)
}

SignalNotifier is the interface for OS functions that can notify about incoming signals using a channel.