xref: /freebsd/share/examples/perfmon/README (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1`perfmon' is a sample program to access the performance-monitoring
2counters on Pentium and Pentium Pro CPUs.  See perfmon(4) for a
3description of this facility.
4
5The program takes the following options:
6
7	-u	count events in user mode
8	-o	count events in kernel mode
9		(these two can be combined)
10
11	-e	count events, not duration
12	-l n	run `n' loops (default 50)
13	-s n	sleep `n' seconds between loop iterations (default 0)
14
15The following options are not implemented on Pentium CPUs:
16
17	-m n	use count mask `n'
18	-i	invert sense of count mask comparison
19	-U n	use unit mask `n'
20
21There is one mandatory argument, which is the event number to be
22monitored, defined in <machine/perfmon.h>.  All numbers can be
23specified in any format acceptable to strtol(3).
24