diff options
Diffstat (limited to 'usr.sbin/pmcstat/pmcstat.8')
-rw-r--r-- | usr.sbin/pmcstat/pmcstat.8 | 41 |
1 files changed, 34 insertions, 7 deletions
diff --git a/usr.sbin/pmcstat/pmcstat.8 b/usr.sbin/pmcstat/pmcstat.8 index 692216f..5a3e3ec 100644 --- a/usr.sbin/pmcstat/pmcstat.8 +++ b/usr.sbin/pmcstat/pmcstat.8 @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 26, 2006 +.Dd April 2, 2006 .Os .Dt PMCSTAT 8 .Sh NAME @@ -138,8 +138,27 @@ option. .It Fl O Ar logfilename Send logging output to file .Ar logfilename . -If this option is not specified and one of the logging options -is requested, then +If +.Ar logfilename +is of the form +.Ar hostname Ns : Ns Ar port , +where +.Ar hostname +does not start with a +.Sq \&. +or a +.Sq / , +then +.Nm +will open a network socket to host +.Ar hostname +on port +.Ar port . +.Pp +If the +.Fl O +option is not specified and one of the logging options is requested, +then .Nm will print a textual form of the logged events to the configured output file. @@ -249,10 +268,16 @@ 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: +To perform system-wide sampling based on processor instructions +retired use: .Dl "pmcstat -S instructions -O /tmp/sample.out" .Pp +To send the generated event log to a remote machine use: +.Dl "pmcstat -S instructions -O remotehost:port" +On the remote machine, the sample log can be collected using +.Xr nc 1 : +.Dl "nc -l remotehost port > /tmp/sample.out" +.Pp To generate .Xr gprof 1 compatible flat profiles from a sample file use: @@ -261,6 +286,7 @@ compatible flat profiles from a sample file use: .Ex -std .Sh SEE ALSO .Xr gprof 1 , +.Xr nc 1 , .Xr execvp 3 , .Xr pmc 3 , .Xr pmclog 3 , @@ -277,6 +303,7 @@ It is .Sh AUTHORS .An Joseph Koshy Aq jkoshy@FreeBSD.org .Sh BUGS -On AMD64 platforms .Nm -does not yet handle profiles with samples from 32 bit executables. +cannot yet analyse +.Xr hwpmc 4 +logs generated by non-native architectures. |