osutil

type ContextSignalNotifier interface {
	SignalNotifier

	// NotifyContext returns a copy of the parent context that will be canceled
	// when one of the given signals arrives, when the stop function is called,
	// or when the parent context is marked done.  This depends on which event
	// happens first.
	//
	// See also [signal.NotifyContext].
	NotifyContext(
		parent context.Context,
		sig ...os.Signal,
	) (ctx context.Context, stop context.CancelFunc)
}

type DefaultSignalNotifier struct{}

type EmptySignalNotifier struct{}

type ExitCode = int

type ExitFunc func(code int)

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)
}