diff options
author | jkoshy <jkoshy@FreeBSD.org> | 2005-07-01 03:50:30 +0000 |
---|---|---|
committer | jkoshy <jkoshy@FreeBSD.org> | 2005-07-01 03:50:30 +0000 |
commit | e90ce451cea694ffa38b37df6e681bcb8d59056f (patch) | |
tree | c3af3f09262119311de3411640756dd8944744c2 /usr.sbin/pmcstat/pmcstat.8 | |
parent | 9d5179d4ba115e9b868a77109fe25cf59dce4448 (diff) | |
download | FreeBSD-src-e90ce451cea694ffa38b37df6e681bcb8d59056f.zip FreeBSD-src-e90ce451cea694ffa38b37df6e681bcb8d59056f.tar.gz |
Add examples illustrating how to record system-wide profiles and
how to convert these to gprof(1) flat profiles. Augment description
for the '-g' option.
Remove superfluous quotes around a macro argument, bump document date [1].
Reminded by: ru [1]
Approved by: re (blanket hwpmc)
Diffstat (limited to 'usr.sbin/pmcstat/pmcstat.8')
-rw-r--r-- | usr.sbin/pmcstat/pmcstat.8 | 21 |
1 files changed, 18 insertions, 3 deletions
diff --git a/usr.sbin/pmcstat/pmcstat.8 b/usr.sbin/pmcstat/pmcstat.8 index 881c3b5..fe1f89a 100644 --- a/usr.sbin/pmcstat/pmcstat.8 +++ b/usr.sbin/pmcstat/pmcstat.8 @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd June 24, 2005 +.Dd July 1, 2005 .Os .Dt PMCSTAT 8 .Sh NAME @@ -153,13 +153,17 @@ process' current and future children or only measuring events for the target process. The default is to measure events for the target process alone. .It Fl g -Produce execution profiles in a format compatible with +Produce flat execution profiles in a format compatible with .Xr gprof 1 . +A separate profile file is generated for each executable object +encountered. +Profile files are placed in sub-directories named by their PMC +event name. .It Fl k Ar kernelfile Set the pathname of the kernel to argument .Ar kernelfile . The default is -.Pa "/boot/kernel/kernel" . +.Pa /boot/kernel/kernel . .It Fl n Ar rate Set the default sampling rate for subsequent sampling mode PMCs specified on the command line. @@ -212,6 +216,15 @@ To execute and measure the number of data cache misses suffered by it and its children every 12 seconds on an AMD Athlon, use: .Dl "pmcstat -d -w 12 -p k7-dc-misses mozilla" +.Pp +To collect a system-wide samples driven by processor instructions executed +use: +.Dl "pmcstat -S instructions -O /tmp/sample.out" +.Pp +To generate +.Xr gprof 1 +compatible flat profiles from a sample file use: +.Dl "pmcstat -R /tmp/sample.out -g" .Sh DIAGNOSTICS .Ex -std .Sh SEE ALSO @@ -227,5 +240,7 @@ The .Nm utility first appeared in .Fx 6.0 . +It is +.Ud .Sh AUTHORS .An Joseph Koshy Aq jkoshy@FreeBSD.org |