The highest tagged major version is
README
¶
daemon impl, pure go
I rewrote this one because most of others are dead or deading.
To find out all goos and goarch values:
ACK
Thanks them (incompletely):
- https://github.com/sevlyar/go-daemon
- https://github.com/VividCortex/godaemon
- https://github.com/takama/daemon
- https://github.com/fiorix/go-daemon
- https://github.com/leprosus/golang-daemon
- https://github.com/kardianos/service
References
- Daemon Definition
- https://en.wikipedia.org/wiki/Daemon_(computing)
- https://zh.wikipedia.org/wiki/守护进程
- https://web.archive.org/web/20061118065514/http://www.linuxprofilm.com/articles/linux-daemon-howto.html
- https://www.thegeekstuff.com/2012/02/c-daemon-process/
- https://socketloop.com/tutorials/golang-daemonizing-a-simple-web-server-process-example
- https://stackoverflow.com/questions/23736046/how-to-create-a-daemon-process-in-golang
- https://www.reddit.com/r/golang/comments/35v5bm/best_way_to_run_go_server_as_a_daemon/
- https://fabianlee.org/2017/05/21/golang-running-a-go-binary-as-a-systemd-service-on-ubuntu-16-04/
- https://blog.burntsushi.net/golang-daemonize-bsd/
- Systemd
Documentation
¶
Index ¶
- Constants
- Variables
- func Demonize(ctx *Context) (err error)
- func FindDaemonProcess(ctx *Context) (present bool, process *os.Process)
- func GetChs() (stopCh, doneCh chan struct{})
- func HandleSignalCaughtEvent() bool
- func HotReload(appName string, ctx *Context)
- func IsPidFileExists(ctx *Context) bool
- func IsRunningInDemonizedMode() bool
- func Readlink(name string) (string, error)
- func Reload(appName string, ctx *Context)
- func ServeSignals(ctx *Context) (err error)
- func SetHotReloadSignals(sig func() []os.Signal)
- func SetOnGetListener(fn func() net.Listener)
- func SetReloadSignals(sig func() []os.Signal)
- func SetSigEmtSignals(sig func() []os.Signal)
- func SetSigHandler(handler SignalHandlerFunc, signals ...os.Signal)
- func SetTermSignals(sig func() []os.Signal)
- func Stop(appName string, ctx *Context)
- type Context
- type SignalHandlerFunc
Constants ¶
const (
// ErrnoForkAndDaemonFailed is os errno when daemon plugin and its impl occurs errors.
ErrnoForkAndDaemonFailed = -1
)
Variables ¶
var ( // ErrStop should be returned signal handler function // for termination of handling signals. ErrStop = errors.New("stop serve signals") )
Functions ¶
func Demonize ¶
Demonize enables the demonized mode for this app. It fork a new child process and detach it from linux tty session, and the parent process exit itself.
func FindDaemonProcess ¶
FindDaemonProcess locates the daemon process if running
func GetChs ¶
func GetChs() (stopCh, doneCh chan struct{})
GetChs returns the standard `stop`, `done` channel
func HandleSignalCaughtEvent ¶
func HandleSignalCaughtEvent() bool
HandleSignalCaughtEvent is a shortcut to block the main business logic loop but break it if os signals caught. `stop` channel will be trigger if any hooked os signal caught, such as os.Interrupt; the main business logic loop should trigger `done` once `stop` holds.
func IsPidFileExists ¶
IsPidFileExists checks if the pid file exists or not
func IsRunningInDemonizedMode ¶
func IsRunningInDemonizedMode() bool
IsRunningInDemonizedMode returns true if you are running under demonized mode. false means that you're running in normal console/tty mode.
func Readlink ¶
Readlink returns the file pointed to by the given soft link, or an error of type PathError otherwise. This mimics the os.Readlink() function, but works around a bug we've seen in CentOS 5.10 (kernel 2.6.27.10 on x86_64) where the underlying OS function readlink() returns a wrong number of bytes for the result (see man readlink). Here we don't rely blindly on that value; if there's a zero byte among that number of bytes, then we keep only up to that point.
NOTE: We chose not to use os.Readlink() and then search on its result to avoid an extra overhead of converting back to []byte. The function to search for a byte over the string itself (strings.IndexByte()) is only available starting with Go 1.2. Also, we're not searching at every iteration to save some CPU time, even though that could mean extra iterations for systems affected with this bug. But it's wiser to optimize for the general case (i.e., those not affected).
func ServeSignals ¶
ServeSignals calls handlers for system signals. before invoking ServeSignals(), you should run SetupSignals() at first.
func SetHotReloadSignals ¶ added in v1.6.19
SetHotReloadSignals allows an functor to provide a list of Signals
func SetOnGetListener ¶ added in v1.6.19
SetOnGetListener returns tcp/http listener for daemon hot-restarting
func SetReloadSignals ¶
SetReloadSignals allows an functor to provide a list of Signals
func SetSigEmtSignals ¶
SetSigEmtSignals allows an functor to provide a list of Signals
func SetSigHandler ¶
func SetSigHandler(handler SignalHandlerFunc, signals ...os.Signal)
SetSigHandler sets handler for the given signals. SIGTERM has the default handler, he returns ErrStop.
func SetTermSignals ¶
SetTermSignals allows an functor to provide a list of Signals
Types ¶
type Context ¶
type Context struct {
// daemon.Context
PidFileName string
PidFilePerm int
LogFileName string
LogFilePerm int
WorkDir string
Umask int
Args []string
Hot bool
DaemonImpl interface{}
// contains filtered or unexported fields
}
Context of daemon operations
type SignalHandlerFunc ¶
SignalHandlerFunc is the interface for signal handler functions.
Source Files