1 |
+ |
.\" $MidnightBSD$ |
2 |
|
.\" Copyright (c) 2001 John H. Baldwin <jhb@FreeBSD.org> |
3 |
|
.\" All rights reserved. |
4 |
|
.\" |
23 |
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
24 |
|
.\" SUCH DAMAGE. |
25 |
|
.\" |
26 |
< |
.\" $MidnightBSD$ |
26 |
> |
.\" $FreeBSD: stable/10/share/man/man4/ktr.4 243437 2012-11-23 08:44:36Z kevlo $ |
27 |
|
.\" |
28 |
< |
.Dd January 25, 2005 |
28 |
> |
.Dd October 20, 2012 |
29 |
|
.Dt KTR 4 |
30 |
|
.Os |
31 |
|
.Sh NAME |
53 |
|
The |
54 |
|
.Dv KTR_ENTRIES |
55 |
|
option sets the size of the buffer of events. |
55 |
– |
It must be a power of two. |
56 |
|
The size of the buffer in the currently running kernel can be found via the |
57 |
< |
read-only sysctl |
57 |
> |
sysctl |
58 |
|
.Va debug.ktr.entries . |
59 |
|
By default the buffer contains 1024 entries. |
60 |
|
.Ss Event Masking |
78 |
|
It can also be examined and set after booting via the |
79 |
|
.Va debug.ktr.mask |
80 |
|
sysctl. |
81 |
< |
By default the run time mask is set to log only |
82 |
< |
.Dv KTR_GEN |
83 |
< |
events. |
81 |
> |
By default the run time mask is set to block any tracing. |
82 |
|
The definitions of the event mask bits can be found in |
83 |
|
.In sys/ktr.h . |
84 |
|
.Pp |
86 |
|
the |
87 |
|
.Dv KTR_CPUMASK |
88 |
|
option. |
89 |
+ |
When two or more parameters to |
90 |
+ |
.Dv KTR_CPUMASK , |
91 |
+ |
are used, it is important they are not separated by whitespace. |
92 |
|
A CPU must have the bit corresponding to its logical id set in this bitmask |
93 |
|
for events that occur on it to be logged. |
94 |
|
This mask can be set by the |
99 |
|
It can also be examined and set after booting via the |
100 |
|
.Va debug.ktr.cpumask |
101 |
|
sysctl. |
102 |
< |
By default events on all CPUs are enabled. |
102 |
> |
By default, only CPUs specified in |
103 |
> |
.Dv KTR_CPUMASK |
104 |
> |
will log events. |
105 |
> |
See |
106 |
> |
.Pa sys/conf/NOTES |
107 |
> |
for more information. |
108 |
|
.Ss Verbose Mode |
109 |
|
By default, events are only logged to the internal buffer for examination |
110 |
|
later, but if the verbose flag is set then they are dumped to the kernel |