- 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

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.