...
▽

Package exithook

import "internal/runtime/exithook"
Overview
Index

Overview ▾

Package exithook provides limited support for on-exit cleanup.

CAREFUL! The expectation is that Add should only be called from a safe context (e.g. not an error/panic path or signal handler, preemption enabled, allocation allowed, write barriers allowed, etc), and that the exit function F will be invoked under similar circumstances. That is the say, we are expecting that F uses normal / high-level Go code as opposed to one of the more restricted dialects used for the trickier parts of the runtime.

Index ▾

Package files

hooks.go

Variables

var (

    // runtime sets these for us
    Gosched func()
    Goid    func() uint64
    Throw   func(string)
)

func Add 

func Add(h Hook)

Add adds a new exit hook.

func Run 

func Run(code int)

Run runs the exit hooks.

If an exit hook panics, Run will throw with the panic on the stack. If an exit hook invokes exit in the same goroutine, the goroutine will throw. If an exit hook invokes exit in another goroutine, that exit will block.

type Hook

A Hook is a function to be run at program termination (when someone invokes os.Exit, or when main.main returns). Hooks are run in reverse order of registration: the first hook added is the last one run. 

type Hook struct {
    F            func() // func to run
    RunOnFailure bool   // whether to run on non-zero exit code
}