Changeset View
Changeset View
Standalone View
Standalone View
lib/libpmc/pmc.3
Show All 17 Lines | |||||||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||||||
.\" | .\" | ||||||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||||||
.\" | .\" | ||||||||
.Dd August 10, 2021 | .Dd May 28, 2022 | ||||||||
.Dt PMC 3 | .Dt PMC 3 | ||||||||
.Os | .Os | ||||||||
.Sh NAME | .Sh NAME | ||||||||
.Nm pmc | .Nm pmc | ||||||||
.Nd library for accessing hardware performance monitoring counters | .Nd library for accessing hardware performance monitoring counters | ||||||||
.Sh LIBRARY | .Sh LIBRARY | ||||||||
.Lb libpmc | .Lb libpmc | ||||||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||||||
▲ Show 20 Lines • Show All 160 Lines • ▼ Show 20 Lines | |||||||||
the | the | ||||||||
.Vt "enum pmc_caps" | .Vt "enum pmc_caps" | ||||||||
enumeration. | enumeration. | ||||||||
Supported capabilities include: | Supported capabilities include: | ||||||||
.Pp | .Pp | ||||||||
.Bl -tag -width "Li PMC_CAP_INTERRUPT" -compact | .Bl -tag -width "Li PMC_CAP_INTERRUPT" -compact | ||||||||
.It Li PMC_CAP_CASCADE | .It Li PMC_CAP_CASCADE | ||||||||
The ability to cascade counters. | The ability to cascade counters. | ||||||||
.It Li PMC_CAP_DOMWIDE | |||||||||
One counter in each NUMA domain. | |||||||||
pauamma_gundo.com: Unclear to me. Do you mean something like "Counters can be tied/specific to each NUMA domain"? | |||||||||
allanjudeUnsubmitted Done Inline ActionsIt means that there will be a separate value/counter for each NUMA domain allanjude: It means that there will be a separate value/counter for each NUMA domain | |||||||||
pauamma_gundo.comUnsubmitted Done Inline Actions
pauamma_gundo.com: | |||||||||
tsoomeAuthorUnsubmitted Done Inline Actionsthanks! tsoome: thanks! | |||||||||
.It Li PMC_CAP_EDGE | .It Li PMC_CAP_EDGE | ||||||||
The ability to count negated to asserted transitions of the hardware | The ability to count negated to asserted transitions of the hardware | ||||||||
conditions being probed for. | conditions being probed for. | ||||||||
.It Li PMC_CAP_INTERRUPT | .It Li PMC_CAP_INTERRUPT | ||||||||
The ability to interrupt the CPU. | The ability to interrupt the CPU. | ||||||||
.It Li PMC_CAP_INVERT | .It Li PMC_CAP_INVERT | ||||||||
The ability to invert the sense of the hardware conditions being | The ability to invert the sense of the hardware conditions being | ||||||||
measured. | measured. | ||||||||
.It Li PMC_CAP_PRECISE | .It Li PMC_CAP_PRECISE | ||||||||
The ability to perform precise sampling. | The ability to perform precise sampling. | ||||||||
.It Li PMC_CAP_QUALIFIER | .It Li PMC_CAP_QUALIFIER | ||||||||
The hardware allows monitored to be further qualified in some | The hardware allows monitored to be further qualified in some | ||||||||
system dependent way. | system dependent way. | ||||||||
.It Li PMC_CAP_READ | .It Li PMC_CAP_READ | ||||||||
The ability to read from performance counters. | The ability to read from performance counters. | ||||||||
.It Li PMC_CAP_SYSTEM | .It Li PMC_CAP_SYSTEM | ||||||||
The ability to restrict counting of hardware events to when the CPU is | The ability to restrict counting of hardware events to when the CPU is | ||||||||
running privileged code. | running privileged code. | ||||||||
.It Li PMC_CAP_SYSWIDE | |||||||||
System wide counter. | |||||||||
pauamma_gundo.comUnsubmitted Done Inline ActionsLikewise, do you mean "Counters can have a single value shared among all NUMA domains" here? pauamma_gundo.com: Likewise, do you mean "Counters can have a single value shared among all NUMA domains" here? | |||||||||
allanjudeUnsubmitted Done Inline ActionsOne value for the entire system, rather than one per domain allanjude: One value for the entire system, rather than one per domain | |||||||||
pauamma_gundo.comUnsubmitted Done Inline Actions
pauamma_gundo.com: | |||||||||
tsoomeAuthorUnsubmitted Done Inline Actionsthanks! tsoome: thanks! | |||||||||
.It Li PMC_CAP_THRESHOLD | .It Li PMC_CAP_THRESHOLD | ||||||||
The ability to ignore simultaneous hardware events below a | The ability to ignore simultaneous hardware events below a | ||||||||
programmable threshold. | programmable threshold. | ||||||||
.It Li PMC_CAP_USER | .It Li PMC_CAP_USER | ||||||||
The ability to restrict counting of hardware events to those when the | The ability to restrict counting of hardware events to those when the | ||||||||
CPU is running unprivileged code. | CPU is running unprivileged code. | ||||||||
.It Li PMC_CAP_WRITE | .It Li PMC_CAP_WRITE | ||||||||
The ability to write to performance counters. | The ability to write to performance counters. | ||||||||
▲ Show 20 Lines • Show All 299 Lines • Show Last 20 Lines |
Unclear to me. Do you mean something like "Counters can be tied/specific to each NUMA domain"?