pmc_write man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD 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 FreeBSD

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