NAME
pmc.soft – measurements using software based events
LIBRARY
library “libpmc”
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.ibs(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 library “libpmc” library was written by Joseph Koshy ⟨[email protected]⟩. Software PMC was written by Fabien Thomas ⟨[email protected]⟩.