svn commit: r321422 - head/usr.bin/ktrace

[Edward Tomasz Napierala]

Author: trasz
Date: Mon Jul 24 16:58:54 2017
New Revision: 321422
URL: https://svnweb.freebsd.org/changeset/base/321422

Log:
  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.
  
  Discussed with:	wblock [1]
  MFC after:	2 weeks
  Sponsored by:	DARPA, AFRL

Modified:
  head/usr.bin/ktrace/ktrace.1

Modified: head/usr.bin/ktrace/ktrace.1
==============================================================================
--- head/usr.bin/ktrace/ktrace.1	Mon Jul 24 16:45:38 2017	(r321421)
+++ head/usr.bin/ktrace/ktrace.1	Mon Jul 24 16:58:54 2017	(r321422)
@@ -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