package
0.0.0-20230303194329-7b712e5ff658
Repository: https://github.com/aclements/go-perf.git
Documentation: pkg.go.dev

# Functions

New reads a "perf.data" file from r.
Open opens the named "perf.data" file using os.Open.

# Constants

Sample collided with another.
AUX data was collected in overwrite mode, so the AUX buffer was treated as a circular ring buffer.
Record contains gaps.
Record was truncated to fit in the ring buffer.
ARM Coresight format CORESIGHT.
ARM Coresight format RAW.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
BranchFlagAbort indicates the branch is a transaction abort.
BranchFlagInTransaction indicates the branch occurred in a transaction.
BranchFlagMispredicted indicates branch target was mispredicted.
BranchFlagPredicted indicates branch target was predicted.
Transaction aborts.
Any branch types.
Any call branch.
Any return branch.
Direct call.
Call/ret stack.
Conditional branches.
Hypervisor branches.
Do set RecordSample.BranchHWIndex.
Indirect calls.
Indirect jumps.
In transaction.
Kernel branches.
Don't set BranchRecord.Cycles.
Don't set BranchRecord.Flags.
Not in transaction.
Do set BranchRecord.Type.
User branches.
function call.
conditional.
conditional function call.
conditional function return.
exception return.
indirect.
indirect function call.
interrupt.
function return.
syscall.
syscall return.
unconditional.
unknown.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
-2048.
-2176.
-2560.
-32.
-128.
-512.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Address conflict.
Data could not be forwarded.
No description provided by the author
Remote board.
Remote core, same node.
No description provided by the author
Remote node, same socket.
Remote socket, same board.
I/O memory.
No description provided by the author
No description provided by the author
No description provided by the author
Line fill buffer.
Local DRAM.
No description provided by the author
Any cache.
L1.
L2.
L3.
L4.
LFB.
N/A.
PMEM.
RAM.
Remote cache (1 hop).
Remote cache (2 hops).
Remote DRAM (1 hop).
Remote DRAM (2 hops).
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Snoop hit modified.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Generate aux records instead of events.
Use build ID in mmap2 events instead of inode.
Include cgroup events.
Use clock specified by clockid for time fields.
Include comm data.
Flag comm events that are due to an exec.
Record context switch data.
Event is disabled by default.
Next exec enables this event.
Don't include kernel/user callchains.
No description provided by the author
No description provided by the author
Don't count events in host/guest.
No description provided by the author
No description provided by the author
No description provided by the author
Don't count events in user/kernel/hypervisor/when idle.
Event is only group on PMU.
Use frequency, not period.
Children inherit this event.
Per task counts.
Children only inherit if cloned with CLONE_THREAD.
Include ksymbol events.
Include mmap data.
Non-exec mmap data.
Include inode data in mmap events.
Include namespaces data.
Event must always be on the PMU.
Event is removed from task on exec.
All events have SampleField fields.
Send synchronous SIGTRAP on event.
Trace fork/exit.
Include text poke events.
WakeupWatermark is set rather than WakeupEvents.
Write ring buffer from end to beginning.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Ksymbol was unregistered.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
RecordsCausalOrder requests records in causal order.
RecordsFileOrder requests records in file order.
RecordsTimeOrder requests records in time-stamp order.
No description provided by the author
No description provided by the author
perf_user_event_type in tools/perf/util/event.h TODO: Figure out what to do with these.
TODO.
TODO.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
TODO: How does this differ from RecordTypeLost?.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
Instruction is not related.
Capactiy read abort.
Capactiy write abort.
Conflict abort.
From elision.
Retry possible.
Instruction is related.
From transaction.

# Structs

A BranchRecord records a single branching event in a sample.
A BuildIDInfo records the mapping between a single build ID and the path of an executable with that build ID.
A Count records the raw value of an event counter.
No description provided by the author
EventAttr describes an event and how that event should be recorded.
EventBreakpoint represents a breakpoint event.
EventGeneric is a generic representation of a performance event.
EventHardware represents a hardware event.
EventHWCache represents a hardware cache event.
A File is a perf.data file.
No description provided by the author
A GroupDesc describes a group of PMU events that are scheduled together.
No description provided by the author
A NUMANode represents a single hardware NUMA node.
A RecordAux records the data was added to the AUX buffer.
RecordAuxOutputHardwareID records an archtecture-specific hardware ID assosciated with the aux data for this event ID.
No description provided by the author
No description provided by the author
RecordBPFEvent records BPF program load/unload information.
RecordCGroup records the assosciation between a cgroup id and path.
A RecordComm records that a process being profiled called exec.
RecordCommon stores fields that are common to all record types, as well as additional metadata.
A RecordExit records that a process or thread exited.
A RecordFork records that a process called clone to either fork the process or create a new thread.
A RecordItraceStart indicates that an instruction trace started.
RecordKsymbol record kernel symbol register/unregister information, for dynamically loaded or JITed kernel functions.
A RecordLost records that profiling events were lost because of a buffer overflow.
A RecordLostSamples records the number of dropped or lost samples.
A RecordMmap records when a process being profiled called mmap.
No description provided by the author
A Records is an iterator over the records in a "perf.data" file.
A RecordSample records a profiling sample event.
A RecordSwitch records a context switch in or out of the monitored process.
RecordSwitchCPUWide is a CPU-wide version of RecordSwitch.
RecordTextPoke records single instruction changes to the kernel text.
A RecordThrottle records that interrupt throttling was enabled or disabled.
A RecordUnknown is a Record of unknown or unimplemented type.
No description provided by the author

# Interfaces

Event describes a specific performance monitoring event.
Record is the common interface implemented by all profile record types.

# Type aliases

AuxFlags gives flags for an RecordAux event.
AuxPMUFormat is the PMU specific trace format type.
No description provided by the author
No description provided by the author
No description provided by the author
BranchSampleType is a bit-field of the types of branches to record in the branch stack.
No description provided by the author
BreakpointOp is a type of memory access that can trigger a breakpoint event.
No description provided by the author
A CPUMode indicates the privilege level of a sample or event.
A CPUSet represents a set of CPUs by CPU index.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
EventFlags is a bitmask of boolean properties of an event.
EventHardwareID represents a hardware event type.
An EventID combined with an EventType describes a specific event.
An EventPrecision indicates the precision of instruction pointers recorded by an event.
EventRaw represents a "raw" hardware PMU event in a CPU-specific format.
EventSoftware represents a software event.
EventTracepoint represents a kernel tracepoint event.
An EventType is a general class of performance event.
HWCache represents a level in the hardware cache.
HWCacheOp represents a type of access to a hardware cache.
HWCacheResult represents the result of a accessing a hardware cache.
KsymbolFlags gives flags for a RecordKsymbol event.
No description provided by the author
PMUTypeID is a kernel-assigned type id assigned on PMU registration, visible at /sys/bus/event_source/devices/$PMU/type.
ReadFormat is a bitmask of the fields recorded in the SampleRead field(s) of a sample.
No description provided by the author
A RecordType indicates the type of a record in a profile.
A SampleFormat is a bitmask of the fields recorded by a sample.
SampleRegsABI indicates the register ABI of a given sample for architectures that support multiple ABIs.
No description provided by the author