Add a section documenting the sysctl(8) tunables that influence the

operation of ktrace(2).  Add a cross-reference to sysctl(8).  Make the
language of rev 1.22 more consistent with the rest of the manual page.
This commit is contained in:
Joseph Koshy 2003-11-11 04:59:25 +00:00
parent 669073a7e6
commit 5274183ef4

View File

@ -135,6 +135,18 @@ record.
The type specific records are defined in the The type specific records are defined in the
.In sys/ktrace.h .In sys/ktrace.h
include file. include file.
.Sh SYSCTL TUNABLES
The following
.Xr sysctl 8
tunables influence the behaviour of
.Fn ktrace :
.Bl -tag -width indent
.It Va kern.ktrace.geniosize
bounds the amount of data a traced I/O request will log
to the trace file.
.It Va kern.ktrace.request_pool
bounds the number of trace events being logged at a time.
.El
.Sh RETURN VALUES .Sh RETURN VALUES
.Rv -std ktrace .Rv -std ktrace
.Sh ERRORS .Sh ERRORS
@ -162,7 +174,7 @@ The kernel was not compiled with
support. support.
.El .El
.Pp .Pp
A thread may be unable to post one or more tracing requests due to a A thread may be unable to log one or more tracing events due to a
temporary shortage of resources. temporary shortage of resources.
This condition is remembered by the kernel, and the next tracing request This condition is remembered by the kernel, and the next tracing request
that succeeds will have the flag that succeeds will have the flag
@ -173,7 +185,8 @@ field.
.Sh SEE ALSO .Sh SEE ALSO
.Xr kdump 1 , .Xr kdump 1 ,
.Xr ktrace 1 , .Xr ktrace 1 ,
.Xr utrace 2 .Xr utrace 2 ,
.Xr sysctl 8
.Sh HISTORY .Sh HISTORY
The The
.Fn ktrace .Fn ktrace