svn commit: r324269 - stable/11/usr.bin/ktrace

[Edward Tomasz Napierala]

Author: trasz
Date: Wed Oct  4 11:59:53 2017
New Revision: 324269
URL: https://svnweb.freebsd.org/changeset/base/324269

Log:
  MFC r321422:
  
  Improve the ktrace(1) man page to make it slightly more obvious that there
  are _two_ options that control its behaviour wrt child processes; slightly
  improve the example[1], and add Xrefs.

Modified:
  stable/11/usr.bin/ktrace/ktrace.1
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/usr.bin/ktrace/ktrace.1
==============================================================================
--- stable/11/usr.bin/ktrace/ktrace.1	Wed Oct  4 11:58:52 2017	(r324268)
+++ stable/11/usr.bin/ktrace/ktrace.1	Wed Oct  4 11:59:53 2017	(r324269)
@@ -85,6 +85,9 @@ Clear the specified trace points associated with the g
 .It Fl d
 Descendants; perform the operation for all current children of the
 designated processes.
+See also the
+.Fl i
+option.
 .It Fl f Ar trfile
 Log trace records to
 .Ar trfile
@@ -97,6 +100,9 @@ flag is permitted).
 .It Fl i
 Inherit; pass the trace flags to all future children of the designated
 processes.
+See also the
+.Fl d
+option.
 .It Fl p Ar pid
 Enable (disable) tracing on the indicated process id (only one
 .Fl p
@@ -148,6 +154,9 @@ and
 .Ar command
 options are mutually exclusive.
 .Sh EXAMPLES
+Run "make", then trace it and any child processes:
+.Dl $ ktrace -i make
+.Pp
 Trace all kernel operations of process id 34:
 .Dl $ ktrace -p 34
 .Pp
@@ -166,16 +175,15 @@ Enable tracing of
 on process 67:
 .Dl $ ktrace -ti -p 67
 .Pp
-Run the command "w", tracing only system calls:
-.Dl $ ktrace -tc w
-.Pp
 Disable all tracing to the file "tracedata":
 .Dl $ ktrace -c -f tracedata
 .Pp
 Disable tracing of all user-owned processes:
 .Dl $ ktrace -C
 .Sh SEE ALSO
+.Xr dtrace 1 ,
 .Xr kdump 1 ,
+.Xr truss 1 ,
 .Xr ktrace 2
 .Sh HISTORY
 The