5 ** This file is used to generate the flag header files.
7 ** Don't forget to regenerate flag_codes.gen. (lost the Makefile...bleech!)
9 /* spec idem global mode args */
12 # define modeFlag FALSE, FALSE, FALSE, TRUE, ARG_NONE
14 # define plainFlag FALSE, FALSE, FALSE, FALSE, ARG_NONE
16 # define specialFlag TRUE, FALSE, FALSE, FALSE, ARG_NONE
18 # define plainSpecialFlag TRUE, FALSE, FALSE, FALSE, ARG_NONE
20 # define idemSpecialFlag TRUE, TRUE, FALSE, FALSE, ARG_NONE
22 # define valueFlag FALSE, FALSE, FALSE, FALSE, ARG_NUMBER
25 # define charFlag FALSE, FALSE, FALSE, FALSE, ARG_CHAR
28 # define modeValueFlag FALSE, FALSE, FALSE, TRUE, ARG_NUMBER
30 # define specialValueFlag TRUE, FALSE, FALSE, FALSE, ARG_NUMBER
32 # define debugFlag FALSE, TRUE, FALSE, FALSE, ARG_NONE
34 # define debugValueFlag FALSE, TRUE, FALSE, FALSE, ARG_NUMBER
36 # define specialDebugFlag TRUE, TRUE, FALSE, FALSE, ARG_NONE
38 # define globalFlag FALSE, FALSE, TRUE, FALSE, ARG_NONE
40 # define idemGlobalFlag FALSE, TRUE, TRUE, FALSE, ARG_NONE
42 # define globalValueFlag FALSE, FALSE, TRUE, FALSE, ARG_NUMBER
44 /* Note: type argument missing */
46 # define regStringFlag FALSE, FALSE, FALSE, FALSE
48 # define idemStringFlag FALSE, TRUE, FALSE, FALSE
50 # define globalStringFlag FALSE, FALSE, TRUE, FALSE
53 # define extraArgFlag FALSE, FALSE, FALSE, FALSE, ARG_SPECIAL
55 # define globalExtraArgFlag FALSE, FALSE, TRUE, FALSE, ARG_SPECIAL
57 # define globalFileFlag FALSE, TRUE, TRUE, FALSE, ARG_FILE
61 ** Note: the flag code must be on a separate line, since I'm
62 ** too stupid to write an awk/sed/whatever script that can separate
66 static flaglist flags =
69 ** Null Dereferences (Manual Section 2)
73 FK_NULL, FK_MEMORY, specialFlag,
76 "misuses of null pointer",
77 "A possibly null pointer is misused (sets nullderef, nullpass, "
78 "nullref, nullassign, and nullstate).",
82 FK_NULL, FK_MEMORY, modeFlag,
85 "possible dereferencce of null pointer",
86 "A possibly null pointer is dereferenced. Value is "
87 "either the result of a function which may return null "
88 "(in which case, code should check it is not null), or a "
89 "global, parameter or structure field declared with the "
94 FK_NULL, FK_MEMORY, modeFlag,
97 "possibly null pointer passed as formal with no null annotation",
98 "A possibly null pointer is passed as a parameter corresponding to "
99 "a formal parameter with no /*@null@*/ annotation. If NULL "
100 "may be used for this parameter, add a /*@null@*/ annotation "
101 "to the function parameter declaration.",
105 FK_NULL, FK_MEMORY, modeFlag,
108 "possibly null pointer returned as result with no null annotation",
109 "Function returns a possibly null pointer, but is not declared "
110 "using /*@null@*/ annotation of result. If function may "
111 "return NULL, add /*@null@*/ annotation to the return "
112 "value declaration.",
116 FK_NULL, FK_MEMORY, modeFlag,
119 "possibly null pointer reachable from a reference with no null annotation",
120 "A possibly null pointer is reachable from a parameter or global "
121 "variable that is not declared using a /*@null@*/ annotation.",
125 FK_NULL, FK_MEMORY, modeFlag,
128 "inconsistent assignment or initialization involving null pointer",
129 "A reference with no null annotation is assigned or initialized "
130 "to NULL. Use /*@null@*/ to declare the reference as "
131 "a possibly null pointer.",
136 ** Undefined Values (Section 3)
140 FK_DEF, FK_NONE, modeFlag,
143 "use before definition",
144 "An rvalue is used that may not be initialized to a value on some execution path.",
148 FK_MEMORY, FK_DEF, modeFlag,
151 "out storage not defined before return or scope exit",
152 "An out parameter or global is not defined before control is transferred.",
156 FK_MEMORY, FK_DEF, modeFlag,
159 "at least one field of a union must be defined",
160 "No field of a union is defined. Generally, one field of a union is "
161 "expected to be defined.",
165 FK_MEMORY, FK_DEF, modeFlag,
168 "parameter, return value or global completely defined",
169 "Storage derivable from a parameter, return value or global is "
170 "not defined. Use /*@out@*/ to denote passed or returned "
171 "storage which need not be defined.",
175 FK_DEF, FK_NONE, plainFlag,
178 "initializer sets all fields",
179 "Initializer does not set every field in the structure.",
183 FK_DEF, FK_NONE, plainFlag,
186 "initializer defines all array elements",
187 "Initializer does not define all elements of a declared array.",
191 FK_DEF, FK_NONE, plainFlag,
194 "initializer defines extra array elements",
195 "Initializer block contains more elements than the size of a declared array.",
200 FK_DEF, FK_IMPLICIT, modeFlag,
203 "pointer parameters to unspecified functions may be implicit out parameters",
212 FK_DECL, FK_TYPE, modeFlag,
215 "function, variable or constant redefined with inconsistent type",
216 "A function, variable or constant is redefined with a different type.",
220 FK_DECL, FK_TYPE, modeFlag,
223 "struct or enum type redefined with inconsistent fields or members",
224 "A struct, union or enum type is redefined with inconsistent fields or members.",
228 FK_TYPE, FK_NONE, modeFlag,
231 "dereferencce of a function type",
232 "A function type is dereferenced. The ANSI standard allows this "
233 "because of implicit conversion of function designators, however the "
234 "dereference is unnecessary.",
238 FK_OPS, FK_NONE, modeFlag,
241 "dangerous comparison between reals (dangerous because of inexact "
242 "floating point representations)",
243 "Two real (float, double, or long double) values are compared "
244 "directly using a C primitive. "
245 "This may produce unexpected results since floating point "
246 "representations are inexact. Instead, compare the difference to "
247 "FLT_EPSILON or DBL_EPSILON.",
251 FK_OPS, FK_NONE, modeFlag,
254 "comparison using <, <=, >= between an unsigned integral and zero constant",
255 "An unsigned value is used in a comparison with zero in a way that is either a bug or confusing.",
259 FK_OPS, FK_POINTER, modeFlag,
262 "arithmetic involving pointer and integer",
263 "Pointer arithmetic using pointer and integer.", 0, 0
266 FK_OPS, FK_POINTER, modeFlag,
268 FLG_NULLPOINTERARITH,
269 "arithmetic involving possibly null pointer and integer",
270 "Pointer arithmetic using a possibly null pointer and integer.", 0, 0
273 FK_OPS, FK_POINTER, modeFlag,
276 "comparison between pointer and number",
277 "A pointer is compared to a number.", 0, 0
280 FK_OPS, FK_TYPE, modeFlag,
283 "primitive operation does not type check strictly",
284 "A primitive operation does not type check strictly.", 0, 0
287 FK_OPS, FK_TYPE, modeFlag,
290 "a bitwise logical operator does not have unsigned operands",
291 "An operand to a bitwise operator is not an unsigned values. This "
292 "may have unexpected results depending on the signed "
293 "representations.", 0, 0
296 FK_OPS, FK_TYPE, modeFlag,
299 "a shift right operand may be negative",
300 "The right operand to a shift operator may be negative (behavior undefined).",
304 FK_OPS, FK_TYPE, modeFlag,
305 "shiftimplementation",
306 FLG_SHIFTIMPLEMENTATION,
307 "a shift left operand may be negative",
308 "The left operand to a shift operator may be negative (behavior is implementation-defined).",
312 FK_OPS, FK_TYPE, modeFlag,
315 "sizeof operator has a type argument",
316 "Operand of sizeof operator is a type. (Safer to use expression, "
317 "int *x = sizeof (*x); instead of sizeof (int).)",
321 FK_OPS, FK_TYPE, plainFlag,
323 FLG_SIZEOFFORMALARRAY,
324 "sizeof operator has an array formal parameter argument",
325 "Operand of a sizeof operator is a function parameter declared as "
326 "an array. The value of sizeof will be the size of a pointer to the "
327 "element type, not the number of elements in the array.",
331 FK_DECL, FK_TYPE, plainFlag,
333 FLG_FIXEDFORMALARRAY,
334 "formal parameter of type array is declared with size",
335 "A formal parameter is declared as an array with size. The size of the array "
336 "is ignored in this context, since the array formal parameter is treated "
341 FK_DECL, FK_TYPE, plainFlag,
344 "formal parameter has an incomplete type",
345 "A formal parameter is declared with an incomplete type.",
349 FK_DECL, FK_TYPE, plainFlag,
352 "formal parameter is an array",
353 "A formal parameter is declared as an array. This can be confusing, since "
354 "a formal array parameter is treated as a pointer.",
364 FK_BOOL, FK_NONE, regStringFlag, ARG_STRING,
367 "set name of boolean type (default bool)",
371 FK_BOOL, FK_NONE, regStringFlag, ARG_STRING,
374 "set name of boolean false (default FALSE)",
378 FK_BOOL, FK_NONE, regStringFlag, ARG_STRING,
381 "set name of boolean true (default TRUE)",
385 FK_BOOL, FK_HELP, plainFlag,
388 "type name is probably a boolean type but does not match default "
389 "boolean type name, \"bool\", and alternate name is not set",
390 "Use the -booltype, -boolfalse and -booltrue flags to change the "
391 "name of the default boolean type.",
396 FK_BOOL, FK_OPS, modeFlag,
399 "comparison between bools (dangerous because of multiple TRUE values)",
400 "Two bool values are compared directly using a C primitive. This "
401 "may produce unexpected results since all non-zero values are "
402 "considered TRUE, so different TRUE values may not be equal. "
403 "The file bool.h (included in splint/lib) provides bool_equal "
404 "for safe bool comparisons.", 0, 0
407 FK_BOOL, FK_OPS, modeFlag,
410 "primitive operation (!, && or ||) does not has a boolean argument",
411 "The operand of a boolean operator is not a boolean. Use +ptrnegate "
412 "to allow ! to be used on pointers.",
416 FK_BOOL, FK_POINTER, modeFlag,
419 "allow ! to be used on pointer operand",
420 "The operand of ! operator is a pointer.", 0, 0
423 FK_BOOL, FK_PRED,plainFlag,
426 "condition test (if, while or for) is an assignment",
427 "The condition test is an assignment expression. Probably, you mean "
428 "to use == instead of =. If an assignment is intended, add an "
429 "extra parentheses nesting (e.g., if ((a = b)) ...) to suppress "
434 FK_BOOL, FK_PRED, specialFlag,
437 "type of condition test (if, while or for) not bool (sets predboolint, "
438 "predboolptr and predboolothers)",
439 "Test expression type is not boolean.", 0, 0
442 FK_PRED, FK_BOOL, modeFlag,
445 "type of condition test (if, while or for) is an integral type",
446 "Test expression type is not boolean or int.", 0, 0
449 FK_BOOL, FK_PRED, modeFlag,
452 "type of condition test (if, while or for) is a pointer",
453 "Test expression type is not boolean.", 0, 0
456 FK_BOOL, FK_PRED, modeFlag,
459 "type of condition test (if, while or for) not bool, int or pointer",
460 "Test expression type is not boolean.", 0, 0
464 ** 4.3 Abstract types
468 FK_ABSTRACT, FK_NONE, plainFlag,
471 "data abstraction barriers",
472 "An abstraction barrier is broken. If necessary, use /*@access <type>@*/ to allow access to an abstract type.",
476 FK_ABSTRACT, FK_NONE, plainFlag,
479 "data abstraction barriers",
480 "An abstraction barrier involving a numabstract type is broken. If necessary, use /*@access <type>@*/ to allow access to a numabstract type.",
484 FK_ABSTRACT, FK_NONE, modeFlag,
487 "numeric literal cast to numabstract type",
488 "A numeric literal is cast to a numabstract type.",
492 FK_ABSTRACT, FK_NONE, modeFlag,
495 "numeric literal can used as numabstract type",
496 "A numeric literal can be used as a numabstract type.",
500 FK_ABSTRACT, FK_IMPLICIT, plainFlag,
503 "assume user type definitions are abstract (unless /*@concrete@*/ is used)",
511 FK_ABSTRACT, FK_NAMES, plainFlag,
514 "allow access to abstract types in definition module",
515 "The representation of an abstract type defined in <M>.<x> is "
516 "accessible anywhere in a file named <M>.<y>.",
520 FK_ABSTRACT, FK_NAMES, plainFlag,
523 "allow access to abstract types by file name convention",
524 "The representation of an abstract type named <t> is "
525 "accessible anywhere in a file named <t>.<x>.",
529 FK_ABSTRACT, FK_NAMES, plainFlag,
532 "allow access to abstract types by czech naming convention",
533 "The representation of an abstract type named <t> is accessible "
534 "in the definition of a function or constant named <t>_<name>",
538 FK_ABSTRACT, FK_NAMES, plainFlag,
541 "allow access to abstract types by slovak naming convention",
542 "The representation of an abstract type named <t> is accessible "
543 "in the definition of a function or constant named <t><Name>",
547 FK_ABSTRACT, FK_NAMES, plainFlag,
548 "accessczechoslovak",
549 FLG_ACCESSCZECHOSLOVAK,
550 "allow access to abstract types by czechoslovak naming convention",
551 "The representation of an abstract type named <t> is accessible "
552 "in the definition of a function or constant named <t>_<name> or <t><Name>",
556 FK_ABSTRACT, FK_NAMES, specialFlag,
559 "set accessmodule, accessfile and accessczech",
560 "Sets accessmodule, accessfile and accessczech",
564 /* 4.3.2 Mutability */
566 FK_ABSTRACT, FK_NONE, modeFlag,
569 "representation of mutable type has sharing semantics",
570 "LCL semantics requires that a mutable type exhibits sharing semantics. "
571 "In order for objects to be shared a indirection is necessary in the representation. "
572 "A mutable type may be represented by a pointer or an abstract mutable type. Handles "
573 "into static data are fine, too, but will generate this error message unless it is suppressed.",
579 ** Memory Management (5)
582 /* Deallocation Errors */
584 FK_MEMORY, FK_LEAK, modeFlag,
587 "freshly allocated storage not released before return or scope exit",
588 "A memory leak has been detected. Storage allocated locally "
589 "is not released before the last reference to it is lost.",
593 FK_MEMORY, FK_LEAK, modeFlag,
596 "only storage not released before return or scope exit",
597 "A memory leak has been detected. Only-qualified storage is not released before the last "
598 "reference to it is lost.",
602 FK_MEMORY, FK_LEAK, specialFlag,
605 "fresh or only storage not released before return or scope exit (sets mustfreefresh and mustfreeonly)",
606 "A memory leak has been detected.",
610 FK_MEMORY, FK_DEAD, modeFlag,
613 "storage used after release",
614 "Memory is used after it has been released (either by passing "
615 "as an only param or assigning to an only global).",
619 FK_MEMORY, FK_DEAD, modeFlag,
621 FLG_STRICTUSERELEASED,
622 "element used after it may have been released",
623 "Memory (through fetch) is used after it may have been released "
624 "(either by passing as an only param or assigning to an only global).",
628 FK_MEMORY, FK_LEAK, modeFlag,
631 "all only references derivable from void pointer out only parameter are released",
632 "A storage leak due to incomplete deallocation of a structure or deep "
633 "pointer is suspected. Unshared storage that is reachable from "
634 "a reference that is being deallocated has not yet been deallocated. "
635 "Splint assumes when an object is passed "
636 "as an out only void pointer that the outer object will be "
637 "deallocated, but the inner objects will not.",
641 FK_MEMORY, FK_LEAK, modeFlag,
644 "report complete destruction errors for array elements that "
645 "may have been released",
650 FK_MEMORY, FK_ARRAY, modeFlag,
653 "array elements are dependent storage",
654 "When an element is fetched from an array, Splint analysis is "
655 "not able to determine if the same element is reused. "
656 "If +deparrays, Splint will mark local storage assigned from "
657 "array fetches as dependent.",
661 FK_MEMORY, FK_NONE, modeFlag,
664 "storage has inconsistent states of alternate paths through a branch",
665 "The state of a variable is different depending on which branch "
666 "is taken. This means no annotation can sensibly be applied "
671 FK_MEMORY, FK_NONE, modeFlag,
673 FLG_STRICTBRANCHSTATE,
674 "storage through array fetch has inconsistent states of alternate "
675 "paths through a branch",
676 "The state of a variable through an array fetch is different depending "
677 "on which branch is taken. This means no annotation can sensibly be applied "
682 FK_MEMORY, FK_NONE, specialFlag,
685 "sets all dynamic memory checking flags (memimplicit, mustfree, mustdefine, "
686 "mustnotalias, null, memtrans)",
690 FK_MEMORY, FK_DEF, modeFlag,
693 "actual parameter matches alias kind of formal parameter completely ",
694 "Storage derivable from a parameter does not match the alias kind "
695 "expected for the formal parameter.",
699 FK_MEMORY, FK_DEAD, modeFlag,
702 "external reference to stack-allocated storage is created",
703 "A stack reference is pointed to by an external reference when the "
704 "function returns. The stack-allocated storage is destroyed "
705 "after the call, leaving a dangling reference.",
710 FK_MEMORY, FK_NONE, specialFlag,
713 "memory transfer errors (sets all *trans flags)",
714 "Memory is transferred in a way that violates annotations.",
718 FK_MEMORY, FK_NONE, modeFlag,
721 "dependent transfer errors",
722 "Dependent storage is transferred to a non-dependent reference.",
726 FK_MEMORY, FK_NONE, modeFlag,
729 "new reference transfer to reference counted reference",
730 "A new reference is transferred to a reference counted reference.",
734 FK_MEMORY, FK_NONE, modeFlag,
737 "only storage transferred to non-only reference (memory leak)",
738 "The only reference to this storage is transferred to another "
739 "reference (e.g., by returning it) that does not have the "
740 "only annotation. This may lead to a memory leak, since the "
741 "new reference is not necessarily released.",
745 FK_MEMORY, FK_NONE, modeFlag,
746 "onlyunqglobaltrans",
747 FLG_ONLYUNQGLOBALTRANS,
748 "only storage transferred to an unqualified global or "
749 "static reference (memory leak)",
750 "The only reference to this storage is transferred to another "
751 "reference that does not have an aliasing annotation. "
752 "This may lead to a memory leak, since the "
753 "new reference is not necessarily released.",
757 FK_MEMORY, FK_NONE, modeFlag,
760 "owned storage transferred to non-owned reference (memory leak)",
761 "The owned reference to this storage is transferred to another "
762 "reference (e.g., by returning it) that does not have the "
763 "owned annotation. This may lead to a memory leak, since the "
764 "new reference is not necessarily released.",
768 FK_MEMORY, FK_NONE, modeFlag,
771 "fresh storage transferred to non-only reference (memory leak)",
772 "Fresh storage (newly allocated in this function) is transferred "
773 "in a way that the obligation to release storage is not "
774 "propagated. Use the /*@only@*/ annotation to indicate "
775 "the a return value is the only reference to the returned "
780 FK_MEMORY, FK_NONE, modeFlag,
783 "shared storage transferred to non-shared reference",
784 "Shared storage is transferred to a non-shared reference. The other "
785 "reference may release storage needed by this reference.",
789 FK_MEMORY, FK_NONE, modeFlag,
792 "temp storage transferred to non-temporary reference",
793 "Temp storage (associated with a formal parameter) is transferred "
794 "to a non-temporary reference. The storage may be released "
795 "or new aliases created.",
799 FK_MEMORY, FK_NONE, modeFlag,
802 "kept storage transferred to non-temporary reference",
803 "storage is transferred "
804 "to a non-temporary reference after being passed as keep parameter. The storage may be released "
805 "or new aliases created.",
809 FK_MEMORY, FK_NONE, modeFlag,
812 "keep storage transferred inconsistently",
813 "Keep storage is transferred inconsistently --- either in a way "
814 "that may add a new alias to it, or release it.",
818 FK_MEMORY, FK_NONE, modeFlag,
821 "an immediate address (result of &) is transferred inconsistently",
822 "An immediate address (result of & operator) is transferred "
827 FK_MEMORY, FK_NONE, modeFlag,
830 "reference counted storage is transferred in an inconsistent way",
831 "Reference counted storage is transferred in a way that may not "
832 "be consistent with the reference count.",
836 FK_MEMORY, FK_NONE, modeFlag,
839 "static storage is transferred in an inconsistent way",
840 "Static storage is transferred in an inconsistent way.",
844 FK_MEMORY, FK_NONE, modeFlag,
847 "unqualified storage is transferred in an inconsistent way",
848 "Unqualified storage is transferred in an inconsistent way.",
852 FK_MEMORY, FK_NONE, modeFlag,
855 "static storage is used as an initial value in an inconsistent way",
856 "Static storage is used as an initial value in an inconsistent way.",
860 FK_MEMORY, FK_NONE, modeFlag,
861 "unqualifiedinittrans",
862 FLG_UNKNOWNINITTRANS,
863 "unqualified storage is used as an initial value in an inconsistent way",
864 "Unqualified storage is used as an initial value in an inconsistent way.",
868 FK_MEMORY, FK_NONE, modeFlag,
871 "report memory transfer errors for initializations to read-only string literals",
872 "A read-only string literal is assigned to a non-observer reference.",
876 FK_MEMORY, FK_PARAMS, modeFlag,
879 "passing a value as an un-annotated parameter clears its annotation",
883 /* 5.3 Implicit Memory Annotations */
886 FK_MEMORY, FK_NONE, modeFlag,
889 "string literals are read-only (error if one is modified or released)",
890 "String literals are read-only. An error is reported "
891 "if a string literal may be modified or released.",
895 FK_MEMORY, FK_IMPLICIT, modeFlag,
898 "memory errors for unqualified storage",
902 FK_MEMORY, FK_IMPLICIT, plainFlag,
905 "assume unannotated parameter is temp",
909 FK_MEMORY, FK_IMPLICIT, specialFlag,
912 "sets globimponly, retimponly, structimponly, specglobimponly, "
913 "specretimponly and specstructimponly",
917 FK_MEMORY, FK_IMPLICIT, specialFlag,
920 "sets globimponly, retimponly and structimponly",
924 FK_MEMORY, FK_IMPLICIT, specialFlag,
927 "sets specglobimponly, specretimponly and specstructimponly",
931 FK_MEMORY, FK_IMPLICIT, plainFlag,
934 "assume unannotated global storage is only",
938 FK_MEMORY, FK_IMPLICIT, plainFlag,
941 "assume unannotated returned storage is only",
945 FK_MEMORY, FK_IMPLICIT, plainFlag,
948 "assume unannotated structure field is only",
952 FK_MEMORY, FK_IMPLICIT, plainFlag,
955 "assume unannotated global storage is only",
959 FK_MEMORY, FK_IMPLICIT, plainFlag,
962 "assume unannotated returned storage is only",
966 FK_MEMORY, FK_IMPLICIT, plainFlag,
968 FLG_SPECSTRUCTIMPONLY,
969 "assume unannotated structure field is only",
973 /* Reference Counting */
981 /* 6.1 Aliasing warnings */
984 FK_ALIAS, FK_MEMORY, modeFlag,
987 "unique parameter is aliased",
988 "A unique or only parameter is aliased by some other parameter or visible global.",
992 FK_ALIAS, FK_MEMORY, modeFlag,
995 "unique parameter may be aliased",
996 "A unique or only parameter may be aliased by some other parameter or visible global.",
1000 FK_ALIAS, FK_MEMORY, modeFlag,
1003 "temp storage aliased at return point or scope exit",
1004 "An alias has been added to a temp-qualifier parameter or global that is visible externally when the function returns. If the aliasing is needed, use the /*@shared@*/ annotation to indicate that new aliases to the parameter may be created.",
1008 FK_ALIAS, FK_NONE, modeFlag,
1011 "function returns alias to parameter or global",
1012 "The returned value shares storage with a parameter or global. If a parameter is to be returned, use the returned qualifier. If the result is not modified, use the observer qualifier on the result type. Otherwise, exposed can be used, but limited checking is done.", 0, 0
1015 /* Global aliasing */
1017 FK_ALIAS, FK_GLOBALS, specialFlag,
1020 "function returns with global aliasing external state (sets "
1021 "checkstrictglobalias, checkedglobalias, checkmodglobalias and "
1022 "uncheckedglobalias)",
1023 "A global variable aliases externally-visible state when the function returns.",
1027 FK_ALIAS, FK_GLOBALS, modeFlag,
1028 "checkstrictglobalias",
1029 FLG_CHECKSTRICTGLOBALIAS,
1030 "function returns with a checkstrict global aliasing external state",
1031 "A global variable aliases externally-visible state when the function returns.",
1035 FK_ALIAS, FK_GLOBALS, modeFlag,
1037 FLG_CHECKEDGLOBALIAS,
1038 "function returns with a checked global aliasing external state",
1039 "A global variable aliases externally-visible state when the function returns.",
1043 FK_ALIAS, FK_GLOBALS, modeFlag,
1044 "checkmodglobalias",
1045 FLG_CHECKMODGLOBALIAS,
1046 "function returns with a checkmod global aliasing external state",
1047 "A global variable aliases externally-visible state when the function returns.",
1051 FK_ALIAS, FK_GLOBALS, modeFlag,
1052 "uncheckedglobalias",
1053 FLG_UNCHECKEDGLOBALIAS,
1054 "function returns with an unchecked global aliasing external state",
1055 "A global variable aliases externally-visible state when the function returns.",
1062 FK_MEMORY, FK_NONE, modeFlag,
1065 "exposure transfer errors",
1066 "Exposed storage is transferred to a non-exposed, non-observer reference.",
1070 FK_MEMORY, FK_NONE, modeFlag,
1073 "observer transfer errors",
1074 "Observer storage is transferred to a non-observer reference.",
1078 FK_EXPOSURE, FK_ABSTRACT, specialFlag,
1081 "abstract representation is exposed (sets assignexpose, retexpose, and castexpose)",
1082 "The internal representation of an abstract type is visible to the "
1083 "caller. This means clients may have access to a pointer "
1084 "into the abstract representation.",
1088 FK_EXPOSURE, FK_ABSTRACT, modeFlag,
1091 "abstract representation is exposed (return values only)",
1092 "The return value shares storage with an instance of an abstract "
1093 "type. This means clients may have access to a pointer into "
1094 "the abstract representation. Use the observer qualifier to "
1095 "return exposed storage that may not be modified by the "
1096 "client. Use the exposed qualifier to return modifiable "
1097 "(but not deallocatable) exposed storage (dangerous).",
1101 FK_EXPOSURE, FK_ABSTRACT, modeFlag,
1104 "abstract representation is exposed (assignments only)",
1105 "Storage internal to the representation of an abstract type is "
1106 "assigned to an external pointer. This means clients may "
1107 "have access to a pointer into the abstract representation. "
1108 "If the external pointer is a parameter, the exposed qualifier "
1109 "can be used to allow the assignment, however, this is "
1110 "considered dangerous programming practice.",
1114 FK_EXPOSURE, FK_ABSTRACT, modeFlag,
1117 "abstract representation is exposed through a cast",
1118 "Storage internal to the representation of an abstract type is exposed "
1119 "through a type cast. This means clients may have access to a "
1120 "pointer into the abstract representation.",
1124 FK_DECL, FK_TYPE, modeFlag,
1125 "redundantsharequal",
1126 FLG_REDUNDANTSHAREQUAL,
1127 "declaration uses observer qualifier that is always true",
1128 "A declaration of an immutable object uses a redundant observer qualifier.",
1132 FK_DECL, FK_TYPE, modeFlag,
1133 "misplacedsharequal",
1134 FLG_MISPLACEDSHAREQUAL,
1135 "declaration of unsharable storage uses sharing annotation",
1136 "A declaration of an unsharable object uses a sharing annotation.",
1141 ** 7. Function Interfaces
1144 /* 7.1 Modifications */
1147 FK_MODIFIES, FK_SPEC, plainFlag,
1150 "unspecified modification of caller-visible state",
1151 "An externally-visible object is modified by a function, but not "
1152 "listed in its modifies clause.",
1156 FK_MODIFIES, FK_SPEC, modeFlag,
1159 "specified modification is not detected",
1160 "An object listed in the modifies clause is not modified by the "
1161 "implementation of the function. The modification may not "
1162 "be detected if it is done through a call to an unspecified "
1167 FK_MODIFIES, FK_MEMORY, plainFlag,
1170 "possible modification of observer storage",
1171 "Storage declared with observer is possibly modified. Observer "
1172 "storage may not be modified.",
1176 FK_MODIFIES, FK_MEMORY, modeFlag,
1178 FLG_MODOBSERVERUNCON,
1179 "possible modification of observer storage through unconstrained call",
1180 "Storage declared with observer may be modified through a call to an "
1181 "unconstrained function.",
1185 FK_MODIFIES, FK_MEMORY, modeFlag,
1186 "modinternalstrict",
1187 FLG_MODINTERNALSTRICT,
1188 "possible modification of internal storage through function call",
1189 "A function that modifies internalState is called from a function that "
1190 "does not list internalState in its modifies clause",
1194 FK_MODIFIES, FK_UNSPEC, modeFlag,
1197 "report undocumented file system modifications (applies to unspecified "
1198 "functions if modnomods is set)",
1202 FK_MODIFIES, FK_UNSPEC, specialFlag,
1205 "modification in unspecified functions (sets modnomods, "
1206 "modglobunspec and modstrictglobsunspec)",
1210 FK_MODIFIES, FK_UNSPEC, modeFlag,
1213 "modification in a function with no modifies clause",
1214 "An externally-visible object is modified by a function with no "
1215 "/*@modifies@*/ comment. The /*@modifies ... @*/ control "
1216 "comment can be used to give a modifies list for an "
1217 "unspecified function.",
1221 FK_MODIFIES, FK_UNSPEC, modeFlag,
1224 "possible modification through a call to an unconstrained function",
1225 "An unconstrained function is called in a function body where "
1226 "modifications are checked. Since the unconstrained function "
1227 "may modify anything, there may be undetected modifications in "
1228 "the checked function.",
1232 FK_MODIFIES, FK_UNSPEC, modeFlag,
1235 "possible modification through a call to an unconstrained function in "
1236 "a function with no modifies clause",
1237 "An unconstrained function is called in a function body where "
1238 "modifications are checked. Since the unconstrained function "
1239 "may modify anything, there may be undetected modifications in "
1240 "the checked function.",
1244 FK_MODIFIES, FK_GLOBALS, modeFlag,
1245 "globsimpmodsnothing",
1246 FLG_GLOBALSIMPMODIFIESNOTHING,
1247 "functions declared with a globals list but no modifies clause are "
1248 "assumed to modify nothing",
1249 "An implicit modifies nothing clause is assumed for a function "
1250 "declared with a globals list but not modifies clause.",
1254 FK_MODIFIES, FK_GLOBALS, modeFlag,
1256 FLG_MODIFIESIMPNOGLOBALS,
1257 "functions declared with a modifies clause but no globals list "
1258 "are assumed to use no globals",
1259 "An implicit empty globals list is assumed for a function "
1260 "declared with a modifies clause but no globals list.",
1269 FK_GLOBALS, FK_NONE, modeFlag,
1272 "returns with global in inconsistent state (null or undefined)",
1273 "A global variable does not satisfy its annotations when control is transferred.",
1278 FK_GLOBALS, FK_SPEC, plainFlag,
1281 "undocumented use of a checked global variable",
1282 "A checked global variable is used in the function, but not listed in "
1283 "its globals clause. By default, only globals specified in .lcl "
1284 "files are checked. To check all globals, use +allglobals. To "
1285 "check globals selectively use /*@checked@*/ in the global "
1290 FK_GLOBALS, FK_SPEC, modeFlag,
1293 "global listed for a function not used",
1294 "A global variable listed in the function's globals list is not used "
1295 "in the body of the function.",
1299 FK_GLOBALS, FK_NONE, modeFlag,
1302 "use of internalState",
1303 "A called function uses internal state, but the globals list for the "
1304 "function being checked does not include internalState",
1308 FK_GLOBALS, FK_NONE, modeFlag,
1309 "internalglobsnoglobs",
1310 FLG_INTERNALGLOBSNOGLOBS,
1311 "use of internalState (in function with no globals list)",
1312 "A called function uses internal state, but the function being checked "
1313 "has no globals list",
1317 FK_GLOBALS, FK_MODIFIES, modeFlag,
1319 FLG_WARNMISSINGGLOBALS,
1320 "global variable used in modifies clause is not listed in globals list",
1321 "A global variable is used in the modifies clause, but it is not listed in "
1322 "the globals list. The variable will be added to the globals list.",
1327 FK_GLOBALS, FK_MODIFIES, modeFlag,
1328 "warnmissingglobsnoglobs",
1329 FLG_WARNMISSINGGLOBALSNOGLOBS,
1330 "global variable used in modifies clause in a function with no globals list",
1331 "A global variable is used in the modifies clause, but the function "
1332 "has no globals list. The variable will be added to the globals list.",
1336 FK_GLOBALS, FK_UNSPEC, modeFlag,
1339 "use of checked global in a function with no globals list or specification",
1340 "A specified global variable is used in the function, but not listed "
1341 "in its globals list. Without +globnoglobs, only globals "
1342 "declared with /*@checkedstrict@*/ will produce use "
1343 "errors in functions without globals "
1344 "lists. The /*@globals ... @*/ control comment can be used to give "
1345 "a globals list for an unspecified function.",
1349 FK_GLOBALS, FK_IMPLICIT, modeFlag,
1352 "report use and modification errors for globals not annotated with unchecked",
1356 FK_GLOBALS, FK_UNSPEC, modeFlag,
1358 FLG_CHECKSTRICTGLOBALS,
1359 "report use and modification errors for checkedstrict globals",
1363 FK_GLOBALS, FK_UNSPEC, modeFlag,
1364 "impcheckedspecglobs",
1365 FLG_IMPCHECKEDSPECGLOBALS,
1366 "assume checked qualifier for unqualified global declarations in .lcl files",
1370 FK_GLOBALS, FK_UNSPEC, modeFlag,
1371 "impcheckmodspecglobs",
1372 FLG_IMPCHECKMODSPECGLOBALS,
1373 "assume checkmod qualifier for unqualified global declarations in .lcl files",
1377 FK_GLOBALS, FK_UNSPEC, modeFlag,
1378 "impcheckedstrictspecglobs",
1379 FLG_IMPCHECKEDSTRICTSPECGLOBALS,
1380 "assume checkmod qualifier for unqualified global declarations in .lcl files",
1384 FK_GLOBALS, FK_UNSPEC, modeFlag,
1386 FLG_IMPCHECKEDGLOBALS,
1387 "assume checked qualifier for unqualified global declarations",
1391 FK_GLOBALS, FK_UNSPEC, modeFlag,
1393 FLG_IMPCHECKMODGLOBALS,
1394 "assume checkmod qualifier for unqualified global declarations",
1398 FK_GLOBALS, FK_UNSPEC, modeFlag,
1399 "impcheckedstrictglobs",
1400 FLG_IMPCHECKEDSTRICTGLOBALS,
1401 "assume checkedstrict qualifier for unqualified global declarations",
1405 FK_GLOBALS, FK_UNSPEC, modeFlag,
1406 "impcheckedstatics",
1407 FLG_IMPCHECKEDSTATICS,
1408 "assume checked qualifier for unqualified file static declarations",
1412 FK_GLOBALS, FK_UNSPEC, modeFlag,
1413 "impcheckmodstatics",
1414 FLG_IMPCHECKMODSTATICS,
1415 "assume checkmod qualifier for unqualified file static declarations",
1419 FK_GLOBALS, FK_UNSPEC, modeFlag,
1420 "impcheckmodinternals",
1421 FLG_IMPCHECKMODINTERNALS,
1422 "assume checkmod qualifier for unqualified local "
1423 "static declarations (for internal state modifications)",
1427 FK_GLOBALS, FK_UNSPEC, modeFlag,
1428 "impcheckedstrictstatics",
1429 FLG_IMPCHECKEDSTRICTSTATICS,
1430 "assume checkedstrict qualifier for unqualified file static declarations",
1434 FK_GLOBALS, FK_MODIFIES, modeFlag,
1437 "undocumented modification of a checked global variable",
1438 "A checked global variable is modified by the function, but not listed in "
1439 "its modifies clause.",
1443 FK_GLOBALS, FK_MODIFIES, modeFlag,
1446 "undocumented modification of a checked global variable in a function "
1447 "declared with no modifies clause",
1448 "A checked global variable is modified by the function, but not listed in "
1449 "its modifies clause.",
1453 FK_GLOBALS, FK_MODIFIES, modeFlag,
1454 "modstrictglobsnomods",
1455 FLG_MODSTRICTGLOBSUNSPEC,
1456 "undocumented modification of a strict checked global variable in a "
1457 "function declared with no modifies clause",
1458 "A checked global variable is modified by the function, but not listed in "
1459 "its modifies clause.",
1463 FK_GLOBALS, FK_MODIFIES, modeFlag,
1464 "modglobsunchecked",
1465 FLG_MODGLOBSUNCHECKED,
1466 "undocumented modification of an unchecked checked global variable",
1467 "An unchecked global variable is modified by the function, but not listed in "
1468 "its modifies clause.",
1483 FK_CONTROL, FK_NONE, modeFlag,
1486 "path with no return detected in non-void function",
1487 "There is a path through a function declared to return a value on "
1488 "which there is no return statement. This means the execution "
1489 "may fall through without returning a meaningful result to "
1494 FK_CONTROL, FK_NONE, plainFlag,
1497 "empty return in function declared to return value",
1502 FK_CONTROL, FK_NONE, plainFlag,
1505 "loop predicate always exits",
1511 FK_CONTROL, FK_MEMORY, specialFlag,
1514 "assume all loops execute at least once (sets forloopexec, whileloopexec and iterloopexec)",
1518 FK_CONTROL, FK_MEMORY, plainFlag,
1521 "assume all for loops execute at least once",
1525 FK_CONTROL, FK_MEMORY, plainFlag,
1528 "assume all while loops execute at least once",
1532 FK_CONTROL, FK_MEMORY, plainFlag,
1535 "assume all iterator loops execute at least once",
1539 FK_CONTROL, FK_MEMORY, plainFlag,
1541 FLG_OBVIOUSLOOPEXEC,
1542 "assume loop that can be determined to always execute always does",
1546 /* 8.2 Undefined Behavior */
1549 FK_BEHAVIOR, FK_ANSI, modeFlag,
1552 "code has unspecified or implementation-dependent behavior "
1553 "because of order of evaluation",
1554 "Code has unspecified behavior. "
1555 "Order of evaluation of function parameters or subexpressions "
1556 "is not defined, so if a value is used and modified in different "
1557 "places not separated by a sequence point constraining "
1558 "evaluation order, then the result of the expression is "
1563 FK_BEHAVIOR, FK_ANSI, modeFlag,
1566 "code involving call to unspecified function has undefined or implementation-dependent behavior",
1567 "Code involving a call to function with no modifies or globals clause "
1568 "may have undefined or implementation-dependent behavior (Splint assumes the "
1569 "unconstrained call may modify any reachable state or use any global). Add a "
1570 "specification for the function.",
1574 /* 8.3 Problematic Control Structures */
1576 /* 8.3.1 Infinite Loops */
1579 FK_CONTROL, FK_NONE, modeFlag,
1582 "likely infinite loop is detected",
1583 "This appears to be an infinite loop. Nothing in the body of the "
1584 "loop or the loop test modifies the value of the loop test. "
1585 "Perhaps the specification of a function called in the loop "
1586 "body is missing a modification.",
1590 FK_CONTROL, FK_NONE, modeFlag,
1593 "likely infinite loop is detected (may result from unconstrained function)",
1594 "This appears to be an infinite loop. Nothing in the body of the "
1595 "loop or the loop test modifies the value of the loop test. "
1596 "There may be a modification through a call to an unconstrained "
1597 "function, or an unconstrained function in the loop test may use "
1598 "a global variable modified by the loop body.",
1602 /* 8.3.2 Switches */
1605 FK_CONTROL, FK_NONE, modeFlag,
1608 "non-empty case in a switch without preceding break",
1609 "Execution falls through from the previous case.", 0, 0
1612 FK_CONTROL, FK_NONE, modeFlag,
1615 "switch on enum type missing case for some value",
1616 "Not all values in an enumeration are present as cases in the switch.",
1620 FK_CONTROL, FK_NONE, modeFlag,
1623 "first statement in switch is not a case",
1624 "The first statement after a switch is not a case.",
1628 FK_CONTROL, FK_NONE, plainFlag,
1631 "duplicate cases in switch",
1632 "Duplicate cases in switch.",
1636 /* 8.3.3 Deep Breaks */
1639 FK_CONTROL, FK_NONE, specialFlag,
1642 "break inside nested while or for or switch",
1643 "A break statement appears inside the body of a nested while, for or "
1644 "switch statement. Sets looploopbreak, loopswitchbreak, "
1645 "switchloopbreak, switchswitchbreak, and looploopcontinue.",
1649 FK_CONTROL, FK_NONE, modeFlag,
1652 "break inside nested while or for",
1653 "A break statement appears inside the body of a nested while or for "
1654 "statement. This is perfectly reasonable code, but check that "
1655 "the break is intended to break only the inner loop. The "
1656 "break statement may be preceded by /*@innerbreak@*/ to suppress "
1657 "the message for this break only.",
1661 FK_CONTROL, FK_NONE, modeFlag,
1663 FLG_SWITCHLOOPBREAK,
1664 "break in loop inside switch",
1665 "A break statement appears inside the body of a while or for "
1666 "statement within a switch. This is perfectly reasonable code, but check that "
1667 "the break is intended to break only the inner loop. The "
1668 "break statement may be preceded by /*@loopbreak@*/ to suppress "
1669 "the message for this break only.",
1673 FK_CONTROL, FK_NONE, modeFlag,
1675 FLG_LOOPSWITCHBREAK,
1676 "break in switch inside loop",
1677 "A break statement appears inside a switch statement within a while or "
1678 "for loop. This is perfectly reasonable code, but check that "
1679 "the break is intended to break only the inner loop. The "
1680 "break statement may be preceded by /*@switchbreak@*/ to suppress "
1681 "the message for this break only.",
1685 FK_CONTROL, FK_NONE, modeFlag,
1686 "switchswitchbreak",
1687 FLG_SWITCHSWITCHBREAK,
1688 "break in switch inside switch",
1689 "A break statement appears inside a switch statement within another "
1690 "switch statement. This is perfectly reasonable code, but check that "
1691 "the break is intended to break only the inner switch. The "
1692 "break statement may be preceded by /*@innerbreak@*/ to suppress "
1693 "the message for this break only.",
1697 FK_CONTROL, FK_NONE, modeFlag,
1699 FLG_LOOPLOOPCONTINUE,
1700 "continue inside nested loop",
1701 "A continue statement appears inside a loop within a loop. "
1702 "This is perfectly reasonable code, but check that "
1703 "the continue is intended to continue only the inner loop. The "
1704 "continue statement may be preceded by /*@innercontinue@*/ to suppress "
1705 "the message for this continue only.",
1709 /* 8.3.4 Loop and If Bodies */
1712 FK_CONTROL, FK_NONE, modeFlag,
1715 "a while statement has no body",
1716 "While statement has no body.",
1720 FK_CONTROL, FK_NONE, modeFlag,
1723 "the body of a while statement is not a block",
1724 "While body is a single statement, not a compound block.",
1728 FK_CONTROL, FK_NONE, modeFlag,
1731 "a for statement has no body",
1732 "For statement has no body.",
1736 FK_CONTROL, FK_NONE, modeFlag,
1739 "the body of a for statement is not a block",
1740 "Loop body is a single statement, not a compound block.",
1744 FK_CONTROL, FK_NONE, modeFlag,
1747 "an if statement has no body",
1748 "If statement has no body.",
1752 FK_CONTROL, FK_NONE, modeFlag,
1755 "the body of an if statement is not a block",
1756 "If body is a single statement, not a compound block.",
1760 FK_CONTROL, FK_NONE, specialFlag,
1763 "an if, while or for statement has no body (sets ifempty, "
1764 "whileempty and forempty",
1769 FK_CONTROL, FK_NONE, specialFlag,
1772 "the body of an if, while or for statement is not a block "
1773 "(sets ifblock, whileblock and forblock)",
1774 "Body is a single statement, not a compound block.",
1778 /* 8.3.5 Complete Logic */
1781 FK_CONTROL, FK_NONE, modeFlag,
1784 "if ... else if chains must have final else",
1785 "There is no final else following an else if construct.",
1789 /* 8.4 Suspicious Statements */
1792 FK_CONTROL, FK_NONE, modeFlag,
1795 "unreachable code detected",
1796 "This code will never be reached on any possible execution.",
1800 /* 8.4.1 Statements with No Effects */
1803 FK_EFFECT, FK_CONTROL, modeFlag,
1806 "statement with no effect",
1807 "Statement has no visible effect --- no values are modified.",
1811 FK_EFFECT, FK_CONTROL, modeFlag,
1814 "statement with no effect (except possibly through call to "
1815 "unconstrained function)",
1816 "Statement has no visible effect --- no values are modified. It may "
1817 "modify something through a call to an unconstrained function.",
1821 /* 8.4.2 Ignored Return Values */
1824 FK_IGNORERET, FK_NONE, specialFlag,
1827 "return value ignored (sets retvalint, retvalbool and retvalother)",
1828 "Result returned by function call is not used. If this is intended, "
1829 "cast result to (void) to eliminate message.",
1833 FK_IGNORERET, FK_BOOL, modeFlag,
1836 "return value of type other than bool or int ignored",
1837 "Result returned by function call is not used. If this is intended, "
1838 "can cast result to (void) to eliminate message.",
1842 FK_IGNORERET, FK_BOOL, modeFlag,
1845 "return value of manifest type bool ignored",
1846 "Result returned by function call is not used. If this is intended, "
1847 "can cast result to (void) to eliminate message.",
1851 FK_IGNORERET, FK_NONE, modeFlag,
1854 "return value of type int ignored",
1855 "Result returned by function call is not used. If this is intended, "
1856 "can cast result to (void) to eliminate message.",
1865 FK_BOUNDS, FK_MEMORY, modeFlag,
1868 "misuse of nullterminated allocation",
1869 "A possibly non-nullterminated string/memory is used/referenced as a nullterminated one.",
1873 FK_BOUNDS, FK_MEMORY, specialFlag,
1876 "memory bounds checking (sets boundsread and boundswrite)",
1877 "Memory read or write may be out of bounds of allocated storage.", 0, 0
1880 FK_BOUNDS, FK_MEMORY, plainFlag,
1883 "possible out of bounds read",
1884 "A memory read references memory beyond the allocated storage.",
1888 FK_BOUNDS, FK_MEMORY, plainFlag,
1891 "possible buffer overflow from an out of bounds write",
1892 "A memory write may write to an address beyond the allocated buffer.",
1897 FK_BOUNDS, FK_DISPLAY, plainFlag,
1900 "display function post conditions",
1901 "Display function post conditions.",
1905 FK_BOUNDS, FK_DISPLAY, plainFlag,
1906 "redundantconstraints",
1907 FLG_REDUNDANTCONSTRAINTS,
1908 "display seemingly redundant constraints",
1909 "Display seemingly redundant constraints",
1912 /*drl7x added 6/18/01 */
1914 FK_BOUNDS, FK_MEMORY, modeFlag,
1917 "unable to verify predicate in ensures clause",
1918 "The function implementation may not satisfy a post condition given in an ensures clause.",
1923 FK_BOUNDS, FK_MEMORY, plainFlag,
1924 "implictconstraint",
1925 FLG_IMPLICTCONSTRAINT,
1926 "generate implicit constraints for functions",
1930 /*drl7x added 4/29/01 */
1932 FK_BOUNDS, FK_MEMORY, plainFlag,
1935 "use limited OR expressions to resolve constraints",
1941 FK_BOUNDS, FK_MEMORY, plainFlag,
1943 FLG_NULLTERMINATEDWARNING,
1944 "misuse of nullterminated allocation",
1945 "A user annotated non-nullterminated buffer is used/referenced as a nullterminated one.",
1950 FK_BOUNDS, FK_DISPLAY, plainFlag,
1951 "showconstraintparens",
1952 FLG_PARENCONSTRAINT,
1953 "display parentheses around constraint terms",
1957 /*drl added 2/4/2002*/
1959 FK_BOUNDS, FK_DISPLAY, plainFlag,
1960 "boundscompacterrormessages",
1961 FLG_BOUNDSCOMPACTERRORMESSAGES,
1962 "Display fewer new lines in bounds checking error messages",
1967 FK_BOUNDS, FK_DISPLAY, plainFlag,
1968 "showconstraintlocation",
1969 FLG_CONSTRAINTLOCATION,
1970 "display location for every constraint generated",
1973 }, /*drl added flag 4/26/01*/
1976 ** 10. Extensible Checking
1980 FK_EXTENSIBLE, FK_FILES, globalStringFlag, ARG_FILE,
1983 "load meta state declaration and corresponding xh file",
1987 FK_EXTENSIBLE, FK_MEMORY, modeFlag,
1990 "storage has been transfered with invalid state",
1991 "Transfer violates user-defined state rules.",
1995 FK_EXTENSIBLE, FK_MEMORY, modeFlag,
1998 "control paths merge with storage in incompatible states",
1999 "Control path merge violates user-defined state merge rules.",
2008 FK_MACROS, FK_NONE, modeFlag,
2012 "A macro is defined in more than one place.", 0, 0
2015 FK_MACROS, FK_UNRECOG, modeFlag,
2018 "unrecognized identifier in macro",
2019 "An unrecognized identifier appears in a macro. If the identifier "
2020 "is defined before the macro is used, then this is okay.",
2024 /* 11.1 Constant Macros */
2027 FK_MACROS, FK_PROTOS, modeFlag,
2030 "non-parameterized macro without prototype or specification",
2031 "Macro constant has no declaration. Use /*@constant ...@*/ to "
2032 "declare the macro.",
2036 /* 11.2 Function-like Macros */
2039 FK_MACROS, FK_NONE, modeFlag,
2042 "macro definition is syntactically not equivalent to function",
2043 "A macro is defined in a way that may cause syntactic problems. "
2044 "If the macro returns a value, use commas to separate expressions; "
2045 "otherwise, use do { <macro body> } while (FALSE) construct.",
2049 FK_MACROS, FK_NONE, modeFlag,
2052 "macro definition for is empty",
2053 "A macro definition has no body.",
2057 FK_MACROS, FK_PARAMS, modeFlag,
2060 "macro parameter not used exactly once",
2061 "A macro parameter is not used exactly once in all possible "
2062 "invocations of the macro. To behave like a function, "
2063 "each macro parameter must be used exactly once on all "
2064 "invocations of the macro so that parameters with "
2065 "side-effects are evaluated exactly once. Use /*@sef@*/ to "
2066 "denote parameters that must be side-effect free.",
2070 FK_MACROS, FK_CONTROL, modeFlag,
2073 "return statement in macro body",
2074 "The body of a macro declared as a function uses a return statement. "
2075 "This exhibits behavior that "
2076 "could not be implemented by a function.",
2080 FK_MACROS, FK_PARAMS, modeFlag,
2083 "assignment to a macro parameter",
2084 "A macro parameter is used as the left side of an "
2085 "assignment expression. This exhibits behavior that "
2086 "could not be implemented by a function.",
2090 FK_MACROS, FK_NONE, modeFlag,
2093 "macro parameter used without parentheses (in potentially dangerous context)",
2094 "A macro parameter is used without parentheses. This could be "
2095 "dangerous if the macro is invoked with a complex expression "
2096 "and precedence rules will change the evaluation inside the macro.",
2100 FK_MACROS, FK_PROTOS, modeFlag,
2103 "macro without prototype or specification (sets macrofcndecl and macroconstdecl)",
2104 "Argument checking cannot be done well for macros without prototypes "
2105 "or specifications, since the types of the arguments are unknown.",
2109 FK_MACROS, FK_PROTOS, modeFlag,
2112 "parameterized macro without prototype or specification",
2113 "Function macro has no declaration.",
2117 /* 11.2.1 Side Effect Free Parameters */
2120 FK_MACROS, FK_PARAMS, modeFlag,
2123 "a parameter with side-effects is passed as a sef parameter",
2124 "An actual parameter corresponding to a sef parameter may have a side-effect.",
2128 FK_MACROS, FK_PARAMS, modeFlag,
2131 "a parameter with unconstrained side-effects is passed as a sef parameter",
2132 "An actual parameter corresponding to a sef parameter involves a call "
2133 "to a procedure with no modifies clause that may have a side-effect.",
2137 /* 11.3 Controlling Macro Checking */
2140 FK_MACROS, FK_NONE, plainFlag,
2143 "check all macros without parameter lists as constants",
2144 "Every non-parameterized macro (not preceded by /*@notfunction@*/) "
2145 "is checked as a constant.",
2149 FK_MACROS, FK_NONE, plainFlag,
2152 "check all macros with parameter lists as functions",
2153 "Every parameterized macro (not preceded by /*@notfunction@*/) "
2154 "is checked as a function.",
2158 FK_MACROS, FK_NONE, plainSpecialFlag,
2161 "sets fcnmacros and constmacros",
2162 "All macros (not preceded by /*@notfunction@*/) are checked as functions or "
2163 "constants depending on whether or not they have parameter lists.",
2167 FK_MACROS, FK_NONE, plainFlag,
2170 "check all macros with declarations in library as functions",
2171 "Every macro declared in the load library is checked.",
2175 FK_MACROS, FK_NONE, plainFlag,
2178 "check all macros corresponding to specified functions or constants",
2179 "Every macro declared a specification file is checked.",
2183 FK_MACROS, FK_NONE, modeFlag,
2186 "macro definition does not match iter or constant declaration",
2187 "A iter or constant macro is defined using a different name from the "
2188 "one used in the previous syntactic comment",
2192 FK_MACROS, FK_NONE, plainFlag,
2195 "the line after a constant or iter declaration must be a macro definition",
2196 "A constant or iter declaration is not immediately followed by a macro definition.",
2200 /* 11.4 Iterators */
2203 FK_ITER, FK_NONE, plainFlag,
2206 "iter is not balanced with end_<iter>",
2211 FK_ITER, FK_NONE, plainFlag,
2214 "iter yield parameter is inappropriate",
2219 FK_ITER, FK_NONE, plainFlag,
2222 "iter declaration has no yield parameters",
2223 "An iterator has been declared with no parameters annotated with "
2224 "yield. This may be what you want, if the iterator is meant "
2225 "to do something a fixed number of times, but returns no "
2226 "information to the calling context. Probably, a parameter "
2227 "is missing the yield annotation to indicate that it is "
2228 "assigned a value in the calling context.",
2233 ** 12. Naming Conventions
2237 FK_NAMES, FK_ABSTRACT, plainFlag,
2240 "controls name checking without changing other settings",
2244 /* 12.1.1 Czech Names */
2247 FK_NAMES, FK_ABSTRACT, specialFlag,
2250 "czech naming convention (sets accessczech, czechfunctions, czechvars, "
2251 "czechconstants, czechenums, and czechmacros)",
2252 "Name is not consistent with Czech naming convention.", 0, 0
2255 FK_NAMES, FK_ABSTRACT, plainFlag,
2258 "czech naming convention violated in a function or iterator declaration",
2259 "Function or iterator name is not consistent with Czech naming convention.", 0, 0
2262 FK_NAMES, FK_ABSTRACT, plainFlag,
2265 "czech naming convention violated in a variable declaration",
2266 "Variable name is not consistent with Czech naming convention.", 0, 0
2269 FK_NAMES, FK_ABSTRACT, plainFlag,
2272 "czech naming convention violated in an expanded macro name",
2273 "Expanded macro name is not consistent with Czech naming convention.", 0, 0
2276 FK_NAMES, FK_ABSTRACT, plainFlag,
2279 "czech naming convention violated in a constant declaration",
2280 "Constant name is not consistent with Czech naming convention.", 0, 0
2283 FK_NAMES, FK_ABSTRACT, plainFlag,
2286 "czech naming convention violated in a user-defined type definition",
2287 "Type name is not consistent with Czech naming convention. Czech type "
2288 "names must not use the underscore character.", 0, 0
2291 /* 12.1.2 Slovak Names */
2294 FK_NAMES, FK_ABSTRACT, specialFlag,
2297 "slovak naming convention violated",
2298 "Name is not consistent with Slovak naming convention.", 0, 0
2301 FK_NAMES, FK_ABSTRACT, plainFlag,
2303 FLG_SLOVAKFUNCTIONS,
2304 "slovak naming convention violated in a function or iterator declaration",
2305 "Function or iterator name is not consistent with Slovak naming convention.", 0, 0
2308 FK_NAMES, FK_ABSTRACT, plainFlag,
2311 "slovak naming convention violated in an expanded macro name",
2312 "Expanded macro name is not consistent with Slovak naming convention.", 0, 0
2315 FK_NAMES, FK_ABSTRACT, plainFlag,
2318 "slovak naming convention violated in a variable declaration",
2319 "Variable name is not consistent with Slovak naming convention.", 0, 0
2322 FK_NAMES, FK_ABSTRACT, plainFlag,
2324 FLG_SLOVAKCONSTANTS,
2325 "slovak naming convention violated in a constant declaration",
2326 "Constant name is not consistent with Slovak naming convention.", 0, 0
2329 FK_NAMES, FK_ABSTRACT, plainFlag,
2332 "slovak naming convention violated in a use-defined type definition",
2333 "Type name is not consistent with Slovak naming convention. Slovak type "
2334 "names may not include uppercase letters.", 0, 0
2337 /* 12.1.3 Czechoslovak Names */
2339 FK_NAMES, FK_ABSTRACT, specialFlag,
2342 "czech or slovak naming convention violated",
2343 "Name is not consistent with either Czech or Slovak naming convention.", 0, 0
2346 FK_NAMES, FK_ABSTRACT, plainFlag,
2348 FLG_CZECHOSLOVAKFUNCTIONS,
2349 "czechoslovak naming convention violated in a function or iterator declaration",
2350 "Function name is not consistent with Czechoslovak naming convention.", 0, 0
2353 FK_NAMES, FK_ABSTRACT, plainFlag,
2354 "czechoslovakmacros",
2355 FLG_CZECHOSLOVAKMACROS,
2356 "czechoslovak naming convention violated in an expanded macro name",
2357 "Expanded macro name is not consistent with Czechoslovak naming convention.", 0, 0
2360 FK_NAMES, FK_ABSTRACT, plainFlag,
2362 FLG_CZECHOSLOVAKVARS,
2363 "czechoslovak naming convention violated in a variable declaration",
2364 "Variable name is not consistent with Czechoslovak naming convention.", 0, 0
2367 FK_NAMES, FK_ABSTRACT, plainFlag,
2368 "czechoslovakconsts",
2369 FLG_CZECHOSLOVAKCONSTANTS,
2370 "czechoslovak naming convention violated in a constant declaration",
2371 "Constant name is not consistent with Czechoslovak naming convention.", 0, 0
2374 FK_NAMES, FK_ABSTRACT, plainFlag,
2375 "czechoslovaktypes",
2376 FLG_CZECHOSLOVAKTYPES,
2377 "czechoslovak naming convention violated in a user-defined type definition",
2378 "Type name is not consistent with Czechoslovak naming convention. Czechoslovak "
2379 "type names may not include uppercase letters or the underscore character.", 0, 0
2382 /* 12.2 Namespace Prefixes */
2385 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2388 "set namespace prefix for variables declared in a macro body",
2389 "A variable declared in a macro body does not start with the macrovarprefix.",
2393 FK_NAMES, FK_PREFIX, plainFlag,
2394 "macrovarprefixexclude",
2395 FLG_MACROVARPREFIXEXCLUDE,
2396 "the macrovarprefix may not be used for non-macro variables",
2397 "A variable declared outside a macro body starts with the macrovarprefix.",
2401 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2404 "set namespace prefix for struct, union and enum tags",
2405 "A tag identifier does not start with the tagprefix.",
2409 FK_NAMES, FK_PREFIX, plainFlag,
2411 FLG_TAGPREFIXEXCLUDE,
2412 "the tagprefix may not be used for non-tag identifiers",
2413 "An identifier that is not a tag starts with the tagprefix.",
2417 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2420 "set namespace prefix for enum members",
2421 "An enum member does not start with the enumprefix.",
2425 FK_NAMES, FK_PREFIX, plainFlag,
2426 "enumprefixexclude",
2427 FLG_ENUMPREFIXEXCLUDE,
2428 "the enumprefix may not be used for non-enum member identifiers",
2429 "An identifier that is not an enum member starts with the enumprefix.",
2433 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2435 FLG_FILESTATICPREFIX,
2436 "set namespace prefix for file static declarations",
2437 "A file-static identifier does not start with the filestaticprefix.",
2441 FK_NAMES, FK_PREFIX, plainFlag,
2442 "filestaticprefixexclude",
2443 FLG_FILESTATICPREFIXEXCLUDE,
2444 "the filestaticprefix may not be used for identifiers that are not file static",
2445 "An identifier that is not file static starts with the filestaticprefix.",
2449 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2452 "set namespace prefix for global variables",
2453 "A global variable does not start with the globalprefix",
2457 FK_NAMES, FK_PREFIX, plainFlag,
2458 "globalprefixexclude",
2459 FLG_GLOBPREFIXEXCLUDE,
2460 "the globalprefix may not be used for non-global identifiers",
2461 "An identifier that is not a global variable starts with the globalprefix.",
2465 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2468 "set namespace prefix for user-defined types",
2469 "A user-defined type does not start with the typeprefix",
2473 FK_NAMES, FK_PREFIX, plainFlag,
2474 "typeprefixexclude",
2475 FLG_TYPEPREFIXEXCLUDE,
2476 "the typeprefix may not be used for identifiers that are not type names",
2477 "An identifier that is not a type name starts with the typeprefix.",
2481 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2484 "set namespace prefix for external identifiers",
2485 "An external identifier does not start with the externalprefix",
2489 FK_NAMES, FK_PREFIX, plainFlag,
2490 "externalprefixexclude",
2491 FLG_EXTERNALPREFIXEXCLUDE,
2492 "the externalprefix may not be used for non-external identifiers",
2493 "An identifier that is not external starts with the externalprefix.",
2497 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2500 "set namespace prefix for local variables",
2501 "A local variable does not start with the localprefix",
2505 FK_NAMES, FK_PREFIX, plainFlag,
2506 "localprefixexclude",
2507 FLG_LOCALPREFIXEXCLUDE,
2508 "the localprefix may not be used for non-local identifiers",
2509 "An identifier that is not a local variable starts with the localprefix.",
2513 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2514 "uncheckedmacroprefix",
2515 FLG_UNCHECKEDMACROPREFIX,
2516 "set namespace prefix for unchecked macros",
2517 "An unchecked macro name does not start with the uncheckedmacroprefix",
2521 FK_NAMES, FK_PREFIX, plainFlag,
2522 "uncheckedmacroprefixexclude",
2523 FLG_UNCHECKEDMACROPREFIXEXCLUDE,
2524 "the uncheckmacroprefix may not be used for identifiers that are not "
2526 "An identifier that is not the name of an unchecked macro "
2527 "starts with the uncheckedmacroprefix.",
2531 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2534 "set namespace prefix for constants",
2535 "A constant does not start with the constantprefix",
2539 FK_NAMES, FK_PREFIX, plainFlag,
2540 "constprefixexclude",
2541 FLG_CONSTPREFIXEXCLUDE,
2542 "the constprefix may not be used for non-constant identifiers",
2543 "An identifier that is not a constant starts with the constantprefix.",
2547 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2550 "set namespace prefix for iterators",
2551 "An iter does not start with the iterator prefix",
2555 FK_NAMES, FK_PREFIX, plainFlag,
2556 "iterprefixexclude",
2557 FLG_ITERPREFIXEXCLUDE,
2558 "the iterprefix may not be used for non-iter identifiers",
2559 "An identifier that is not a iter starts with the iterprefix.",
2563 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2565 FLG_DECLPARAMPREFIX,
2566 "set namespace prefix for parameters in function prototype declarations",
2567 "A parameter name in a function prototype declaration does not start with the "
2568 "declaration parameter prefix",
2572 /* 12.3 Naming Restrictions */
2574 FK_NAMES, FK_ANSI, modeFlag,
2577 "external name conflicts with name reserved for system or standard library",
2578 "External name is reserved for system use by ISO C99 standard.",
2582 FK_NAMES, FK_ANSI, modeFlag,
2585 "external or internal name is a C++ keyword or reserved word",
2586 "External name is a C++ keyword or reserved word. "
2587 "This could lead to problems if the "
2588 "code is compiled with a C++ compiler.",
2592 FK_NAMES, FK_ANSI, modeFlag,
2593 "isoreservedinternal",
2594 FLG_ISORESERVEDLOCAL,
2595 "internal name conflicts with name reserved for system or standard library",
2596 "Internal name is reserved for system in ISO C99 standard (this should not be necessary unless you are worried about C library implementations that violate the standard and use macros).",
2600 FK_NAMES, FK_ANSI, plainFlag,
2601 "distinctexternalnames",
2602 FLG_DISTINCTEXTERNALNAMES,
2603 "external name is not distinguishable from another external name using "
2604 "the number of significant characters",
2605 "An external name is not distinguishable from another external name "
2606 "using the number of significant characters. According to "
2607 "ANSI Standard (3.1), an implementation may only consider the first 6 "
2608 "characters significant, and ignore alphabetical case "
2609 "distinctions (ISO C99 requires 31). The "
2610 "+externalnamelen <n> flag may be used to change the number "
2611 "of significant characters, and -externalnamecaseinsensitive to make "
2612 "alphabetical case significant in external names.",
2616 FK_NAMES, FK_ANSI, specialValueFlag,
2618 FLG_EXTERNALNAMELEN,
2619 "set the number of significant characters in an external name",
2620 "Sets the number of significant characters in an external name (default is 6 for old "
2621 "ANSI89 limit, C99 requires 31). "
2622 "Sets +distinctexternalnames.",
2626 FK_NAMES, FK_ANSI, plainSpecialFlag,
2627 "externalnamecaseinsensitive",
2628 FLG_EXTERNALNAMECASEINSENSITIVE,
2629 "alphabetic comparisons for external names are case-insensitive",
2630 "Make alphabetic case insignificant in external names. By ANSI89 "
2631 "standard, case need not be significant in an external name. "
2632 "If +distinctexternalnames is not set, sets "
2633 "+distinctexternalnames with unlimited external name length.",
2637 FK_NAMES, FK_ANSI, plainFlag,
2638 "distinctinternalnames",
2639 FLG_DISTINCTINTERNALNAMES,
2640 "internal name is not distinguishable from another internal name using "
2641 "the number of significant characters",
2642 "An internal name is not distinguishable from another internal name "
2643 "using the number of significant characters. According to "
2644 "ANSI89 Standard (3.1), an implementation may only consider the first 31 "
2645 "characters significant (ISO C99 specified 63). The "
2646 "+internalnamelen <n> flag changes the number "
2647 "of significant characters, -internalnamecaseinsensitive to makes "
2648 "alphabetical case significant, and "
2649 "+internalnamelookalike to make similar-looking characters "
2654 FK_NAMES, FK_ANSI, specialValueFlag,
2656 FLG_INTERNALNAMELEN,
2657 "set the number of significant characters in an internal name",
2658 "Sets the number of significant characters in an internal name (ANSI89 "
2659 "default is 31.) Sets +distinctinternalnames.",
2663 FK_NAMES, FK_ANSI, plainSpecialFlag,
2664 "internalnamecaseinsensitive",
2665 FLG_INTERNALNAMECASEINSENSITIVE,
2666 "set whether case is significant an internal names "
2667 "(-internalnamecaseinsensitive means case is significant)" ,
2668 "Set whether case is significant an internal names "
2669 "(-internalnamecaseinsensitive "
2670 "means case is significant). By ANSI89 default, case is not "
2671 "significant. If +distinctinternalnames is not set, sets "
2672 "+distinctinternalnames with unlimited internal name length.",
2676 FK_NAMES, FK_ANSI, plainSpecialFlag,
2677 "internalnamelookalike",
2678 FLG_INTERNALNAMELOOKALIKE,
2679 "lookalike characters match in internal names",
2680 "Set whether similar looking characters (e.g., \"1\" and \"l\") "
2681 "match in internal names.",
2685 FK_NAMES, FK_PREFIX, modeFlag,
2688 "a parameter in a function prototype has a name",
2689 "A parameter in a function prototype has a name. This is dangerous, "
2690 "since a macro definition could be visible here.",
2694 FK_NAMES, FK_PREFIX, modeFlag,
2697 "the name of a parameter in a function prototype and corresponding "
2698 "declaration must match (after removing the protoparamprefix",
2699 "A parameter in a function definition does not have the same name as "
2700 "the corresponding in the declaration of the function after "
2701 "removing the protoparamprefix",
2705 FK_NAMES, FK_PREFIX, plainFlag,
2706 "protoparamprefixexclude",
2707 FLG_DECLPARAMPREFIXEXCLUDE,
2708 "the protoparamprefix may not be used for non-declaraction parameter identifiers",
2709 "An identifier that is not a parameter name in a function prototype "
2710 "starts with the protoparamprefix.",
2718 /* 13.1 Unused Declarations */
2721 FK_USE, FK_COMPLETE, modeFlag,
2724 "declaration at top level not used",
2725 "An external declaration not used in any source file.", 0, 0
2728 FK_USE, FK_EXPORT, modeFlag,
2731 "a declaration is exported but not used outside this module",
2732 "A declaration is exported, but not used outside this module. "
2733 "Declaration can use static qualifier.",
2737 FK_USE, FK_EXPORT, modeFlag,
2740 "a declaration is exported but does not appear in a header file",
2741 "A declaration is exported, but does not appear in a header file.",
2745 FK_USE, FK_EXPORT, modeFlag,
2747 FLG_EXPORTHEADERVAR,
2748 "a variable declaration is exported but does not appear in a header file",
2749 "A variable declaration is exported, but does not appear in a header "
2750 "file. (Used with exportheader.)",
2754 FK_USE, FK_NONE, modeFlag,
2757 "field of structure type not used",
2758 "A field is present in a structure type but never used. Use /*@unused@*/ in front of field declaration to suppress message.",
2762 FK_USE, FK_NONE, modeFlag,
2765 "member of an enum type not used",
2766 "A member of an enum type is never used.",
2770 FK_USE, FK_NONE, modeFlag,
2773 "constant declared but not used",
2774 "A constant is declared but not used. Use unused in the constant declaration to suppress message.",
2778 FK_USE, FK_NONE, modeFlag,
2781 "function declared but not used",
2782 "A function is declared but not used. Use /*@unused@*/ in front of function header to suppress message.",
2786 FK_USE, FK_PARAMS, modeFlag,
2789 "function parameter not used ",
2790 "A function parameter is not used in the body of the function. If the argument is needed for type compatibility or future plans, use /*@unused@*/ in the argument declaration.",
2794 FK_USE, FK_TYPE, modeFlag,
2797 "type declared but not used",
2798 "A type is declared but not used. Use /*@unused@*/ in front of typedef to suppress messages.",
2802 FK_USE, FK_NONE, modeFlag,
2805 "variable declared but not used",
2806 "A variable is declared but never used. Use /*@unused@*/ in front "
2807 "of declaration to suppress message.",
2811 FK_USE, FK_COMPLETE, modeFlag,
2814 "unused declaration in special file (corresponding to .l or .y file)",
2818 /* 13.2 Complete Programs */
2821 FK_COMPLETE, FK_NONE, modeFlag,
2824 "function or variable declared but never defined",
2825 "A function or variable is declared, but not defined in any source code file.",
2829 FK_COMPLETE, FK_SPEC, modeFlag,
2832 "function or variable specified but never defined",
2833 "A function or variable is declared in an .lcl file, but not defined in any source code file.",
2837 FK_COMPLETE, FK_SPEC, plainFlag,
2840 "function or variable specified but never declared in a source file",
2841 "A function or variable is declared in an .lcl file, but not declared "
2842 "in any source code file.",
2846 FK_DECL, FK_LIBS, plainFlag,
2849 "report new global declarations in source files",
2850 "There is a new declaration that is not declared in a loaded library "
2851 "or earlier file. (Use this flag to check for consistency "
2852 "against a library.)",
2856 FK_INIT, FK_SPEC, plainFlag,
2859 "information in specifications is not also included in syntactic comments",
2860 "There is information in the specification that is not duplicated "
2861 "in syntactic comments. Normally, this is not an "
2862 "error, but it may be useful to detect it to make "
2863 "sure checking incomplete systems without the specifications will "
2864 "still use this information.",
2869 ** 14. Libraries and Header File Inclusion
2872 /* 14.1 Standard Libraries */
2875 FK_LIBS, FK_INIT, idemGlobalFlag,
2878 "do not load standard library",
2882 FK_LIBS, FK_INIT, idemGlobalFlag,
2885 "use normal standard library",
2886 "Library based on the ISO standard library specification is used.",
2890 FK_LIBS, FK_INIT, idemGlobalFlag,
2893 "interpret standard library strictly",
2894 "Stricter version of the standard library is used. (The default "
2895 "library is standard.lcd; strict library is strict.lcd.)",
2899 FK_LIBS, FK_INIT, idemGlobalFlag,
2902 "use UNIX (sort-of) standard library",
2903 "UNIX version of the standard library is used.",
2907 FK_LIBS, FK_INIT, idemGlobalFlag,
2910 "use strict version of UNIX (sort-of) library",
2911 "strict version of the UNIX library is used.",
2915 FK_LIBS, FK_INIT, idemGlobalFlag,
2918 "use POSIX standard library",
2919 "POSIX version of the standard library is used.",
2923 FK_LIBS, FK_INIT, idemGlobalFlag,
2926 "use strict POSIX standard library",
2927 "POSIX version of the strict standard library is used.",
2931 FK_LIBS, FK_INIT, idemGlobalFlag,
2934 "show standard library filename",
2938 FK_LIBS, FK_ANSI, plainFlag,
2941 "a POSIX header is included, but the POSIX library is not used",
2942 "Header name matches a POSIX header, but the POSIX library is not selected.",
2946 FK_LIBS, FK_ANSI, plainFlag,
2949 "warn when the unix library is used",
2950 "Unix library may not be compatible with all platforms",
2954 FK_LIBS, FK_ANSI, plainFlag,
2957 "non-standard <varargs.h> included",
2958 "Header <varargs.h> is not part of ANSI Standard. "
2959 "Should use <stdarg.h> instead.",
2963 FK_HEADERS, FK_FILES, plainFlag,
2964 "caseinsensitivefilenames",
2965 FLG_CASEINSENSITIVEFILENAMES,
2966 "file names are case insensitive (file.h and FILE.H are the same file)",
2970 /* 14.2 Generating Libraries */
2973 FK_LIBS, FK_FILES, globalStringFlag, ARG_FILE,
2976 "save state for merging (default suffix .lcd)",
2980 FK_LIBS, FK_FILES, globalStringFlag, ARG_FILE,
2983 "load state from dump file (default suffix .lcd)",
2987 /* 14.3 Header File Inclusion */
2990 FK_HEADERS, FK_SPEED, globalFlag,
2993 "optimize header inclusion to eliminate redundant includes",
2994 "When checking multiple files, each header file is processed only "
2995 "once. This may change the meaning of the code, if the "
2996 "same header file is included in different contexts (e.g., the "
2997 "header file includes #if directives and the values are "
2998 "different when it is included in different places.)",
3002 FK_HEADERS, FK_SPEED, globalFlag,
3005 "optimize header inclusion to not include any header files",
3006 "Ignore header includes. Only works if relevant information is "
3007 "loaded from a library.",
3011 FK_HEADERS, FK_SPEED, globalFlag,
3014 "do not include header files in system directories (set by -sysdirs)",
3015 "Do not include header files in system directories (set by -sysdirs)",
3029 FK_SYNTAX, FK_ANSI, plainFlag,
3032 "support some gnu (gcc) language extensions",
3033 "ANSI C does not allow some language features supported by gcc and other compilers. "
3034 "Use +gnuextensions to allow some of these extensions.", 0, 0
3040 FK_PROTOS, FK_ANSI, modeFlag,
3043 "function declaration has no parameter list",
3044 "A function declaration does not have a parameter list.",
3048 FK_PROTOS, FK_ANSI, modeFlag,
3051 "old style function definition",
3052 "Function definition is in old style syntax. Standard prototype "
3053 "syntax is preferred.",
3063 FK_SYSTEMFUNCTIONS, FK_TYPE, plainFlag,
3066 "type of main does not match expected type",
3067 "The function main does not match the expected type.",
3071 FK_SYSTEMFUNCTIONS, FK_BEHAVIOR, modeFlag,
3074 "argument to exit has implementation defined behavior",
3075 "The argument to exit should be 0, EXIT_SUCCESS or EXIT_FAILURE",
3080 FK_DECL, FK_NONE, modeFlag,
3083 "declaration reuses name visible in outer scope",
3084 "An outer declaration is shadowed by the local declaration.",
3088 FK_DECL, FK_LIBS, modeFlag,
3091 "function, variable or constant defined in a library is redefined with inconsistent type",
3092 "A function, variable or constant previously defined in a library is "
3093 "redefined with a different type.",
3097 FK_DECL, FK_LIBS, modeFlag,
3100 "library function overloaded",
3101 "A function, variable or constant defined in the library is redefined "
3102 "with a different type.",
3106 FK_DECL, FK_NONE, modeFlag,
3109 "an extern declaration is inside a function scope",
3110 "An extern declaration is used inside a function scope.",
3114 FK_DECL, FK_NONE, modeFlag,
3117 "function or variable redeclared",
3118 "A function or variable is declared in more than one place. This is "
3119 "not necessarily a problem, since the declarations are consistent.",
3123 FK_DECL, FK_NONE, plainFlag,
3126 "function or variable redefined",
3127 "A function or variable is redefined. One of the declarations should use extern.",
3131 FK_DECL, FK_TYPE, modeFlag,
3134 "variable declaration has unknown (implicitly int) type",
3135 "A variable declaration has no explicit type. The type is implicitly int.",
3140 FK_DIRECT, FK_FILES, globalStringFlag, ARG_DIRECTORY,
3143 "set directory for writing temp files",
3147 FK_DIRECT, FK_FILES, globalStringFlag, ARG_PATH,
3150 "set path for searching for library files (overrides LARCH_PATH environment variable)",
3154 FK_DIRECT, FK_FILES, globalStringFlag, ARG_DIRECTORY,
3157 "set directory to search for LCL import files (overrides LCLIMPORTDIR)",
3161 FK_DIRECT, FK_FILES, globalStringFlag, ARG_PATH,
3164 "set directories for system files (default /usr/include). Separate "
3165 "directories with path separator (colons in Unix, semi-colons in Windows). "
3166 "Flag settings propagate to files in a system directory. If "
3167 "-sysdirerrors is set, no errors are reported for files in "
3168 "system directories.",
3172 FK_DIRECT, FK_FILES, plainFlag,
3175 "prevent inclusion of header files in a system directory with "
3176 "names that match standard ANSI headers. The symbolic information "
3177 "in the standard library is used instead. Flag in effect only "
3178 "if a library including the ANSI library is loaded. The ANSI "
3179 "headers are: assert, ctype, errno, float, limits, locale, math, "
3180 "setjmp, signal, stdarg, stddef, stdio, stdlib, strings, string, "
3185 FK_DIRECT, FK_FILES, plainFlag,
3187 FLG_SKIPPOSIXHEADERS,
3188 "prevent inclusion of header files in a system directory with "
3189 "names that match standard POSIX headers. The symbolic information "
3190 "in the posix library is used instead. The POSIX headers are: "
3191 "dirent, fcntl, grp, pwd, termios, sys/stat, sys/times, "
3192 "sys/types, sys/utsname, sys/wait, unistd, and utime.",
3196 FK_DIRECT, FK_SUPPRESS, modeFlag,
3198 FLG_SYSTEMDIRERRORS,
3199 "report errors in files in system directories (set by -sysdirs)",
3203 FK_DIRECT, FK_MACROS, plainFlag,
3204 "sysdirexpandmacros",
3205 FLG_SYSTEMDIREXPAND,
3206 "expand macros in system directories regardless of other settings, "
3207 "except for macros corresponding to names defined in a load library",
3212 FK_DIRECT, FK_HEADERS, globalExtraArgFlag,
3215 "add to C include path",
3219 FK_DIRECT, FK_SPEC, globalExtraArgFlag,
3226 FK_EXPORT, FK_SPEC, specialFlag,
3229 "variable, function or type exported but not specified",
3230 "A variable, function or type is exported, but not specified.",
3234 FK_EXPORT, FK_SPEC, modeFlag,
3237 "function exported but not specified",
3238 "A function is exported, but not specified.", 0, 0
3241 FK_EXPORT, FK_SPEC, modeFlag,
3244 "expanded macro exported but not specified",
3245 "A macro is exported, but not specified.", 0, 0
3248 FK_EXPORT, FK_SPEC, modeFlag,
3251 "type definition exported but not specified",
3252 "A type is exported, but not specified.", 0, 0
3255 FK_EXPORT, FK_SPEC, modeFlag,
3258 "variable exported but not specified",
3259 "A variable is exported, but not specified.", 0, 0
3262 FK_EXPORT, FK_SPEC, modeFlag,
3265 "constant exported but not specified",
3266 "A constant is exported, but not specified.", 0, 0
3269 FK_EXPORT, FK_SPEC, modeFlag,
3272 "constant exported but not specified",
3273 "A constant is exported, but not specified.", 0, 0
3277 FK_FORMAT, FK_DISPLAY, valueFlag,
3280 "set length of messages (number of chars)",
3284 FK_FORMAT, FK_DISPLAY, valueFlag,
3287 "set number of spaces to indent sub-messages",
3291 FK_FORMAT, FK_DISPLAY, plainFlag,
3294 "show column number where error is found",
3298 FK_FORMAT, FK_DISPLAY, plainFlag,
3301 "show location information for load files",
3305 FK_FORMAT, FK_DISPLAY, globalFileFlag,
3308 "produce comma-separated values (CSV) warnings output file",
3312 FK_FORMAT, FK_DISPLAY, plainFlag,
3315 "overwrite exisiting CVS output file",
3319 FK_FORMAT, FK_DISPLAY, plainFlag,
3321 FLG_PARENFILEFORMAT,
3322 "show column number where error is found",
3326 FK_FORMAT, FK_DISPLAY, plainFlag,
3329 "show file locations as links",
3333 FK_FORMAT, FK_NONE, plainFlag,
3336 "show name of function containing error",
3340 FK_FORMAT, FK_NONE, plainFlag,
3343 "show all possible types",
3344 "When a library function is declared with multiple possible type, the "
3345 "alternate types are shown only if +showallconjs.",
3349 FK_LIBS, FK_NONE, plainFlag,
3352 "make all alternate types implicit (useful for making system libraries",
3356 FK_GLOBAL, FK_ERRORS, globalValueFlag,
3359 "expect <int> code errors",
3363 FK_GLOBAL, FK_ERRORS, globalValueFlag,
3366 "expect <int> spec errors",
3370 FK_GLOBAL, FK_USE, idemSpecialFlag,
3373 "check as partial system (-specundef, -declundef, -exportlocal, "
3374 "don't check macros in headers without corresponding .c files)",
3379 ** Appendix D. Specifications
3383 FK_HEADERS, FK_SPEC, globalFlag,
3386 "generate .lh files", NULL,
3390 FK_HEADERS, FK_SPEC, globalFlag,
3393 "generate .lcs files", NULL,
3402 FK_HELP, FK_NONE, plainFlag,
3405 "warn when command line sets flag in abnormal way",
3406 "Command line sets flag in abnormal way",
3410 FK_HELP, FK_NONE, plainFlag,
3413 "warn when there are problems with reading the initialization files",
3414 "There was a problem reading an initialization file",
3418 FK_HELP, FK_NONE, plainFlag,
3421 "warn about bad command line flags",
3422 "A flag is not recognized or used in an incorrect way",
3426 FK_HELP, FK_NONE, plainFlag,
3429 "warn when command line file does not have a recognized extension",
3433 FK_HELP, FK_NONE, globalExtraArgFlag,
3436 "-help <flags> will describe flags",
3441 FK_INIT, FK_FILES, globalFileFlag,
3444 "read an options file (default ~/.splintrc not loaded)",
3445 "Read an options file (instead of loading default ~/.splintc)",
3449 FK_INIT, FK_FILES, globalFileFlag,
3452 "set LCL initilization file",
3456 FK_INIT, FK_FILES, globalFlag,
3459 "do not read options file",
3460 "Do not read the default options file (~/.splintrc)",
3464 FK_INIT, FK_COMMENTS, charFlag,
3467 "set marker character for syntactic comments (default is '@')",
3468 "Set the marker character for syntactic comments. Comments beginning "
3469 "with /*<char> are interpreted by Splint, where <char> is the "
3470 "comment marker character.",
3479 FK_LIMITS, FK_ANSI, modeValueFlag,
3481 FLG_CONTROLNESTDEPTH,
3482 "set maximum nesting depth of compound statements, iteration control "
3483 "structures, and selection control structures (ANSI89 minimum is 15; ISO99 is 63)",
3484 "Maximum number of control levels exceeded.",
3488 FK_LIMITS, FK_ANSI, modeValueFlag,
3490 FLG_STRINGLITERALLEN,
3491 "set maximum length of string literals (ANSI89 minimum is 509; ISO99 is 4095)",
3492 "Maximum length of string literal exceeded.",
3496 FK_LIMITS, FK_ANSI, modeValueFlag,
3498 FLG_NUMSTRUCTFIELDS,
3499 "set maximum number of fields in a struct or union (ANSI89 minimum is 127; ISO99 is 1023)",
3500 "Maximum number of fields in a struct or union exceeded.",
3504 FK_LIMITS, FK_ANSI, modeValueFlag,
3507 "set maximum number of members of an enum (ANSI89 minimum is 127; ISO99 is 1023)",
3508 "Limit on maximum number of members of an enum is exceeded.",
3512 FK_LIMITS, FK_ANSI, modeValueFlag,
3515 "set maximum number of nested #include files (ANSI89 minimum is 8; ISO99 is 63)",
3516 "Maximum number of nested #include files exceeded.",
3520 FK_LIMITS, FK_ANSI, specialFlag,
3523 "check for violations of standard limits (controlnestdepth, "
3524 "stringliterallen, includenest, numstructfields, numenummembers) based on ANSI89 standard",
3529 FK_LIMITS, FK_ANSI, specialFlag,
3532 "check for violations of standard limits (controlnestdepth, "
3533 "stringliterallen, includenest, numstructfields, numenummembers) based on ISO99 standard",
3539 FK_PREPROC, FK_NONE, globalExtraArgFlag,
3542 "passed to pre-processor",
3546 FK_PREPROC, FK_NONE, globalExtraArgFlag,
3549 "passed to pre-processor",
3553 FK_PREPROC, FK_SYNTAX, plainFlag,
3555 FLG_UNRECOGDIRECTIVE,
3556 "unrecognized pre-processor directive",
3557 "Pre-processor directive is not recognized.",
3561 FK_SUPPRESS, FK_COMMENTS, globalFlag,
3564 "The number of errors detected does not match number in /*@i<n>@*/.",
3568 FK_SUPPRESS, FK_ERRORS, valueFlag,
3571 "limit <int> consecutive repeated errors",
3575 FK_SYNTAX, FK_NONE, plainFlag,
3578 "syntax error in parsing",
3579 "Code cannot be parsed. For help on parse errors, see splint -help parseerrors.",
3583 FK_SYNTAX, FK_NONE, plainFlag,
3586 "try to recover from parse error",
3587 "Try to recover from parse error. It really means try - this doesn't usually work.", 0, 0
3590 FK_SYNTAX, FK_PREPROC, plainFlag,
3593 "preprocessing error",
3594 "Preprocessing error.",
3599 FK_TYPE, FK_NONE, plainFlag,
3603 "Types are incompatible.",
3608 FK_TYPE, FK_NONE, plainFlag,
3609 "stringliteraltoolong",
3610 FLG_STRINGLITTOOLONG,
3611 "string literal too long for character array",
3612 "A string literal is assigned to a char array too small to hold it.",
3616 FK_TYPE, FK_NONE, modeFlag,
3617 "stringliteralnoroomfinalnull",
3618 FLG_STRINGLITNOROOMFINALNULL,
3619 "string literal leaves no room for null terminator",
3620 "A string literal is assigned to a char array that is not big enough to hold the final null terminator. This may not be a problem because a null character has been explictedly included in the string literal using an escape sequence",
3624 FK_TYPE, FK_NONE, modeFlag,
3625 "stringliteralnoroom",
3626 FLG_STRINGLITNOROOM,
3627 "string literal leaves no room for null terminator",
3628 "A string literal is assigned to a char array that is not big enough to hold the null terminator.",
3632 FK_TYPE, FK_NONE, modeFlag,
3633 "stringliteralsmaller",
3634 FLG_STRINGLITSMALLER,
3635 "string literal is smaller than the char array it is assigned to",
3636 "A string literal is assigned to a char array that smaller than the string literal needs.",
3640 FK_TYPE, FK_NONE, modeFlag,
3643 "enum members must be int values",
3644 "Type of initial values for enum members must be int.",
3649 FK_TYPE, FK_NONE, plainFlag,
3652 "type-mismatch in parameter corresponding to format code in a printf or scanf-like function",
3653 "Type of parameter is not consistent with corresponding code in format string.",
3657 FK_TYPE, FK_NONE, modeFlag,
3660 "format parameter is not a string constant (hence variable arguments cannot be typechecked)",
3661 "Format parameter is not known at compile-time. This can lead to security vulnerabilities because the arguments cannot be type checked.",
3665 FK_TYPE, FK_NONE, plainFlag,
3668 "invalid format code in format string for printf or scanf-like function",
3669 "Format code in a format string is not valid.",
3673 FK_TYPEEQ, FK_ABSTRACT, modeFlag,
3676 "forward declarations of pointers to abstract representation match abstract type",
3680 FK_TYPEEQ, FK_ABSTRACT, modeFlag,
3683 "void * matches pointers to abstract types, casting ok (dangerous)",
3684 "A pointer to void is cast to a pointer to an abstract type (or vice versa).",
3688 FK_TYPEEQ, FK_POINTER, plainFlag,
3691 "a pointer to a function is cast to a pointer to void (or vice versa)",
3692 "A pointer to a function is cast to (or used as) a pointer to void (or vice versa).",
3696 FK_TYPEEQ, FK_ARRAY, modeFlag,
3699 "char can be used to index arrays",
3700 "To allow char types to index arrays, use +charindex.", 0, 0
3703 FK_TYPEEQ, FK_ARRAY, modeFlag,
3706 "enum can be used to index arrays",
3707 "To allow enum types to index arrays, use +enumindex.", 0, 0
3710 FK_TYPEEQ, FK_BOOL, modeFlag,
3713 "bool and int are equivalent",
3714 "To make bool and int types equivalent, use +boolint.",
3718 FK_TYPEEQ, FK_NONE, modeFlag,
3721 "char and int are equivalent",
3722 "To make char and int types equivalent, use +charint.",
3726 FK_TYPEEQ, FK_NONE, modeFlag,
3729 "enum and int are equivalent",
3730 "To make enum and int types equivalent, use +enumint.",
3734 FK_TYPEEQ, FK_NONE, modeFlag,
3737 "long int and int are equivalent",
3738 "To make long int and int types equivalent, use +longint.",
3742 FK_TYPEEQ, FK_NONE, modeFlag,
3745 "short int and int are equivalent",
3746 "To make short int and int types equivalent, use +shortint.",
3750 FK_TYPEEQ, FK_NONE, modeFlag,
3753 "float and double are equivalent",
3754 "To make float and double types equivalent, use +floatdouble.",
3758 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3761 "ignore type qualifiers (long, short, unsigned)",
3762 "To ignore type qualifiers in type comparisons use +ignorequals.",
3766 FK_TYPEEQ, FK_SYNTAX, plainFlag,
3769 "report duplicate type qualifiers (e.g., unsigned unsigned)",
3770 "Duplicate type qualifiers not supported by ISO standard.",
3774 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3777 "ignore signs in type comparisons (unsigned matches signed)",
3778 "To ignore signs in type comparisons use +ignoresigns",
3782 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3785 "int literals can be reals",
3786 "An int literal is used as any numeric type (including float and long long). Use +numliteral to "
3787 "allow int literals to be used as any numeric type.",
3791 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3794 "character constants (e.g., 'a') can be used as ints",
3795 "A character constant is used as an int. Use +charintliteral to "
3796 "allow character constants to be used as ints. (This is safe "
3797 "since the actual type of a char constant is int.)",
3801 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3804 "report qualifier mismatches only if dangerous",
3805 "To allow qualifier mismatches that are not dangerous, use +relaxquals.", 0, 0
3808 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3811 "allow all numeric types to match",
3812 "To allow all numeric types to match, use +relaxtypes.", 0, 0
3815 FK_TYPEEQ, FK_NONE, modeFlag,
3817 FLG_CHARUNSIGNEDCHAR,
3818 "allow char and unsigned char types to match",
3819 "To allow char and unsigned char types to match use +charunsignedchar.",
3823 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3825 FLG_MATCHANYINTEGRAL,
3826 "allow any intergral type to match an arbitrary integral type (e.g., dev_t)",
3827 "To allow arbitrary integral types to match any integral type, use +matchanyintegral.",
3831 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3832 "longunsignedintegral",
3833 FLG_LONGUNSIGNEDINTEGRAL,
3834 "allow long unsigned type to match an arbitrary integral type (e.g., dev_t)",
3835 "To allow arbitrary integral types to match long unsigned, use +longunsignedintegral.",
3839 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3842 "allow long type to match an arbitrary integral type (e.g., dev_t)",
3843 "To allow arbitrary integral types to match long unsigned, use +longintegral.",
3847 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3848 "longunsignedunsignedintegral",
3849 FLG_LONGUNSIGNEDUNSIGNEDINTEGRAL,
3850 "allow long unsigned type to match an arbitrary unsigned integral type (e.g., size_t)",
3851 "To allow arbitrary unsigned integral types to match long unsigned, "
3852 "use +longunsignedunsignedintegral.",
3856 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3857 "longsignedintegral",
3858 FLG_LONGSIGNEDINTEGRAL,
3859 "allow long type to match an arbitrary signed integral type (e.g., ssize_t)",
3860 "To allow arbitrary signed integral types to match long unsigned, use +longsignedintegral.",
3864 FK_TYPEEQ, FK_POINTER, plainFlag,
3867 "treat 0 as a pointer",
3871 FK_TYPEEQ, FK_BOOL, modeFlag,
3874 "treat 0 as a boolean",
3878 FK_UNRECOG, FK_DISPLAY, plainFlag,
3881 "do not suppress repeated unrecognized identifier messages (instead of only reporting the first error)",
3882 "Identifier used in code has not been declared. (Message repeated for future uses in this file.)",
3886 FK_UNRECOG, FK_DISPLAY, plainFlag,
3889 "report unrecognized identifiers with system (__) prefix",
3890 "Identifier used in code has not been declared. (Message repeated for "
3891 "future uses in this file.) Use +gnuextensions to make Splint "
3892 "recognize some keywords that are gnu extensions.",
3896 FK_UNRECOG, FK_NONE, plainFlag,
3899 "unrecognized identifier",
3900 "Identifier used in code has not been declared.", 0, 0
3905 FK_DECL, FK_TYPE, plainFlag,
3907 FLG_ANNOTATIONERROR,
3908 "annotation is used in inconsistent location",
3909 "A declaration uses an invalid annotation.",
3913 FK_DECL, FK_TYPE, plainFlag,
3916 "inconsistent syntactic comment",
3917 "A syntactic comment is used inconsistently.",
3926 FK_WARNUSE, FK_NONE, plainFlag,
3929 "warn when declaration marked with warn is used",
3930 "Declaration marked with warn clause is used (can be suppresed by more specific flags).",
3934 FK_WARNUSE, FK_SECURITY, modeFlag,
3937 "possible buffer overflow vulnerability",
3938 "Use of function that may lead to buffer overflow.",
3942 FK_WARNUSE, FK_SECURITY, modeFlag,
3943 "bufferoverflowhigh",
3944 FLG_BUFFEROVERFLOWHIGH,
3945 "likely buffer overflow vulnerability",
3946 "Use of function that may lead to buffer overflow.",
3950 FK_WARNUSE, FK_SECURITY, modeFlag,
3951 "implementationoptional",
3952 FLG_IMPLEMENTATIONOPTIONAL,
3953 "declarator is implementation optional (ISO99 does not require an implementation to provide it)",
3954 "Use of a declarator that is implementation optional, not required by ISO99.",
3958 FK_WARNUSE, FK_NONE, modeFlag,
3961 "legacy declaration in Unix Standard",
3962 "Use of a declarator that is marked as a legacy entry in the Unix Standard.",
3966 FK_WARNUSE, FK_SECURITY, modeFlag,
3969 "function is not reentrant",
3970 "Non-reentrant function should not be used in multithreaded code.",
3974 FK_WARNUSE, FK_SECURITY, modeFlag,
3977 "function may have undefined behavior",
3978 "Use of function that may have implementation-dependent behavior.",
3982 FK_WARNUSE, FK_SECURITY, modeFlag,
3985 "function is restricted to superusers",
3986 "Call to function restricted to superusers.",
3990 FK_WARNUSE, FK_SECURITY, modeFlag,
3993 "possible time of check, time of use vulnerability",
3994 "Possible time of check, time of use vulnerability.",
3998 FK_WARNUSE, FK_SECURITY, modeFlag,
4001 "function is not required in Standard UNIX Specification",
4002 "Use of function that need not be provided by UNIX implementations",
4007 ** ITS4 Compability Flags
4009 ** These flags flags must appear in order (most severe -> weakest).
4013 FK_ITS4, FK_SECURITY, specialFlag,
4016 "most risky security vulnerabilities (from its4 database)",
4017 "Security vulnerability classified as most risky in its4 database.",
4021 FK_ITS4, FK_SECURITY, specialFlag,
4024 "very risky security vulnerabilities (from its4 database)",
4025 "Security vulnerability classified as very risky in its4 database.",
4029 FK_ITS4, FK_SECURITY, specialFlag,
4032 "risky security vulnerabilities (from its4 database)",
4033 "Security vulnerability classified as risky in its4 database.",
4037 FK_ITS4, FK_SECURITY, specialFlag,
4039 FLG_ITS4MODERATERISK,
4040 "moderately risky security vulnerabilities (from its4 database)",
4041 "Security vulnerability classified as moderate risk in its4 database.",
4045 FK_ITS4, FK_SECURITY, specialFlag,
4048 "risky security vulnerabilities (from its4 database)",
4049 "Security vulnerability classified as risky in its4 database.",
4054 ** Syntactic comments
4058 FK_SYNCOMMENTS, FK_SUPPRESS, plainFlag,
4061 "ignore all stylized comments",
4065 FK_SYNCOMMENTS, FK_ABSTRACT, plainFlag,
4068 "ignore access comments",
4073 FK_SYNCOMMENTS, FK_SYNTAX, plainFlag,
4075 FLG_UNRECOGCOMMENTS,
4076 "stylized comment is unrecognized",
4077 "Word after a stylized comment marker does not correspond to a "
4078 "stylized comment.",
4082 FK_SYNCOMMENTS, FK_SYNTAX, plainFlag,
4083 "unrecogflagcomments",
4084 FLG_UNRECOGFLAGCOMMENTS,
4085 "stylized flag comment uses an unrecognized flag",
4086 "Semantic comment attempts to set a flag that is not recognized.",
4090 FK_SYNCOMMENTS, FK_SUPPRESS, modeFlag,
4093 "interpret t comments (ignore errors in lines marked with /*@t<n>@*/",
4097 FK_SYNCOMMENTS, FK_SUPPRESS, plainFlag,
4100 "interpret traditional lint comments (/*FALLTHROUGH*/, /*NOTREACHED*/)",
4104 FK_SYNCOMMENTS, FK_SUPPRESS, modeFlag,
4106 FLG_WARNLINTCOMMENTS,
4107 "warn when a traditional lint comment is used",
4108 "A traditional lint comment is used. Some traditional lint comments "
4109 "are interpreted by Splint to enable easier checking of legacy "
4110 "code. It is preferable to replace these comments with the "
4111 "suggested Splint alternative.",
4120 FK_COMMENTS, FK_SYNTAX, plainFlag,
4122 FLG_CONTINUECOMMENT,
4123 "line continuation marker (\\) in comment before */ on same line",
4124 "A line continuation marker (\\) appears inside a comment on the same "
4125 "line as the comment close. Preprocessors should handle this "
4126 "correctly, but it causes problems for some preprocessors.",
4130 FK_COMMENTS, FK_SYNTAX, plainFlag,
4131 "slashslashcomment",
4132 FLG_SLASHSLASHCOMMENT,
4133 "use of // comment",
4134 "A // comment is used. ISO C99 allows // comments, but earlier standards did not.",
4138 FK_COMMENTS, FK_SYNTAX, plainFlag,
4141 "comment begins inside comment",
4142 "A comment open sequence (/*) appears within a comment. This usually "
4143 "means an earlier comment was not closed.",
4148 ** Flags for controlling warning message printing.
4154 FK_DISPLAY, FK_ERRORS, plainFlag,
4157 "suppress herald and error count",
4162 ** Default is to send messages, warnings and errors to stderr
4166 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4167 "messagestreamstdout",
4168 FLG_MESSAGESTREAMSTDOUT,
4169 "send status messages to standard output stream",
4173 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4174 "messagestreamstderr",
4175 FLG_MESSAGESTREAMSTDERR,
4176 "send status messages to standard error stream",
4180 FK_DISPLAY, FK_ERRORS, globalStringFlag, ARG_FILE,
4183 "send status messages to <file>",
4188 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4189 "warningstreamstdout",
4190 FLG_WARNINGSTREAMSTDOUT,
4191 "send warnings to standard output stream",
4195 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4196 "warningstreamstderr",
4197 FLG_WARNINGSTREAMSTDERR,
4198 "send warnings to standard error stream",
4202 FK_DISPLAY, FK_ERRORS, globalStringFlag, ARG_FILE,
4205 "send warnings to <file>",
4210 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4211 "errorstreamstdout",
4212 FLG_ERRORSTREAMSTDOUT,
4213 "send fatal errors to standard output stream",
4217 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4218 "errorstreamstderr",
4219 FLG_ERRORSTREAMSTDERR,
4220 "send fatal errors to standard error stream",
4224 FK_DISPLAY, FK_ERRORS, globalStringFlag, ARG_FILE,
4227 "send fatal errors to <file>",
4232 FK_DISPLAY, FK_ERRORS, globalFlag,
4234 FLG_STREAMOVERWRITE,
4235 "warn and exit if a stream output file would overwrite an existing file",
4241 FK_DISPLAY, FK_ERRORS, plainFlag,
4244 "show summary of all errors reported and suppressed",
4248 FK_DISPLAY, FK_FILES, plainFlag,
4251 "show file names are they are processed",
4255 FK_DISPLAY, FK_FILES, plainFlag,
4258 "Splint has been run on a system file, by default no errors are reported for system files. Use +systemdirerrors if you want splint to report errors in system files. A file is considered a system file if it is in a system directory or a subdirectory of a system directory. The sysdirs flag can be used to control the directories treated as system directories.",
4262 FK_DISPLAY, FK_NONE, globalFlag,
4265 "display lines processed and time",
4269 FK_DISPLAY, FK_NONE, globalFlag,
4272 "display time distribution",
4276 FK_DISPLAY, FK_USE, globalFlag,
4279 "show sorted list of uses of all globals",
4286 FK_HINTS, FK_FORMAT, plainFlag,
4289 "provide a hint the first time a particular warning appears",
4290 "Provide a hint the first time a particular warning appears",
4294 FK_HINTS, FK_FORMAT, plainFlag,
4297 "provide a hint for every warnings",
4298 "Provide a hint for every warning",
4303 ** Flags for debugging
4307 FK_DEBUG, FK_NONE, valueFlag,
4310 "set maximum number of bugs detected before giving up",
4314 FK_DEBUG, FK_BOUNDS, plainFlag,
4315 "debugfcnconstraint",
4316 FLG_DEBUGFUNCTIONCONSTRAINT,
4317 "debug function constraints",
4318 "Perform buffer overflow checking even if the errors would be surpressed.",
4322 FK_DEBUG, FK_NONE, specialDebugFlag,
4325 "debug parsing", NULL,
4329 FK_DEBUG, FK_NONE, debugFlag,
4332 "do not delete temporary files", NULL,
4336 FK_DEBUG, FK_NONE, debugFlag,
4339 "do not pre-process input files", NULL,
4343 FK_DEBUG, FK_NONE, debugFlag,
4346 "display the source code location where a warning is produced", NULL,