kern/v4/lev2/kernel_keeper/kernel_keeper.go

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

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

	mL0 "gitp78su.ipnodns.ru/svi/kern/v4/lev0"
	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/alias"
	mKt "gitp78su.ipnodns.ru/svi/kern/v4/lev0/ktypes"
	mL1 "gitp78su.ipnodns.ru/svi/kern/v4/lev1"
)

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

var (
	kernKeep *kernelKeeper
	block    sync.Mutex
	qName    = alias.NewAStreamName("kernel_keeper")
)

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

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

// Log -- возвращает лог сторожа системных сигналов.
func (sf *kernelKeeper) Log() mKt.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(qName)
	sf.log.Debug("run(): end")
}