summaryrefslogtreecommitdiffstats
path: root/usr.bin/ktrace
diff options
context:
space:
mode:
authortrhodes <trhodes@FreeBSD.org>2006-11-06 15:17:50 +0000
committertrhodes <trhodes@FreeBSD.org>2006-11-06 15:17:50 +0000
commit34663c9485b6a8aad350956ee9a7d71d55e31af5 (patch)
treee96a2d3926fcd9d485952d1615cd2afed4a6e623 /usr.bin/ktrace
parentef1d02698e97475bad3551e43db0579cb7712e28 (diff)
downloadFreeBSD-src-34663c9485b6a8aad350956ee9a7d71d55e31af5.zip
FreeBSD-src-34663c9485b6a8aad350956ee9a7d71d55e31af5.tar.gz
Add needed hyphens, note the KTRACE kernel option, bump doc date.
PR: 85186 Submitted by: garys
Diffstat (limited to 'usr.bin/ktrace')
-rw-r--r--usr.bin/ktrace/ktrace.114
1 files changed, 9 insertions, 5 deletions
diff --git a/usr.bin/ktrace/ktrace.1 b/usr.bin/ktrace/ktrace.1
index fd2d390..0260b1e 100644
--- a/usr.bin/ktrace/ktrace.1
+++ b/usr.bin/ktrace/ktrace.1
@@ -32,7 +32,7 @@
.\" @(#)ktrace.1 8.1 (Berkeley) 6/6/93
.\" $FreeBSD$
.\"
-.Dd June 6, 1993
+.Dd November 6, 2006
.Dt KTRACE 1
.Os
.Sh NAME
@@ -64,7 +64,7 @@ either the process exits or the trace point is cleared.
A traced process can generate enormous amounts of log data quickly;
It is strongly suggested that users memorize how to disable tracing before
attempting to trace a process.
-The following command is sufficient to disable tracing on all user owned
+The following command is sufficient to disable tracing on all user-owned
processes, and, if executed by root, all processes:
.Pp
.Dl \&$ ktrace -C
@@ -73,12 +73,16 @@ The trace file is not human readable; use
.Xr kdump 1
to decode it.
.Pp
-The options are as follows:
+The utility may be used only with a kernel that has been built with the
+.Dq KTRACE
+option in the kernel configuration file.
+.Pp
+The options are:
.Bl -tag -width indent
.It Fl a
Append to the trace file instead of recreating it.
.It Fl C
-Disable tracing on all user owned processes, and, if executed by root, all
+Disable tracing on all user-owned processes, and, if executed by root, all
processes in the system.
.It Fl c
Clear the trace points associated with the specified file or processes.
@@ -160,7 +164,7 @@ on process 67
# disable all tracing to the file "tracedata"
.Dl $ ktrace -c -f tracedata
.Pp
-# disable tracing of all processes owned by the user
+# disable tracing of all user-owned processes
.Dl $ ktrace -C
.Sh SEE ALSO
.Xr kdump 1
OpenPOWER on IntegriCloud