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
108
109
110
111
|
// Copyright 2023 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
// Code generated by "gen.bash" from internal/trace; DO NOT EDIT.
//go:build go1.23
package tracev2
// EventType indicates an event's type from which its arguments and semantics can be
// derived. Its representation matches the wire format's representation of the event
// types that precede all event data.
type EventType uint8
// EventSpec is a specification for a trace event. It contains sufficient information
// to perform basic parsing of any trace event for any version of Go.
type EventSpec struct {
// Name is the human-readable name of the trace event.
Name string
// Args contains the names of each trace event's argument.
// Its length determines the number of arguments an event has.
//
// Argument names follow a certain structure and this structure
// is relied on by the testing framework to type-check arguments
// and to produce Values for experimental events.
//
// The structure is:
//
// (?P<name>[A-Za-z]+)(_(?P<type>[A-Za-z]+))?
//
// In sum, it's a name followed by an optional type.
// If the type is present, it is preceded with an underscore.
// Arguments without types will be interpreted as just raw uint64s.
// The valid argument types and the Go types they map to are listed
// in the ArgTypes variable.
Args []string
// StringIDs indicates which of the arguments are string IDs.
StringIDs []int
// StackIDs indicates which of the arguments are stack IDs.
//
// The list is not sorted. The first index always refers to
// the main stack for the current execution context of the event.
StackIDs []int
// StartEv indicates the event type of the corresponding "start"
// event, if this event is an "end," for a pair of events that
// represent a time range.
StartEv EventType
// IsTimedEvent indicates whether this is an event that both
// appears in the main event stream and is surfaced to the
// trace reader.
//
// Events that are not "timed" are considered "structural"
// since they either need significant reinterpretation or
// otherwise aren't actually surfaced by the trace reader.
IsTimedEvent bool
// HasData is true if the event has trailer consisting of a
// varint length followed by unencoded bytes of some data.
//
// An event may not be both a timed event and have data.
HasData bool
// IsStack indicates that the event represents a complete
// stack trace. Specifically, it means that after the arguments
// there's a varint length, followed by 4*length varints. Each
// group of 4 represents the PC, file ID, func ID, and line number
// in that order.
IsStack bool
// Experiment indicates the ID of an experiment this event is associated
// with. If Experiment is not NoExperiment, then the event is experimental
// and will be exposed as an EventExperiment.
Experiment Experiment
}
// EventArgTypes is a list of valid argument types for use in Args.
//
// See the documentation of Args for more details.
var EventArgTypes = [...]string{
"seq", // sequence number
"pstatus", // P status
"gstatus", // G status
"g", // trace.GoID
"m", // trace.ThreadID
"p", // trace.ProcID
"string", // string ID
"stack", // stack ID
"value", // uint64
"task", // trace.TaskID
}
// EventNames is a helper that produces a mapping of event names to event types.
func EventNames(specs []EventSpec) map[string]EventType {
nameToType := make(map[string]EventType)
for i, spec := range specs {
nameToType[spec.Name] = EventType(byte(i))
}
return nameToType
}
// Experiment is an experiment ID that events may be associated with.
type Experiment uint
// NoExperiment is the reserved ID 0 indicating no experiment.
const NoExperiment Experiment = 0
|
