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.

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>.