An instance of a performance counter. More...

#include <perfevent.hh>

Public Member Functions
	PerfKvmCounter (PerfKvmCounterConfig &config, pid_t tid)
	Create and attach a new counter group. More...

	PerfKvmCounter (PerfKvmCounterConfig &config, pid_t tid, const PerfKvmCounter &parent)
	Create and attach a new counter and make it a member of an exist counter group. More...

	PerfKvmCounter ()
	Create a new counter, but don't attach it. More...

	~PerfKvmCounter ()

void	attach (PerfKvmCounterConfig &config, pid_t tid)
	Attach a counter. More...

void	attach (PerfKvmCounterConfig &config, pid_t tid, const PerfKvmCounter &parent)
	Attach a counter and make it a member of an existing counter group. More...

void	detach ()
	Detach a counter from PerfEvent. More...

bool	attached () const
	Check if a counter is attached. More...

void	start ()
	Start counting. More...

void	stop ()
	Stop counting. More...

void	period (uint64_t period)
	Update the period of an overflow counter. More...

void	refresh (int refresh)
	Enable a counter for a fixed number of events. More...

uint64_t	read () const
	Read the current value of a counter. More...

void	enableSignals (pid_t tid, int signal)
	Enable signal delivery to a thread on counter overflow. More...

void	enableSignals (int signal)
	Enable signal delivery on counter overflow. More...

Private Member Functions
	PerfKvmCounter (const PerfKvmCounter &that)

PerfKvmCounter &	operator= (const PerfKvmCounter &that)

void	attach (PerfKvmCounterConfig &config, pid_t tid, int group_fd)

pid_t	sysGettid ()
	Get the TID of the current thread. More...

void	mmapPerf (int pages)
	MMAP the PerfEvent file descriptor. More...

void	read (void *buf, size_t size) const
	Perform a read from the counter file descriptor. More...


int	fcntl (int cmd, long p1)
	PerfEvent fnctl interface. More...

int	fcntl (int cmd, void *p1)


int	ioctl (int request, long p1)
	PerfEvent ioctl interface. More...

int	ioctl (int request, void *p1)

int	ioctl (int request)

Private Attributes
int	fd
	PerfEvent file descriptor associated with counter. More...

struct perf_event_mmap_page *	ringBuffer
	Memory mapped PerfEvent sample ring buffer. More...

int	ringNumPages
	Total number of pages in ring buffer. More...

long	pageSize
	Cached host page size. More...

Detailed Description

An instance of a performance counter.

Definition at line 168 of file perfevent.hh.

Constructor & Destructor Documentation

◆ PerfKvmCounter() [1/4]

PerfKvmCounter::PerfKvmCounter	(	PerfKvmCounterConfig &	config,
		pid_t	tid
	)

Create and attach a new counter group.

Parameters

config	Counter configuration
tid	Thread to sample (0 indicates current thread)

Definition at line 68 of file perfevent.cc.

References attach().

◆ PerfKvmCounter() [2/4]

PerfKvmCounter::PerfKvmCounter	(	PerfKvmCounterConfig &	config,
		pid_t	tid,
		const PerfKvmCounter &	parent
	)

Create and attach a new counter and make it a member of an exist counter group.

Parameters

config	Counter configuration
tid	Thread to sample (0 indicates current thread)
parent	Group leader

Definition at line 74 of file perfevent.cc.

References attach().

◆ PerfKvmCounter() [3/4]

PerfKvmCounter::PerfKvmCounter ( )

Create a new counter, but don't attach it.

Definition at line 81 of file perfevent.cc.

◆ ~PerfKvmCounter()

PerfKvmCounter::~PerfKvmCounter ( )

Definition at line 86 of file perfevent.cc.

References attached(), and detach().

◆ PerfKvmCounter() [4/4]

PerfKvmCounter::PerfKvmCounter ( const PerfKvmCounter & that )

private

Member Function Documentation

◆ attach() [1/3]

void PerfKvmCounter::attach	(	PerfKvmCounterConfig &	config,
		pid_t	tid
	)

inline

Attach a counter.

Note: This operation is only supported if the counter isn't already attached.

Parameters

config	Counter configuration
tid	Thread to sample (0 indicates current thread)

Definition at line 204 of file perfevent.hh.

Referenced by attach(), PerfKvmCounter(), BaseKvmCPU::setupCounters(), and BaseKvmCPU::setupInstCounter().

◆ attach() [2/3]

void PerfKvmCounter::attach	(	PerfKvmCounterConfig &	config,
		pid_t	tid,
		const PerfKvmCounter &	parent
	)

inline

Attach a counter and make it a member of an existing counter group.

Note: This operation is only supported if the counter isn't already attached.

Parameters

config	Counter configuration
tid	Thread to sample (0 indicates current thread)
parent	Group leader

Definition at line 219 of file perfevent.hh.

References attach(), and fd.

◆ attach() [3/3]

void PerfKvmCounter::attach	(	PerfKvmCounterConfig &	config,
		pid_t	tid,
		int	group_fd
	)

private

Definition at line 159 of file perfevent.cc.

References attached(), PerfKvmCounterConfig::attr, fd, mmapPerf(), and panic.

◆ attached()

bool PerfKvmCounter::attached ( ) const

inline

Check if a counter is attached.

Definition at line 228 of file perfevent.hh.

References fd.

Referenced by attach(), detach(), fcntl(), ioctl(), mmapPerf(), read(), BaseKvmCPU::setupInstCounter(), and ~PerfKvmCounter().

◆ detach()

void PerfKvmCounter::detach ( )

Detach a counter from PerfEvent.

Definition at line 93 of file perfevent.cc.

References attached(), fd, pageSize, ringBuffer, ringNumPages, and warn.

Referenced by BaseKvmCPU::notifyFork(), BaseKvmCPU::setupInstCounter(), and ~PerfKvmCounter().

◆ enableSignals() [1/2]

void PerfKvmCounter::enableSignals ( int signal )

inline

Enable signal delivery on counter overflow.

Identical to enableSignals(pid_t) when called with the current TID as its parameter.

Parameters

signal Signal to send upon overflow

Definition at line 298 of file perfevent.hh.

References enableSignals(), and sysGettid().

Referenced by enableSignals().

◆ enableSignals() [2/2]

void PerfKvmCounter::enableSignals	(	pid_t	tid,
		int	signal
	)

Enable signal delivery to a thread on counter overflow.

Parameters

tid	Thread to deliver signal to
signal	Signal to send upon overflow

Definition at line 144 of file perfevent.cc.

References fcntl(), and panic.

Referenced by PerfKvmTimer::PerfKvmTimer(), and BaseKvmCPU::setupInstCounter().

◆ fcntl() [1/2]

int PerfKvmCounter::fcntl	(	int	cmd,
		long	p1
	)

private

PerfEvent fnctl interface.

Parameters

cmd	fcntl command
p1	Request parameter

Returns: -1 on error (error number in errno), ioctl dependent value otherwise.

Definition at line 216 of file perfevent.cc.

References attached(), and fd.

Referenced by enableSignals().

◆ fcntl() [2/2]

int PerfKvmCounter::fcntl	(	int	cmd,
		void *	p1
	)

inlineprivate

Definition at line 340 of file perfevent.hh.

References fcntl().

Referenced by fcntl().

◆ ioctl() [1/3]

int PerfKvmCounter::ioctl ( int request )

inlineprivate

Definition at line 355 of file perfevent.hh.

References ioctl(), and X86ISA::L.

Referenced by ioctl().

◆ ioctl() [2/3]

int PerfKvmCounter::ioctl	(	int	request,
		long	p1
	)

private

PerfEvent ioctl interface.

Parameters

request	PerfEvent request
p1	Optional request parameter

Returns: -1 on error (error number in errno), ioctl dependent value otherwise.

Definition at line 223 of file perfevent.cc.

References attached(), and fd.

Referenced by period(), refresh(), start(), and stop().

◆ ioctl() [3/3]

int PerfKvmCounter::ioctl	(	int	request,
		void *	p1
	)

inlineprivate

Definition at line 354 of file perfevent.hh.

References ioctl().

Referenced by ioctl().

◆ mmapPerf()

void PerfKvmCounter::mmapPerf ( int pages )

private

MMAP the PerfEvent file descriptor.

Note: We currently don't use the ring buffer, but PerfEvent requires this to be mapped for overflow handling to work.; Overflow handling requires at least one buf_page to be mapped.

Parameters

pages number of pages in circular sample buffer. Must be an even power of 2.

Definition at line 193 of file perfevent.cc.

References attached(), fd, pageSize, panic, ringBuffer, and ringNumPages.

Referenced by attach().

◆ operator=()

PerfKvmCounter& PerfKvmCounter::operator= ( const PerfKvmCounter & that )

private

◆ period()

void PerfKvmCounter::period ( uint64_t period )

Update the period of an overflow counter.

Warning: This ioctl has some pretty bizarre semantics. It seems like the new period isn't effective until after the next counter overflow. If you use this method to change the sample period, you will see one sample with the old period and then start sampling with the new period. This problem was fixed for ARM in version 3.7 of the kernel.; This method doesn't work at all on some 2.6.3x kernels since it has inverted check for the return value when copying parameters from userspace.

Parameters

period Overflow period in events

Definition at line 121 of file perfevent.cc.

References ioctl(), and panic.

Referenced by PerfKvmTimer::arm().

◆ read() [1/2]

uint64_t PerfKvmCounter::read ( ) const

Read the current value of a counter.

Definition at line 135 of file perfevent.cc.

Referenced by BaseKvmCPU::getHostCycles(), BaseKvmCPU::kvmRun(), and read().

◆ read() [2/2]

void PerfKvmCounter::read	(	void *	buf,
		size_t	size
	)		const

private

Perform a read from the counter file descriptor.

Parameters

buf	Destination buffer
size	Amount of data to read

Definition at line 230 of file perfevent.cc.

References attached(), fd, panic, and read().

◆ refresh()

void PerfKvmCounter::refresh ( int refresh )

Enable a counter for a fixed number of events.

When this method is called, perf event enables the counter if it was disabled. It then leaves the counter enabled until it has overflowed a refresh times.

Note: This does not update the period of the counter.

Parameters

refresh Number of overflows before disabling the counter.

Definition at line 128 of file perfevent.cc.

References ioctl(), and panic.

Referenced by PerfKvmTimer::arm().

◆ start()

void PerfKvmCounter::start ( )

Start counting.

Note: If this counter is a group leader, it will start the entire group.

Definition at line 107 of file perfevent.cc.

References ioctl(), and panic.

Referenced by BaseKvmCPU::kvmRun().

◆ stop()

void PerfKvmCounter::stop ( )

Stop counting.

Note: If this counter is a group leader, it will stop the entire group.

Definition at line 114 of file perfevent.cc.

References ioctl(), and panic.

Referenced by PerfKvmTimer::disarm(), and BaseKvmCPU::kvmRun().

◆ sysGettid()

pid_t PerfKvmCounter::sysGettid ( )

private

Get the TID of the current thread.

Returns: Current thread's TID

Definition at line 187 of file perfevent.cc.

Referenced by enableSignals().

Member Data Documentation

◆ fd

int PerfKvmCounter::fd

private

PerfEvent file descriptor associated with counter.

-1 if not attached to PerfEvent.

Definition at line 370 of file perfevent.hh.

Referenced by attach(), attached(), detach(), fcntl(), ioctl(), mmapPerf(), and read().

◆ pageSize

long PerfKvmCounter::pageSize

private

Cached host page size.

Definition at line 378 of file perfevent.hh.

Referenced by detach(), and mmapPerf().

◆ ringBuffer

struct perf_event_mmap_page* PerfKvmCounter::ringBuffer

private

Memory mapped PerfEvent sample ring buffer.

Definition at line 373 of file perfevent.hh.

Referenced by detach(), and mmapPerf().

◆ ringNumPages

int PerfKvmCounter::ringNumPages

private

Total number of pages in ring buffer.

Definition at line 375 of file perfevent.hh.

Referenced by detach(), and mmapPerf().

The documentation for this class was generated from the following files:

cpu/kvm/perfevent.hh
cpu/kvm/perfevent.cc

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ PerfKvmCounter() [1/4]

◆ PerfKvmCounter() [2/4]

◆ PerfKvmCounter() [3/4]

◆ ~PerfKvmCounter()

◆ PerfKvmCounter() [4/4]

Member Function Documentation

◆ attach() [1/3]

◆ attach() [2/3]

◆ attach() [3/3]

◆ attached()

◆ detach()

◆ enableSignals() [1/2]

◆ enableSignals() [2/2]

◆ fcntl() [1/2]

◆ fcntl() [2/2]

◆ ioctl() [1/3]

◆ ioctl() [2/3]

◆ ioctl() [3/3]

◆ mmapPerf()

◆ operator=()

◆ period()

◆ read() [1/2]

◆ read() [2/2]

◆ refresh()

◆ start()

◆ stop()

◆ sysGettid()

Member Data Documentation

◆ fd

◆ pageSize

◆ ringBuffer

◆ ringNumPages