[src/trunk]: src/usr.bin/ktrace Explain what ktruss does. Document -l, -R an...

[gmcgarry <gmcgarry%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c7be7aec761b
branches:  trunk
changeset: 546587:c7be7aec761b
user:      gmcgarry <gmcgarry%NetBSD.org@localhost>
date:      Fri May 02 07:40:20 2003 +0000

description:
Explain what ktruss does.  Document -l, -R and -T options.
Addresses PR#10458.

diffstat:

 usr.bin/ktrace/ktrace.1 |  22 +++++++++++++++++++++-
 1 files changed, 21 insertions(+), 1 deletions(-)

diffs (56 lines):

diff -r 968fb80cf9a3 -r c7be7aec761b usr.bin/ktrace/ktrace.1
--- a/usr.bin/ktrace/ktrace.1   Fri May 02 07:17:18 2003 +0000
+++ b/usr.bin/ktrace/ktrace.1   Fri May 02 07:40:20 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ktrace.1,v 1.18 2003/02/25 10:35:45 wiz Exp $
+.\"    $NetBSD: ktrace.1,v 1.19 2003/05/02 07:40:20 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -90,6 +90,17 @@
 .Xr kdump 1
 to decode it.
 .Pp
+.Nm ktruss
+is functionally the same as
+.Nm ktrace
+except that trace output is printed
+on standard output or to the file specified with the
+.Fl o
+option.
+.Nm ktruss
+is useful to see the kernel operations interleaved with
+the program output.
+.Pp
 The options are as follows:
 .Bl -tag -width indent
 .It Fl a
@@ -114,12 +125,18 @@
 .It Fl i
 Inherit; pass the trace flags to all future children of the designated
 processes.
+.It Fl l
+Continue monitoring process after it has finished.
 .It Fl p Ar pid
 Enable (disable) tracing on the indicated process id (only one
 .Fl p
 flag is permitted).
 .It Fl s
 Write to the trace file with synchronized I/O.
+.It Fl R
+Display relative time stamps.
+.It Fl T
+Display time stamps.
 .It Fl t Ar trstr
 The string argument represents the kernel trace points, one per letter.
 The following table equates the letters with the tracepoints:
@@ -191,6 +208,9 @@
 .Pp
 # disable tracing of all processes owned by the user
 .Dl $ ktrace -C
+.Pp
+# run the command "w", displaying to standard output
+.Dl $ ktruss w
 .Sh SEE ALSO
 .Xr kdump 1
 .Sh HISTORY