gem5::probing Namespace Reference

Name space containing shared probe point declarations. More...

Classes
struct	PacketInfo
	A struct to hold on to the essential fields from a packet, so that the packet and underlying request can be safely passed on, and consequently modified or even deleted. More...

Typedefs
typedef ProbePointArg< PacketInfo >	Packet
	Packet probe point.
typedef std::unique_ptr< Packet >	PacketUPtr
typedef ProbePointArg< uint64_t >	PMU
	PMU probe point.
typedef std::unique_ptr< PMU >	PMUUPtr

Detailed Description

Name space containing shared probe point declarations.

Probe types that are shared between multiple types of SimObjects should live in this name space. This makes it possible to use a common instrumentation interface for devices such as PMUs that have different implementations in different ISAs.

Typedef Documentation

Packet

typedef ProbePointArg<PacketInfo> gem5::probing::Packet

Packet probe point.

This probe point provides a unified interface for components that want to instrument Packets in the memory system. Components should when possible adhere to the following naming scheme:

• PktRequest: Requests sent out on the memory side of a normal components and incoming requests for memories. Packets should not be duplicated (i.e., a packet should only appear once irrespective of the receiving end requesting a retry).

• PktResponse: Response received from the memory side of a normal component or a response being sent out from a memory.

• PktRequestCPU: Incoming, accepted, memory request on the CPU side of a two-sided component. This probe point is primarily intended for components that cache or forward requests (e.g., caches and XBars), single-sided components should use PktRequest instead. The probe point should only be called when a packet is accepted.

• PktResponseCPU: Outgoing response memory request on the CPU side of a two-sided component. This probe point is primarily intended for components that cache or forward requests (e.g., caches and XBars), single-sided components should use PktRequest instead.

Definition at line 108 of file mem.hh.

PacketUPtr

typedef std::unique_ptr<Packet> gem5::probing::PacketUPtr

Definition at line 109 of file mem.hh.

PMU

typedef ProbePointArg<uint64_t> gem5::probing::PMU

PMU probe point.

This probe point provides a unified interface for PMU instrumentation of SimObjects. SimObjects that need PMU instrumentation should implement probes of this type call the notify method with the event count increment as its only parameter.

Definition at line 59 of file pmu.hh.

PMUUPtr

typedef std::unique_ptr<PMU> gem5::probing::PMUUPtr

Definition at line 60 of file pmu.hh.