aboutsummaryrefslogtreecommitdiffhomepage
path: root/internal/fmsg/fmsg.go
blob: 48538380c077b1d38af117f2326136970b25bfe9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
// Package fmsg provides various functions for output messages.
package fmsg

import (
	"bytes"
	"io"
	"log"
	"os"
	"sync"
	"sync/atomic"
	"syscall"
)

const (
	bufSize    = 4 * 1024
	bufSizeMax = 16 * 1024 * 1024
)

var o = &suspendable{w: os.Stderr}

// Prepare configures the system logger for [Suspend] and [Resume] to take effect.
func Prepare(prefix string) { log.SetPrefix(prefix + ": "); log.SetFlags(0); log.SetOutput(o) }

type suspendable struct {
	w io.Writer
	s atomic.Bool

	buf     bytes.Buffer
	bufOnce sync.Once
	bufMu   sync.Mutex
	dropped int
}

func (s *suspendable) Write(p []byte) (n int, err error) {
	if !s.s.Load() {
		return s.w.Write(p)
	}
	s.bufOnce.Do(func() { s.prepareBuf() })

	s.bufMu.Lock()
	defer s.bufMu.Unlock()

	if l := len(p); s.buf.Len()+l > bufSizeMax {
		s.dropped += l
		return 0, syscall.ENOMEM
	}
	return s.buf.Write(p)
}

func (s *suspendable) prepareBuf()   { s.buf.Grow(bufSize) }
func (s *suspendable) Suspend() bool { return o.s.CompareAndSwap(false, true) }
func (s *suspendable) Resume() (resumed bool, dropped uintptr, n int64, err error) {
	if o.s.CompareAndSwap(true, false) {
		o.bufMu.Lock()
		defer o.bufMu.Unlock()

		resumed = true
		dropped = uintptr(o.dropped)

		o.dropped = 0
		n, err = io.Copy(s.w, &s.buf)
		s.buf = bytes.Buffer{}
		s.prepareBuf()
	}
	return
}

func Suspend() bool { return o.Suspend() }
func Resume() bool {
	resumed, dropped, _, err := o.Resume()
	if err != nil {
		// probably going to result in an error as well,
		// so this call is as good as unreachable
		log.Printf("cannot dump buffer on resume: %v", err)
	}
	if resumed && dropped > 0 {
		log.Fatalf("dropped %d bytes while output is suspended", dropped)
	}
	return resumed
}

func BeforeExit() {
	if Resume() {
		log.Printf("beforeExit reached on suspended output")
	}
}