Bug #3068 ยป 0001-Improve-kdump.1-and-ktrace.1.patch
| usr.bin/kdump/kdump.1 | ||
|---|---|---|
|
in human readable format.
|
||
|
By default, the file
|
||
|
.Pa ktrace.out
|
||
|
in the current directory is displayed.
|
||
|
in the current directory is displayed, which may be overriden by the
|
||
|
.Ar -f
|
||
|
option.
|
||
|
.Pp
|
||
|
The options are as follows:
|
||
|
.Bl -tag -width Fl
|
||
| ... | ... | |
|
.It Fl m Ar maxdata
|
||
|
Display at most
|
||
|
.Ar maxdata
|
||
|
bytes when decoding
|
||
|
.Tn I/O ;
|
||
|
set to
|
||
|
bytes when decoding I/O; set to
|
||
|
.Cm 0
|
||
|
to disable the size limit.
|
||
|
.It Fl p Ar pid
|
||
| ... | ... | |
|
option of
|
||
|
.Xr ktrace 1 .
|
||
|
.El
|
||
|
.Sh FILES
|
||
|
.Bl -tag -width ktrace.out -compact
|
||
|
.It Pa ktrace.out
|
||
|
default ktrace dump file
|
||
|
.El
|
||
|
.Sh SEE ALSO
|
||
|
.Xr ktrace 1
|
||
|
.Sh HISTORY
|
||
| usr.bin/ktrace/ktrace.1 | ||
|---|---|---|
|
The
|
||
|
.Nm
|
||
|
utility enables kernel trace logging for the specified processes.
|
||
|
Kernel trace data is logged to the file
|
||
|
.Pa ktrace.out .
|
||
|
By default, kernel trace data is logged to the file
|
||
|
.Pa ktrace.out ,
|
||
|
this may be overridden by the
|
||
|
.Ar -f
|
||
|
option.
|
||
|
The kernel operations that are traced include system calls, namei
|
||
|
translations, signal processing, and
|
||
|
.Tn I/O .
|
||
|
translations, signal processing, and I/O.
|
||
|
.Pp
|
||
|
Once tracing is enabled on a process, trace data will be logged until
|
||
|
either the process exits or the trace point is cleared.
|
||
| ... | ... | |
|
.It Cm n
|
||
|
trace namei translations
|
||
|
.It Cm i
|
||
|
trace
|
||
|
.Tn I/O
|
||
|
trace I/O
|
||
|
.It Cm s
|
||
|
trace signal processing
|
||
|
.It Cm u
|
||
| ... | ... | |
|
and
|
||
|
.Ar command
|
||
|
options are mutually exclusive.
|
||
|
.Sh FILES
|
||
|
.Bl -tag -width ktrace.out -compact
|
||
|
.It Pa ktrace.out
|
||
|
default ktrace dump file
|
||
|
.El
|
||
|
.Sh EXAMPLES
|
||
|
# trace all kernel operations of process id 34
|
||
|
.Dl $ ktrace -p 34
|
||
| ... | ... | |
|
# disable tracing signals on process 70 and all current children
|
||
|
.Dl $ ktrace -t s -cdp 70
|
||
|
.Pp
|
||
|
# enable tracing of
|
||
|
.Tn I/O
|
||
|
# enable tracing of I/O
|
||
|
on process 67
|
||
|
.Dl $ ktrace -ti -p 67
|
||
|
.Pp
|
||
| ... | ... | |
|
# disable tracing of all processes owned by the user
|
||
|
.Dl $ ktrace -C
|
||
|
.Sh SEE ALSO
|
||
|
.Xr kdump 1
|
||
|
.Xr kdump 1 ,
|
||
|
.Xr ktrace 2 ,
|
||
|
.Xr utrace 2
|
||
|
.Sh HISTORY
|
||
|
The
|
||
|
.Nm
|
||