pmc_read man page on PC-BSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
PC-BSD logo
[printable version]

PMC_READ(3)		 BSD Library Functions Manual		   PMC_READ(3)

NAME
     pmc_read, pmc_rw, pmc_write, — read and write hardware performace coun‐
     ters

LIBRARY
     Performance Counters Library (libpmc, -lpmc)

SYNOPSIS
     #include <pmc.h>

     int
     pmc_read(pmc_id_t pmc, pmc_value_t *value);

     int
     pmc_rw(pmc_id_t pmc, pmc_value_t newvalue, pmc_value_t *oldvaluep);

     int
     pmc_write(pmc_id_t pmc, pmc_value_t value);

DESCRIPTION
     These functions read and write the current value of a PMC.

     Function pmc_read() with read the current value of the PMC specified by
     argument pmc and write it to the location specified by argument value.

     Function pmc_write() will set the current value of the PMC specified by
     argument pmc to the value specified by argument value.

     Function pmc_rw() combines a read and a write into a single atomic opera‐
     tion.

     For write operations the PMC should be a quiesced state.

RETURN VALUES
     Upon successful completion, the value 0 is returned; otherwise the
     value -1 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:

     [EBUSY]		A write operation specified a currently running PMC.

     [EINVAL]		Argument pmc specified a PMC not in a readable state.

     [EINVAL]		The PMC specified by argument pmc was not owned by the
			current process.

SEE ALSO
     pmc(3), hwpmc(4)

BSD			       November 25, 2007			   BSD
[top]

List of man pages available for PC-BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net