kern/v4/lev2/kernel_keeper/kernel_keeper.go

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

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

	. "gitp78su.ipnodns.ru/svi/kern/v4/lev0/ktypes"
	. "gitp78su.ipnodns.ru/svi/kern/v4/lev1"
)

// kernelKeeper -- сторож системных сигналов
type kernelKeeper struct {
	ctx      context.Context
	fnCancel func()
	wg       IKernelWg
	log      ILogBuf
	chSys_   chan os.Signal
}

var (
	kernKeep *kernelKeeper
	block    sync.Mutex
)

// GetKernelKeeper -- возвращает новый сторож системных сигналов
func GetKernelKeeper(ctx context.Context, fnCancel func(),
	wg IKernelWg) IResult[*kernelKeeper] {
	block.Lock()
	defer block.Unlock()
	if kernKeep != nil {
		kernKeep.log.Debug("GetKernelKeeper()")
		return NewRes(kernKeep)
	}
	if ctx == nil {
		err := fmt.Errorf("NewKernelCtx(): ctx==nil")
		return NewErr[*kernelKeeper](err)
	}
	if wg == nil {
		err := fmt.Errorf("NewKernelCtx(): IKernelWg==nil")
		return NewErr[*kernelKeeper](err)
	}
	if fnCancel == nil {
		err := fmt.Errorf("NewKernelCtx(): fnCancel==nil")
		return NewErr[*kernelKeeper](err)
	}
	sf := &kernelKeeper{
		ctx:      ctx,
		fnCancel: fnCancel,
		wg:       wg,
		log:      NewLogBuf(OptIsTerm(true), OptPrefix("kernelKeeper")),
		chSys_:   make(chan os.Signal, 2),
	}
	sf.log.Debug("GetKernelKeeper(): first run")
	res := sf.wg.Add("kernel_keeper")
	res.Hassert("NewKernelCtx(): in add stream kernel keeper in IKernelWg")

	go sf.run(sf.chSys_)
	kernKeep = sf
	_ = IKernelKeeper(sf)
	return NewRes(sf)
}

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

// Работает в отдельном потоке и ждёт сигналов прерываний работы
func (sf *kernelKeeper) 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("kernel_keeper")
	sf.log.Debug("run(): end")
}