Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Some more ktruss documentation from Christian Biere <christianbiere@gmx.de>

Browse Source 
in PR#17111.
This commit is contained in:
gmcgarry 2003-05-02 07:52:23 +00:00
parent 9256662c6b
commit e00d2f72dc
1 changed files with 37 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
usr.bin/ktrace/ktrace.1
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ktrace.1,v 1.19 2003/05/02 07:40:20 gmcgarry Exp $ .\" $NetBSD: ktrace.1,v 1.20 2003/05/02 07:52:23 gmcgarry Exp $
.\" .\"
.\" Copyright (c) 1990, 1993 .\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved. .\" The Regents of the University of California. All rights reserved.
@ -50,7 +50,7 @@
.Op Fl adis .Op Fl adis
.Op Fl f Ar trfile .Op Fl f Ar trfile
.Op Fl t Ar trstr .Op Fl t Ar trstr
command .Ar command
.Nm ktruss .Nm ktruss
.Op Fl aCcdilRT .Op Fl aCcdilRT
.Op Fl e Ar emulation .Op Fl e Ar emulation
@ -113,11 +113,15 @@ Clear the trace points associated with the specified file or processes.
.It Fl d .It Fl d
Descendants; perform the operation for all current children of the Descendants; perform the operation for all current children of the
designated processes. designated processes.
.It Fl f Ar file .It Fl f Ar trfile
Log trace records to Log trace records to
.Ar file .Ar trfile
instead of instead of
.Pa ktrace.out . .Pa ktrace.out .
It Fl f Ar infile
Read the trace records from
.Ar infile
and print them in a human readable format to standard out.
.It Fl g Ar pgid .It Fl g Ar pgid
Enable (disable) tracing on all processes in the process group (only one Enable (disable) tracing on all processes in the process group (only one
.Fl g .Fl g
@ -126,7 +130,20 @@ flag is permitted).
Inherit; pass the trace flags to all future children of the designated Inherit; pass the trace flags to all future children of the designated
processes. processes.
.It Fl l .It Fl l
Continue monitoring process after it has finished. Poll the trace file for new data and prints it to standard out.
Only for use together with the
.Fl f
option.
.It Fl m Ar maxdata
Print at most
.Ar maxdata
bytes of data. This is used for pointer type arguments e.g. strings.
The data will be escaped in C-Style.
.It Fl o Ar outfile
Log trace records to
.Ar outfile .
Without this option ktruss will print its output in a human
readable format to standard out.
.It Fl p Ar pid .It Fl p Ar pid
Enable (disable) tracing on the indicated process id (only one Enable (disable) tracing on the indicated process id (only one
.Fl p .Fl p
@ -134,9 +151,11 @@ flag is permitted).
.It Fl s .It Fl s
Write to the trace file with synchronized I/O. Write to the trace file with synchronized I/O.
.It Fl R .It Fl R
Display relative time stamps. Display relative time stamps to output.
.It Fl T .It Fl T
Display time stamps. Same as
.Fl R
options but use absolute timestamps instead.
.It Fl t Ar trstr .It Fl t Ar trstr
The string argument represents the kernel trace points, one per letter. The string argument represents the kernel trace points, one per letter.
The following table equates the letters with the tracepoints: The following table equates the letters with the tracepoints:
@ -179,6 +198,11 @@ The
and and
.Ar command .Ar command
options are mutually exclusive. options are mutually exclusive.
The
.Fl R
and
.Fl T
options are also mutually exclusive.
.Sh EXAMPLES .Sh EXAMPLES
# trace all kernel operations of process id 34 # trace all kernel operations of process id 34
.Dl $ ktrace -p 34 .Dl $ ktrace -p 34
@ -211,6 +235,12 @@ on process 67
.Pp .Pp
# run the command "w", displaying to standard output # run the command "w", displaying to standard output
.Dl $ ktruss w .Dl $ ktruss w
.Pp
# trace process 42 and log the records to "ktruss.out"
.Dl $ ktruss -p 42 -o ktruss.out
.Pp
# poll ktruss.out for available records and print them
.Dl $ ktruss -lf ktruss.out
.Sh SEE ALSO .Sh SEE ALSO
.Xr kdump 1 .Xr kdump 1
.Sh HISTORY .Sh HISTORY