xref: /haiku/build/config_headers/kernel_debug_config.h (revision e81a954787e50e56a7f06f72705b7859b6ab06d1)
1 #ifndef KERNEL_DEBUG_CONFIG_H
2 #define KERNEL_DEBUG_CONFIG_H
3 
4 // Master switch:
5 // 0: Disables all debug code that hasn't been enabled otherwise.
6 // 1: Enables some lightweight debug code.
7 // 2: Enables more debug code. Will impact performance.
8 #define KDEBUG_LEVEL 2
9 
10 #define KDEBUG_LEVEL_2	(KDEBUG_LEVEL >= 2)
11 #define KDEBUG_LEVEL_1	(KDEBUG_LEVEL >= 1)
12 #define KDEBUG_LEVEL_0	(KDEBUG_LEVEL >= 0)
13 
14 
15 // general kernel debugging
16 
17 // Enables kernel ASSERT()s and various checks, locking primitives aren't
18 // benaphore-style.
19 #define KDEBUG							KDEBUG_LEVEL_2
20 
21 // Size of the heap used by the kernel debugger.
22 #define KDEBUG_HEAP						(64 * 1024)
23 
24 // Set to 0 to disable support for kernel breakpoints.
25 #define KERNEL_BREAKPOINTS				1
26 
27 // Enables the debug syslog feature (accessing the previous syslog in the boot
28 // loader) by default. Can be overridden in the boot loader menu.
29 #define KDEBUG_ENABLE_DEBUG_SYSLOG		KDEBUG_LEVEL_1
30 
31 
32 // block/file cache
33 
34 // Enables debugger commands.
35 #define DEBUG_BLOCK_CACHE				KDEBUG_LEVEL_1
36 
37 // Enables checks that non-dirty blocks really aren't changed. Seriously
38 // degrades performance when the block cache is used heavily.
39 #define BLOCK_CACHE_DEBUG_CHANGED		KDEBUG_LEVEL_2
40 
41 // Enables a global list of file maps and related debugger commands.
42 #define DEBUG_FILE_MAP					KDEBUG_LEVEL_1
43 
44 
45 // heap / slab
46 
47 // Initialize newly allocated memory with something non zero.
48 #define PARANOID_KERNEL_MALLOC			KDEBUG_LEVEL_2
49 
50 // Check for double free, and fill freed memory with 0xdeadbeef.
51 #define PARANOID_KERNEL_FREE			KDEBUG_LEVEL_2
52 
53 // Validate sanity of the heap after each operation (slow!).
54 #define PARANOID_HEAP_VALIDATION		0
55 
56 // Store size, thread and team info at the end of each allocation block.
57 // Enables the "allocations*" debugger commands.
58 #define KERNEL_HEAP_LEAK_CHECK			0
59 
60 // Enables the "allocations*" debugger commands for the slab.
61 #define SLAB_ALLOCATION_TRACKING		0
62 
63 
64 // interrupts
65 
66 // Adds statistics and unhandled counter per interrupts. Enables the "ints"
67 // debugger command.
68 #define DEBUG_INTERRUPTS				KDEBUG_LEVEL_1
69 
70 
71 // semaphores
72 
73 // Enables tracking of the last threads that acquired/released a semaphore.
74 #define DEBUG_SEM_LAST_ACQUIRER			KDEBUG_LEVEL_1
75 
76 
77 // SMP
78 
79 // Enables spinlock caller debugging. When acquiring a spinlock twice on a
80 // non-SMP machine, this will give a clue who locked it the first time.
81 // Furthermore (also on SMP machines) the "spinlock" debugger command will be
82 // available.
83 #define DEBUG_SPINLOCKS					KDEBUG_LEVEL_2
84 
85 #define DEBUG_SPINLOCK_LATENCIES		0
86 
87 
88 // VM
89 
90 // Enables the vm_page::queue field, i.e. it is tracked which queue the page
91 // should be in.
92 #define DEBUG_PAGE_QUEUE				0
93 
94 // Enables the vm_page::access_count field, which is used to detect invalid
95 // concurrent access to the page.
96 #define DEBUG_PAGE_ACCESS				KDEBUG_LEVEL_2
97 
98 // Enables a global list of all vm_cache structures.
99 #define DEBUG_CACHE_LIST				KDEBUG_LEVEL_1
100 
101 // Enables swap support.
102 #define ENABLE_SWAP_SUPPORT				1
103 
104 // Use the selected allocator as generic memory allocator (malloc()/free()).
105 #define USE_DEBUG_HEAP_FOR_MALLOC		0
106 	// Heap implementation with additional debugging facilities.
107 #define USE_GUARDED_HEAP_FOR_MALLOC		0
108 	// Heap implementation that allocates memory so that the end of the
109 	// allocation always coincides with a page end and is followed by a guard
110 	// page which is marked non-present. Out of bounds access (both read and
111 	// write) therefore cause a crash (unhandled page fault). Note that this
112 	// allocator is neither speed nor space efficient, indeed it wastes huge
113 	// amounts of pages and address space so it is quite easy to hit limits.
114 #define USE_SLAB_ALLOCATOR_FOR_MALLOC	1
115 	// Heap implementation based on the slab allocator (for production use).
116 
117 // Replace the object cache with the guarded heap to force debug features. Also
118 // requires the use of the guarded heap for malloc.
119 #define USE_GUARDED_HEAP_FOR_OBJECT_CACHE			0
120 
121 // Enables additional sanity checks in the slab allocator's memory manager.
122 #define DEBUG_SLAB_MEMORY_MANAGER_PARANOID_CHECKS	0
123 
124 // Disables memory re-use in the guarded heap (freed memory is never reused and
125 // stays invalid causing every access to crash). Note that this is a magnitude
126 // more space inefficient than the guarded heap itself. Fully booting may not
127 // work at all due to address space waste.
128 #define DEBUG_GUARDED_HEAP_DISABLE_MEMORY_REUSE		0
129 
130 // When set limits the amount of available RAM (in MB).
131 //#define LIMIT_AVAILABLE_MEMORY		256
132 
133 // Enables tracking of page allocations.
134 #define VM_PAGE_ALLOCATION_TRACKING		0
135 
136 // Enables the (boot) system profiler for use with "profile -r"
137 #define SYSTEM_PROFILER					0
138 #define SYSTEM_PROFILE_SIZE				40 * 1024 * 1024
139 #define SYSTEM_PROFILE_STACK_DEPTH		10
140 #define SYSTEM_PROFILE_INTERVAL			10000
141 
142 
143 #endif	// KERNEL_DEBUG_CONFIG_H
144