File: reader.go

package info (click to toggle)
golang-github-crowdsecurity-dlog 0.0.1-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 120 kB
  • sloc: makefile: 2
file content (107 lines) | stat: -rw-r--r-- 2,616 bytes parent folder | download
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
// Package dlog provides utilities to read Docker Logs API stream format.
package dlog

import (
	"encoding/binary"
	"fmt"
	"io"
)

const (
	// these should match https://github.com/docker/docker/blob/master/pkg/stdcopy/stdcopy.go
	stdWriterPrefixLen = 8 // len of header
	stdWriterSizeIndex = 4 // size byte index in header

	initialBufLen = 1024 * 2
	maxMsgLen     = 1024 * 64
)

type reader struct {
	r io.Reader // original reader

	// reader state
	inMsg     bool
	msgLen    uint32
	cursor    uint32
	buf       []byte
	prefixBuf []byte
}

// NewReader returns a reader that strips off the message headers from the
// underlying raw docker logs stream and returns the messages.
func NewReader(r io.Reader) io.Reader {
	return &reader{
		r:         r,
		prefixBuf: make([]byte, stdWriterPrefixLen),
		buf:       make([]byte, initialBufLen)}
}

func (r *reader) Read(p []byte) (n int, err error) {
	// at the beginning of a message, parse and store the message
	if !r.inMsg {
		if err := r.parse(); err != nil {
			return 0, err
		}
		r.inMsg = true
	}

	n, err = r.readMsg(p) // serve from buf
	if err == io.EOF {
		err = nil // continue next msg (parse() handles the EOF from r.r)
		r.inMsg = false
	}
	return
}

func (r *reader) readMsg(p []byte) (int, error) {
	if r.cursor >= r.msgLen {
		return 0, io.EOF
	}
	n := copy(p, r.buf[r.cursor:r.msgLen])
	r.cursor += uint32(n)
	return n, nil
}

func (r *reader) parse() error {
	n, err := io.ReadFull(r.r, r.prefixBuf)
	if err != nil {
		switch err {
		case io.EOF:
			return err // end of the underlying logs stream
		case io.ErrUnexpectedEOF:
			return fmt.Errorf("dlog: corrupted prefix. read %d bytes", n)
		default:
			return fmt.Errorf("dlog: error reading prefix: %v", err)
		}
	}

	if r.prefixBuf[0] != 0x1 && r.prefixBuf[0] != 0x2 {
		return fmt.Errorf("dlog: unexpected stream byte: %#x", r.prefixBuf[0])
	}

	size := binary.BigEndian.Uint32(r.prefixBuf[stdWriterSizeIndex : stdWriterSizeIndex+4])
	if size > maxMsgLen { // safeguard to prevent reading garbage
		return fmt.Errorf("dlog: parsed msg too large: %d (max: %d) suspected garbage", size, maxMsgLen)
	}

	// grow buf if necessary
	if int(size) > len(r.buf) {
		r.buf = make([]byte, size)
	}

	// read the message body into buf
	m, err := io.ReadFull(r.r, r.buf[:int(size)])
	if err != nil {
		switch err {
		case io.EOF, io.ErrUnexpectedEOF:
			return fmt.Errorf("dlog: corrupt message read %d out of %d bytes: %v", m, size, err)
		default:
			return fmt.Errorf("dlog: failed to read message: %v", err)
		}
	}

	// reset cursors for the new message
	r.msgLen = size
	r.cursor = 0
	return nil
}