kern/v4/d2/kernel_keeper/kernel_keeper.go

// package kernel_keeper -- сторож системных сигналов.
package kernel_keeper

import (
	"context"
	"os"
	"os/signal"
	"sync"
	"syscall"

	"gitp78su.ipnodns.ru/svi/kern/v4/d0"
	"gitp78su.ipnodns.ru/svi/kern/v4/d1"
	"gitp78su.ipnodns.ru/svi/kern/v4/d2/kern_ent/stream_name"
	"gitp78su.ipnodns.ru/svi/kern/v4/d2/kspec"
)

// KernKeeper -- сторож системных сигналов.
type KernKeeper struct {
	owner    *d0.LOwner
	ctx      context.Context
	fnCancel func()
	wg       kspec.IKernelWg
	log      *d1.LogBuf
	chSys_   chan os.Signal
}

var (
	kernKeep *KernKeeper
	block    sync.Mutex
	qName    = stream_name.NewAStreamName("kernel_keeper")
)

// GetKernelKeeper -- возвращает новый сторож системных сигналов.
func GetKernelKeeper(ctx context.Context, fnCancel func(),
	wg kspec.IKernelWg) *KernKeeper {
	block.Lock()
	defer block.Unlock()
	if kernKeep != nil {
		kernKeep.log.Debug("GetKernelKeeper()")
		return kernKeep
	}
	d0.If(ctx == nil).Hassert("NewKernelCtx(): ctx==nil", []any{})
	d0.If(wg == nil).Hassert("NewKernelCtx(): IKernelWg==nil", []any{})
	d0.If(fnCancel == nil).Hassert("NewKernelCtx(): fnCancel==nil", []any{})
	owner := d0.LetOwner(1, "kern_keeper")
	paramLogBuf := &d1.LogBufParam{
		IsTerm_: d0.MutSafeBool(owner, true),
		Prefix_: d0.LetTxt("kernelKeeper"),
	}
	sf := &KernKeeper{
		owner:    owner,
		ctx:      ctx,
		fnCancel: fnCancel,
		wg:       wg,
		log:      d1.NewLogBuf(paramLogBuf),
		chSys_:   make(chan os.Signal, 2),
	}
	sf.log.Debug("GetKernelKeeper(): first run")
	sf.wg.Add(qName)

	go sf.run(sf.chSys_)
	kernKeep = sf
	return sf
}

// Log -- возвращает лог сторожа системных сигналов.
func (sf *KernKeeper) Log() *d1.LogBuf {
	return sf.log
}

// Работает в отдельном потоке и ждёт сигналов прерываний работы.
func (sf *KernKeeper) run(chSys chan os.Signal) {
	sf.log.Debug("run()")

	// Регистрируем сигналы SIGINT (Ctrl+C) и SIGTERM (завершение процесса)
	// syscall.SIGHUP: Сигнал, отправляемый при закрытии терминала.
	// syscall.SIGQUIT: Сигнал, отправляемый при нажатии **Ctrl+**.
	signal.Notify(chSys, syscall.SIGINT, syscall.SIGTERM, syscall.SIGHUP, syscall.SIGQUIT)
	select {
	case sig := <-chSys: // системный сигнал
		sf.log.Debug("run(): system signal, sig=%v\n", sig)
		sf.fnCancel()
	case <-sf.ctx.Done(): // сигнал от приложения
		sf.log.Debug("run(): cancel app context, err=\n\t%v\n", sf.ctx.Err())
	}
	sf.wg.Done(qName)
	sf.log.Debug("run(): end")
}