system_cmds-880.100.5.tar.gz

[apple/system_cmds.git] / trace.tproj / trace.1

diff --git a/trace.tproj/trace.1 b/trace.tproj/trace.1
index d860ee0ec950fb189fd0d693d86f48f531e486e4..afbd280c305c61370716b91be506f869f2984683 100644 (file)
--- a/trace.tproj/trace.1
+++ b/trace.tproj/trace.1
@@ -64,6 +64,11 @@ optionally converted to a human-readable, plain-text format.
 .Pp
 .Nm
 operates according to the command flag specified.
+.Pp
+NOTE:
+.Nm
+is obsolete.   The command you probably want is
+.Xr ktrace 1
 .Sh COMMANDS
 .Bl -tag -width Ds
 .It Fl h
@@ -219,20 +224,30 @@ Additional trace codes files specified will still be used.
 .Pp
 Empty the current kernel trace buffer into
 .Ar rawfile
-in a binary format.
+in a binary format.  If
+.Ar rawfile
+is
+.Li - ,
+the file will be written to
+.Xr stdout 4 .
 .\"
 .\"     ## trace -L ##
 .It Fl L Ar rawfile Fl S Ar seconds
 .Pp
 Copy the current trace buffer to
 .Ar rawfile
-and send all future trace events to 
+and send all future trace events to
 .Ar rawfile .
 .Bl -tag -width Ds
 .It Fl S Ar seconds
 After 
 .Ar seconds
-have elapsed, stop recording and exit.
+have elapsed, stop recording and exit.  If
+.Ar rawfile
+is
+.Li - ,
+the file will be written to
+.Xr stdout 4 .
 .El
 .\"
 .\"     ## trace -R ##
@@ -240,7 +255,7 @@ have elapsed, stop recording and exit.
 .Pp
 Read events from
 .Ar rawfile
-and print them in a human-readable format.  
+and print them in a human-readable format.
 .Bl -tag -width " "
 .It Fl F Ar frequency
 If