114895Swollman`perfmon' is a sample program to access the performance-monitoring
214895Swollmancounters on Pentium and Pentium Pro CPUs.  See perfmon(4) for a
314895Swollmandescription of this facility.
414895Swollman
514895SwollmanThe program takes the following options:
614895Swollman
714895Swollman	-u	count events in user mode
814895Swollman	-o	count events in kernel mode
914895Swollman		(these two can be combined)
1014895Swollman
1114895Swollman	-e	count events, not duration
1214895Swollman	-l n	run `n' loops (default 50)
1314895Swollman	-s n	sleep `n' seconds between loop iterations (default 0)
1414895Swollman
1514895SwollmanThe following options are not implemented on Pentium CPUs:
1614895Swollman
1714895Swollman	-m n	use count mask `n'
1814895Swollman	-i	invert sense of count mask comparison
1914895Swollman	-U n	use unit mask `n'
2014895Swollman
2176122SddThere is one mandatory argument, which is the event number to be
2276122Sddmonitored, defined in <machine/perfmon.h>.  All numbers can be
2376122Sddspecified in any format acceptable to strtol(3).
2414895Swollman
2550476Speter$FreeBSD: releng/10.2/share/examples/perfmon/README 76122 2001-04-29 03:54:48Z dd $
26