summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/ktrace.2
diff options
context:
space:
mode:
authorchris <chris@FreeBSD.org>2000-06-23 05:05:44 +0000
committerchris <chris@FreeBSD.org>2000-06-23 05:05:44 +0000
commita6d911fe4ec44bd192bc844817123acbfbb79fd8 (patch)
tree8888b98b7734fc74018a7258777e65e84b9969da /lib/libc/sys/ktrace.2
parent884ed8fd45a157d537285e599ff01a509ff189b8 (diff)
downloadFreeBSD-src-a6d911fe4ec44bd192bc844817123acbfbb79fd8.zip
FreeBSD-src-a6d911fe4ec44bd192bc844817123acbfbb79fd8.tar.gz
Replace .Va, .Ar and .Nm with .Fa or .Va where necessary, examples:
``.Ar errno'' -> ``.Va errno'' ``.Nm ops'' -> ``.Fa ops'' ``.Va fd'' -> ``.Fa fd''
Diffstat (limited to 'lib/libc/sys/ktrace.2')
-rw-r--r--lib/libc/sys/ktrace.228
1 files changed, 14 insertions, 14 deletions
diff --git a/lib/libc/sys/ktrace.2 b/lib/libc/sys/ktrace.2
index 7e36134..cc45f91 100644
--- a/lib/libc/sys/ktrace.2
+++ b/lib/libc/sys/ktrace.2
@@ -55,30 +55,30 @@ Users may only trace their own processes.
Only the super-user can trace setuid or setgid programs.
.Pp
The
-.Ar tracefile
+.Fa tracefile
gives the pathname of the file to be used for tracing.
The file must exist and be a regular file writable by the calling process.
All trace records are always appended to the file,
so the file must be truncated to zero length to discard
previous trace data.
If tracing points are being disabled (see KTROP_CLEAR below),
-.Ar tracefile
+.Fa tracefile
may be NULL.
.Pp
The
-.Nm ops
+.Fa ops
parameter specifies the requested ktrace operation.
The defined operations are:
.Bl -column KTRFLAG_DESCENDXXX -offset indent
-.It KTROP_SET Enable trace points specified in Ar trpoints .
-.It KTROP_CLEAR Disable trace points specified in Ar trpoints .
+.It KTROP_SET Enable trace points specified in Fa trpoints .
+.It KTROP_CLEAR Disable trace points specified in Fa trpoints .
.It KTROP_CLEARFILE Stop all tracing.
.It KTRFLAG_DESCEND The tracing change should apply to the
specified process and all its current children.
.El
.Pp
The
-.Nm trpoints
+.Fa trpoints
parameter specifies the trace points of interest.
The defined trace points are:
.Bl -column KTRFAC_SYSCALLXXX -offset indent
@@ -107,27 +107,27 @@ struct ktr_header {
.Ed
.Pp
The
-.Nm ktr_len
+.Va ktr_len
field specifies the length of the
-.Nm ktr_type
+.Va ktr_type
data that follows this header.
The
-.Nm ktr_pid
+.Va ktr_pid
and
-.Nm ktr_comm
+.Va ktr_comm
fields specify the process and command generating the record.
The
-.Nm ktr_time
+.Va ktr_time
field gives the time (with microsecond resolution)
that the record was generated.
The
-.Nm ktr_buf
+.Va ktr_buf
is an internal kernel pointer and is not useful.
.Pp
The generic header is followed by
-.Nm ktr_len
+.Va ktr_len
bytes of a
-.Nm ktr_type
+.Va ktr_type
record.
The type specific records are defined in the
.Aq Pa sys/ktrace.h
OpenPOWER on IntegriCloud