freebsd man page for pmc_get_driver_stats

PMC_GET_DRIVER_STATS(3) 				   BSD Library Functions Manual 				   PMC_GET_DRIVER_STATS(3)

NAME
     pmc_get_driver_stats -- retrieve driver statistics

LIBRARY
     Performance Counters Library (libpmc, -lpmc)

SYNOPSIS
     #include <pmc.h>

     int
     pmc_get_driver_stats(struct pmc_driverstats *gms);

DESCRIPTION
     The function pmc_get_driver_statistics() retrieves a snapshot of the usage statistics maintained by hwpmc(4) into the memory area pointed to
     by argument gms.

     The returned structure includes the following fields:
	   pm_intr_ignored	The number of sampling interrupts ignored.
	   pm_intr_processed	The number of sampling interrupts processed.
	   pm_intr_bufferfull	The number of sampling interrupts dropped due to lack of space in the sample buffer.
	   pm_syscalls		The number of system calls into hwpmc(4).
	   pm_syscalls_errors	The number of system calls into hwpmc(4) that failed.
	   pm_buffer_requests	The number of log buffer requests so far.
	   pm_buffer_requests_failed
				The number of log buffer requests that failed due to lack of buffers.
	   pm_log_sweeps	The number of sample buffer processing sweeps.

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.

SEE ALSO
     pmc(3), hwpmc(4)

BSD
								 November 25, 2007							       BSD