diff options
author | Aaron Ballman <aaron@aaronballman.com> | 2018-12-20 20:20:20 +0000 |
---|---|---|
committer | Aaron Ballman <aaron@aaronballman.com> | 2018-12-20 20:20:20 +0000 |
commit | 2f234cbfb05549c62130bf53fc500c0c612f4f7b (patch) | |
tree | 754c224411ed11eb80ee79838ee8b38675d27eb2 /clang/www | |
parent | ed414847bc80916af4361ad703ab542fe2d2577b (diff) |
Allow direct navigation to static analysis checker documentation through SARIF exports.
This adds anchors to all of the documented checks so that you can directly link to a check by a stable name. This is useful because the SARIF file format has a field for specifying a URI to documentation for a rule and some viewers, like CodeSonar, make use of this information. These links are then exposed through the SARIF exporter.
llvm-svn: 349812
Diffstat (limited to 'clang/www')
-rw-r--r-- | clang/www/analyzer/alpha_checks.html | 234 | ||||
-rw-r--r-- | clang/www/analyzer/available_checks.html | 284 |
2 files changed, 259 insertions, 259 deletions
diff --git a/clang/www/analyzer/alpha_checks.html b/clang/www/analyzer/alpha_checks.html index a9a30b2d3614..beab87b6b36a 100644 --- a/clang/www/analyzer/alpha_checks.html +++ b/clang/www/analyzer/alpha_checks.html @@ -43,10 +43,10 @@ Patches welcome! <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.clone.CloneChecker"><div class="namedescr expandable"><span class="name"> alpha.clone.CloneChecker</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> -Reports similar pieces of code.</div></div></td> +Reports similar pieces of code.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void log(); @@ -74,10 +74,10 @@ int maxClone(int x, int y) { // similar code here <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.BoolAssignment"><div class="namedescr expandable"><span class="name"> alpha.core.BoolAssignment</span><span class="lang"> (ObjC)</span><div class="descr"> -Warn about assigning non-{0,1} values to boolean variables.</div></div></td> +Warn about assigning non-{0,1} values to boolean variables.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -86,11 +86,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.CallAndMessageUnInitRefArg"><div class="namedescr expandable"><span class="name"> alpha.core.CallAndMessageUnInitRefArg</span><span class="lang"> (C, C++)</span><div class="descr"> -Check for uninitialized arguments in function calls and Objective-C -message expressions.</div></div></td> +Check for uninitialized arguments in function calls and Objective-C +message expressions.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(void) { @@ -109,13 +109,13 @@ void test(void) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.CastSize"><div class="namedescr expandable"><span class="name"> alpha.core.CastSize</span><span class="lang"> (C)</span><div class="descr"> -Check when casting a malloc'ed type T, whether the size is a multiple of the +Check when casting a malloc'ed type T, whether the size is a multiple of the size of T (Works only with <span class="name">unix.Malloc</span> -or <span class="name">alpha.unix.MallocWithAnnotations</span> -checks enabled).</div></div></td> +or <span class="name">alpha.unix.MallocWithAnnotations</span> +checks enabled).</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -124,10 +124,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.CastToStruct"><div class="namedescr expandable"><span class="name"> alpha.core.CastToStruct</span><span class="lang"> (C, C++)</span><div class="descr"> -Check for cast from non-struct pointer to struct pointer.</div></div></td> +Check for cast from non-struct pointer to struct pointer.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // C @@ -147,10 +147,10 @@ void test(int *p) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.Conversion"><div class="namedescr expandable"><span class="name"> alpha.core.Conversion</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> -Loss of sign or precision in implicit conversions</div></div></td> +Loss of sign or precision in implicit conversions</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(unsigned U, signed S) { @@ -172,26 +172,26 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.DynamicTypeChecker"><div class="namedescr expandable"><span class="name"> alpha.core.DynamicTypeChecker</span><span class="lang"> (ObjC)</span><div class="descr"> -Check for cases where the dynamic and the static type of an -object are unrelated.</div></div></td> +Check for cases where the dynamic and the static type of an +object are unrelated.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> id date = [NSDate date]; -// Warning: Object has a dynamic type 'NSDate *' which is +// Warning: Object has a dynamic type 'NSDate *' which is // incompatible with static type 'NSNumber *'" NSNumber *number = date; [number doubleValue]; </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.FixedAddr"><div class="namedescr expandable"><span class="name"> alpha.core.FixedAddr</span><span class="lang"> (C)</span><div class="descr"> -Check for assignment of a fixed address to a pointer.</div></div></td> +Check for assignment of a fixed address to a pointer.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -201,10 +201,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.IdenticalExpr"><div class="namedescr expandable"><span class="name"> alpha.core.IdenticalExpr</span><span class="lang"> (C, C++)</span><div class="descr"> -Warn about suspicious uses of identical expressions.</div></div></td> +Warn about suspicious uses of identical expressions.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // C @@ -232,11 +232,11 @@ void test(bool b) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.PointerArithm"><div class="namedescr expandable"><span class="name"> alpha.core.PointerArithm</span><span class="lang"> (C)</span><div class="descr"> -Check for pointer arithmetic on locations other than array -elements.</div></div></td> +Check for pointer arithmetic on locations other than array +elements.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -247,11 +247,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.PointerSub"><div class="namedescr expandable"><span class="name"> alpha.core.PointerSub</span><span class="lang"> (C)</span><div class="descr"> -Check for pointer subtractions on two pointers pointing to different memory -chunks.</div></div></td> +Check for pointer subtractions on two pointers pointing to different memory +chunks.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -261,60 +261,60 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.SizeofPtr"><div class="namedescr expandable"><span class="name"> alpha.core.SizeofPtr</span><span class="lang"> (C)</span><div class="descr"> -Warn about unintended use of <code>sizeof()</code> on pointer -expressions.</div></div></td> +Warn about unintended use of <code>sizeof()</code> on pointer +expressions.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> struct s {}; int test(struct s *p) { - return sizeof(p); + return sizeof(p); // warn: sizeof(ptr) can produce an unexpected result } </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.StackAddressAsyncEscape"><div class="namedescr expandable"><span class="name"> alpha.core.StackAddressAsyncEscape</span><span class="lang"> (C)</span><div class="descr"> Check that addresses to stack memory do not escape the function that involves <code>dispatch_after</code> or <code>dispatch_async</code>. This checker is a part of core.StackAddressEscape, but is <a href=https://reviews.llvm.org/D41042>temporarily disabled</a> until some -false positives are fixed.</div></div></td> +false positives are fixed.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> dispatch_block_t test_block_inside_block_async_leak() { int x = 123; void (^inner)(void) = ^void(void) { int y = x; - ++y; + ++y; }; void (^outer)(void) = ^void(void) { int z = x; ++z; - inner(); - }; + inner(); + }; return outer; // warn: address of stack-allocated block is captured by a // returned block } </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.core.TestAfterDivZero"><div class="namedescr expandable"><span class="name"> alpha.core.TestAfterDivZero</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> -Check for division by variable that is later compared against 0. +Check for division by variable that is later compared against 0. Either the comparison is useless or there is division by zero. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(int x) { var = 77 / x; - if (x == 0) { } // warn + if (x == 0) { } // warn } </pre></div></div></td></tr> @@ -329,12 +329,12 @@ void test(int x) { <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.cplusplus.DeleteWithNonVirtualDtor"><div class="namedescr expandable"><span class="name"> alpha.cplusplus.DeleteWithNonVirtualDtor</span><span class="lang"> (C++)</span><div class="descr"> Reports destructions of polymorphic objects with a non-virtual destructor in their base class -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> NonVirtual *create() { @@ -349,11 +349,11 @@ void sink(NonVirtual *x) { } </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.cplusplus.EnumCastOutOfRange"><div class="namedescr expandable"><span class="name"> alpha.cplusplus.EnumCastOutOfRange</span><span class="lang"> (C++)</span><div class="descr"> Check for integer to enumeration casts that could result in undefined values. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> enum TestEnum { @@ -368,11 +368,11 @@ void foo() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.cplusplus.InvalidatedIterator"><div class="namedescr expandable"><span class="name"> alpha.cplusplus.InvalidatedIterator</span><span class="lang"> (C++)</span><div class="descr"> Check for use of invalidated iterators. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void bad_copy_assign_operator_list1(std::list<int> &L1, @@ -384,11 +384,11 @@ void bad_copy_assign_operator_list1(std::list<int> &L1, </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.cplusplus.IteratorRange"><div class="namedescr expandable"><span class="name"> alpha.cplusplus.IteratorRange</span><span class="lang"> (C++)</span><div class="descr"> Check for iterators used outside their valid ranges. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void simple_bad_end(const std::vector<int> &v) { @@ -398,12 +398,12 @@ void simple_bad_end(const std::vector<int> &v) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.cplusplus.MismatchedIterator"><div class="namedescr expandable"><span class="name"> alpha.cplusplus.MismatchedIterator</span><span class="lang"> (C++)</span><div class="descr"> Check for use of iterators of different containers where iterators of the same container are expected. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void bad_insert3(std::vector<int> &v1, std::vector<int> &v2) { @@ -424,12 +424,12 @@ void bad_insert3(std::vector<int> &v1, std::vector<int> &v2) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> -alpha.cplusplus.MisusedMovedObject</span><span class="lang"> +<tr><td><a id="alpha.cplusplus.Move"><div class="namedescr expandable"><span class="name"> +alpha.cplusplus.Move</span><span class="lang"> (C++)</span><div class="descr"> Method calls on a moved-from object and copying a moved-from object will be reported. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> struct A { @@ -444,7 +444,7 @@ void f() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.cplusplus.UninitializedObject"><div class="namedescr expandable"><span class="name"> alpha.cplusplus.UninitializedObject</span><span class="lang"> (C++)</span><div class="descr"> This checker reports uninitialized fields in objects created after a constructor @@ -481,7 +481,7 @@ It has several options: <code>-analyzer-config alpha.cplusplus.UninitializedObject:IgnoreRecordsWithField="[Tt]ag|[Kk]ind"</code>. </li> -</ul></div></div></td> +</ul></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // With Pedantic and CheckPointeeInitialization set to true @@ -568,10 +568,10 @@ void f() { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.deadcode.UnreachableCode"><div class="namedescr expandable"><span class="name"> alpha.deadcode.UnreachableCode</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> -Check unreachable code.</div></div></td> +Check unreachable code.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // C @@ -609,7 +609,7 @@ void test(id x) { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.llvm.Conventions"><div class="namedescr expandable"><span class="name"> alpha.llvm.Conventions</span><span class="lang"> (C)</span><div class="descr"> Check code for LLVM codebase conventions: @@ -618,7 +618,7 @@ Check code for LLVM codebase conventions: whose lifetime is shorter than the <code>StringRef</code>'s.</li> <li>Clang AST nodes should not have fields that can allocate memory.</li> </ul> -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> <!-- TODO: Add examples, as currently it's hard to get this checker working. --> @@ -634,11 +634,11 @@ Check code for LLVM codebase conventions: <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.osx.cocoa.DirectIvarAssignment"><div class="namedescr expandable"><span class="name"> alpha.osx.cocoa.DirectIvarAssignment</span><span class="lang"> (ObjC)</span><div class="descr"> -Check that Objective C properties follow the following rule: the property -should be set with the setter, not though a direct assignment.</div></div></td> +Check that Objective C properties follow the following rule: the property +should be set with the setter, not though a direct assignment.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface MyClass : NSObject {} @@ -654,11 +654,11 @@ should be set with the setter, not though a direct assignment.</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.osx.cocoa.DirectIvarAssignmentForAnnotatedFunctions"><div class="namedescr expandable"><span class="name"> alpha.osx.cocoa.DirectIvarAssignmentForAnnotatedFunctions</span><span class="lang"> (ObjC)</span><div class="descr"> -Check for direct assignments to instance variables in the methods annotated -with <code>objc_no_direct_instance_variable_assignment</code>.</div></div></td> +Check for direct assignments to instance variables in the methods annotated +with <code>objc_no_direct_instance_variable_assignment</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface MyClass : NSObject {} @@ -679,17 +679,17 @@ with <code>objc_no_direct_instance_variable_assignment</code>.</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.osx.cocoa.InstanceVariableInvalidation"><div class="namedescr expandable"><span class="name"> alpha.osx.cocoa.InstanceVariableInvalidation</span><span class="lang"> (ObjC)</span><div class="descr"> Check that the invalidatable instance variables are invalidated in the methods -annotated with <code>objc_instance_variable_invalidator</code>.</div></div></td> +annotated with <code>objc_instance_variable_invalidator</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @protocol Invalidation <NSObject> -- (void) invalidate +- (void) invalidate __attribute__((annotate("objc_instance_variable_invalidator"))); -@end +@end @interface InvalidationImpObj : NSObject <Invalidation> @end @@ -707,15 +707,15 @@ annotated with <code>objc_instance_variable_invalidator</code>.</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.osx.cocoa.MissingInvalidationMethod"><div class="namedescr expandable"><span class="name"> alpha.osx.cocoa.MissingInvalidationMethod</span><span class="lang"> (ObjC)</span><div class="descr"> -Check that the invalidation methods are present in classes that contain -invalidatable instance variables.</div></div></td> +Check that the invalidation methods are present in classes that contain +invalidatable instance variables.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @protocol Invalidation <NSObject> -- (void)invalidate +- (void)invalidate __attribute__((annotate("objc_instance_variable_invalidator"))); @end @@ -732,25 +732,25 @@ invalidatable instance variables.</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.osx.cocoa.localizability.PluralMisuseChecker"><div class="namedescr expandable"><span class="name"> alpha.osx.cocoa.localizability.PluralMisuseChecker</span><span class="lang"> (ObjC)</span><div class="descr"> -Warns against using one vs. many plural pattern in code +Warns against using one vs. many plural pattern in code when generating localized strings. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> -NSString *reminderText = +NSString *reminderText = NSLocalizedString(@"None", @"Indicates no reminders"); if (reminderCount == 1) { // Warning: Plural cases are not supported across all languages. // Use a .stringsdict file instead - reminderText = + reminderText = NSLocalizedString(@"1 Reminder", @"Indicates single reminder"); } else if (reminderCount >= 2) { // Warning: Plural cases are not supported across all languages. // Use a .stringsdict file instead - reminderText = + reminderText = [NSString stringWithFormat: NSLocalizedString(@"%@ Reminders", @"Indicates multiple reminders"), reminderCount]; @@ -766,10 +766,10 @@ if (reminderCount == 1) { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.security.ArrayBound"><div class="namedescr expandable"><span class="name"> alpha.security.ArrayBound</span><span class="lang"> (C)</span><div class="descr"> -Warn about buffer overflows (older checker).</div></div></td> +Warn about buffer overflows (older checker).</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -791,7 +791,7 @@ void test() { } </pre></div><div class="separator"></div> <div class="example"><pre> -// note: requires unix.Malloc or +// note: requires unix.Malloc or // alpha.unix.MallocWithAnnotations checks enabled. void test() { int *p = malloc(12); @@ -807,10 +807,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.security.ArrayBoundV2"><div class="namedescr expandable"><span class="name"> alpha.security.ArrayBoundV2</span><span class="lang"> (C)</span><div class="descr"> -Warn about buffer overflows (newer checker).</div></div></td> +Warn about buffer overflows (newer checker).</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -844,10 +844,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.security.MallocOverflow"><div class="namedescr expandable"><span class="name"> alpha.security.MallocOverflow</span><span class="lang"> (C)</span><div class="descr"> -Check for overflows in the arguments to <code>malloc()</code>.</div></div></td> +Check for overflows in the arguments to <code>malloc()</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(int n) { @@ -856,11 +856,11 @@ void test(int n) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.security.MmapWriteExec"><div class="namedescr expandable"><span class="name"> alpha.security.MmapWriteExec</span><span class="lang"> (C)</span><div class="descr"> Warn on <code>mmap()<code> calls that are both writable and executable. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(int n) { @@ -873,10 +873,10 @@ void test(int n) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.security.ReturnPtrRange"><div class="namedescr expandable"><span class="name"> alpha.security.ReturnPtrRange</span><span class="lang"> (C)</span><div class="descr"> -Check for an out-of-bound pointer being returned to callers.</div></div></td> +Check for an out-of-bound pointer being returned to callers.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> static int A[10]; @@ -894,10 +894,10 @@ int test(void) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.security.taint.TaintPropagation"><div class="namedescr expandable"><span class="name"> alpha.security.taint.TaintPropagation</span><span class="lang"> (C)</span><div class="descr"> -Generate taint information used by other checkers.</div></div></td> +Generate taint information used by other checkers.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -907,7 +907,7 @@ void test() { </pre></div><div class="separator"></div> <div class="example"><pre> // note: compiler internally checks if the second param to -// sprintf is a string literal or not. +// sprintf is a string literal or not. // Use -Wno-format-security to suppress compiler warning. void test() { char s[10], buf[10]; @@ -920,7 +920,7 @@ void test() { void test() { size_t ts; scanf("%zd", &ts); // 'ts' marked as tainted - int *p = (int *)malloc(ts * sizeof(int)); + int *p = (int *)malloc(ts * sizeof(int)); // warn: untrusted data as buffer size } </pre></div></div></td></tr> @@ -935,7 +935,7 @@ void test() { <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.BlockInCriticalSection"><div class="namedescr expandable"><span class="name"> alpha.unix.BlockInCriticalSection</span><span class="lang"> (C)</span><div class="descr"> Check for calls to blocking functions inside a critical section. Applies to: @@ -955,7 +955,7 @@ mtx_trylock<br> mtx_unlock<br> lock_guard<br> unique_lock</div> -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -968,10 +968,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.Chroot"><div class="namedescr expandable"><span class="name"> alpha.unix.Chroot</span><span class="lang"> (C)</span><div class="descr"> -Check improper use of <code>chroot</code>.</div></div></td> +Check improper use of <code>chroot</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void f(); @@ -983,7 +983,7 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.PthreadLock"><div class="namedescr expandable"><span class="name"> alpha.unix.PthreadLock</span><span class="lang"> (C)</span><div class="descr"> Simple lock -> unlock checker; applies to:<div class=functions> @@ -1002,14 +1002,14 @@ lck_rw_try_lock_shared<br> pthread_mutex_unlock<br> pthread_rwlock_unlock<br> lck_mtx_unlock<br> -lck_rw_done</div></div></div></td> +lck_rw_done</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> pthread_mutex_t mtx; void test() { pthread_mutex_lock(&mtx); - pthread_mutex_lock(&mtx); + pthread_mutex_lock(&mtx); // warn: this lock has already been acquired } </pre></div><div class="separator"></div> @@ -1019,7 +1019,7 @@ lck_mtx_t lck1, lck2; void test() { lck_mtx_lock(&lck1); lck_mtx_lock(&lck2); - lck_mtx_unlock(&lck1); + lck_mtx_unlock(&lck1); // warn: this was not the most recently acquired lock } </pre></div><div class="separator"></div> @@ -1037,7 +1037,7 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.SimpleStream"><div class="namedescr expandable"><span class="name"> alpha.unix.SimpleStream</span><span class="lang"> (C)</span><div class="descr"> Check for misuses of stream APIs:<div class=functions> @@ -1046,7 +1046,7 @@ fclose</div>(demo checker, the subject of the demo (<a href="http://llvm.org/devmtg/2012-11/Zaks-Rose-Checker24Hours.pdf">Slides</a> ,<a href="https://youtu.be/kdxlsP5QVPw">Video</a>) by Anna Zaks and Jordan Rose presented at the <a href="http://llvm.org/devmtg/2012-11/"> -2012 LLVM Developers' Meeting).</a></div></div></td> +2012 LLVM Developers' Meeting).</a></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1065,7 +1065,7 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.Stream"><div class="namedescr expandable"><span class="name"> alpha.unix.Stream</span><span class="lang"> (C)</span><div class="descr"> Check stream handling functions:<div class=functions>fopen<br> @@ -1081,7 +1081,7 @@ fsetpos<br> clearerr<br> feof<br> ferror<br> -fileno</div></div></div></td> +fileno</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1092,7 +1092,7 @@ void test() { void test() { FILE *p = fopen("foo", "r"); fseek(p, 1, SEEK_SET); // warn: stream pointer might be NULL - fclose(p); + fclose(p); } </pre></div><div class="separator"></div> <div class="example"><pre> @@ -1103,13 +1103,13 @@ void test() { fseek(p, 1, 3); // warn: third arg should be SEEK_SET, SEEK_END, or SEEK_CUR - fclose(p); + fclose(p); } </pre></div><div class="separator"></div> <div class="example"><pre> void test() { FILE *p = fopen("foo", "r"); - fclose(p); + fclose(p); fclose(p); // warn: already closed } </pre></div><div class="separator"></div> @@ -1122,12 +1122,12 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.cstring.BufferOverlap"><div class="namedescr expandable"><span class="name"> alpha.unix.cstring.BufferOverlap</span><span class="lang"> (C)</span><div class="descr"> Checks for overlap in two buffer arguments; applies to:<div class=functions> memcpy<br> -mempcpy</div></div></div></td> +mempcpy</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1137,7 +1137,7 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.cstring.NotNullTerminated"><div class="namedescr expandable"><span class="name"> alpha.unix.cstring.NotNullTerminated</span><span class="lang"> (C)</span><div class="descr"> Check for arguments which are not null-terminated strings; applies @@ -1153,16 +1153,16 @@ strncat</div></div></div></td> void test() { int y = strlen((char *)&test); // warn } -</pre></div></div></td></tr> +</pre></div></div></a></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="alpha.unix.cstring.OutOfBounds"><div class="namedescr expandable"><span class="name"> alpha.unix.cstring.OutOfBounds</span><span class="lang"> (C)</span><div class="descr"> Check for out-of-bounds access in string functions; applies to:<div class=functions> strncopy<br> -strncat</div></div></div></td> +strncat</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(char *y) { diff --git a/clang/www/analyzer/available_checks.html b/clang/www/analyzer/available_checks.html index d5eb0eaeccec..6ca3f8490eb2 100644 --- a/clang/www/analyzer/available_checks.html +++ b/clang/www/analyzer/available_checks.html @@ -52,11 +52,11 @@ Experimental (Alpha) Checkers</a>. <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.CallAndMessage"><div class="namedescr expandable"><span class="name"> core.CallAndMessage</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> Check for logical errors for function calls and Objective-C message expressions -(e.g., uninitialized arguments, null function pointers).</div></div></td> +(e.g., uninitialized arguments, null function pointers).</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // C @@ -153,10 +153,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.DivideZero"><div class="namedescr expandable"><span class="name"> core.DivideZero</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> -Check for division by zero.</div></div></td> +Check for division by zero.</div></div></a>co</td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(int z) { @@ -172,11 +172,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.NonNullParamChecker"><div class="namedescr expandable"><span class="name"> core.NonNullParamChecker</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> Check for null pointers passed as arguments to a function whose arguments are -marked with the <code>nonnull</code> attribute.</div></div></td> +marked with the <code>nonnull</code> attribute.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> int f(int *p) __attribute__((nonnull)); @@ -188,10 +188,10 @@ void test(int *p) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.NullDereference"><div class="namedescr expandable"><span class="name"> core.NullDereference</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> -Check for dereferences of null pointers.</div></div></td> +Check for dereferences of null pointers.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // C @@ -236,10 +236,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.StackAddressEscape"><div class="namedescr expandable"><span class="name"> core.StackAddressEscape</span><span class="lang"> (C)</span><div class="descr"> -Check that addresses of stack memory do not escape the function.</div></div></td> +Check that addresses of stack memory do not escape the function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> char const *p; @@ -263,10 +263,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.UndefinedBinaryOperatorResult"><div class="namedescr expandable"><span class="name"> core.UndefinedBinaryOperatorResult</span><span class="lang"> (C)</span><div class="descr"> -Check for undefined results of binary operators.</div></div></td> +Check for undefined results of binary operators.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -276,10 +276,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.VLASize"><div class="namedescr expandable"><span class="name"> core.VLASize</span><span class="lang"> (C)</span><div class="descr"> -Check for declarations of VLA of undefined or zero size.</div></div></td> +Check for declarations of VLA of undefined or zero size.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -295,10 +295,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.uninitialized.ArraySubscript"><div class="namedescr expandable"><span class="name"> core.uninitialized.ArraySubscript</span><span class="lang"> (C)</span><div class="descr"> -Check for uninitialized values used as array subscripts.</div></div></td> +Check for uninitialized values used as array subscripts.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -308,10 +308,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.uninitialized.Assign"><div class="namedescr expandable"><span class="name"> core.uninitialized.Assign</span><span class="lang"> (C)</span><div class="descr"> -Check for assigning uninitialized values.</div></div></td> +Check for assigning uninitialized values.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -321,10 +321,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.uninitialized.Branch"><div class="namedescr expandable"><span class="name"> core.uninitialized.Branch</span><span class="lang"> (C)</span><div class="descr"> -Check for uninitialized values used as branch conditions.</div></div></td> +Check for uninitialized values used as branch conditions.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -335,10 +335,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.uninitialized.CapturedBlockVariable"><div class="namedescr expandable"><span class="name"> core.uninitialized.CapturedBlockVariable</span><span class="lang"> (C)</span><div class="descr"> -Check for blocks that capture uninitialized values.</div></div></td> +Check for blocks that capture uninitialized values.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -348,10 +348,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="core.uninitialized.UndefReturn"><div class="namedescr expandable"><span class="name"> core.uninitialized.UndefReturn</span><span class="lang"> (C)</span><div class="descr"> -Check for uninitialized values being returned to the caller.</div></div></td> +Check for uninitialized values being returned to the caller.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> int test() { @@ -369,11 +369,11 @@ int test() { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="cplusplus.NewDelete"><div class="namedescr expandable"><span class="name"> cplusplus.NewDelete</span><span class="lang"> (C++)</span><div class="descr"> Check for double-free, use-after-free and offset problems involving C++ <code> -delete</code>.</div></div></td> +delete</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void f(int *p); @@ -423,11 +423,11 @@ void test() { } </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="cplusplus.NewDeleteLeaks"><div class="namedescr expandable"><span class="name"> cplusplus.NewDeleteLeaks</span><span class="lang"> (C++)</span><div class="descr"> Check for memory leaks. Traces memory managed by <code>new</code>/<code> -delete</code>.</div></div></td> +delete</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -444,10 +444,10 @@ void test() { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="deadcode.DeadStores"><div class="namedescr expandable"><span class="name"> deadcode.DeadStores</span><span class="lang"> (C)</span><div class="descr"> -Check for values stored to variables that are never read afterwards.</div></div></td> +Check for values stored to variables that are never read afterwards.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -465,11 +465,11 @@ void test() { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="nullability.NullPassedToNonnull"><div class="namedescr expandable"><span class="name"> nullability.NullPassedToNonnull</span><span class="lang"> (ObjC)</span><div class="descr"> -Warns when a null pointer is passed to a pointer which has a -_Nonnull type.</div></div></td> +Warns when a null pointer is passed to a pointer which has a +_Nonnull type.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> if (name != nil) @@ -479,11 +479,11 @@ NSString *greeting = [@"Hello " stringByAppendingString:name]; </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="nullability.NullReturnedFromNonnull"><div class="namedescr expandable"><span class="name"> nullability.NullReturnedFromNonnull</span><span class="lang"> (ObjC)</span><div class="descr"> -Warns when a null pointer is returned from a function that has -_Nonnull return type.</div></div></td> +Warns when a null pointer is returned from a function that has +_Nonnull return type.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> - (nonnull id)firstChild { @@ -491,17 +491,17 @@ _Nonnull return type.</div></div></td> if ([_children count] > 0) result = _children[0]; - // Warning: nil returned from a method that is expected + // Warning: nil returned from a method that is expected // to return a non-null value return result; } </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="nullability.NullableDereferenced"><div class="namedescr expandable"><span class="name"> nullability.NullableDereferenced</span><span class="lang"> (ObjC)</span><div class="descr"> -Warns when a nullable pointer is dereferenced.</div></div></td> +Warns when a nullable pointer is dereferenced.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> struct LinkedList { @@ -519,10 +519,10 @@ void updateNextData(struct LinkedList *list, int newData) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="nullability.NullablePassedToNonnull"><div class="namedescr expandable"><span class="name"> nullability.NullablePassedToNonnull</span><span class="lang"> (ObjC)</span><div class="descr"> -Warns when a nullable pointer is passed to a pointer which has a _Nonnull type.</div></div></td> +Warns when a nullable pointer is passed to a pointer which has a _Nonnull type.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> typedef struct Dummy { int val; } Dummy; @@ -545,16 +545,16 @@ void test() { <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="optin.cplusplus.VirtualCall"><div class="namedescr expandable"><span class="name"> optin.cplusplus.VirtualCall</span><span class="lang"> (C++)</span><div class="descr"> -Check virtual member function calls during construction or -destruction.</div></div></td> +Check virtual member function calls during construction or +destruction.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> class A { public: - A() { + A() { f(); // warn } virtual void f(); @@ -571,16 +571,16 @@ public: </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="optin.mpi.MPI-Checker"><div class="namedescr expandable"><span class="name"> optin.mpi.MPI-Checker</span><span class="lang"> (C)</span><div class="descr"> -Checks MPI code</div></div></td> +Checks MPI code</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { double buf = 0; MPI_Request sendReq1; - MPI_Ireduce(MPI_IN_PLACE, &buf, 1, MPI_DOUBLE, MPI_SUM, + MPI_Ireduce(MPI_IN_PLACE, &buf, 1, MPI_DOUBLE, MPI_SUM, 0, MPI_COMM_WORLD, &sendReq1); } // warn: request 'sendReq1' has no matching wait. </pre></div><div class="separator"></div> @@ -604,10 +604,10 @@ void missingNonBlocking() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="optin.osx.cocoa.localizability.EmptyLocalizationContextChecker"><div class="namedescr expandable"><span class="name"> optin.osx.cocoa.localizability.EmptyLocalizationContextChecker</span><span class="lang"> (ObjC)</span><div class="descr"> -Check that NSLocalizedString macros include a comment for context.</div></div></td> +Check that NSLocalizedString macros include a comment for context.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> - (void)test { @@ -619,14 +619,14 @@ Check that NSLocalizedString macros include a comment for context.</div></div></ </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="optin.osx.cocoa.localizability.NonLocalizedStringChecker"><div class="namedescr expandable"><span class="name"> optin.osx.cocoa.localizability.NonLocalizedStringChecker</span><span class="lang"> (ObjC)</span><div class="descr"> -Warns about uses of non-localized NSStrings passed to UI methods -expecting localized NSStrings</div></div></td> +Warns about uses of non-localized NSStrings passed to UI methods +expecting localized NSStrings</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> -NSString *alarmText = +NSString *alarmText = NSLocalizedString(@"Enabled", @"Indicates alarm is turned on"); if (!isEnabled) { alarmText = @"Disabled"; @@ -646,11 +646,11 @@ UILabel *alarmStateLabel = [[UILabel alloc] init]; <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.API"><div class="namedescr expandable"><span class="name"> osx.API</span><span class="lang"> (C)</span><div class="descr"> Check for proper uses of various Apple APIs:<div class=functions> -dispatch_once</div></div></div></td> +dispatch_once</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -660,15 +660,15 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.NumberObjectConversion"><div class="namedescr expandable"><span class="name"> osx.NumberObjectConversion</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> -Check for erroneous conversions of objects representing numbers -into numbers</div></div></td> +Check for erroneous conversions of objects representing numbers +into numbers</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> NSNumber *photoCount = [albumDescriptor objectForKey:@"PhotoCount"]; -// Warning: Comparing a pointer value of type 'NSNumber *' +// Warning: Comparing a pointer value of type 'NSNumber *' // to a scalar integer value if (photoCount > 0) { [self displayPhotos]; @@ -676,7 +676,7 @@ if (photoCount > 0) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.SecKeychainAPI"><div class="namedescr expandable"><span class="name"> osx.SecKeychainAPI</span><span class="lang"> (C)</span><div class="descr"> Check for improper uses of the Security framework's Keychain APIs:<div class=functions> @@ -685,7 +685,7 @@ SecKeychainFindGenericPassword<br> SecKeychainFindInternetPassword<br> SecKeychainItemFreeContent<br> SecKeychainItemCopyAttributesAndData<br> -SecKeychainItemFreeAttributesAndData</div></div></div></td> +SecKeychainItemFreeAttributesAndData</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -756,10 +756,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.AtSync"><div class="namedescr expandable"><span class="name"> osx.cocoa.AtSync</span><span class="lang"> (ObjC)</span><div class="descr"> -Check for nil pointers used as mutexes for <code>@synchronized</code>.</div></div></td> +Check for nil pointers used as mutexes for <code>@synchronized</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(id x) { @@ -775,11 +775,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.ClassRelease"><div class="namedescr expandable"><span class="name"> osx.cocoa.ClassRelease</span><span class="lang"> (ObjC)</span><div class="descr"> Check for sending <code>retain</code>, <code>release</code>, or <code> -autorelease</code> directly to a class.</div></div></td> +autorelease</code> directly to a class.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface MyClass : NSObject @@ -791,16 +791,16 @@ void test(void) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.Dealloc"><div class="namedescr expandable"><span class="name"> osx.cocoa.Dealloc</span><span class="lang"> (ObjC)</span><div class="descr"> -Warn about Objective-C classes that lack a correct implementation +Warn about Objective-C classes that lack a correct implementation of <code>-dealloc</code>. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface MyObject : NSObject { - id _myproperty; + id _myproperty; } @end @@ -851,10 +851,10 @@ of <code>-dealloc</code>. </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.IncompatibleMethodTypes"><div class="namedescr expandable"><span class="name"> osx.cocoa.IncompatibleMethodTypes</span><span class="lang"> (ObjC)</span><div class="descr"> -Check for an incompatible type signature when overriding an Objective-C method.</div></div></td> +Check for an incompatible type signature when overriding an Objective-C method.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface MyClass1 : NSObject @@ -875,13 +875,13 @@ Check for an incompatible type signature when overriding an Objective-C method.< </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> -alpha.osx.cocoa.MissingSuperCall</span><span class="lang"> +<tr><td><a id="osx.cocoa.MissingSuperCall"><div class="namedescr expandable"><span class="name"> +osx.cocoa.MissingSuperCall</span><span class="lang"> (ObjC)</span><div class="descr"> Warn about Objective-C methods that lack a necessary call to super. (Note: The compiler now has a warning for methods annotated with <code>objc_requires_super</code> attribute. The checker exists to check methods in the Cocoa frameworks -that haven't yet adopted this attribute.)</div></div></td> +that haven't yet adopted this attribute.)</div></div></a></td> <td><div class="example"><pre> @interface Test : UIViewController @end @@ -891,11 +891,11 @@ that haven't yet adopted this attribute.)</div></div></td> </pre></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.NSAutoreleasePool"><div class="namedescr expandable"><span class="name"> osx.cocoa.NSAutoreleasePool</span><span class="lang"> (ObjC)</span><div class="descr"> Warn for suboptimal uses of NSAutoreleasePool in Objective-C -GC mode (<code>-fobjc-gc</code> compiler option).</div></div></td> +GC mode (<code>-fobjc-gc</code> compiler option).</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -905,10 +905,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.NSError"><div class="namedescr expandable"><span class="name"> osx.cocoa.NSError</span><span class="lang"> (ObjC)</span><div class="descr"> -Check usage of <code>NSError**</code> parameters.</div></div></td> +Check usage of <code>NSError**</code> parameters.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface A : NSObject @@ -936,7 +936,7 @@ Check usage of <code>NSError**</code> parameters.</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.NilArg"><div class="namedescr expandable"><span class="name"> osx.cocoa.NilArg</span><span class="lang"> (ObjC)</span><div class="descr"> Check for prohibited nil arguments in specific Objective-C method calls:<div class=functions> @@ -946,7 +946,7 @@ Check for prohibited nil arguments in specific Objective-C method calls:<div cla - compare:options:range:<br> - compare:options:range:locale:<br> - componentsSeparatedByCharactersInSet:<br> -- initWithFormat:</div></div></div></td> +- initWithFormat:</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> NSComparisonResult test(NSString *s) { @@ -958,25 +958,25 @@ NSComparisonResult test(NSString *s) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.ObjCGenerics"><div class="namedescr expandable"><span class="name"> osx.cocoa.ObjCGenerics</span><span class="lang"> (ObjC)</span><div class="descr"> -Check for type errors when using Objective-C generics</div></div></td> +Check for type errors when using Objective-C generics</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> NSMutableArray<NSString *> *names = [NSMutableArray array]; NSMutableArray *birthDates = names; -// Warning: Conversion from value of type 'NSDate *' +// Warning: Conversion from value of type 'NSDate *' // to incompatible type 'NSString *' [birthDates addObject: [NSDate date]]; </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.RetainCount"><div class="namedescr expandable"><span class="name"> osx.cocoa.RetainCount</span><span class="lang"> (ObjC)</span><div class="descr"> -Check for leaks and violations of the Cocoa Memory Management rules.</div></div></td> +Check for leaks and violations of the Cocoa Memory Management rules.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -991,11 +991,11 @@ CFStringRef test(char *bytes) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.SelfInit"><div class="namedescr expandable"><span class="name"> osx.cocoa.SelfInit</span><span class="lang"> (ObjC)</span><div class="descr"> Check that <code>self</code> is properly initialized inside an initializer -method.</div></div></td> +method.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface MyObj : NSObject { @@ -1027,10 +1027,10 @@ method.</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.SuperDealloc"><div class="namedescr expandable"><span class="name"> osx.cocoa.SuperDealloc</span><span class="lang"> (ObjC)</span><div class="descr"> -Warn about improper use of '[super dealloc]' in Objective-C</div></div></td> +Warn about improper use of '[super dealloc]' in Objective-C</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface SuperDeallocThenReleaseIvarClass : NSObject { @@ -1047,10 +1047,10 @@ Warn about improper use of '[super dealloc]' in Objective-C</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.UnusedIvars"><div class="namedescr expandable"><span class="name"> osx.cocoa.UnusedIvars</span><span class="lang"> (ObjC)</span><div class="descr"> -Warn about private ivars that are never used.</div></div></td> +Warn about private ivars that are never used.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> @interface MyObj : NSObject { @@ -1064,11 +1064,11 @@ Warn about private ivars that are never used.</div></div></td> </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.cocoa.VariadicMethodTypes"><div class="namedescr expandable"><span class="name"> osx.cocoa.VariadicMethodTypes</span><span class="lang"> (ObjC)</span><div class="descr"> Check for passing non-Objective-C types to variadic collection initialization -methods that expect only Objective-C types.</div></div></td> +methods that expect only Objective-C types.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1078,10 +1078,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.coreFoundation.CFError"><div class="namedescr expandable"><span class="name"> osx.coreFoundation.CFError</span><span class="lang"> (C)</span><div class="descr"> -Check usage of <code>CFErrorRef*</code> parameters.</div></div></td> +Check usage of <code>CFErrorRef*</code> parameters.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(CFErrorRef *error) { @@ -1097,10 +1097,10 @@ int foo(CFErrorRef *error) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.coreFoundation.CFNumber"><div class="namedescr expandable"><span class="name"> osx.coreFoundation.CFNumber</span><span class="lang"> (C)</span><div class="descr"> -Check for improper uses of <code>CFNumberCreate</code>.</div></div></td> +Check for improper uses of <code>CFNumberCreate</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> CFNumberRef test(unsigned char x) { @@ -1110,11 +1110,11 @@ CFNumberRef test(unsigned char x) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.coreFoundation.CFRetainRelease"><div class="namedescr expandable"><span class="name"> osx.coreFoundation.CFRetainRelease</span><span class="lang"> (C)</span><div class="descr"> Check for null arguments to <code>CFRetain</code>, <code>CFRelease</code>, -<code>CFMakeCollectable</code>.</div></div></td> +<code>CFMakeCollectable</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test(CFTypeRef p) { @@ -1132,10 +1132,10 @@ void test(int x, CFTypeRef p) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.coreFoundation.containers.OutOfBounds"><div class="namedescr expandable"><span class="name"> osx.coreFoundation.containers.OutOfBounds</span><span class="lang"> (C)</span><div class="descr"> -Checks for index out-of-bounds when using <code>CFArray</code> API.</div></div></td> +Checks for index out-of-bounds when using <code>CFArray</code> API.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1145,11 +1145,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="osx.coreFoundation.containers.PointerSizedValues"><div class="namedescr expandable"><span class="name"> osx.coreFoundation.containers.PointerSizedValues</span><span class="lang"> (C)</span><div class="descr"> Warns if <code>CFArray</code>, <code>CFDictionary</code>, <code>CFSet</code> are -created with non-pointer-size values.</div></div></td> +created with non-pointer-size values.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1168,11 +1168,11 @@ void test() { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.FloatLoopCounter"><div class="namedescr expandable"><span class="name"> security.FloatLoopCounter</span><span class="lang"> (C)</span><div class="descr"> Warn on using a floating point value as a loop counter (CERT: FLP30-C, -FLP30-CPP).</div></div></td> +FLP30-CPP).</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1181,7 +1181,7 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.UncheckedReturn"><div class="namedescr expandable"><span class="name"> security.insecureAPI.UncheckedReturn</span><span class="lang"> (C)</span><div class="descr"> Warn on uses of functions whose return values must be always checked:<div class=functions> @@ -1190,7 +1190,7 @@ setgid<br> seteuid<br> setegid<br> setreuid<br> -setregid</div></div></div></td> +setregid</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1199,10 +1199,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.bcmp"><div class="namedescr expandable"><span class="name"> security.insecureAPI.bcmp</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>bcmp</code> function.</div></div></td> +Warn on uses of the <code>bcmp</code> function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1210,10 +1210,10 @@ void test() { } </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.bcopy"><div class="namedescr expandable"><span class="name"> security.insecureAPI.bcopy</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>bcopy</code> function.</div></div></td> +Warn on uses of the <code>bcopy</code> function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1221,10 +1221,10 @@ void test() { } </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.bzero"><div class="namedescr expandable"><span class="name"> security.insecureAPI.bzero</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>bzero</code> function.</div></div></td> +Warn on uses of the <code>bzero</code> function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1233,10 +1233,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.getpw"><div class="namedescr expandable"><span class="name"> security.insecureAPI.getpw</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>getpw</code> function.</div></div></td> +Warn on uses of the <code>getpw</code> function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1246,10 +1246,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.gets"><div class="namedescr expandable"><span class="name"> security.insecureAPI.gets</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>gets</code> function.</div></div></td> +Warn on uses of the <code>gets</code> function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1259,12 +1259,12 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.mkstemp"><div class="namedescr expandable"><span class="name"> security.insecureAPI.mkstemp</span><span class="lang"> (C)</span><div class="descr"> Warn when <code>mktemp</code>, <code>mkstemp</code>, <code>mkstemps</code> or <code>mkdtemp</code> is passed fewer than 6 -X's in the format string.</div></div></td> +X's in the format string.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1273,10 +1273,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.mktemp"><div class="namedescr expandable"><span class="name"> security.insecureAPI.mktemp</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>mktemp</code> function.</div></div></td> +Warn on uses of the <code>mktemp</code> function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1285,7 +1285,7 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.rand"><div class="namedescr expandable"><span class="name"> security.insecureAPI.rand</span><span class="lang"> (C)</span><div class="descr"> Warn on uses of inferior random number generating functions (only if <code>arc4random</code> @@ -1298,7 +1298,7 @@ lrand48<br> mrand48<br> nrand48<br> random<br> -rand_r</div></div></div></td> +rand_r</div></div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1307,10 +1307,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.strcpy"><div class="namedescr expandable"><span class="name"> security.insecureAPI.strcpy</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>strcpy</code> and <code>strcat</code> functions.</div></div></td> +Warn on uses of the <code>strcpy</code> and <code>strcat</code> functions.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1322,10 +1322,10 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="security.insecureAPI.vfork"><div class="namedescr expandable"><span class="name"> security.insecureAPI.vfork</span><span class="lang"> (C)</span><div class="descr"> -Warn on uses of the <code>vfork</code> function.</div></div></td> +Warn on uses of the <code>vfork</code> function.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1342,7 +1342,7 @@ void test() { <thead><tr><td>Name, Description</td><td>Example</td></tr></thead> <tbody> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="unix.API"><div class="namedescr expandable"><span class="name"> unix.API</span><span class="lang"> (C)</span><div class="descr"> Check calls to various UNIX/POSIX functions:<div class=functions> @@ -1351,7 +1351,7 @@ pthread_once<br> calloc<br> malloc<br> realloc<br> -alloca<br> +alloca<br></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // Currently the check is performed for apple targets only. @@ -1398,11 +1398,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="unix.Malloc"><div class="namedescr expandable"><span class="name"> unix.Malloc</span><span class="lang"> (C)</span><div class="descr"> Check for memory leaks, double free, and use-after-free and offset problems -involving <code>malloc</code>.</div></div></td> +involving <code>malloc</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1440,11 +1440,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="unix.MallocSizeof"><div class="namedescr expandable"><span class="name"> unix.MallocSizeof</span><span class="lang"> (C)</span><div class="descr"> Check for dubious <code>malloc</code>, <code>calloc</code> or -<code>realloc</code> arguments involving <code>sizeof</code>.</div></div></td> +<code>realloc</code> arguments involving <code>sizeof</code>.</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1456,11 +1456,11 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="unix.MismatchedDeallocator"><div class="namedescr expandable"><span class="name"> unix.MismatchedDeallocator</span><span class="lang"> (C, C++, ObjC)</span><div class="descr"> Check for mismatched deallocators (e.g. passing a pointer allocating -with <code>new</code> to <code>free()</code>).</div></div></td> +with <code>new</code> to <code>free()</code>).</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> // C, C++ @@ -1527,10 +1527,10 @@ void test(NSUInteger dataLength) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="unix.Vfork"><div class="namedescr expandable"><span class="name"> unix.Vfork</span><span class="lang"> (C)</span><div class="descr"> -Check for proper usage of vfork</div></div></td> +Check for proper usage of vfork</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> int test(int x) { @@ -1559,13 +1559,13 @@ int test(int x) { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="unix.cstring.BadSizeArg"><div class="namedescr expandable"><span class="name"> unix.cstring.BadSizeArg</span><span class="lang"> (C)</span><div class="descr"> Check the size argument passed to <code>strncat</code> for common erroneous patterns. Use <code>-Wno-strncat-size</code> compiler option to mute other <code>strncat</code>-related compiler warnings. -</div></div></td> +</div></div></a></td> <td><div class="exampleContainer expandable"> <div class="example"><pre> void test() { @@ -1576,7 +1576,7 @@ void test() { </pre></div></div></td></tr> -<tr><td><div class="namedescr expandable"><span class="name"> +<tr><td><a id="unix.cstring.NullArg"><div class="namedescr expandable"><span class="name"> unix.cstring.NullArg</span><span class="lang"> (C)</span><div class="descr"> Check for null pointers being passed as arguments to C string functions:<div class=functions> @@ -1589,7 +1589,7 @@ strncat<br> strcmp<br> strncmp<br> strcasecmp<br> -strncasecmp</div></div></div></td> +strncasecmp</div></div></div></a></td> <td><div class="example"><pre> int test() { return strlen(0); // warn |