diff options
author | jkoshy <jkoshy@FreeBSD.org> | 2006-04-02 12:52:16 +0000 |
---|---|---|
committer | jkoshy <jkoshy@FreeBSD.org> | 2006-04-02 12:52:16 +0000 |
commit | 80251d4f05948e213f6f292db20a93ad4cf36852 (patch) | |
tree | f82c027fa9baa5cc1c2c54f83529b6118bd99a57 /usr.sbin/pmcstat/pmcstat.8 | |
parent | 19f9c1efe47d365dd95231c4ba6a1e467157f00a (diff) | |
download | FreeBSD-src-80251d4f05948e213f6f292db20a93ad4cf36852.zip FreeBSD-src-80251d4f05948e213f6f292db20a93ad4cf36852.tar.gz |
- Teach pmcstat(8) to log over the network; the -O option now
takes a host:port specification.
- Update the manual page and add an example showing how log
over the network using pmcstat(8) and nc(1). Document the
current inability to process logs in cross-platform manner.
- Have pmcstat_open_log() call err(3) directly in case
of an error; this simplifies error handling in its caller.
MFC after: 1 week
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. |