package signal import ( "os" gosignal "os/signal" "path/filepath" "runtime" "sync/atomic" "syscall" "time" "github.com/Sirupsen/logrus" ) // Trap sets up a simplified signal "trap", appropriate for common // behavior expected from a vanilla unix command-line tool in general // (and the Docker engine in particular). // // * If SIGINT or SIGTERM are received, `cleanup` is called, then the process is terminated. // * If SIGINT or SIGTERM are received 3 times before cleanup is complete, then cleanup is // skipped and the process is terminated immediately (allows force quit of stuck daemon) // * A SIGQUIT always causes an exit without cleanup, with a goroutine dump preceding exit. // * Ignore SIGPIPE events. These are generated by systemd when journald is restarted while // the docker daemon is not restarted and also running under systemd. // Fixes https://github.com/docker/docker/issues/19728 // func Trap(cleanup func()) { c := make(chan os.Signal, 1) // we will handle INT, TERM, QUIT, SIGPIPE here signals := []os.Signal{os.Interrupt, syscall.SIGTERM, syscall.SIGQUIT, syscall.SIGPIPE} gosignal.Notify(c, signals...) go func() { interruptCount := uint32(0) for sig := range c { if sig == syscall.SIGPIPE { continue } go func(sig os.Signal) { logrus.Infof("Processing signal '%v'", sig) switch sig { case os.Interrupt, syscall.SIGTERM: if atomic.LoadUint32(&interruptCount) < 3 { // Initiate the cleanup only once if atomic.AddUint32(&interruptCount, 1) == 1 { // Call the provided cleanup handler cleanup() os.Exit(0) } else { return } } else { // 3 SIGTERM/INT signals received; force exit without cleanup logrus.Info("Forcing docker daemon shutdown without cleanup; 3 interrupts received") } case syscall.SIGQUIT: DumpStacks("") logrus.Info("Forcing docker daemon shutdown without cleanup on SIGQUIT") } //for the SIGINT/TERM, and SIGQUIT non-clean shutdown case, exit with 128 + signal # os.Exit(128 + int(sig.(syscall.Signal))) }(sig) } }() } // DumpStacks dumps the runtime stack. func DumpStacks(root string) { var ( buf []byte stackSize int ) bufferLen := 16384 for stackSize == len(buf) { buf = make([]byte, bufferLen) stackSize = runtime.Stack(buf, true) bufferLen *= 2 } buf = buf[:stackSize] // Note that if the daemon is started with a less-verbose log-level than "info" (the default), the goroutine // traces won't show up in the log. if root == "" { logrus.Infof("=== BEGIN goroutine stack dump ===\n%s\n=== END goroutine stack dump ===", buf) } else { // Dumps the stacks to a file in the root directory of the daemon // On Windows, this overcomes two issues - one being that if the stack is too big, it doesn't // get written to the event log when the Windows daemon is running as a service. // Second, using logrus, the tabs and new-lines end up getting written as literal // \t and \n's, meaning you need to use something like notepad++ to convert the // output into something readable using 'type' from a command line or notepad/notepad++ etc. path := filepath.Join(root, "goroutine-stacks.log") f, err := os.OpenFile(path, os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0666) if err != nil { logrus.Warnf("Could not open %s to write the goroutine stacks: %v", path, err) return } defer f.Close() f.WriteString("=== BEGIN goroutine stack dump ===\n") f.WriteString(time.Now().String() + "\n") if _, err := f.Write(buf); err != nil { logrus.Warnf("Could not write goroutine stacks to %s: %v", path, err) return } f.WriteString("=== END goroutine stack dump ===\n") f.Sync() logrus.Infof("goroutine stacks written to %s", path) } }