pmc_name_of_disposition(3)

Usage

const char *

Library

library “libpmc”

Overview

These convenience functions translate numeric constants used by the library “libpmc” to const char * pointers to human readable representations of their arguments.

Function pmc_name_of_capability() translates a PMC capability flag given in argument pc to a human readable string. PMC capabilities are described in pmc(3).

Function pmc_name_of_class() translates the PMC class value specified in argument pc to a human readable name. PMC classes are described in pmc(3).

Function pmc_name_of_cputype() translates the CPU type value specified in argument ct to a human readable name. CPU types known to the library are described in pmc(3).

Function pmc_name_of_disposition() translates the PMC row disposition specified in argument pd to a human readable name. PMC row dispositions are described in hwpmc(4).

Function pmc_name_of_event() translates the PMC event number specified by argument pe to a string. PMC event names are documented in section EVENT SPECIFIERS of pmc(3).

Function pmc_name_of_mode() translates the PMC mode specified by argument pm to a human readable string. PMC modes are described in pmc(3).

Function pmc_name_of_state() translates the value of argument ps to a human readable name.

Implementation notes

The returned pointers point to static storage inside the PMC library and should not be freed by the caller.

Return values

These functions return a non-NULL pointer on successful completion. In case of an error, a NULL pointer is returned and the global variable errno is set to indicate the error.

Errors

A call to these functions may fail with the following errors:

[EINVAL]: The function argument specified an invalid value.

History

FreeBSD 16.0-CURRENT (2026-10-27) to FreeBSD 13.3-RELEASE: the text shown here
FreeBSD 13.2-RELEASE to FreeBSD 13.0-RELEASE
FreeBSD 12.4-RELEASE
FreeBSD 12.3-RELEASE
FreeBSD 12.2-RELEASE
FreeBSD 12.1-RELEASE
FreeBSD 12.0-RELEASE
FreeBSD 11.4-RELEASE
FreeBSD 11.3-RELEASE
FreeBSD 11.2-RELEASE
FreeBSD 11.1-RELEASE
FreeBSD 11.0-RELEASE
FreeBSD 10.4-RELEASE
FreeBSD 10.3-RELEASE
FreeBSD 10.2-RELEASE
FreeBSD 10.1-RELEASE
FreeBSD 10.0-RELEASE
FreeBSD 9.3-RELEASE
FreeBSD 9.2-RELEASE
FreeBSD 9.1-RELEASE
FreeBSD 9.0-RELEASE
FreeBSD 8.4-RELEASE
FreeBSD 8.3-RELEASE
FreeBSD 8.2-RELEASE
FreeBSD 8.1-RELEASE
FreeBSD 8.0-RELEASE
FreeBSD 7.4-RELEASE
FreeBSD 7.3-RELEASE