blob: c453da96cf4e2cabed79a71061619df46c3a129a [file] [log] [blame]
Argyrios Kyrtzidis43dee222011-02-14 18:13:31 +00001//===--- Checkers.td - Static Analyzer Checkers -===-----------------------===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9
10include "clang/StaticAnalyzer/Checkers/CheckerBase.td"
11
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +000012//===----------------------------------------------------------------------===//
13// Packages.
14//===----------------------------------------------------------------------===//
15
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000016def Core : Package<"core">;
Argyrios Kyrtzidis43dee222011-02-14 18:13:31 +000017def Cocoa : Package<"cocoa">;
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000018def Unix : Package<"unix">;
19def MacOSX : Package<"macosx">;
20
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +000021def CoreExperimental : Package<"experimental">,
22 InPackage<Core>, Hidden;
23
Argyrios Kyrtzidis7dd445e2011-02-17 21:39:33 +000024def CocoaExperimental : Package<"experimental">,
25 InPackage<Cocoa>, Hidden;
26
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +000027def UnixExperimental : Package<"experimental">,
28 InPackage<Unix>, Hidden;
29
Argyrios Kyrtzidis9fb94742011-02-17 21:39:24 +000030def LLVM : Package<"llvm">;
Argyrios Kyrtzidis2d67b902011-02-17 21:39:39 +000031def Debug : Package<"debug">;
Argyrios Kyrtzidis9fb94742011-02-17 21:39:24 +000032
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +000033//===----------------------------------------------------------------------===//
34// Groups.
35//===----------------------------------------------------------------------===//
36
37def AllExperimental : CheckerGroup<"all-experimental">,
38 Hidden;
39
40//===----------------------------------------------------------------------===//
41// Checkers.
42//===----------------------------------------------------------------------===//
43
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000044let ParentPackage = Cocoa in {
Argyrios Kyrtzidis43dee222011-02-14 18:13:31 +000045
Argyrios Kyrtzidis26c05b12011-02-15 07:42:38 +000046def ObjCSelfInitChecker : Checker<"SelfInit">,
Argyrios Kyrtzidis43dee222011-02-14 18:13:31 +000047 HelpText<"Check that 'self' is propely initialized inside an initializer method">,
48 DescFile<"ObjCSelfInitChecker.cpp">;
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000049
Argyrios Kyrtzidis26c05b12011-02-15 07:42:38 +000050def ObjCAtSyncChecker : Checker<"AtSync">,
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000051 HelpText<"Check for null pointers used as mutexes for @synchronized">,
52 DescFile<"ObjCAtSyncChecker.cpp">;
53
Argyrios Kyrtzidis0b1ba622011-02-16 01:40:52 +000054def NilArgChecker : Checker<"NilArg">,
55 HelpText<"Check for prohibited nil arguments to ObjC method calls">,
56 DescFile<"BasicObjCFoundationChecks.cpp">;
57
58def ClassReleaseChecker : Checker<"ClassRelease">,
59 HelpText<"Check for sending 'retain', 'release', or 'autorelease' directly to a Class">,
60 DescFile<"BasicObjCFoundationChecks.cpp">;
61
Ted Kremenekb8d545c2011-02-25 22:19:14 +000062def NSAutoreleasePoolChecker : Checker<"NSAutoreleasePool">,
63 HelpText<"Warn for subpar uses of NSAutoreleasePool">,
Argyrios Kyrtzidis0b1ba622011-02-16 01:40:52 +000064 DescFile<"NSAutoreleasePoolChecker.cpp">;
65
Argyrios Kyrtzidis7dd445e2011-02-17 21:39:33 +000066def ObjCMethSigsChecker : Checker<"MethodSigs">,
67 HelpText<"Warn about Objective-C method signatures with type incompatibilities">,
68 DescFile<"CheckObjCInstMethSignature.cpp">;
69
70def ObjCUnusedIvarsChecker : Checker<"UnusedIvars">,
71 HelpText<"Warn about private ivars that are never used">,
72 DescFile<"ObjCUnusedIVarsChecker.cpp">;
73
Ted Kremenekf5d2ef42011-02-25 22:00:43 +000074} // end "cocoa"
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000075
Ted Kremenekf5d2ef42011-02-25 22:00:43 +000076def StackAddrEscapeChecker : Checker<"StackAddrEscape">,
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000077 InPackage<Core>,
Ted Kremenekf5d2ef42011-02-25 22:00:43 +000078 HelpText<"Check that addresses to stack memory do not escape the function">,
79 DescFile<"StackAddrEscapeChecker.cpp">;
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000080
Argyrios Kyrtzidis7dd445e2011-02-17 21:39:33 +000081def DeadStoresChecker : Checker<"DeadStores">,
82 InPackage<Core>,
Ted Kremenekf5d2ef42011-02-25 22:00:43 +000083 HelpText<"Check for values stored to a variables that are never read afterwards">,
Argyrios Kyrtzidis7dd445e2011-02-17 21:39:33 +000084 DescFile<"DeadStoresChecker.cpp">;
85
Argyrios Kyrtzidis26c05b12011-02-15 07:42:38 +000086def UnixAPIChecker : Checker<"API">,
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000087 InPackage<Unix>,
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000088 HelpText<"Check calls to various UNIX/Posix functions">,
89 DescFile<"UnixAPIChecker.cpp">;
90
Argyrios Kyrtzidis26c05b12011-02-15 07:42:38 +000091def MacOSXAPIChecker : Checker<"API">,
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000092 InPackage<MacOSX>,
Ted Kremenekf5d2ef42011-02-25 22:00:43 +000093 HelpText<"Check for proper uses of various Mac OS X APIs">,
Argyrios Kyrtzidis027a6ab2011-02-15 07:42:33 +000094 DescFile<"MacOSXAPIChecker.cpp">;
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +000095
Argyrios Kyrtzidisf0293662011-02-28 01:27:02 +000096def OSAtomicChecker : Checker<"AtomicCAS">,
97 InPackage<MacOSX>,
98 HelpText<"Evaluate calls to OSAtomic functions">,
99 DescFile<"OSAtomicChecker.cpp">;
100
Argyrios Kyrtzidis0b1ba622011-02-16 01:40:52 +0000101def CFNumberCreateChecker : Checker<"CFNumber">,
102 InPackage<MacOSX>,
Ted Kremenekf5d2ef42011-02-25 22:00:43 +0000103 HelpText<"Check for proper uses of CFNumberCreate">,
Argyrios Kyrtzidis0b1ba622011-02-16 01:40:52 +0000104 DescFile<"BasicObjCFoundationChecks.cpp">;
105
106def CFRetainReleaseChecker : Checker<"CFRetainRelease">,
107 InPackage<MacOSX>,
108 HelpText<"Check for null arguments to CFRetain/CFRelease">,
109 DescFile<"BasicObjCFoundationChecks.cpp">;
110
Argyrios Kyrtzidis9fb94742011-02-17 21:39:24 +0000111def LLVMConventionsChecker : Checker<"Conventions">,
112 InPackage<LLVM>,
113 HelpText<"Check code for LLVM codebase conventions">,
114 DescFile<"LLVMConventionsChecker.cpp">;
115
Argyrios Kyrtzidis2d67b902011-02-17 21:39:39 +0000116def LiveVariablesDumper : Checker<"DumpLiveVars">,
117 InPackage<Debug>,
118 HelpText<"Print results of live variable analysis">,
119 DescFile<"DebugCheckers.cpp">;
120
121def CFGViewer : Checker<"ViewCFG">,
122 InPackage<Debug>,
123 HelpText<"View Control-Flow Graphs using GraphViz">,
124 DescFile<"DebugCheckers.cpp">;
125
126def CFGDumper : Checker<"DumpCFG">,
127 InPackage<Debug>,
128 HelpText<"Display Control-Flow Graphs">,
129 DescFile<"DebugCheckers.cpp">;
130
Argyrios Kyrtzidis58f2e7c2011-02-28 01:26:50 +0000131def AnalyzerStatsChecker : Checker<"Stats">,
132 InPackage<Debug>,
133 HelpText<"Emit warnings with analyzer statistics">,
134 DescFile<"AnalyzerStatsChecker.cpp">;
135
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +0000136//===----------------------------------------------------------------------===//
137// Hidden experimental checkers.
138//===----------------------------------------------------------------------===//
139
140let Group = AllExperimental in {
141
Argyrios Kyrtzidis05357012011-02-28 01:26:57 +0000142def ArrayBoundCheckerV2 : Checker<"Overflow">,
143 InPackage<CoreExperimental>,
144 HelpText<"Warn about buffer overflows">,
145 DescFile<"ArrayBoundCheckerV2.cpp">,
146 Hidden; // Must be specified explicitly in order to run.
147
Argyrios Kyrtzidis312dbec2011-02-28 01:26:35 +0000148def MallocChecker : Checker<"Malloc">,
149 InPackage<CoreExperimental>,
150 HelpText<"Check for potential memory leaks, double free, and use-after-free problems">,
151 DescFile<"MallocChecker.cpp">;
152
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +0000153def CStringChecker : Checker<"CString">,
154 InPackage<CoreExperimental>,
155 HelpText<"Check calls to functions in <string.h>">,
156 DescFile<"CStringChecker.cpp">;
157
158def UnreachableCodeChecker : Checker<"UnreachableCode">,
159 InPackage<CoreExperimental>,
160 HelpText<"Check unreachable code">,
Argyrios Kyrtzidis08099ad2011-02-24 21:42:52 +0000161 DescFile<"UnreachableCodeChecker.cpp">,
162 Hidden; // Must be specified explicitly in order to run.
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +0000163
Argyrios Kyrtzidisc9f2e0f2011-02-15 22:55:14 +0000164def IdempotentOperationChecker : Checker<"IdempotentOps">,
165 InPackage<CoreExperimental>,
166 HelpText<"Warn about idempotent operations">,
167 DescFile<"IdempotentOperationChecker.cpp">;
168
Argyrios Kyrtzidis23ade502011-02-15 22:55:20 +0000169def CastToStructChecker : Checker<"CastToStruct">,
170 InPackage<CoreExperimental>,
171 HelpText<"Check for cast from non-struct pointer to struct pointer">,
172 DescFile<"CastToStructChecker.cpp">;
173
174def FixedAddressChecker : Checker<"FixedAddr">,
175 InPackage<CoreExperimental>,
176 HelpText<"Check for assignment of a fixed address to a pointer">,
177 DescFile<"FixedAddressChecker.cpp">;
178
179def PointerArithChecker : Checker<"PointerArithm">,
180 InPackage<CoreExperimental>,
181 HelpText<"Check for pointer arithmetic on locations other than array elements">,
182 DescFile<"PointerArithChecker">;
183
184def PointerSubChecker : Checker<"PointerSub">,
185 InPackage<CoreExperimental>,
186 HelpText<"Check for pointer subtractions on two pointers pointing to different memory chunks">,
187 DescFile<"PointerSubChecker">;
188
Argyrios Kyrtzidis7dd445e2011-02-17 21:39:33 +0000189def SizeofPointerChecker : Checker<"SizeofPtr">,
190 InPackage<CoreExperimental>,
191 HelpText<"Warn about unintended use of sizeof() on pointer expressions">,
192 DescFile<"CheckSizeofPointer.cpp">;
193
194def SecuritySyntaxChecker : Checker<"SecuritySyntactic">,
195 InPackage<CoreExperimental>,
196 HelpText<"Perform quick security checks that require no data flow">,
197 DescFile<"CheckSecuritySyntaxOnly.cpp">;
198
Argyrios Kyrtzidis69355792011-02-24 08:41:57 +0000199def ReturnPointerRangeChecker : Checker<"ReturnPtrRange">,
200 InPackage<CoreExperimental>,
201 HelpText<"Check for an out-of-bound pointer being returned to callers">,
202 DescFile<"ReturnPointerRangeChecker.cpp">;
203
Argyrios Kyrtzidis8be5b3a2011-02-24 08:42:12 +0000204def ArrayBoundChecker : Checker<"ArrayBound">,
205 InPackage<CoreExperimental>,
206 HelpText<"Check for an out-of-bound pointer being returned to callers">,
207 DescFile<"ArrayBoundChecker.cpp">;
208
Argyrios Kyrtzidis0d6b0c02011-02-24 21:42:49 +0000209def CastSizeChecker : Checker<"CastSize">,
210 InPackage<CoreExperimental>,
211 HelpText<"Check when casting a malloc'ed type T, whether the size is a multiple of the size of T">,
212 DescFile<"CastSizeChecker.cpp">;
213
Argyrios Kyrtzidis7dd445e2011-02-17 21:39:33 +0000214def ObjCDeallocChecker : Checker<"Dealloc">,
215 InPackage<CocoaExperimental>,
216 HelpText<"Warn about Objective-C classes that lack a correct implementation of -dealloc">,
217 DescFile<"CheckObjCDealloc.cpp">;
218
Argyrios Kyrtzidisa0decc92011-02-15 21:25:03 +0000219def ChrootChecker : Checker<"Chroot">,
220 InPackage<UnixExperimental>,
221 HelpText<"Check improper use of chroot">,
222 DescFile<"ChrootChecker.cpp">;
223
224def PthreadLockChecker : Checker<"PthreadLock">,
225 InPackage<UnixExperimental>,
226 HelpText<"Simple lock -> unlock checker">,
227 DescFile<"PthreadLockChecker.cpp">;
228
229def StreamChecker : Checker<"Stream">,
230 InPackage<UnixExperimental>,
231 HelpText<"Check stream handling functions">,
232 DescFile<"StreamChecker.cpp">;
233
234}