NAME
pmc.soft —
measurements using software based
events
LIBRARY
Performance Counters Library (libpmc, -lpmc)
SYNOPSIS
#include
<pmc.h>
DESCRIPTION
Software events are used to collect various source of software events.
PMC Features
16 sampling counters using software events based on various sources. These PMCs support the following capabilities:
| Capability | Support |
| PMC_CAP_CASCADE | No |
| PMC_CAP_EDGE | No |
| PMC_CAP_INTERRUPT | Yes |
| PMC_CAP_INVERT | No |
| PMC_CAP_READ | Yes |
| PMC_CAP_PRECISE | No |
| PMC_CAP_SYSTEM | Yes |
| PMC_CAP_TAGGING | No |
| PMC_CAP_THRESHOLD | No |
| PMC_CAP_USER | Yes |
| PMC_CAP_WRITE | Yes |
Event Qualifiers
There is no supported event qualifier.
The event specifiers supported by software are:
CLOCK.HARD- Hard clock ticks.
CLOCK.STAT- Stat clock ticks.
CLOCK.PROF- Profiling clock ticks.
INTR.ALL- Interrupt filter executed
INTR.FILTER- Interrupt filter returned FILTER_HANDLED.
INTR.ITHREAD- Interrupt filter returned FILTER_SCHEDULE_ITHREAD.
INTR.SCHEDULE- Ithread scheduled.
INTR.STRAY- Interrupt filter returned FILTER_STRAY.
INTR.WAITING- Ithread not scheduled, already active.
LOCK.FAILED- Lock acquisition failed.
PAGE_FAULT.ALL- All page fault type.
PAGE_FAULT.READ- Read page fault.
PAGE_FAULT.WRITE- Write page fault.
SEE ALSO
pmc(3), pmc.amd(3), pmc.atom(3), pmc.core(3), pmc.corei7(3), pmc.corei7uc(3), pmc.iaf(3), pmc.tsc(3), pmc.ucf(3), pmc.westmereuc(3), pmc_cpuinfo(3), pmclog(3), hwpmc(4)
HISTORY
The pmc library first appeared in
FreeBSD 6.0.
AUTHORS
The Performance Counters Library (libpmc, -lpmc) library was written by Joseph Koshy <jkoshy@FreeBSD.org>. Software PMC was written by Fabien Thomas <fabient@FreeBSD.org>.