]> andersk Git - splint.git/blame_incremental - src/flags.def
Fixed bug in makefile causing unnecessary remaking of cgrammar.c.
[splint.git] / src / flags.def
... / ...
CommitLineData
1/*;-*-C-*-;
2**
3** flags.def
4**
5** This file is used to generate the flag header files.
6**
7** Don't forget to regenerate flag_codes.gen. (lost the Makefile...bleech!)
8*/
9 /* spec idem global mode args */
10/*@-namechecks@*/
11/*@notfunction@*/
12# define modeFlag FALSE, FALSE, FALSE, TRUE, ARG_NONE
13/*@notfunction@*/
14# define plainFlag FALSE, FALSE, FALSE, FALSE, ARG_NONE
15/*@notfunction@*/
16# define specialFlag TRUE, FALSE, FALSE, FALSE, ARG_NONE
17/*@notfunction@*/
18# define plainSpecialFlag TRUE, FALSE, FALSE, FALSE, ARG_NONE
19/*@notfunction@*/
20# define idemSpecialFlag TRUE, TRUE, FALSE, FALSE, ARG_NONE
21/*@notfunction@*/
22# define valueFlag FALSE, FALSE, FALSE, FALSE, ARG_NUMBER
23
24/*@notfunction@*/
25# define charFlag FALSE, FALSE, FALSE, FALSE, ARG_CHAR
26
27/*@notfunction@*/
28# define modeValueFlag FALSE, FALSE, FALSE, TRUE, ARG_NUMBER
29/*@notfunction@*/
30# define specialValueFlag TRUE, FALSE, FALSE, FALSE, ARG_NUMBER
31/*@notfunction@*/
32# define debugFlag FALSE, TRUE, FALSE, FALSE, ARG_NONE
33/*@notfunction@*/
34# define debugValueFlag FALSE, TRUE, FALSE, FALSE, ARG_NUMBER
35/*@notfunction@*/
36# define specialDebugFlag TRUE, TRUE, FALSE, FALSE, ARG_NONE
37/*@notfunction@*/
38# define globalFlag FALSE, FALSE, TRUE, FALSE, ARG_NONE
39/*@notfunction@*/
40# define idemGlobalFlag FALSE, TRUE, TRUE, FALSE, ARG_NONE
41/*@notfunction@*/
42# define globalValueFlag FALSE, FALSE, TRUE, FALSE, ARG_NUMBER
43
44/* Note: type argument missing */
45/*@notfunction@*/
46# define regStringFlag FALSE, FALSE, FALSE, FALSE
47/*@notfunction@*/
48# define idemStringFlag FALSE, TRUE, FALSE, FALSE
49/*@notfunction@*/
50# define globalStringFlag FALSE, FALSE, TRUE, FALSE
51
52/*@notfunction@*/
53# define extraArgFlag FALSE, FALSE, FALSE, FALSE, ARG_SPECIAL
54/*@notfunction@*/
55# define globalExtraArgFlag FALSE, FALSE, TRUE, FALSE, ARG_SPECIAL
56/*@notfunction@*/
57# define globalFileFlag FALSE, FALSE, TRUE, FALSE, ARG_FILE
58/*@=namechecks@*/
59
60/*
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
63** the lines.
64*/
65
66static flaglist flags =
67{
68 /*
69 ** Null Dereferences (Manual Section 2)
70 */
71
72 {
73 FK_NULL, FK_MEMORY, specialFlag,
74 "null",
75 FLG_NULL,
76 "misuses of null pointer",
77 "A possibly null pointer is misused (sets nullderef, nullpass, "
78 "nullref, nullassign, and nullstate).",
79 0, 0
80 },
81 {
82 FK_NULL, FK_MEMORY, modeFlag,
83 "nullderef",
84 FLG_NULLDEREF,
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 "
90 "null qualifier.",
91 0, 0
92 },
93 {
94 FK_NULL, FK_MEMORY, modeFlag,
95 "nullpass",
96 FLG_NULLPASS,
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.",
102 0, 0
103 },
104 {
105 FK_NULL, FK_MEMORY, modeFlag,
106 "nullret",
107 FLG_NULLRET,
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.",
113 0, 0
114 },
115 {
116 FK_NULL, FK_MEMORY, modeFlag,
117 "nullstate",
118 FLG_NULLSTATE,
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.",
122 0, 0
123 },
124 {
125 FK_NULL, FK_MEMORY, modeFlag,
126 "nullassign",
127 FLG_NULLASSIGN,
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.",
132 0, 0
133 },
134
135 /*
136 ** Undefined Values (Section 3)
137 */
138
139 {
140 FK_DEF, FK_NONE, modeFlag,
141 "usedef",
142 FLG_USEDEF,
143 "use before definition",
144 "An rvalue is used that may not be initialized to a value on some execution path.",
145 0, 0
146 },
147 {
148 FK_MEMORY, FK_DEF, modeFlag,
149 "mustdefine",
150 FLG_MUSTDEFINE,
151 "out storage not defined before return or scope exit",
152 "An out parameter or global is not defined before control is transferred.",
153 0, 0
154 },
155 {
156 FK_MEMORY, FK_DEF, modeFlag,
157 "uniondef",
158 FLG_UNIONDEF,
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.",
162 0, 0
163 },
164 {
165 FK_MEMORY, FK_DEF, modeFlag,
166 "compdef",
167 FLG_COMPDEF,
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.",
172 0, 0
173 },
174 {
175 FK_DEF, FK_NONE, plainFlag,
176 "fullinitblock",
177 FLG_FULLINITBLOCK,
178 "initializer sets all fields",
179 "Initializer does not set every field in the structure.",
180 0, 0
181 },
182 {
183 FK_DEF, FK_NONE, plainFlag,
184 "initallelements",
185 FLG_INITALLELEMENTS,
186 "initializer defines all array elements",
187 "Initializer does not define all elements of a declared array.",
188 0, 0
189 },
190 {
191 FK_DEF, FK_NONE, plainFlag,
192 "initsize",
193 FLG_INITSIZE,
194 "initializer defines extra array elements",
195 "Initializer block contains more elements than the size of a declared array.",
196 0, 0
197 },
198
199 {
200 FK_DEF, FK_IMPLICIT, modeFlag,
201 "impouts",
202 FLG_IMPOUTS,
203 "pointer parameters to unspecified functions may be implicit out parameters",
204 NULL, 0, 0
205 },
206
207 /*
208 ** Types (Section 4)
209 */
210
211 {
212 FK_DECL, FK_TYPE, modeFlag,
213 "incondefs",
214 FLG_INCONDEFS,
215 "function, variable or constant redefined with inconsistent type",
216 "A function, variable or constant is redefined with a different type.",
217 0, 0
218 },
219 {
220 FK_DECL, FK_TYPE, modeFlag,
221 "matchfields",
222 FLG_MATCHFIELDS,
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.",
225 0, 0
226 },
227 {
228 FK_TYPE, FK_NONE, modeFlag,
229 "fcnderef",
230 FLG_FCNDEREF,
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.",
235 0, 0
236 },
237 {
238 FK_OPS, FK_NONE, modeFlag,
239 "realcompare",
240 FLG_REALCOMPARE,
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.",
248 0, 0,
249 },
250 {
251 FK_OPS, FK_NONE, modeFlag,
252 "unsignedcompare",
253 FLG_UNSIGNEDCOMPARE,
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.",
256 0, 0,
257 },
258 {
259 FK_OPS, FK_POINTER, modeFlag,
260 "ptrarith",
261 FLG_POINTERARITH,
262 "arithmetic involving pointer and integer",
263 "Pointer arithmetic using pointer and integer.", 0, 0
264 },
265 {
266 FK_OPS, FK_POINTER, modeFlag,
267 "nullptrarith",
268 FLG_NULLPOINTERARITH,
269 "arithmetic involving possibly null pointer and integer",
270 "Pointer arithmetic using a possibly null pointer and integer.", 0, 0
271 },
272 {
273 FK_OPS, FK_POINTER, modeFlag,
274 "ptrcompare",
275 FLG_PTRNUMCOMPARE,
276 "comparison between pointer and number",
277 "A pointer is compared to a number.", 0, 0
278 },
279 {
280 FK_OPS, FK_TYPE, modeFlag,
281 "strictops",
282 FLG_STRICTOPS,
283 "primitive operation does not type check strictly",
284 "A primitive operation does not type check strictly.", 0, 0
285 },
286 {
287 FK_OPS, FK_TYPE, modeFlag,
288 "bitwisesigned",
289 FLG_BITWISEOPS,
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
294 },
295 {
296 FK_OPS, FK_TYPE, modeFlag,
297 "shiftnegative",
298 FLG_SHIFTNEGATIVE,
299 "a shift right operand may be negative",
300 "The right operand to a shift operator may be negative (behavior undefined).",
301 0, 0
302 },
303 {
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).",
309 0, 0
310 },
311 {
312 FK_OPS, FK_TYPE, modeFlag,
313 "sizeoftype",
314 FLG_SIZEOFTYPE,
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).)",
318 0, 0
319 },
320 {
321 FK_OPS, FK_TYPE, plainFlag,
322 "sizeofformalarray",
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.",
328 0, 0
329 },
330 {
331 FK_DECL, FK_TYPE, plainFlag,
332 "fixedformalarray",
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 "
337 "as a pointer.",
338 0, 0
339 },
340 {
341 FK_DECL, FK_TYPE, plainFlag,
342 "incompletetype",
343 FLG_INCOMPLETETYPE,
344 "formal parameter has an incomplete type",
345 "A formal parameter is declared with an incomplete type.",
346 0, 0
347 },
348 {
349 FK_DECL, FK_TYPE, plainFlag,
350 "formalarray",
351 FLG_FORMALARRAY,
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.",
355 0, 0
356 },
357
358
359 /*
360 ** Booleans (4.2)
361 */
362
363 {
364 FK_BOOL, FK_NONE, regStringFlag, ARG_STRING,
365 "booltype",
366 FLG_BOOLTYPE,
367 "set name of boolean type (default bool)",
368 NULL, 0, 0
369 },
370 {
371 FK_BOOL, FK_NONE, regStringFlag, ARG_STRING,
372 "boolfalse",
373 FLG_BOOLFALSE,
374 "set name of boolean false (default FALSE)",
375 NULL, 0, 0
376 },
377 {
378 FK_BOOL, FK_NONE, regStringFlag, ARG_STRING,
379 "booltrue",
380 FLG_BOOLTRUE,
381 "set name of boolean true (default TRUE)",
382 NULL, 0, 0
383 },
384 {
385 FK_BOOL, FK_HELP, plainFlag,
386 "likelybool",
387 FLG_LIKELYBOOL,
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.",
392 0, 0
393 },
394
395 {
396 FK_BOOL, FK_OPS, modeFlag,
397 "boolcompare",
398 FLG_BOOLCOMPARE,
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
405 },
406 {
407 FK_BOOL, FK_OPS, modeFlag,
408 "boolops",
409 FLG_BOOLOPS,
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.",
413 0, 0
414 },
415 {
416 FK_BOOL, FK_POINTER, modeFlag,
417 "ptrnegate",
418 FLG_PTRNEGATE,
419 "allow ! to be used on pointer operand",
420 "The operand of ! operator is a pointer.", 0, 0
421 },
422 {
423 FK_BOOL, FK_PRED,plainFlag,
424 "predassign",
425 FLG_PREDASSIGN,
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 "
430 "this message.",
431 0, 0
432 },
433 {
434 FK_BOOL, FK_PRED, specialFlag,
435 "predbool",
436 FLG_PREDBOOL,
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
440 },
441 {
442 FK_PRED, FK_BOOL, modeFlag,
443 "predboolint",
444 FLG_PREDBOOLINT,
445 "type of condition test (if, while or for) is an integral type",
446 "Test expression type is not boolean or int.", 0, 0
447 },
448 {
449 FK_BOOL, FK_PRED, modeFlag,
450 "predboolptr",
451 FLG_PREDBOOLPTR,
452 "type of condition test (if, while or for) is a pointer",
453 "Test expression type is not boolean.", 0, 0
454 },
455 {
456 FK_BOOL, FK_PRED, modeFlag,
457 "predboolothers",
458 FLG_PREDBOOLOTHERS,
459 "type of condition test (if, while or for) not bool, int or pointer",
460 "Test expression type is not boolean.", 0, 0
461 },
462
463 /*
464 ** 4.3 Abstract types
465 */
466
467 {
468 FK_ABSTRACT, FK_NONE, plainFlag,
469 "abstract",
470 FLG_ABSTRACT,
471 "data abstraction barriers",
472 "An abstraction barrier is broken. If necessary, use /*@access <type>@*/ to allow access to an abstract type.",
473 0, 0
474 },
475 {
476 FK_ABSTRACT, FK_IMPLICIT, plainFlag,
477 "impabstract",
478 FLG_IMPABSTRACT,
479 "assume user type definitions are abstract (unless /*@concrete@*/ is used)",
480 NULL,
481 0, 0
482 },
483
484 /* 4.3.1 Access */
485
486 {
487 FK_ABSTRACT, FK_NAMES, plainFlag,
488 "accessmodule",
489 FLG_ACCESSMODULE,
490 "allow access to abstract types in definition module",
491 "The representation of an abstract type defined in <M>.<x> is "
492 "accessible anywhere in a file named <M>.<y>.",
493 0, 0
494 },
495 {
496 FK_ABSTRACT, FK_NAMES, plainFlag,
497 "accessfile",
498 FLG_ACCESSFILE,
499 "allow access to abstract types by file name convention",
500 "The representation of an abstract type named <t> is "
501 "accessible anywhere in a file named <t>.<x>.",
502 0, 0
503 },
504 {
505 FK_ABSTRACT, FK_NAMES, plainFlag,
506 "accessczech",
507 FLG_ACCESSCZECH,
508 "allow access to abstract types by czech naming convention",
509 "The representation of an abstract type named <t> is accessible "
510 "in the definition of a function or constant named <t>_<name>",
511 0, 0
512 },
513 {
514 FK_ABSTRACT, FK_NAMES, plainFlag,
515 "accessslovak",
516 FLG_ACCESSSLOVAK,
517 "allow access to abstract types by slovak naming convention",
518 "The representation of an abstract type named <t> is accessible "
519 "in the definition of a function or constant named <t><Name>",
520 0, 0
521 },
522 {
523 FK_ABSTRACT, FK_NAMES, plainFlag,
524 "accessczechoslovak",
525 FLG_ACCESSCZECHOSLOVAK,
526 "allow access to abstract types by czechoslovak naming convention",
527 "The representation of an abstract type named <t> is accessible "
528 "in the definition of a function or constant named <t>_<name> or <t><Name>",
529 0, 0
530 },
531 {
532 FK_ABSTRACT, FK_NAMES, specialFlag,
533 "accessall",
534 FLG_ACCESSALL,
535 "set accessmodule, accessfile and accessczech",
536 "Sets accessmodule, accessfile and accessczech",
537 0, 0
538 },
539
540 /* 4.3.2 Mutability */
541 {
542 FK_ABSTRACT, FK_NONE, modeFlag,
543 "mutrep",
544 FLG_MUTREP,
545 "representation of mutable type has sharing semantics",
546 "LCL semantics requires that a mutable type exhibits sharing semantics. "
547 "In order for objects to be shared a indirection is necessary in the representation. "
548 "A mutable type may be represented by a pointer or an abstract mutable type. Handles "
549 "into static data are fine, too, but will generate this error message unless it is suppressed.",
550 0, 0
551 },
552
553
554 /*
555 ** Memory Management (5)
556 */
557
558 /* Deallocation Errors */
559 {
560 FK_MEMORY, FK_LEAK, modeFlag,
561 "mustfreefresh",
562 FLG_MUSTFREEFRESH,
563 "freshly allocated storage not released before return or scope exit",
564 "A memory leak has been detected. Storage allocated locally "
565 "is not released before the last reference to it is lost.",
566 0, 0
567 },
568 {
569 FK_MEMORY, FK_LEAK, modeFlag,
570 "mustfreeonly",
571 FLG_MUSTFREEONLY,
572 "only storage not released before return or scope exit",
573 "A memory leak has been detected. Only-qualified storage is not released before the last "
574 "reference to it is lost.",
575 0, 0
576 },
577 {
578 FK_MEMORY, FK_LEAK, specialFlag,
579 "mustfree",
580 FLG_MUSTFREE,
581 "fresh or only storage not released before return or scope exit (sets mustfreefresh and mustfreeonly)",
582 "A memory leak has been detected.",
583 0, 0
584 },
585 {
586 FK_MEMORY, FK_DEAD, modeFlag,
587 "usereleased",
588 FLG_USERELEASED,
589 "storage used after release",
590 "Memory is used after it has been released (either by passing "
591 "as an only param or assigning to an only global).",
592 0, 0
593 },
594 {
595 FK_MEMORY, FK_DEAD, modeFlag,
596 "strictusereleased",
597 FLG_STRICTUSERELEASED,
598 "element used after it may have been released",
599 "Memory (through fetch) is used after it may have been released "
600 "(either by passing as an only param or assigning to an only global).",
601 0, 0
602 },
603 {
604 FK_MEMORY, FK_LEAK, modeFlag,
605 "compdestroy",
606 FLG_COMPDESTROY,
607 "all only references derivable from void pointer out only parameter are released",
608 "A storage leak due to incomplete deallocation of a structure or deep "
609 "pointer is suspected. Unshared storage that is reachable from "
610 "a reference that is being deallocated has not yet been deallocated. "
611 "Splint assumes when an object is passed "
612 "as an out only void pointer that the outer object will be "
613 "deallocated, but the inner objects will not.",
614 0, 0
615 },
616 {
617 FK_MEMORY, FK_LEAK, modeFlag,
618 "strictdestroy",
619 FLG_STRICTDESTROY,
620 "report complete destruction errors for array elements that "
621 "may have been released",
622 NULL,
623 0, 0
624 },
625 {
626 FK_MEMORY, FK_ARRAY, modeFlag,
627 "deparrays",
628 FLG_DEPARRAYS,
629 "array elements are dependent storage",
630 "When an element is fetched from an array, Splint analysis is "
631 "not able to determine if the same element is reused. "
632 "If +deparrays, Splint will mark local storage assigned from "
633 "array fetches as dependent.",
634 0, 0
635 },
636 {
637 FK_MEMORY, FK_NONE, modeFlag,
638 "branchstate",
639 FLG_BRANCHSTATE,
640 "storage has inconsistent states of alternate paths through a branch",
641 "The state of a variable is different depending on which branch "
642 "is taken. This means no annotation can sensibly be applied "
643 "to the storage.",
644 0, 0
645 },
646 {
647 FK_MEMORY, FK_NONE, modeFlag,
648 "strictbranchstate",
649 FLG_STRICTBRANCHSTATE,
650 "storage through array fetch has inconsistent states of alternate "
651 "paths through a branch",
652 "The state of a variable through an array fetch is different depending "
653 "on which branch is taken. This means no annotation can sensibly be applied "
654 "to the storage.",
655 0, 0
656 },
657 {
658 FK_MEMORY, FK_NONE, specialFlag,
659 "memchecks",
660 FLG_MEMCHECKS,
661 "sets all dynamic memory checking flags (memimplicit, mustfree, mustdefine, "
662 "mustnotalias, null, memtrans)",
663 NULL, 0, 0
664 },
665 {
666 FK_MEMORY, FK_DEF, modeFlag,
667 "compmempass",
668 FLG_COMPMEMPASS,
669 "actual parameter matches alias kind of formal parameter completely ",
670 "Storage derivable from a parameter does not match the alias kind "
671 "expected for the formal parameter.",
672 0, 0
673 },
674 {
675 FK_MEMORY, FK_DEAD, modeFlag,
676 "stackref",
677 FLG_RETSTACK,
678 "external reference to stack-allocated storage is created",
679 "A stack reference is pointed to by an external reference when the "
680 "function returns. The stack-allocated storage is destroyed "
681 "after the call, leaving a dangling reference.",
682 0, 0
683 },
684
685 {
686 FK_MEMORY, FK_NONE, specialFlag,
687 "memtrans",
688 FLG_MEMTRANS,
689 "memory transfer errors (sets all *trans flags)",
690 "Memory is transferred in a way that violates annotations.",
691 0, 0
692 },
693 {
694 FK_MEMORY, FK_NONE, modeFlag,
695 "dependenttrans",
696 FLG_DEPENDENTTRANS,
697 "dependent transfer errors",
698 "Dependent storage is transferred to a non-dependent reference.",
699 0, 0
700 },
701 {
702 FK_MEMORY, FK_NONE, modeFlag,
703 "newreftrans",
704 FLG_NEWREFTRANS,
705 "new reference transfer to reference counted reference",
706 "A new reference is transferred to a reference counted reference.",
707 0, 0
708 },
709 {
710 FK_MEMORY, FK_NONE, modeFlag,
711 "onlytrans",
712 FLG_ONLYTRANS,
713 "only storage transferred to non-only reference (memory leak)",
714 "The only reference to this storage is transferred to another "
715 "reference (e.g., by returning it) that does not have the "
716 "only annotation. This may lead to a memory leak, since the "
717 "new reference is not necessarily released.",
718 0, 0
719 },
720 {
721 FK_MEMORY, FK_NONE, modeFlag,
722 "onlyunqglobaltrans",
723 FLG_ONLYUNQGLOBALTRANS,
724 "only storage transferred to an unqualified global or "
725 "static reference (memory leak)",
726 "The only reference to this storage is transferred to another "
727 "reference that does not have an aliasing annotation. "
728 "This may lead to a memory leak, since the "
729 "new reference is not necessarily released.",
730 0, 0
731 },
732 {
733 FK_MEMORY, FK_NONE, modeFlag,
734 "ownedtrans",
735 FLG_OWNEDTRANS,
736 "owned storage transferred to non-owned reference (memory leak)",
737 "The owned reference to this storage is transferred to another "
738 "reference (e.g., by returning it) that does not have the "
739 "owned annotation. This may lead to a memory leak, since the "
740 "new reference is not necessarily released.",
741 0, 0
742 },
743 {
744 FK_MEMORY, FK_NONE, modeFlag,
745 "freshtrans",
746 FLG_FRESHTRANS,
747 "fresh storage transferred to non-only reference (memory leak)",
748 "Fresh storage (newly allocated in this function) is transferred "
749 "in a way that the obligation to release storage is not "
750 "propagated. Use the /*@only@*/ annotation to indicate "
751 "the a return value is the only reference to the returned "
752 "storage.",
753 0, 0
754 },
755 {
756 FK_MEMORY, FK_NONE, modeFlag,
757 "sharedtrans",
758 FLG_SHAREDTRANS,
759 "shared storage transferred to non-shared reference",
760 "Shared storage is transferred to a non-shared reference. The other "
761 "reference may release storage needed by this reference.",
762 0, 0
763 },
764 {
765 FK_MEMORY, FK_NONE, modeFlag,
766 "temptrans",
767 FLG_TEMPTRANS,
768 "temp storage transferred to non-temporary reference",
769 "Temp storage (associated with a formal parameter) is transferred "
770 "to a non-temporary reference. The storage may be released "
771 "or new aliases created.",
772 0, 0
773 },
774 {
775 FK_MEMORY, FK_NONE, modeFlag,
776 "kepttrans",
777 FLG_KEPTTRANS,
778 "kept storage transferred to non-temporary reference",
779 "storage is transferred "
780 "to a non-temporary reference after being passed as keep parameter. The storage may be released "
781 "or new aliases created.",
782 0, 0
783 },
784 {
785 FK_MEMORY, FK_NONE, modeFlag,
786 "keeptrans",
787 FLG_KEEPTRANS,
788 "keep storage transferred inconsistently",
789 "Keep storage is transferred inconsistently --- either in a way "
790 "that may add a new alias to it, or release it.",
791 0, 0
792 },
793 {
794 FK_MEMORY, FK_NONE, modeFlag,
795 "immediatetrans",
796 FLG_IMMEDIATETRANS,
797 "an immediate address (result of &) is transferred inconsistently",
798 "An immediate address (result of & operator) is transferred "
799 "inconsistently.",
800 0, 0
801 },
802 {
803 FK_MEMORY, FK_NONE, modeFlag,
804 "refcounttrans",
805 FLG_REFCOUNTTRANS,
806 "reference counted storage is transferred in an inconsistent way",
807 "Reference counted storage is transferred in a way that may not "
808 "be consistent with the reference count.",
809 0, 0
810 },
811 {
812 FK_MEMORY, FK_NONE, modeFlag,
813 "statictrans",
814 FLG_STATICTRANS,
815 "static storage is transferred in an inconsistent way",
816 "Static storage is transferred in an inconsistent way.",
817 0, 0
818 },
819 {
820 FK_MEMORY, FK_NONE, modeFlag,
821 "unqualifiedtrans",
822 FLG_UNKNOWNTRANS,
823 "unqualified storage is transferred in an inconsistent way",
824 "Unqualified storage is transferred in an inconsistent way.",
825 0, 0
826 },
827 {
828 FK_MEMORY, FK_NONE, modeFlag,
829 "staticinittrans",
830 FLG_STATICINITTRANS,
831 "static storage is used as an initial value in an inconsistent way",
832 "Static storage is used as an initial value in an inconsistent way.",
833 0, 0
834 },
835 {
836 FK_MEMORY, FK_NONE, modeFlag,
837 "unqualifiedinittrans",
838 FLG_UNKNOWNINITTRANS,
839 "unqualified storage is used as an initial value in an inconsistent way",
840 "Unqualified storage is used as an initial value in an inconsistent way.",
841 0, 0
842 },
843 {
844 FK_MEMORY, FK_NONE, modeFlag,
845 "readonlytrans",
846 FLG_READONLYTRANS,
847 "report memory transfer errors for initializations to read-only string literals",
848 "A read-only string literal is assigned to a non-observer reference.",
849 0, 0
850 },
851 {
852 FK_MEMORY, FK_PARAMS, modeFlag,
853 "passunknown",
854 FLG_PASSUNKNOWN,
855 "passing a value as an un-annotated parameter clears its annotation",
856 NULL, 0, 0
857 },
858
859 /* 5.3 Implicit Memory Annotations */
860
861 {
862 FK_MEMORY, FK_NONE, modeFlag,
863 "readonlystrings",
864 FLG_READONLYSTRINGS,
865 "string literals are read-only (error if one is modified or released)",
866 "String literals are read-only. An error is reported "
867 "if a string literal may be modified or released.",
868 0, 0
869 },
870 {
871 FK_MEMORY, FK_IMPLICIT, modeFlag,
872 "memimp",
873 FLG_MEMIMPLICIT,
874 "memory errors for unqualified storage",
875 NULL, 0, 0
876 },
877 {
878 FK_MEMORY, FK_IMPLICIT, plainFlag,
879 "paramimptemp",
880 FLG_PARAMIMPTEMP,
881 "assume unannotated parameter is temp",
882 NULL, 0, 0
883 },
884 {
885 FK_MEMORY, FK_IMPLICIT, specialFlag,
886 "allimponly",
887 FLG_ALLIMPONLY,
888 "sets globimponly, retimponly, structimponly, specglobimponly, "
889 "specretimponly and specstructimponly",
890 NULL, 0, 0
891 },
892 {
893 FK_MEMORY, FK_IMPLICIT, specialFlag,
894 "codeimponly",
895 FLG_CODEIMPONLY,
896 "sets globimponly, retimponly and structimponly",
897 NULL, 0, 0
898 },
899 {
900 FK_MEMORY, FK_IMPLICIT, specialFlag,
901 "specimponly",
902 FLG_SPECALLIMPONLY,
903 "sets specglobimponly, specretimponly and specstructimponly",
904 NULL, 0, 0
905 },
906 {
907 FK_MEMORY, FK_IMPLICIT, plainFlag,
908 "globimponly",
909 FLG_GLOBIMPONLY,
910 "assume unannotated global storage is only",
911 NULL, 0, 0
912 },
913 {
914 FK_MEMORY, FK_IMPLICIT, plainFlag,
915 "retimponly",
916 FLG_RETIMPONLY,
917 "assume unannotated returned storage is only",
918 NULL, 0, 0
919 },
920 {
921 FK_MEMORY, FK_IMPLICIT, plainFlag,
922 "structimponly",
923 FLG_STRUCTIMPONLY,
924 "assume unannotated structure field is only",
925 NULL, 0, 0
926 },
927 {
928 FK_MEMORY, FK_IMPLICIT, plainFlag,
929 "specglobimponly",
930 FLG_SPECGLOBIMPONLY,
931 "assume unannotated global storage is only",
932 NULL, 0, 0
933 },
934 {
935 FK_MEMORY, FK_IMPLICIT, plainFlag,
936 "specretimponly",
937 FLG_SPECRETIMPONLY,
938 "assume unannotated returned storage is only",
939 NULL, 0, 0
940 },
941 {
942 FK_MEMORY, FK_IMPLICIT, plainFlag,
943 "specstructimponly",
944 FLG_SPECSTRUCTIMPONLY,
945 "assume unannotated structure field is only",
946 NULL, 0, 0
947 },
948
949 /* Reference Counting */
950
951
952
953 /*
954 ** 6. Sharing
955 */
956
957 /* 6.1 Aliasing warnings */
958
959 {
960 FK_ALIAS, FK_MEMORY, modeFlag,
961 "aliasunique",
962 FLG_ALIASUNIQUE,
963 "unique parameter is aliased",
964 "A unique or only parameter is aliased by some other parameter or visible global.",
965 0, 0
966 },
967 {
968 FK_ALIAS, FK_MEMORY, modeFlag,
969 "mayaliasunique",
970 FLG_MAYALIASUNIQUE,
971 "unique parameter may be aliased",
972 "A unique or only parameter may be aliased by some other parameter or visible global.",
973 0, 0
974 },
975 {
976 FK_ALIAS, FK_MEMORY, modeFlag,
977 "mustnotalias",
978 FLG_MUSTNOTALIAS,
979 "temp storage aliased at return point or scope exit",
980 "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.",
981 0, 0
982 },
983 {
984 FK_ALIAS, FK_NONE, modeFlag,
985 "retalias",
986 FLG_RETALIAS,
987 "function returns alias to parameter or global",
988 "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
989 },
990
991 /* Global aliasing */
992 {
993 FK_ALIAS, FK_GLOBALS, specialFlag,
994 "globalias",
995 FLG_GLOBALIAS,
996 "function returns with global aliasing external state (sets "
997 "checkstrictglobalias, checkedglobalias, checkmodglobalias and "
998 "uncheckedglobalias)",
999 "A global variable aliases externally-visible state when the function returns.",
1000 0, 0
1001 },
1002 {
1003 FK_ALIAS, FK_GLOBALS, modeFlag,
1004 "checkstrictglobalias",
1005 FLG_CHECKSTRICTGLOBALIAS,
1006 "function returns with a checkstrict global aliasing external state",
1007 "A global variable aliases externally-visible state when the function returns.",
1008 0, 0
1009 },
1010 {
1011 FK_ALIAS, FK_GLOBALS, modeFlag,
1012 "checkedglobalias",
1013 FLG_CHECKEDGLOBALIAS,
1014 "function returns with a checked global aliasing external state",
1015 "A global variable aliases externally-visible state when the function returns.",
1016 0, 0
1017 },
1018 {
1019 FK_ALIAS, FK_GLOBALS, modeFlag,
1020 "checkmodglobalias",
1021 FLG_CHECKMODGLOBALIAS,
1022 "function returns with a checkmod global aliasing external state",
1023 "A global variable aliases externally-visible state when the function returns.",
1024 0, 0
1025 },
1026 {
1027 FK_ALIAS, FK_GLOBALS, modeFlag,
1028 "uncheckedglobalias",
1029 FLG_UNCHECKEDGLOBALIAS,
1030 "function returns with an unchecked global aliasing external state",
1031 "A global variable aliases externally-visible state when the function returns.",
1032 0, 0
1033 },
1034
1035 /* 6.2 Exposure */
1036
1037 {
1038 FK_MEMORY, FK_NONE, modeFlag,
1039 "exposetrans",
1040 FLG_EXPOSETRANS,
1041 "exposure transfer errors",
1042 "Exposed storage is transferred to a non-exposed, non-observer reference.",
1043 0, 0
1044 },
1045 {
1046 FK_MEMORY, FK_NONE, modeFlag,
1047 "observertrans",
1048 FLG_OBSERVERTRANS,
1049 "observer transfer errors",
1050 "Observer storage is transferred to a non-observer reference.",
1051 0, 0
1052 },
1053 {
1054 FK_EXPOSURE, FK_ABSTRACT, specialFlag,
1055 "repexpose",
1056 FLG_REPEXPOSE,
1057 "abstract representation is exposed (sets assignexpose, retexpose, and castexpose)",
1058 "The internal representation of an abstract type is visible to the "
1059 "caller. This means clients may have access to a pointer "
1060 "into the abstract representation.",
1061 0, 0
1062 },
1063 {
1064 FK_EXPOSURE, FK_ABSTRACT, modeFlag,
1065 "retexpose",
1066 FLG_RETEXPOSE,
1067 "abstract representation is exposed (return values only)",
1068 "The return value shares storage with an instance of an abstract "
1069 "type. This means clients may have access to a pointer into "
1070 "the abstract representation. Use the observer qualifier to "
1071 "return exposed storage that may not be modified by the "
1072 "client. Use the exposed qualifier to return modifiable "
1073 "(but not deallocatable) exposed storage (dangerous).",
1074 0, 0
1075 },
1076 {
1077 FK_EXPOSURE, FK_ABSTRACT, modeFlag,
1078 "assignexpose",
1079 FLG_ASSIGNEXPOSE,
1080 "abstract representation is exposed (assignments only)",
1081 "Storage internal to the representation of an abstract type is "
1082 "assigned to an external pointer. This means clients may "
1083 "have access to a pointer into the abstract representation. "
1084 "If the external pointer is a parameter, the exposed qualifier "
1085 "can be used to allow the assignment, however, this is "
1086 "considered dangerous programming practice.",
1087 0, 0
1088 },
1089 {
1090 FK_EXPOSURE, FK_ABSTRACT, modeFlag,
1091 "castexpose",
1092 FLG_CASTEXPOSE,
1093 "abstract representation is exposed through a cast",
1094 "Storage internal to the representation of an abstract type is exposed "
1095 "through a type cast. This means clients may have access to a "
1096 "pointer into the abstract representation.",
1097 0, 0
1098 },
1099 {
1100 FK_DECL, FK_TYPE, modeFlag,
1101 "redundantsharequal",
1102 FLG_REDUNDANTSHAREQUAL,
1103 "declaration uses observer qualifier that is always true",
1104 "A declaration of an immutable object uses a redundant observer qualifier.",
1105 0, 0
1106 } ,
1107 {
1108 FK_DECL, FK_TYPE, modeFlag,
1109 "misplacedsharequal",
1110 FLG_MISPLACEDSHAREQUAL,
1111 "declaration of unsharable storage uses sharing annotation",
1112 "A declaration of an unsharable object uses a sharing annotation.",
1113 0, 0
1114 } ,
1115
1116 /*
1117 ** 7. Function Interfaces
1118 */
1119
1120 /* 7.1 Modifications */
1121
1122 {
1123 FK_MODIFIES, FK_SPEC, plainFlag,
1124 "mods",
1125 FLG_MODIFIES,
1126 "unspecified modification of caller-visible state",
1127 "An externally-visible object is modified by a function, but not "
1128 "listed in its modifies clause.",
1129 0, 0
1130 },
1131 {
1132 FK_MODIFIES, FK_SPEC, modeFlag,
1133 "mustmod",
1134 FLG_MUSTMOD,
1135 "specified modification is not detected",
1136 "An object listed in the modifies clause is not modified by the "
1137 "implementation of the function. The modification may not "
1138 "be detected if it is done through a call to an unspecified "
1139 "function.",
1140 0, 0
1141 },
1142 {
1143 FK_MODIFIES, FK_MEMORY, plainFlag,
1144 "modobserver",
1145 FLG_MODOBSERVER,
1146 "possible modification of observer storage",
1147 "Storage declared with observer is possibly modified. Observer "
1148 "storage may not be modified.",
1149 0, 0
1150 },
1151 {
1152 FK_MODIFIES, FK_MEMORY, modeFlag,
1153 "modobserveruncon",
1154 FLG_MODOBSERVERUNCON,
1155 "possible modification of observer storage through unconstrained call",
1156 "Storage declared with observer may be modified through a call to an "
1157 "unconstrained function.",
1158 0, 0
1159 },
1160 {
1161 FK_MODIFIES, FK_MEMORY, modeFlag,
1162 "modinternalstrict",
1163 FLG_MODINTERNALSTRICT,
1164 "possible modification of internal storage through function call",
1165 "A function that modifies internalState is called from a function that "
1166 "does not list internalState in its modifies clause",
1167 0, 0
1168 },
1169 {
1170 FK_MODIFIES, FK_UNSPEC, modeFlag,
1171 "modfilesys",
1172 FLG_MODFILESYSTEM,
1173 "report undocumented file system modifications (applies to unspecified "
1174 "functions if modnomods is set)",
1175 NULL, 0, 0
1176 },
1177 {
1178 FK_MODIFIES, FK_UNSPEC, specialFlag,
1179 "modunspec",
1180 FLG_MODUNSPEC,
1181 "modification in unspecified functions (sets modnomods, "
1182 "modglobunspec and modstrictglobsunspec)",
1183 NULL, 0, 0
1184 },
1185 {
1186 FK_MODIFIES, FK_UNSPEC, modeFlag,
1187 "modnomods",
1188 FLG_MODNOMODS,
1189 "modification in a function with no modifies clause",
1190 "An externally-visible object is modified by a function with no "
1191 "/*@modifies@*/ comment. The /*@modifies ... @*/ control "
1192 "comment can be used to give a modifies list for an "
1193 "unspecified function.",
1194 0, 0
1195 },
1196 {
1197 FK_MODIFIES, FK_UNSPEC, modeFlag,
1198 "moduncon",
1199 FLG_MODUNCON,
1200 "possible modification through a call to an unconstrained function",
1201 "An unconstrained function is called in a function body where "
1202 "modifications are checked. Since the unconstrained function "
1203 "may modify anything, there may be undetected modifications in "
1204 "the checked function.",
1205 0, 0
1206 },
1207 {
1208 FK_MODIFIES, FK_UNSPEC, modeFlag,
1209 "modunconnomods",
1210 FLG_MODUNCONNOMODS,
1211 "possible modification through a call to an unconstrained function in "
1212 "a function with no modifies clause",
1213 "An unconstrained function is called in a function body where "
1214 "modifications are checked. Since the unconstrained function "
1215 "may modify anything, there may be undetected modifications in "
1216 "the checked function.",
1217 0, 0
1218 },
1219 {
1220 FK_MODIFIES, FK_GLOBALS, modeFlag,
1221 "globsimpmodsnothing",
1222 FLG_GLOBALSIMPMODIFIESNOTHING,
1223 "functions declared with a globals list but no modifies clause are "
1224 "assumed to modify nothing",
1225 "An implicit modifies nothing clause is assumed for a function "
1226 "declared with a globals list but not modifies clause.",
1227 0, 0
1228 },
1229 {
1230 FK_MODIFIES, FK_GLOBALS, modeFlag,
1231 "modsimpnoglobs",
1232 FLG_MODIFIESIMPNOGLOBALS,
1233 "functions declared with a modifies clause but no globals list "
1234 "are assumed to use no globals",
1235 "An implicit empty globals list is assumed for a function "
1236 "declared with a modifies clause but no globals list.",
1237 0, 0
1238 },
1239
1240 /*
1241 ** Globals
1242 */
1243
1244 {
1245 FK_GLOBALS, FK_NONE, modeFlag,
1246 "globstate",
1247 FLG_GLOBSTATE,
1248 "returns with global in inconsistent state (null or undefined)",
1249 "A global variable does not satisfy its annotations when control is transferred.",
1250 0, 0
1251 },
1252
1253 {
1254 FK_GLOBALS, FK_SPEC, plainFlag,
1255 "globs",
1256 FLG_GLOBALS,
1257 "undocumented use of a checked global variable",
1258 "A checked global variable is used in the function, but not listed in "
1259 "its globals clause. By default, only globals specified in .lcl "
1260 "files are checked. To check all globals, use +allglobals. To "
1261 "check globals selectively use /*@checked@*/ in the global "
1262 "declaration.",
1263 0, 0
1264 },
1265 {
1266 FK_GLOBALS, FK_SPEC, modeFlag,
1267 "globuse",
1268 FLG_USEALLGLOBS,
1269 "global listed for a function not used",
1270 "A global variable listed in the function's globals list is not used "
1271 "in the body of the function.",
1272 0, 0
1273 },
1274 {
1275 FK_GLOBALS, FK_NONE, modeFlag,
1276 "internalglobs",
1277 FLG_INTERNALGLOBS,
1278 "use of internalState",
1279 "A called function uses internal state, but the globals list for the "
1280 "function being checked does not include internalState",
1281 0, 0
1282 },
1283 {
1284 FK_GLOBALS, FK_NONE, modeFlag,
1285 "internalglobsnoglobs",
1286 FLG_INTERNALGLOBSNOGLOBS,
1287 "use of internalState (in function with no globals list)",
1288 "A called function uses internal state, but the function being checked "
1289 "has no globals list",
1290 0, 0
1291 },
1292 {
1293 FK_GLOBALS, FK_MODIFIES, modeFlag,
1294 "warnmissingglobs",
1295 FLG_WARNMISSINGGLOBALS,
1296 "global variable used in modifies clause is not listed in globals list",
1297 "A global variable is used in the modifies clause, but it is not listed in "
1298 "the globals list. The variable will be added to the globals list.",
1299 0, 0
1300 },
1301
1302 {
1303 FK_GLOBALS, FK_MODIFIES, modeFlag,
1304 "warnmissingglobsnoglobs",
1305 FLG_WARNMISSINGGLOBALSNOGLOBS,
1306 "global variable used in modifies clause in a function with no globals list",
1307 "A global variable is used in the modifies clause, but the function "
1308 "has no globals list. The variable will be added to the globals list.",
1309 0, 0
1310 },
1311 {
1312 FK_GLOBALS, FK_UNSPEC, modeFlag,
1313 "globnoglobs",
1314 FLG_GLOBUNSPEC,
1315 "use of checked global in a function with no globals list or specification",
1316 "A specified global variable is used in the function, but not listed "
1317 "in its globals list. Without +globnoglobs, only globals "
1318 "declared with /*@checkedstrict@*/ will produce use "
1319 "errors in functions without globals "
1320 "lists. The /*@globals ... @*/ control comment can be used to give "
1321 "a globals list for an unspecified function.",
1322 0, 0
1323 },
1324 {
1325 FK_GLOBALS, FK_IMPLICIT, modeFlag,
1326 "allglobs",
1327 FLG_ALLGLOBALS,
1328 "report use and modification errors for globals not annotated with unchecked",
1329 NULL, 0, 0
1330 },
1331 {
1332 FK_GLOBALS, FK_UNSPEC, modeFlag,
1333 "checkstrictglobs",
1334 FLG_CHECKSTRICTGLOBALS,
1335 "report use and modification errors for checkedstrict globals",
1336 NULL, 0, 0
1337 },
1338 {
1339 FK_GLOBALS, FK_UNSPEC, modeFlag,
1340 "impcheckedspecglobs",
1341 FLG_IMPCHECKEDSPECGLOBALS,
1342 "assume checked qualifier for unqualified global declarations in .lcl files",
1343 NULL, 0, 0
1344 },
1345 {
1346 FK_GLOBALS, FK_UNSPEC, modeFlag,
1347 "impcheckmodspecglobs",
1348 FLG_IMPCHECKMODSPECGLOBALS,
1349 "assume checkmod qualifier for unqualified global declarations in .lcl files",
1350 NULL, 0, 0
1351 },
1352 {
1353 FK_GLOBALS, FK_UNSPEC, modeFlag,
1354 "impcheckedstrictspecglobs",
1355 FLG_IMPCHECKEDSTRICTSPECGLOBALS,
1356 "assume checkmod qualifier for unqualified global declarations in .lcl files",
1357 NULL, 0, 0
1358 },
1359 {
1360 FK_GLOBALS, FK_UNSPEC, modeFlag,
1361 "impcheckedglobs",
1362 FLG_IMPCHECKEDGLOBALS,
1363 "assume checked qualifier for unqualified global declarations",
1364 NULL, 0, 0
1365 },
1366 {
1367 FK_GLOBALS, FK_UNSPEC, modeFlag,
1368 "impcheckmodglobs",
1369 FLG_IMPCHECKMODGLOBALS,
1370 "assume checkmod qualifier for unqualified global declarations",
1371 NULL, 0, 0
1372 },
1373 {
1374 FK_GLOBALS, FK_UNSPEC, modeFlag,
1375 "impcheckedstrictglobs",
1376 FLG_IMPCHECKEDSTRICTGLOBALS,
1377 "assume checkedstrict qualifier for unqualified global declarations",
1378 NULL, 0, 0
1379 },
1380 {
1381 FK_GLOBALS, FK_UNSPEC, modeFlag,
1382 "impcheckedstatics",
1383 FLG_IMPCHECKEDSTATICS,
1384 "assume checked qualifier for unqualified file static declarations",
1385 NULL, 0, 0
1386 },
1387 {
1388 FK_GLOBALS, FK_UNSPEC, modeFlag,
1389 "impcheckmodstatics",
1390 FLG_IMPCHECKMODSTATICS,
1391 "assume checkmod qualifier for unqualified file static declarations",
1392 NULL, 0, 0
1393 },
1394 {
1395 FK_GLOBALS, FK_UNSPEC, modeFlag,
1396 "impcheckmodinternals",
1397 FLG_IMPCHECKMODINTERNALS,
1398 "assume checkmod qualifier for unqualified local "
1399 "static declarations (for internal state modifications)",
1400 NULL, 0, 0
1401 },
1402 {
1403 FK_GLOBALS, FK_UNSPEC, modeFlag,
1404 "impcheckedstrictstatics",
1405 FLG_IMPCHECKEDSTRICTSTATICS,
1406 "assume checkedstrict qualifier for unqualified file static declarations",
1407 NULL, 0, 0
1408 },
1409 {
1410 FK_GLOBALS, FK_MODIFIES, modeFlag,
1411 "modglobs",
1412 FLG_MODGLOBS,
1413 "undocumented modification of a checked global variable",
1414 "A checked global variable is modified by the function, but not listed in "
1415 "its modifies clause.",
1416 0, 0
1417 },
1418 {
1419 FK_GLOBALS, FK_MODIFIES, modeFlag,
1420 "modglobsnomods",
1421 FLG_MODGLOBSUNSPEC,
1422 "undocumented modification of a checked global variable in a function "
1423 "declared with no modifies clause",
1424 "A checked global variable is modified by the function, but not listed in "
1425 "its modifies clause.",
1426 0, 0
1427 },
1428 {
1429 FK_GLOBALS, FK_MODIFIES, modeFlag,
1430 "modstrictglobsnomods",
1431 FLG_MODSTRICTGLOBSUNSPEC,
1432 "undocumented modification of a strict checked global variable in a "
1433 "function declared with no modifies clause",
1434 "A checked global variable is modified by the function, but not listed in "
1435 "its modifies clause.",
1436 0, 0
1437 },
1438 {
1439 FK_GLOBALS, FK_MODIFIES, modeFlag,
1440 "modglobsunchecked",
1441 FLG_MODGLOBSUNCHECKED,
1442 "undocumented modification of an unchecked checked global variable",
1443 "An unchecked global variable is modified by the function, but not listed in "
1444 "its modifies clause.",
1445 0, 0
1446 },
1447
1448 /*
1449 ** State Clauses
1450 */
1451
1452 /*
1453 ** 8. Control Flow
1454 */
1455
1456 /* 8.1 Execution */
1457
1458 {
1459 FK_CONTROL, FK_NONE, modeFlag,
1460 "noret",
1461 FLG_NORETURN,
1462 "path with no return detected in non-void function",
1463 "There is a path through a function declared to return a value on "
1464 "which there is no return statement. This means the execution "
1465 "may fall through without returning a meaningful result to "
1466 "the caller.",
1467 0, 0
1468 },
1469 {
1470 FK_CONTROL, FK_NONE, plainFlag,
1471 "emptyret",
1472 FLG_EMPTYRETURN,
1473 "empty return in function declared to return value",
1474 NULL,
1475 0, 0
1476 },
1477 {
1478 FK_CONTROL, FK_NONE, plainFlag,
1479 "alwaysexits",
1480 FLG_ALWAYSEXITS,
1481 "loop predicate always exits",
1482 NULL,
1483 0, 0
1484 },
1485
1486 {
1487 FK_CONTROL, FK_MEMORY, specialFlag,
1488 "loopexec",
1489 FLG_LOOPEXEC,
1490 "assume all loops execute at least once (sets forloopexec, whileloopexec and iterloopexec)",
1491 NULL, 0, 0
1492 },
1493 {
1494 FK_CONTROL, FK_MEMORY, plainFlag,
1495 "forloopexec",
1496 FLG_FORLOOPEXEC,
1497 "assume all for loops execute at least once",
1498 NULL, 0, 0
1499 },
1500 {
1501 FK_CONTROL, FK_MEMORY, plainFlag,
1502 "whileloopexec",
1503 FLG_WHILELOOPEXEC,
1504 "assume all while loops execute at least once",
1505 NULL, 0, 0
1506 },
1507 {
1508 FK_CONTROL, FK_MEMORY, plainFlag,
1509 "iterloopexec",
1510 FLG_ITERLOOPEXEC,
1511 "assume all iterator loops execute at least once",
1512 NULL, 0, 0
1513 },
1514 {
1515 FK_CONTROL, FK_MEMORY, plainFlag,
1516 "obviousloopexec",
1517 FLG_OBVIOUSLOOPEXEC,
1518 "assume loop that can be determined to always execute always does",
1519 NULL, 0, 0
1520 },
1521
1522 /* 8.2 Undefined Behavior */
1523
1524 {
1525 FK_BEHAVIOR, FK_ANSI, modeFlag,
1526 "evalorder",
1527 FLG_EVALORDER,
1528 "code has unspecified or implementation-dependent behavior "
1529 "because of order of evaluation",
1530 "Code has unspecified behavior. "
1531 "Order of evaluation of function parameters or subexpressions "
1532 "is not defined, so if a value is used and modified in different "
1533 "places not separated by a sequence point constraining "
1534 "evaluation order, then the result of the expression is "
1535 "unspecified.",
1536 0, 0
1537 },
1538 {
1539 FK_BEHAVIOR, FK_ANSI, modeFlag,
1540 "evalorderuncon",
1541 FLG_EVALORDERUNCON,
1542 "code involving call to unspecified function has undefined or implementation-dependent behavior",
1543 "Code involving a call to function with no modifies or globals clause "
1544 "may have undefined or implementation-dependent behavior (Splint assumes the "
1545 "unconstrained call may modify any reachable state or use any global). Add a "
1546 "specification for the function.",
1547 0, 0
1548 },
1549
1550 /* 8.3 Problematic Control Structures */
1551
1552 /* 8.3.1 Infinite Loops */
1553
1554 {
1555 FK_CONTROL, FK_NONE, modeFlag,
1556 "infloops",
1557 FLG_INFLOOPS,
1558 "likely infinite loop is detected",
1559 "This appears to be an infinite loop. Nothing in the body of the "
1560 "loop or the loop test modifies the value of the loop test. "
1561 "Perhaps the specification of a function called in the loop "
1562 "body is missing a modification.",
1563 0, 0
1564 },
1565 {
1566 FK_CONTROL, FK_NONE, modeFlag,
1567 "infloopsuncon",
1568 FLG_INFLOOPSUNCON,
1569 "likely infinite loop is detected (may result from unconstrained function)",
1570 "This appears to be an infinite loop. Nothing in the body of the "
1571 "loop or the loop test modifies the value of the loop test. "
1572 "There may be a modification through a call to an unconstrained "
1573 "function, or an unconstrained function in the loop test may use "
1574 "a global variable modified by the loop body.",
1575 0, 0
1576 },
1577
1578 /* 8.3.2 Switches */
1579
1580 {
1581 FK_CONTROL, FK_NONE, modeFlag,
1582 "casebreak",
1583 FLG_CASEBREAK,
1584 "non-empty case in a switch without preceding break",
1585 "Execution falls through from the previous case.", 0, 0
1586 },
1587 {
1588 FK_CONTROL, FK_NONE, modeFlag,
1589 "misscase",
1590 FLG_MISSCASE,
1591 "switch on enum type missing case for some value",
1592 "Not all values in an enumeration are present as cases in the switch.",
1593 0, 0
1594 },
1595 {
1596 FK_CONTROL, FK_NONE, modeFlag,
1597 "firstcase",
1598 FLG_FIRSTCASE,
1599 "first statement in switch is not a case",
1600 "The first statement after a switch is not a case.",
1601 0, 0
1602 },
1603 {
1604 FK_CONTROL, FK_NONE, plainFlag,
1605 "duplicatecases",
1606 FLG_DUPLICATECASES,
1607 "duplicate cases in switch",
1608 "Duplicate cases in switch.",
1609 0, 0
1610 },
1611
1612 /* 8.3.3 Deep Breaks */
1613
1614 {
1615 FK_CONTROL, FK_NONE, specialFlag,
1616 "deepbreak",
1617 FLG_DEEPBREAK,
1618 "break inside nested while or for or switch",
1619 "A break statement appears inside the body of a nested while, for or "
1620 "switch statement. Sets looploopbreak, loopswitchbreak, "
1621 "switchloopbreak, switchswitchbreak, and looploopcontinue.",
1622 0, 0
1623 },
1624 {
1625 FK_CONTROL, FK_NONE, modeFlag,
1626 "looploopbreak",
1627 FLG_LOOPLOOPBREAK,
1628 "break inside nested while or for",
1629 "A break statement appears inside the body of a nested while or for "
1630 "statement. This is perfectly reasonable code, but check that "
1631 "the break is intended to break only the inner loop. The "
1632 "break statement may be preceded by /*@innerbreak@*/ to suppress "
1633 "the message for this break only.",
1634 0, 0
1635 },
1636 {
1637 FK_CONTROL, FK_NONE, modeFlag,
1638 "switchloopbreak",
1639 FLG_SWITCHLOOPBREAK,
1640 "break in loop inside switch",
1641 "A break statement appears inside the body of a while or for "
1642 "statement within a switch. This is perfectly reasonable code, but check that "
1643 "the break is intended to break only the inner loop. The "
1644 "break statement may be preceded by /*@loopbreak@*/ to suppress "
1645 "the message for this break only.",
1646 0, 0
1647 },
1648 {
1649 FK_CONTROL, FK_NONE, modeFlag,
1650 "loopswitchbreak",
1651 FLG_LOOPSWITCHBREAK,
1652 "break in switch inside loop",
1653 "A break statement appears inside a switch statement within a while or "
1654 "for loop. 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 /*@switchbreak@*/ to suppress "
1657 "the message for this break only.",
1658 0, 0
1659 },
1660 {
1661 FK_CONTROL, FK_NONE, modeFlag,
1662 "switchswitchbreak",
1663 FLG_SWITCHSWITCHBREAK,
1664 "break in switch inside switch",
1665 "A break statement appears inside a switch statement within another "
1666 "switch statement. This is perfectly reasonable code, but check that "
1667 "the break is intended to break only the inner switch. The "
1668 "break statement may be preceded by /*@innerbreak@*/ to suppress "
1669 "the message for this break only.",
1670 0, 0
1671 },
1672 {
1673 FK_CONTROL, FK_NONE, modeFlag,
1674 "looploopcontinue",
1675 FLG_LOOPLOOPCONTINUE,
1676 "continue inside nested loop",
1677 "A continue statement appears inside a loop within a loop. "
1678 "This is perfectly reasonable code, but check that "
1679 "the continue is intended to continue only the inner loop. The "
1680 "continue statement may be preceded by /*@innercontinue@*/ to suppress "
1681 "the message for this continue only.",
1682 0, 0
1683 },
1684
1685 /* 8.3.4 Loop and If Bodies */
1686
1687 {
1688 FK_CONTROL, FK_NONE, modeFlag,
1689 "whileempty",
1690 FLG_WHILEEMPTY,
1691 "a while statement has no body",
1692 "While statement has no body.",
1693 0, 0
1694 },
1695 {
1696 FK_CONTROL, FK_NONE, modeFlag,
1697 "whileblock",
1698 FLG_WHILEBLOCK,
1699 "the body of a while statement is not a block",
1700 "While body is a single statement, not a compound block.",
1701 0, 0
1702 },
1703 {
1704 FK_CONTROL, FK_NONE, modeFlag,
1705 "forempty",
1706 FLG_FOREMPTY,
1707 "a for statement has no body",
1708 "For statement has no body.",
1709 0, 0
1710 },
1711 {
1712 FK_CONTROL, FK_NONE, modeFlag,
1713 "forblock",
1714 FLG_FORBLOCK,
1715 "the body of a for statement is not a block",
1716 "Loop body is a single statement, not a compound block.",
1717 0, 0
1718 },
1719 {
1720 FK_CONTROL, FK_NONE, modeFlag,
1721 "ifempty",
1722 FLG_IFEMPTY,
1723 "an if statement has no body",
1724 "If statement has no body.",
1725 0, 0
1726 },
1727 {
1728 FK_CONTROL, FK_NONE, modeFlag,
1729 "ifblock",
1730 FLG_IFBLOCK,
1731 "the body of an if statement is not a block",
1732 "If body is a single statement, not a compound block.",
1733 0, 0
1734 },
1735 {
1736 FK_CONTROL, FK_NONE, specialFlag,
1737 "allempty",
1738 FLG_ALLEMPTY,
1739 "an if, while or for statement has no body (sets ifempty, "
1740 "whileempty and forempty",
1741 NULL,
1742 0, 0
1743 },
1744 {
1745 FK_CONTROL, FK_NONE, specialFlag,
1746 "allblock",
1747 FLG_ALLBLOCK,
1748 "the body of an if, while or for statement is not a block "
1749 "(sets ifblock, whileblock and forblock)",
1750 "Body is a single statement, not a compound block.",
1751 0, 0
1752 },
1753
1754 /* 8.3.5 Complete Logic */
1755
1756 {
1757 FK_CONTROL, FK_NONE, modeFlag,
1758 "elseifcomplete",
1759 FLG_ELSEIFCOMPLETE,
1760 "if ... else if chains must have final else",
1761 "There is no final else following an else if construct.",
1762 0, 0
1763 },
1764
1765 /* 8.4 Suspicious Statements */
1766
1767 {
1768 FK_CONTROL, FK_NONE, modeFlag,
1769 "unreachable",
1770 FLG_UNREACHABLE,
1771 "unreachable code detected",
1772 "This code will never be reached on any possible execution.",
1773 0, 0
1774 },
1775
1776 /* 8.4.1 Statements with No Effects */
1777
1778 {
1779 FK_EFFECT, FK_CONTROL, modeFlag,
1780 "noeffect",
1781 FLG_NOEFFECT,
1782 "statement with no effect",
1783 "Statement has no visible effect --- no values are modified.",
1784 0, 0
1785 },
1786 {
1787 FK_EFFECT, FK_CONTROL, modeFlag,
1788 "noeffectuncon",
1789 FLG_NOEFFECTUNCON,
1790 "statement with no effect (except possibly through call to "
1791 "unconstrained function)",
1792 "Statement has no visible effect --- no values are modified. It may "
1793 "modify something through a call to an unconstrained function.",
1794 0, 0
1795 },
1796
1797 /* 8.4.2 Ignored Return Values */
1798
1799 {
1800 FK_IGNORERET, FK_NONE, specialFlag,
1801 "retval",
1802 FLG_RETVAL,
1803 "return value ignored (sets retvalint, retvalbool and retvalother)",
1804 "Result returned by function call is not used. If this is intended, "
1805 "cast result to (void) to eliminate message.",
1806 0, 0
1807 },
1808 {
1809 FK_IGNORERET, FK_BOOL, modeFlag,
1810 "retvalother",
1811 FLG_RETVALOTHER,
1812 "return value of type other than bool or int ignored",
1813 "Result returned by function call is not used. If this is intended, "
1814 "can cast result to (void) to eliminate message.",
1815 0, 0
1816 },
1817 {
1818 FK_IGNORERET, FK_BOOL, modeFlag,
1819 "retvalbool",
1820 FLG_RETVALBOOL,
1821 "return value of manifest type bool ignored",
1822 "Result returned by function call is not used. If this is intended, "
1823 "can cast result to (void) to eliminate message.",
1824 0, 0
1825 },
1826 {
1827 FK_IGNORERET, FK_NONE, modeFlag,
1828 "retvalint",
1829 FLG_RETVALINT,
1830 "return value of type int ignored",
1831 "Result returned by function call is not used. If this is intended, "
1832 "can cast result to (void) to eliminate message.",
1833 0, 0
1834 },
1835
1836 /*
1837 ** 9. Buffer Sizes
1838 */
1839
1840 {
1841 FK_BOUNDS, FK_MEMORY, modeFlag,
1842 "nullterminated",
1843 FLG_NULLTERMINATED,
1844 "misuse of nullterminated allocation",
1845 "A possibly non-nullterminated string/memory is used/referenced as a nullterminated one.",
1846 0, 0
1847 },
1848 {
1849 FK_BOUNDS, FK_MEMORY, specialFlag,
1850 "bounds",
1851 FLG_BOUNDS,
1852 "memory bounds checking (sets boundsread and boundswrite)",
1853 "Memory read or write may be out of bounds of allocated storage.", 0, 0
1854 },
1855 {
1856 FK_BOUNDS, FK_MEMORY, plainFlag,
1857 "boundsread",
1858 FLG_BOUNDSREAD,
1859 "possible out of bounds read",
1860 "A memory read references memory beyond the allocated storage.",
1861 0, 0
1862 },
1863 {
1864 FK_BOUNDS, FK_MEMORY, plainFlag,
1865 "boundswrite",
1866 FLG_BOUNDSWRITE,
1867 "possible buffer overflow from an out of bounds write",
1868 "A memory write may write to an address beyond the allocated buffer.",
1869 0, 0
1870 },
1871
1872 {
1873 FK_BOUNDS, FK_DISPLAY, plainFlag,
1874 "fcnpost",
1875 FLG_FUNCTIONPOST,
1876 "display function post conditions",
1877 "Display function post conditions.",
1878 0, 0
1879 },
1880 {
1881 FK_BOUNDS, FK_DISPLAY, plainFlag,
1882 "redundantconstraints",
1883 FLG_REDUNDANTCONSTRAINTS,
1884 "display seemingly redundant constraints",
1885 "Display seemingly redundant constraints",
1886 0, 0
1887 },
1888 /*drl7x added 6/18/01 */
1889 {
1890 FK_BOUNDS, FK_MEMORY, modeFlag,
1891 "checkpost",
1892 FLG_CHECKPOST,
1893 "unable to verify predicate in ensures clause",
1894 "The function implementation may not satisfy a post condition given in an ensures clause.",
1895 0, 0
1896 },
1897
1898 {
1899 FK_BOUNDS, FK_MEMORY, plainFlag,
1900 "implictconstraint",
1901 FLG_IMPLICTCONSTRAINT,
1902 "generate implicit constraints for functions",
1903 NULL,
1904 0, 0
1905 },
1906 /*drl7x added 4/29/01 */
1907 {
1908 FK_BOUNDS, FK_MEMORY, plainFlag,
1909 "orconstraint",
1910 FLG_ORCONSTRAINT,
1911 "use limited OR expressions to resolve constraints",
1912 NULL,
1913 0, 0
1914 },
1915
1916 {
1917 FK_BOUNDS, FK_MEMORY, plainFlag,
1918 "nullterminated",
1919 FLG_NULLTERMINATEDWARNING,
1920 "misuse of nullterminated allocation",
1921 "A user annotated non-nullterminated buffer is used/referenced as a nullterminated one.",
1922 0, 0
1923 },
1924
1925 {
1926 FK_BOUNDS, FK_DISPLAY, plainFlag,
1927 "showconstraintparens",
1928 FLG_PARENCONSTRAINT,
1929 "display parentheses around constraint terms",
1930 NULL,
1931 0, 0
1932 },
1933 /*drl added 2/4/2002*/
1934 {
1935 FK_BOUNDS, FK_DISPLAY, plainFlag,
1936 "boundscompacterrormessages",
1937 FLG_BOUNDSCOMPACTERRORMESSAGES,
1938 "Display fewer new lines in bounds checking error messages",
1939 NULL,
1940 0, 0
1941 },
1942 {
1943 FK_BOUNDS, FK_DISPLAY, plainFlag,
1944 "showconstraintlocation",
1945 FLG_CONSTRAINTLOCATION,
1946 "display location for every constraint generated",
1947 NULL,
1948 0, 0
1949 }, /*drl added flag 4/26/01*/
1950
1951 /*
1952 ** 10. Extensible Checking
1953 */
1954
1955 {
1956 FK_EXTENSIBLE, FK_FILES, globalStringFlag, ARG_FILE,
1957 "mts",
1958 FLG_MTSFILE,
1959 "load meta state declaration and corresponding xh file",
1960 NULL, 0, 0
1961 },
1962 {
1963 FK_EXTENSIBLE, FK_MEMORY, modeFlag,
1964 "statetransfer",
1965 FLG_STATETRANSFER,
1966 "storage has been transfered with invalid state",
1967 "Transfer violates user-defined state rules.",
1968 0, 0
1969 },
1970 {
1971 FK_EXTENSIBLE, FK_MEMORY, modeFlag,
1972 "statemerge",
1973 FLG_STATEMERGE,
1974 "control paths merge with storage in incompatible states",
1975 "Control path merge violates user-defined state merge rules.",
1976 0, 0
1977 },
1978
1979 /*
1980 ** 11. Macros
1981 */
1982
1983 {
1984 FK_MACROS, FK_NONE, modeFlag,
1985 "macroredef",
1986 FLG_MACROREDEF,
1987 "macro redefined",
1988 "A macro is defined in more than one place.", 0, 0
1989 },
1990 {
1991 FK_MACROS, FK_UNRECOG, modeFlag,
1992 "macrounrecog",
1993 FLG_MACROUNDEF,
1994 "unrecognized identifier in macro",
1995 "An unrecognized identifier appears in a macro. If the identifier "
1996 "is defined before the macro is used, then this is okay.",
1997 0, 0
1998 },
1999
2000 /* 11.1 Constant Macros */
2001
2002 {
2003 FK_MACROS, FK_PROTOS, modeFlag,
2004 "macroconstdecl",
2005 FLG_MACROCONSTDECL,
2006 "non-parameterized macro without prototype or specification",
2007 "Macro constant has no declaration. Use /*@constant ...@*/ to "
2008 "declare the macro.",
2009 0, 0
2010 },
2011
2012 /* 11.2 Function-like Macros */
2013
2014 {
2015 FK_MACROS, FK_NONE, modeFlag,
2016 "macrostmt",
2017 FLG_MACROSTMT,
2018 "macro definition is syntactically not equivalent to function",
2019 "A macro is defined in a way that may cause syntactic problems. "
2020 "If the macro returns a value, use commas to separate expressions; "
2021 "otherwise, use do { <macro body> } while (FALSE) construct.",
2022 0, 0
2023 },
2024 {
2025 FK_MACROS, FK_NONE, modeFlag,
2026 "macroempty",
2027 FLG_MACROEMPTY,
2028 "macro definition for is empty",
2029 "A macro definition has no body.",
2030 0, 0
2031 },
2032 {
2033 FK_MACROS, FK_PARAMS, modeFlag,
2034 "macroparams",
2035 FLG_MACROPARAMS,
2036 "macro parameter not used exactly once",
2037 "A macro parameter is not used exactly once in all possible "
2038 "invocations of the macro. To behave like a function, "
2039 "each macro parameter must be used exactly once on all "
2040 "invocations of the macro so that parameters with "
2041 "side-effects are evaluated exactly once. Use /*@sef@*/ to "
2042 "denote parameters that must be side-effect free.",
2043 0, 0
2044 },
2045 {
2046 FK_MACROS, FK_CONTROL, modeFlag,
2047 "macroreturn",
2048 FLG_MACRORETURN,
2049 "return statement in macro body",
2050 "The body of a macro declared as a function uses a return statement. "
2051 "This exhibits behavior that "
2052 "could not be implemented by a function.",
2053 0, 0
2054 },
2055 {
2056 FK_MACROS, FK_PARAMS, modeFlag,
2057 "macroassign",
2058 FLG_MACROASSIGN,
2059 "assignment to a macro parameter",
2060 "A macro parameter is used as the left side of an "
2061 "assignment expression. This exhibits behavior that "
2062 "could not be implemented by a function.",
2063 0, 0
2064 },
2065 {
2066 FK_MACROS, FK_NONE, modeFlag,
2067 "macroparens",
2068 FLG_MACROPARENS,
2069 "macro parameter used without parentheses (in potentially dangerous context)",
2070 "A macro parameter is used without parentheses. This could be "
2071 "dangerous if the macro is invoked with a complex expression "
2072 "and precedence rules will change the evaluation inside the macro.",
2073 0, 0
2074 },
2075 {
2076 FK_MACROS, FK_PROTOS, modeFlag,
2077 "macrodecl",
2078 FLG_MACRODECL,
2079 "macro without prototype or specification (sets macrofcndecl and macroconstdecl)",
2080 "Argument checking cannot be done well for macros without prototypes "
2081 "or specifications, since the types of the arguments are unknown.",
2082 0, 0
2083 },
2084 {
2085 FK_MACROS, FK_PROTOS, modeFlag,
2086 "macrofcndecl",
2087 FLG_MACROFCNDECL,
2088 "parameterized macro without prototype or specification",
2089 "Function macro has no declaration.",
2090 0, 0
2091 },
2092
2093 /* 11.2.1 Side Effect Free Parameters */
2094
2095 {
2096 FK_MACROS, FK_PARAMS, modeFlag,
2097 "sefparams",
2098 FLG_SEFPARAMS,
2099 "a parameter with side-effects is passed as a sef parameter",
2100 "An actual parameter corresponding to a sef parameter may have a side-effect.",
2101 0, 0
2102 },
2103 {
2104 FK_MACROS, FK_PARAMS, modeFlag,
2105 "sefuncon",
2106 FLG_SEFUNSPEC,
2107 "a parameter with unconstrained side-effects is passed as a sef parameter",
2108 "An actual parameter corresponding to a sef parameter involves a call "
2109 "to a procedure with no modifies clause that may have a side-effect.",
2110 0, 0
2111 },
2112
2113 /* 11.3 Controlling Macro Checking */
2114
2115 {
2116 FK_MACROS, FK_NONE, plainFlag,
2117 "constmacros",
2118 FLG_CONSTMACROS,
2119 "check all macros without parameter lists as constants",
2120 "Every non-parameterized macro (not preceded by /*@notfunction@*/) "
2121 "is checked as a constant.",
2122 0, 0
2123 },
2124 {
2125 FK_MACROS, FK_NONE, plainFlag,
2126 "fcnmacros",
2127 FLG_FCNMACROS,
2128 "check all macros with parameter lists as functions",
2129 "Every parameterized macro (not preceded by /*@notfunction@*/) "
2130 "is checked as a function.",
2131 0, 0
2132 },
2133 {
2134 FK_MACROS, FK_NONE, plainSpecialFlag,
2135 "allmacros",
2136 FLG_ALLMACROS,
2137 "sets fcnmacros and constmacros",
2138 "All macros (not preceded by /*@notfunction@*/) are checked as functions or "
2139 "constants depending on whether or not they have parameter lists.",
2140 0, 0
2141 },
2142 {
2143 FK_MACROS, FK_NONE, plainFlag,
2144 "libmacros",
2145 FLG_LIBMACROS,
2146 "check all macros with declarations in library as functions",
2147 "Every macro declared in the load library is checked.",
2148 0, 0
2149 },
2150 {
2151 FK_MACROS, FK_NONE, plainFlag,
2152 "specmacros",
2153 FLG_SPECMACROS,
2154 "check all macros corresponding to specified functions or constants",
2155 "Every macro declared a specification file is checked.",
2156 0, 0
2157 },
2158 {
2159 FK_MACROS, FK_NONE, modeFlag,
2160 "macromatchname",
2161 FLG_MACROMATCHNAME,
2162 "macro definition does not match iter or constant declaration",
2163 "A iter or constant macro is defined using a different name from the "
2164 "one used in the previous syntactic comment",
2165 0, 0
2166 },
2167 {
2168 FK_MACROS, FK_NONE, plainFlag,
2169 "nextlinemacros",
2170 FLG_MACRONEXTLINE,
2171 "the line after a constant or iter declaration must be a macro definition",
2172 "A constant or iter declaration is not immediately followed by a macro definition.",
2173 0, 0
2174 },
2175
2176 /* 11.4 Iterators */
2177
2178 {
2179 FK_ITER, FK_NONE, plainFlag,
2180 "iterbalance",
2181 FLG_ITERBALANCE,
2182 "iter is not balanced with end_<iter>",
2183 NULL,
2184 0, 0
2185 },
2186 {
2187 FK_ITER, FK_NONE, plainFlag,
2188 "iteryield",
2189 FLG_ITERYIELD,
2190 "iter yield parameter is inappropriate",
2191 NULL,
2192 0, 0
2193 },
2194 {
2195 FK_ITER, FK_NONE, plainFlag,
2196 "hasyield",
2197 FLG_HASYIELD,
2198 "iter declaration has no yield parameters",
2199 "An iterator has been declared with no parameters annotated with "
2200 "yield. This may be what you want, if the iterator is meant "
2201 "to do something a fixed number of times, but returns no "
2202 "information to the calling context. Probably, a parameter "
2203 "is missing the yield annotation to indicate that it is "
2204 "assigned a value in the calling context.",
2205 0, 0
2206 },
2207
2208 /*
2209 ** 12. Naming Conventions
2210 */
2211
2212 {
2213 FK_NAMES, FK_ABSTRACT, plainFlag,
2214 "namechecks",
2215 FLG_NAMECHECKS,
2216 "controls name checking without changing other settings",
2217 NULL, 0, 0
2218 },
2219
2220 /* 12.1.1 Czech Names */
2221
2222 {
2223 FK_NAMES, FK_ABSTRACT, specialFlag,
2224 "czech",
2225 FLG_CZECH,
2226 "czech naming convention (sets accessczech, czechfunctions, czechvars, "
2227 "czechconstants, czechenums, and czechmacros)",
2228 "Name is not consistent with Czech naming convention.", 0, 0
2229 },
2230 {
2231 FK_NAMES, FK_ABSTRACT, plainFlag,
2232 "czechfcns",
2233 FLG_CZECHFUNCTIONS,
2234 "czech naming convention violated in a function or iterator declaration",
2235 "Function or iterator name is not consistent with Czech naming convention.", 0, 0
2236 },
2237 {
2238 FK_NAMES, FK_ABSTRACT, plainFlag,
2239 "czechvars",
2240 FLG_CZECHVARS,
2241 "czech naming convention violated in a variable declaration",
2242 "Variable name is not consistent with Czech naming convention.", 0, 0
2243 },
2244 {
2245 FK_NAMES, FK_ABSTRACT, plainFlag,
2246 "czechmacros",
2247 FLG_CZECHMACROS,
2248 "czech naming convention violated in an expanded macro name",
2249 "Expanded macro name is not consistent with Czech naming convention.", 0, 0
2250 },
2251 {
2252 FK_NAMES, FK_ABSTRACT, plainFlag,
2253 "czechconsts",
2254 FLG_CZECHCONSTANTS,
2255 "czech naming convention violated in a constant declaration",
2256 "Constant name is not consistent with Czech naming convention.", 0, 0
2257 },
2258 {
2259 FK_NAMES, FK_ABSTRACT, plainFlag,
2260 "czechtypes",
2261 FLG_CZECHTYPES,
2262 "czech naming convention violated in a user-defined type definition",
2263 "Type name is not consistent with Czech naming convention. Czech type "
2264 "names must not use the underscore character.", 0, 0
2265 },
2266
2267 /* 12.1.2 Slovak Names */
2268
2269 {
2270 FK_NAMES, FK_ABSTRACT, specialFlag,
2271 "slovak",
2272 FLG_SLOVAK,
2273 "slovak naming convention violated",
2274 "Name is not consistent with Slovak naming convention.", 0, 0
2275 },
2276 {
2277 FK_NAMES, FK_ABSTRACT, plainFlag,
2278 "slovakfcns",
2279 FLG_SLOVAKFUNCTIONS,
2280 "slovak naming convention violated in a function or iterator declaration",
2281 "Function or iterator name is not consistent with Slovak naming convention.", 0, 0
2282 },
2283 {
2284 FK_NAMES, FK_ABSTRACT, plainFlag,
2285 "slovakmacros",
2286 FLG_SLOVAKMACROS,
2287 "slovak naming convention violated in an expanded macro name",
2288 "Expanded macro name is not consistent with Slovak naming convention.", 0, 0
2289 },
2290 {
2291 FK_NAMES, FK_ABSTRACT, plainFlag,
2292 "slovakvars",
2293 FLG_SLOVAKVARS,
2294 "slovak naming convention violated in a variable declaration",
2295 "Variable name is not consistent with Slovak naming convention.", 0, 0
2296 },
2297 {
2298 FK_NAMES, FK_ABSTRACT, plainFlag,
2299 "slovakconsts",
2300 FLG_SLOVAKCONSTANTS,
2301 "slovak naming convention violated in a constant declaration",
2302 "Constant name is not consistent with Slovak naming convention.", 0, 0
2303 },
2304 {
2305 FK_NAMES, FK_ABSTRACT, plainFlag,
2306 "slovaktypes",
2307 FLG_SLOVAKTYPES,
2308 "slovak naming convention violated in a use-defined type definition",
2309 "Type name is not consistent with Slovak naming convention. Slovak type "
2310 "names may not include uppercase letters.", 0, 0
2311 },
2312
2313 /* 12.1.3 Czechoslovak Names */
2314 {
2315 FK_NAMES, FK_ABSTRACT, specialFlag,
2316 "czechoslovak",
2317 FLG_CZECHOSLOVAK,
2318 "czech or slovak naming convention violated",
2319 "Name is not consistent with either Czech or Slovak naming convention.", 0, 0
2320 },
2321 {
2322 FK_NAMES, FK_ABSTRACT, plainFlag,
2323 "czechoslovakfcns",
2324 FLG_CZECHOSLOVAKFUNCTIONS,
2325 "czechoslovak naming convention violated in a function or iterator declaration",
2326 "Function name is not consistent with Czechoslovak naming convention.", 0, 0
2327 },
2328 {
2329 FK_NAMES, FK_ABSTRACT, plainFlag,
2330 "czechoslovakmacros",
2331 FLG_CZECHOSLOVAKMACROS,
2332 "czechoslovak naming convention violated in an expanded macro name",
2333 "Expanded macro name is not consistent with Czechoslovak naming convention.", 0, 0
2334 },
2335 {
2336 FK_NAMES, FK_ABSTRACT, plainFlag,
2337 "czechoslovakvars",
2338 FLG_CZECHOSLOVAKVARS,
2339 "czechoslovak naming convention violated in a variable declaration",
2340 "Variable name is not consistent with Czechoslovak naming convention.", 0, 0
2341 },
2342 {
2343 FK_NAMES, FK_ABSTRACT, plainFlag,
2344 "czechoslovakconsts",
2345 FLG_CZECHOSLOVAKCONSTANTS,
2346 "czechoslovak naming convention violated in a constant declaration",
2347 "Constant name is not consistent with Czechoslovak naming convention.", 0, 0
2348 },
2349 {
2350 FK_NAMES, FK_ABSTRACT, plainFlag,
2351 "czechoslovaktypes",
2352 FLG_CZECHOSLOVAKTYPES,
2353 "czechoslovak naming convention violated in a user-defined type definition",
2354 "Type name is not consistent with Czechoslovak naming convention. Czechoslovak "
2355 "type names may not include uppercase letters or the underscore character.", 0, 0
2356 },
2357
2358 /* 12.2 Namespace Prefixes */
2359
2360 {
2361 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2362 "macrovarprefix",
2363 FLG_MACROVARPREFIX,
2364 "set namespace prefix for variables declared in a macro body",
2365 "A variable declared in a macro body does not start with the macrovarprefix.",
2366 0, 0
2367 } ,
2368 {
2369 FK_NAMES, FK_PREFIX, plainFlag,
2370 "macrovarprefixexclude",
2371 FLG_MACROVARPREFIXEXCLUDE,
2372 "the macrovarprefix may not be used for non-macro variables",
2373 "A variable declared outside a macro body starts with the macrovarprefix.",
2374 0, 0
2375 } ,
2376 {
2377 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2378 "tagprefix",
2379 FLG_TAGPREFIX,
2380 "set namespace prefix for struct, union and enum tags",
2381 "A tag identifier does not start with the tagprefix.",
2382 0, 0
2383 } ,
2384 {
2385 FK_NAMES, FK_PREFIX, plainFlag,
2386 "tagprefixexclude",
2387 FLG_TAGPREFIXEXCLUDE,
2388 "the tagprefix may not be used for non-tag identifiers",
2389 "An identifier that is not a tag starts with the tagprefix.",
2390 0, 0
2391 } ,
2392 {
2393 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2394 "enumprefix",
2395 FLG_ENUMPREFIX,
2396 "set namespace prefix for enum members",
2397 "An enum member does not start with the enumprefix.",
2398 0, 0
2399 } ,
2400 {
2401 FK_NAMES, FK_PREFIX, plainFlag,
2402 "enumprefixexclude",
2403 FLG_ENUMPREFIXEXCLUDE,
2404 "the enumprefix may not be used for non-enum member identifiers",
2405 "An identifier that is not an enum member starts with the enumprefix.",
2406 0, 0
2407 } ,
2408 {
2409 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2410 "filestaticprefix",
2411 FLG_FILESTATICPREFIX,
2412 "set namespace prefix for file static declarations",
2413 "A file-static identifier does not start with the filestaticprefix.",
2414 0, 0
2415 } ,
2416 {
2417 FK_NAMES, FK_PREFIX, plainFlag,
2418 "filestaticprefixexclude",
2419 FLG_FILESTATICPREFIXEXCLUDE,
2420 "the filestaticprefix may not be used for identifiers that are not file static",
2421 "An identifier that is not file static starts with the filestaticprefix.",
2422 0, 0
2423 } ,
2424 {
2425 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2426 "globalprefix",
2427 FLG_GLOBPREFIX,
2428 "set namespace prefix for global variables",
2429 "A global variable does not start with the globalprefix",
2430 0, 0
2431 } ,
2432 {
2433 FK_NAMES, FK_PREFIX, plainFlag,
2434 "globalprefixexclude",
2435 FLG_GLOBPREFIXEXCLUDE,
2436 "the globalprefix may not be used for non-global identifiers",
2437 "An identifier that is not a global variable starts with the globalprefix.",
2438 0, 0
2439 } ,
2440 {
2441 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2442 "typeprefix",
2443 FLG_TYPEPREFIX,
2444 "set namespace prefix for user-defined types",
2445 "A user-defined type does not start with the typeprefix",
2446 0, 0
2447 } ,
2448 {
2449 FK_NAMES, FK_PREFIX, plainFlag,
2450 "typeprefixexclude",
2451 FLG_TYPEPREFIXEXCLUDE,
2452 "the typeprefix may not be used for identifiers that are not type names",
2453 "An identifier that is not a type name starts with the typeprefix.",
2454 0, 0
2455 } ,
2456 {
2457 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2458 "externalprefix",
2459 FLG_EXTERNALPREFIX,
2460 "set namespace prefix for external identifiers",
2461 "An external identifier does not start with the externalprefix",
2462 0, 0
2463 } ,
2464 {
2465 FK_NAMES, FK_PREFIX, plainFlag,
2466 "externalprefixexclude",
2467 FLG_EXTERNALPREFIXEXCLUDE,
2468 "the externalprefix may not be used for non-external identifiers",
2469 "An identifier that is not external starts with the externalprefix.",
2470 0, 0
2471 } ,
2472 {
2473 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2474 "localprefix",
2475 FLG_LOCALPREFIX,
2476 "set namespace prefix for local variables",
2477 "A local variable does not start with the localprefix",
2478 0, 0
2479 } ,
2480 {
2481 FK_NAMES, FK_PREFIX, plainFlag,
2482 "localprefixexclude",
2483 FLG_LOCALPREFIXEXCLUDE,
2484 "the localprefix may not be used for non-local identifiers",
2485 "An identifier that is not a local variable starts with the localprefix.",
2486 0, 0
2487 } ,
2488 {
2489 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2490 "uncheckedmacroprefix",
2491 FLG_UNCHECKEDMACROPREFIX,
2492 "set namespace prefix for unchecked macros",
2493 "An unchecked macro name does not start with the uncheckedmacroprefix",
2494 0, 0
2495 } ,
2496 {
2497 FK_NAMES, FK_PREFIX, plainFlag,
2498 "uncheckedmacroprefixexclude",
2499 FLG_UNCHECKEDMACROPREFIXEXCLUDE,
2500 "the uncheckmacroprefix may not be used for identifiers that are not "
2501 "unchecked macros",
2502 "An identifier that is not the name of an unchecked macro "
2503 "starts with the uncheckedmacroprefix.",
2504 0, 0
2505 } ,
2506 {
2507 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2508 "constprefix",
2509 FLG_CONSTPREFIX,
2510 "set namespace prefix for constants",
2511 "A constant does not start with the constantprefix",
2512 0, 0
2513 } ,
2514 {
2515 FK_NAMES, FK_PREFIX, plainFlag,
2516 "constprefixexclude",
2517 FLG_CONSTPREFIXEXCLUDE,
2518 "the constprefix may not be used for non-constant identifiers",
2519 "An identifier that is not a constant starts with the constantprefix.",
2520 0, 0
2521 } ,
2522 {
2523 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2524 "iterprefix",
2525 FLG_ITERPREFIX,
2526 "set namespace prefix for iterators",
2527 "An iter does not start with the iterator prefix",
2528 0, 0
2529 } ,
2530 {
2531 FK_NAMES, FK_PREFIX, plainFlag,
2532 "iterprefixexclude",
2533 FLG_ITERPREFIXEXCLUDE,
2534 "the iterprefix may not be used for non-iter identifiers",
2535 "An identifier that is not a iter starts with the iterprefix.",
2536 0, 0
2537 } ,
2538 {
2539 FK_NAMES, FK_PREFIX, idemStringFlag, ARG_STRING,
2540 "protoparamprefix",
2541 FLG_DECLPARAMPREFIX,
2542 "set namespace prefix for parameters in function prototype declarations",
2543 "A parameter name in a function prototype declaration does not start with the "
2544 "declaration parameter prefix",
2545 0, 0
2546 } ,
2547
2548 /* 12.3 Naming Restrictions */
2549 {
2550 FK_NAMES, FK_ANSI, modeFlag,
2551 "isoreserved",
2552 FLG_ISORESERVED,
2553 "external name conflicts with name reserved for system or standard library",
2554 "External name is reserved for system use by ISO C99 standard.",
2555 0, 0
2556 },
2557 {
2558 FK_NAMES, FK_ANSI, modeFlag,
2559 "cppnames",
2560 FLG_CPPNAMES,
2561 "external or internal name is a C++ keyword or reserved word",
2562 "External name is a C++ keyword or reserved word. "
2563 "This could lead to problems if the "
2564 "code is compiled with a C++ compiler.",
2565 0, 0
2566 },
2567 {
2568 FK_NAMES, FK_ANSI, modeFlag,
2569 "isoreservedinternal",
2570 FLG_ISORESERVEDLOCAL,
2571 "internal name conflicts with name reserved for system or standard library",
2572 "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).",
2573 0, 0
2574 },
2575 {
2576 FK_NAMES, FK_ANSI, plainFlag,
2577 "distinctexternalnames",
2578 FLG_DISTINCTEXTERNALNAMES,
2579 "external name is not distinguishable from another external name using "
2580 "the number of significant characters",
2581 "An external name is not distinguishable from another external name "
2582 "using the number of significant characters. According to "
2583 "ANSI Standard (3.1), an implementation may only consider the first 6 "
2584 "characters significant, and ignore alphabetical case "
2585 "distinctions (ISO C99 requires 31). The "
2586 "+externalnamelen <n> flag may be used to change the number "
2587 "of significant characters, and -externalnamecaseinsensitive to make "
2588 "alphabetical case significant in external names.",
2589 0, 0
2590 },
2591 {
2592 FK_NAMES, FK_ANSI, specialValueFlag,
2593 "externalnamelen",
2594 FLG_EXTERNALNAMELEN,
2595 "set the number of significant characters in an external name",
2596 "Sets the number of significant characters in an external name (default is 6 for old "
2597 "ANSI89 limit, C99 requires 31). "
2598 "Sets +distinctexternalnames.",
2599 0, 0
2600 },
2601 {
2602 FK_NAMES, FK_ANSI, plainSpecialFlag,
2603 "externalnamecaseinsensitive",
2604 FLG_EXTERNALNAMECASEINSENSITIVE,
2605 "alphabetic comparisons for external names are case-insensitive",
2606 "Make alphabetic case insignificant in external names. By ANSI89 "
2607 "standard, case need not be significant in an external name. "
2608 "If +distinctexternalnames is not set, sets "
2609 "+distinctexternalnames with unlimited external name length.",
2610 0, 0
2611 },
2612 {
2613 FK_NAMES, FK_ANSI, plainFlag,
2614 "distinctinternalnames",
2615 FLG_DISTINCTINTERNALNAMES,
2616 "internal name is not distinguishable from another internal name using "
2617 "the number of significant characters",
2618 "An internal name is not distinguishable from another internal name "
2619 "using the number of significant characters. According to "
2620 "ANSI89 Standard (3.1), an implementation may only consider the first 31 "
2621 "characters significant (ISO C99 specified 63). The "
2622 "+internalnamelen <n> flag changes the number "
2623 "of significant characters, -internalnamecaseinsensitive to makes "
2624 "alphabetical case significant, and "
2625 "+internalnamelookalike to make similar-looking characters "
2626 "non-distinct.",
2627 0, 0
2628 },
2629 {
2630 FK_NAMES, FK_ANSI, specialValueFlag,
2631 "internalnamelen",
2632 FLG_INTERNALNAMELEN,
2633 "set the number of significant characters in an internal name",
2634 "Sets the number of significant characters in an internal name (ANSI89 "
2635 "default is 31.) Sets +distinctinternalnames.",
2636 0, 0
2637 },
2638 {
2639 FK_NAMES, FK_ANSI, plainSpecialFlag,
2640 "internalnamecaseinsensitive",
2641 FLG_INTERNALNAMECASEINSENSITIVE,
2642 "set whether case is significant an internal names "
2643 "(-internalnamecaseinsensitive means case is significant)" ,
2644 "Set whether case is significant an internal names "
2645 "(-internalnamecaseinsensitive "
2646 "means case is significant). By ANSI89 default, case is not "
2647 "significant. If +distinctinternalnames is not set, sets "
2648 "+distinctinternalnames with unlimited internal name length.",
2649 0, 0
2650 },
2651 {
2652 FK_NAMES, FK_ANSI, plainSpecialFlag,
2653 "internalnamelookalike",
2654 FLG_INTERNALNAMELOOKALIKE,
2655 "lookalike characters match in internal names",
2656 "Set whether similar looking characters (e.g., \"1\" and \"l\") "
2657 "match in internal names.",
2658 0, 0
2659 },
2660 {
2661 FK_NAMES, FK_PREFIX, modeFlag,
2662 "protoparamname",
2663 FLG_DECLPARAMNAME,
2664 "a parameter in a function prototype has a name",
2665 "A parameter in a function prototype has a name. This is dangerous, "
2666 "since a macro definition could be visible here.",
2667 0, 0
2668 } ,
2669 {
2670 FK_NAMES, FK_PREFIX, modeFlag,
2671 "protoparammatch",
2672 FLG_DECLPARAMMATCH,
2673 "the name of a parameter in a function prototype and corresponding "
2674 "declaration must match (after removing the protoparamprefix",
2675 "A parameter in a function definition does not have the same name as "
2676 "the corresponding in the declaration of the function after "
2677 "removing the protoparamprefix",
2678 0, 0
2679 } ,
2680 {
2681 FK_NAMES, FK_PREFIX, plainFlag,
2682 "protoparamprefixexclude",
2683 FLG_DECLPARAMPREFIXEXCLUDE,
2684 "the protoparamprefix may not be used for non-declaraction parameter identifiers",
2685 "An identifier that is not a parameter name in a function prototype "
2686 "starts with the protoparamprefix.",
2687 0, 0
2688 } ,
2689
2690 /*
2691 ** 13. Completeness
2692 */
2693
2694 /* 13.1 Unused Declarations */
2695
2696 {
2697 FK_USE, FK_COMPLETE, modeFlag,
2698 "topuse",
2699 FLG_TOPUNUSED,
2700 "declaration at top level not used",
2701 "An external declaration not used in any source file.", 0, 0
2702 },
2703 {
2704 FK_USE, FK_EXPORT, modeFlag,
2705 "exportlocal",
2706 FLG_EXPORTLOCAL,
2707 "a declaration is exported but not used outside this module",
2708 "A declaration is exported, but not used outside this module. "
2709 "Declaration can use static qualifier.",
2710 0, 0
2711 },
2712 {
2713 FK_USE, FK_EXPORT, modeFlag,
2714 "exportheader",
2715 FLG_EXPORTHEADER,
2716 "a declaration is exported but does not appear in a header file",
2717 "A declaration is exported, but does not appear in a header file.",
2718 0, 0
2719 },
2720 {
2721 FK_USE, FK_EXPORT, modeFlag,
2722 "exportheadervar",
2723 FLG_EXPORTHEADERVAR,
2724 "a variable declaration is exported but does not appear in a header file",
2725 "A variable declaration is exported, but does not appear in a header "
2726 "file. (Used with exportheader.)",
2727 0, 0
2728 },
2729 {
2730 FK_USE, FK_NONE, modeFlag,
2731 "fielduse",
2732 FLG_FIELDUNUSED,
2733 "field of structure type not used",
2734 "A field is present in a structure type but never used. Use /*@unused@*/ in front of field declaration to suppress message.",
2735 0, 0
2736 },
2737 {
2738 FK_USE, FK_NONE, modeFlag,
2739 "enummemuse",
2740 FLG_ENUMMEMUNUSED,
2741 "member of an enum type not used",
2742 "A member of an enum type is never used.",
2743 0, 0
2744 },
2745 {
2746 FK_USE, FK_NONE, modeFlag,
2747 "constuse",
2748 FLG_CONSTUNUSED,
2749 "constant declared but not used",
2750 "A constant is declared but not used. Use unused in the constant declaration to suppress message.",
2751 0, 0
2752 },
2753 {
2754 FK_USE, FK_NONE, modeFlag,
2755 "fcnuse",
2756 FLG_FUNCUNUSED,
2757 "function declared but not used",
2758 "A function is declared but not used. Use /*@unused@*/ in front of function header to suppress message.",
2759 0, 0
2760 },
2761 {
2762 FK_USE, FK_PARAMS, modeFlag,
2763 "paramuse",
2764 FLG_PARAMUNUSED,
2765 "function parameter not used ",
2766 "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.",
2767 0, 0
2768 },
2769 {
2770 FK_USE, FK_TYPE, modeFlag,
2771 "typeuse",
2772 FLG_TYPEUNUSED,
2773 "type declared but not used",
2774 "A type is declared but not used. Use /*@unused@*/ in front of typedef to suppress messages.",
2775 0, 0
2776 },
2777 {
2778 FK_USE, FK_NONE, modeFlag,
2779 "varuse",
2780 FLG_VARUNUSED,
2781 "variable declared but not used",
2782 "A variable is declared but never used. Use /*@unused@*/ in front "
2783 "of declaration to suppress message.",
2784 0, 0
2785 },
2786 {
2787 FK_USE, FK_COMPLETE, modeFlag,
2788 "unusedspecial",
2789 FLG_UNUSEDSPECIAL,
2790 "unused declaration in special file (corresponding to .l or .y file)",
2791 NULL, 0, 0
2792 } ,
2793
2794 /* 13.2 Complete Programs */
2795
2796 {
2797 FK_COMPLETE, FK_NONE, modeFlag,
2798 "declundef",
2799 FLG_DECLUNDEF,
2800 "function or variable declared but never defined",
2801 "A function or variable is declared, but not defined in any source code file.",
2802 0, 0
2803 },
2804 {
2805 FK_COMPLETE, FK_SPEC, modeFlag,
2806 "specundef",
2807 FLG_SPECUNDEF,
2808 "function or variable specified but never defined",
2809 "A function or variable is declared in an .lcl file, but not defined in any source code file.",
2810 0, 0
2811 },
2812 {
2813 FK_COMPLETE, FK_SPEC, plainFlag,
2814 "specundecl",
2815 FLG_SPECUNDECL,
2816 "function or variable specified but never declared in a source file",
2817 "A function or variable is declared in an .lcl file, but not declared "
2818 "in any source code file.",
2819 0, 0
2820 },
2821 {
2822 FK_DECL, FK_LIBS, plainFlag,
2823 "newdecl",
2824 FLG_NEWDECL,
2825 "report new global declarations in source files",
2826 "There is a new declaration that is not declared in a loaded library "
2827 "or earlier file. (Use this flag to check for consistency "
2828 "against a library.)",
2829 0, 0
2830 },
2831 {
2832 FK_INIT, FK_SPEC, plainFlag,
2833 "needspec",
2834 FLG_NEEDSPEC,
2835 "information in specifications is not also included in syntactic comments",
2836 "There is information in the specification that is not duplicated "
2837 "in syntactic comments. Normally, this is not an "
2838 "error, but it may be useful to detect it to make "
2839 "sure checking incomplete systems without the specifications will "
2840 "still use this information.",
2841 0, 0
2842 },
2843
2844 /*
2845 ** 14. Libraries and Header File Inclusion
2846 */
2847
2848 /* 14.1 Standard Libraries */
2849
2850 {
2851 FK_LIBS, FK_INIT, idemGlobalFlag,
2852 "nolib",
2853 FLG_NOLIB,
2854 "do not load standard library",
2855 NULL, 0, 0
2856 },
2857 {
2858 FK_LIBS, FK_INIT, idemGlobalFlag,
2859 "isolib",
2860 FLG_ANSILIB,
2861 "use normal standard library",
2862 "Library based on the ISO standard library specification is used.",
2863 0, 0
2864 },
2865 {
2866 FK_LIBS, FK_INIT, idemGlobalFlag,
2867 "strictlib",
2868 FLG_STRICTLIB,
2869 "interpret standard library strictly",
2870 "Stricter version of the standard library is used. (The default "
2871 "library is standard.lcd; strict library is strict.lcd.)",
2872 0, 0
2873 },
2874 {
2875 FK_LIBS, FK_INIT, idemGlobalFlag,
2876 "unixlib",
2877 FLG_UNIXLIB,
2878 "use UNIX (sort-of) standard library",
2879 "UNIX version of the standard library is used.",
2880 0, 0
2881 },
2882 {
2883 FK_LIBS, FK_INIT, idemGlobalFlag,
2884 "unixstrictlib",
2885 FLG_UNIXSTRICTLIB,
2886 "use strict version of UNIX (sort-of) library",
2887 "strict version of the UNIX library is used.",
2888 0, 0
2889 },
2890 {
2891 FK_LIBS, FK_INIT, idemGlobalFlag,
2892 "posixlib",
2893 FLG_POSIXLIB,
2894 "use POSIX standard library",
2895 "POSIX version of the standard library is used.",
2896 0, 0
2897 },
2898 {
2899 FK_LIBS, FK_INIT, idemGlobalFlag,
2900 "posixstrictlib",
2901 FLG_POSIXSTRICTLIB,
2902 "use strict POSIX standard library",
2903 "POSIX version of the strict standard library is used.",
2904 0, 0
2905 },
2906 {
2907 FK_LIBS, FK_INIT, idemGlobalFlag,
2908 "whichlib",
2909 FLG_WHICHLIB,
2910 "show standard library filename",
2911 NULL, 0, 0
2912 },
2913 {
2914 FK_LIBS, FK_ANSI, plainFlag,
2915 "warnposixheaders",
2916 FLG_WARNPOSIX,
2917 "a POSIX header is included, but the POSIX library is not used",
2918 "Header name matches a POSIX header, but the POSIX library is not selected.",
2919 0, 0
2920 },
2921 {
2922 FK_LIBS, FK_ANSI, plainFlag,
2923 "warnunixlib",
2924 FLG_WARNUNIXLIB,
2925 "warn when the unix library is used",
2926 "Unix library may not be compatible with all platforms",
2927 0, 0
2928 },
2929 {
2930 FK_LIBS, FK_ANSI, plainFlag,
2931 "usevarargs",
2932 FLG_USEVARARGS,
2933 "non-standard <varargs.h> included",
2934 "Header <varargs.h> is not part of ANSI Standard. "
2935 "Should use <stdarg.h> instead.",
2936 0, 0
2937 },
2938 {
2939 FK_HEADERS, FK_FILES, plainFlag,
2940 "caseinsensitivefilenames",
2941 FLG_CASEINSENSITIVEFILENAMES,
2942 "file names are case insensitive (file.h and FILE.H are the same file)",
2943 NULL, 0, 0
2944 },
2945
2946 /* 14.2 Generating Libraries */
2947
2948 {
2949 FK_LIBS, FK_FILES, globalStringFlag, ARG_FILE,
2950 "dump",
2951 FLG_DUMP,
2952 "save state for merging (default suffix .lcd)",
2953 NULL, 0, 0
2954 },
2955 {
2956 FK_LIBS, FK_FILES, globalStringFlag, ARG_FILE,
2957 "load",
2958 FLG_MERGE,
2959 "load state from dump file (default suffix .lcd)",
2960 NULL, 0, 0
2961 },
2962
2963 /* 14.3 Header File Inclusion */
2964
2965 {
2966 FK_HEADERS, FK_SPEED, globalFlag,
2967 "singleinclude",
2968 FLG_SINGLEINCLUDE,
2969 "optimize header inclusion to eliminate redundant includes",
2970 "When checking multiple files, each header file is processed only "
2971 "once. This may change the meaning of the code, if the "
2972 "same header file is included in different contexts (e.g., the "
2973 "header file includes #if directives and the values are "
2974 "different when it is included in different places.)",
2975 0, 0
2976 },
2977 {
2978 FK_HEADERS, FK_SPEED, globalFlag,
2979 "neverinclude",
2980 FLG_NEVERINCLUDE,
2981 "optimize header inclusion to not include any header files",
2982 "Ignore header includes. Only works if relevant information is "
2983 "loaded from a library.",
2984 0, 0
2985 },
2986 {
2987 FK_HEADERS, FK_SPEED, globalFlag,
2988 "skipsysheaders",
2989 FLG_SKIPSYSHEADERS,
2990 "do not include header files in system directories (set by -sysdirs)",
2991 "Do not include header files in system directories (set by -sysdirs)",
2992 0, 0
2993 },
2994
2995 /*
2996 ** A. Operation?
2997 */
2998
2999
3000 /*
3001 ** Syntax
3002 */
3003
3004 {
3005 FK_SYNTAX, FK_ANSI, plainFlag,
3006 "gnuextensions",
3007 FLG_GNUEXTENSIONS,
3008 "support some gnu (gcc) language extensions",
3009 "ANSI C does not allow some language features supported by gcc and other compilers. "
3010 "Use +gnuextensions to allow some of these extensions.", 0, 0
3011 },
3012
3013 /* Prototypes */
3014
3015 {
3016 FK_PROTOS, FK_ANSI, modeFlag,
3017 "noparams",
3018 FLG_NOPARAMS,
3019 "function declaration has no parameter list",
3020 "A function declaration does not have a parameter list.",
3021 0, 0
3022 },
3023 {
3024 FK_PROTOS, FK_ANSI, modeFlag,
3025 "oldstyle",
3026 FLG_OLDSTYLE,
3027 "old style function definition",
3028 "Function definition is in old style syntax. Standard prototype "
3029 "syntax is preferred.",
3030 0, 0
3031 },
3032
3033
3034 /*
3035 ** System functions
3036 */
3037
3038 {
3039 FK_SYSTEMFUNCTIONS, FK_TYPE, plainFlag,
3040 "maintype",
3041 FLG_MAINTYPE,
3042 "type of main does not match expected type",
3043 "The function main does not match the expected type.",
3044 0, 0
3045 },
3046 {
3047 FK_SYSTEMFUNCTIONS, FK_BEHAVIOR, modeFlag,
3048 "exitarg",
3049 FLG_EXITARG,
3050 "argument to exit has implementation defined behavior",
3051 "The argument to exit should be 0, EXIT_SUCCESS or EXIT_FAILURE",
3052 0, 0
3053 },
3054
3055 {
3056 FK_DECL, FK_NONE, modeFlag,
3057 "shadow",
3058 FLG_SHADOW,
3059 "declaration reuses name visible in outer scope",
3060 "An outer declaration is shadowed by the local declaration.",
3061 0, 0
3062 },
3063 {
3064 FK_DECL, FK_LIBS, modeFlag,
3065 "incondefslib",
3066 FLG_INCONDEFSLIB,
3067 "function, variable or constant defined in a library is redefined with inconsistent type",
3068 "A function, variable or constant previously defined in a library is "
3069 "redefined with a different type.",
3070 0, 0
3071 },
3072 {
3073 FK_DECL, FK_LIBS, modeFlag,
3074 "overload",
3075 FLG_WARNOVERLOAD,
3076 "library function overloaded",
3077 "A function, variable or constant defined in the library is redefined "
3078 "with a different type.",
3079 0, 0
3080 },
3081 {
3082 FK_DECL, FK_NONE, modeFlag,
3083 "nestedextern",
3084 FLG_NESTEDEXTERN,
3085 "an extern declaration is inside a function scope",
3086 "An extern declaration is used inside a function scope.",
3087 0, 0
3088 },
3089 {
3090 FK_DECL, FK_NONE, modeFlag,
3091 "redecl",
3092 FLG_REDECL,
3093 "function or variable redeclared",
3094 "A function or variable is declared in more than one place. This is "
3095 "not necessarily a problem, since the declarations are consistent.",
3096 0, 0
3097 },
3098 {
3099 FK_DECL, FK_NONE, plainFlag,
3100 "redef",
3101 FLG_REDEF,
3102 "function or variable redefined",
3103 "A function or variable is redefined. One of the declarations should use extern.",
3104 0, 0
3105 },
3106 {
3107 FK_DECL, FK_TYPE, modeFlag,
3108 "imptype",
3109 FLG_IMPTYPE,
3110 "variable declaration has unknown (implicitly int) type",
3111 "A variable declaration has no explicit type. The type is implicitly int.",
3112 0, 0
3113 },
3114
3115 {
3116 FK_DIRECT, FK_FILES, globalStringFlag, ARG_DIRECTORY,
3117 "tmpdir",
3118 FLG_TMPDIR,
3119 "set directory for writing temp files",
3120 NULL, 0, 0
3121 },
3122 {
3123 FK_DIRECT, FK_FILES, globalStringFlag, ARG_PATH,
3124 "larchpath",
3125 FLG_LARCHPATH,
3126 "set path for searching for library files (overrides LARCH_PATH environment variable)",
3127 NULL, 0, 0
3128 },
3129 {
3130 FK_DIRECT, FK_FILES, globalStringFlag, ARG_DIRECTORY,
3131 "lclimportdir",
3132 FLG_LCLIMPORTDIR,
3133 "set directory to search for LCL import files (overrides LCLIMPORTDIR)",
3134 NULL, 0, 0
3135 },
3136 {
3137 FK_DIRECT, FK_FILES, globalStringFlag, ARG_PATH,
3138 "sysdirs",
3139 FLG_SYSTEMDIRS,
3140 "set directories for system files (default /usr/include). Separate "
3141 "directories with path separator (colons in Unix, semi-colons in Windows). "
3142 "Flag settings propagate to files in a system directory. If "
3143 "-sysdirerrors is set, no errors are reported for files in "
3144 "system directories.",
3145 NULL, 0, 0
3146 },
3147 {
3148 FK_DIRECT, FK_FILES, plainFlag,
3149 "skipisoheaders",
3150 FLG_SKIPISOHEADERS,
3151 "prevent inclusion of header files in a system directory with "
3152 "names that match standard ANSI headers. The symbolic information "
3153 "in the standard library is used instead. Flag in effect only "
3154 "if a library including the ANSI library is loaded. The ANSI "
3155 "headers are: assert, ctype, errno, float, limits, locale, math, "
3156 "setjmp, signal, stdarg, stddef, stdio, stdlib, strings, string, "
3157 "time, and wchar.",
3158 NULL, 0, 0
3159 },
3160 {
3161 FK_DIRECT, FK_FILES, plainFlag,
3162 "skipposixheaders",
3163 FLG_SKIPPOSIXHEADERS,
3164 "prevent inclusion of header files in a system directory with "
3165 "names that match standard POSIX headers. The symbolic information "
3166 "in the posix library is used instead. The POSIX headers are: "
3167 "dirent, fcntl, grp, pwd, termios, sys/stat, sys/times, "
3168 "sys/types, sys/utsname, sys/wait, unistd, and utime.",
3169 NULL, 0, 0
3170 },
3171 {
3172 FK_DIRECT, FK_SUPPRESS, modeFlag,
3173 "sysdirerrors",
3174 FLG_SYSTEMDIRERRORS,
3175 "report errors in files in system directories (set by -sysdirs)",
3176 NULL, 0, 0
3177 },
3178 {
3179 FK_DIRECT, FK_MACROS, plainFlag,
3180 "sysdirexpandmacros",
3181 FLG_SYSTEMDIREXPAND,
3182 "expand macros in system directories regardless of other settings, "
3183 "except for macros corresponding to names defined in a load library",
3184 NULL, 0, 0
3185 },
3186
3187 {
3188 FK_DIRECT, FK_HEADERS, globalExtraArgFlag,
3189 "I<directory>",
3190 FLG_INCLUDEPATH,
3191 "add to C include path",
3192 NULL, 0, 0
3193 },
3194 {
3195 FK_DIRECT, FK_SPEC, globalExtraArgFlag,
3196 "S<directory>",
3197 FLG_SPECPATH,
3198 "add to spec path",
3199 NULL, 0, 0
3200 },
3201 {
3202 FK_EXPORT, FK_SPEC, specialFlag,
3203 "exportany",
3204 FLG_EXPORTANY,
3205 "variable, function or type exported but not specified",
3206 "A variable, function or type is exported, but not specified.",
3207 0, 0
3208 },
3209 {
3210 FK_EXPORT, FK_SPEC, modeFlag,
3211 "exportfcn",
3212 FLG_EXPORTFCN,
3213 "function exported but not specified",
3214 "A function is exported, but not specified.", 0, 0
3215 },
3216 {
3217 FK_EXPORT, FK_SPEC, modeFlag,
3218 "exportmacro",
3219 FLG_EXPORTMACRO,
3220 "expanded macro exported but not specified",
3221 "A macro is exported, but not specified.", 0, 0
3222 },
3223 {
3224 FK_EXPORT, FK_SPEC, modeFlag,
3225 "exporttype",
3226 FLG_EXPORTTYPE,
3227 "type definition exported but not specified",
3228 "A type is exported, but not specified.", 0, 0
3229 },
3230 {
3231 FK_EXPORT, FK_SPEC, modeFlag,
3232 "exportvar",
3233 FLG_EXPORTVAR,
3234 "variable exported but not specified",
3235 "A variable is exported, but not specified.", 0, 0
3236 },
3237 {
3238 FK_EXPORT, FK_SPEC, modeFlag,
3239 "exportconst",
3240 FLG_EXPORTCONST,
3241 "constant exported but not specified",
3242 "A constant is exported, but not specified.", 0, 0
3243 },
3244 {
3245 FK_EXPORT, FK_SPEC, modeFlag,
3246 "exportiter",
3247 FLG_EXPORTITER,
3248 "constant exported but not specified",
3249 "A constant is exported, but not specified.", 0, 0
3250 },
3251
3252 {
3253 FK_FORMAT, FK_DISPLAY, valueFlag,
3254 "linelen",
3255 FLG_LINELEN,
3256 "set length of messages (number of chars)",
3257 NULL, 0, 0
3258 },
3259 {
3260 FK_FORMAT, FK_DISPLAY, valueFlag,
3261 "indentspaces",
3262 FLG_INDENTSPACES,
3263 "set number of spaces to indent sub-messages",
3264 NULL, 0, 0
3265 },
3266 {
3267 FK_FORMAT, FK_DISPLAY, plainFlag,
3268 "showcolumn",
3269 FLG_SHOWCOL,
3270 "show column number where error is found",
3271 NULL, 0, 0
3272 },
3273 {
3274 FK_FORMAT, FK_DISPLAY, plainFlag,
3275 "showloadloc",
3276 FLG_SHOWLOADLOC,
3277 "show location information for load files",
3278 NULL, 0, 0
3279 },
3280 {
3281 FK_FORMAT, FK_DISPLAY, plainFlag,
3282 "parenfileformat",
3283 FLG_PARENFILEFORMAT,
3284 "show column number where error is found",
3285 NULL, 0, 0
3286 },
3287 {
3288 FK_FORMAT, FK_DISPLAY, plainFlag,
3289 "htmlfileformat",
3290 FLG_HTMLFILEFORMAT,
3291 "show file locations as links",
3292 NULL, 0, 0
3293 },
3294 {
3295 FK_FORMAT, FK_NONE, plainFlag,
3296 "showfunc",
3297 FLG_SHOWFUNC,
3298 "show name of function containing error",
3299 NULL, 0, 0
3300 },
3301 {
3302 FK_FORMAT, FK_NONE, plainFlag,
3303 "showallconjs",
3304 FLG_SHOWALLCONJS,
3305 "show all possible types",
3306 "When a library function is declared with multiple possible type, the "
3307 "alternate types are shown only if +showallconjs.",
3308 0, 0
3309 },
3310 {
3311 FK_LIBS, FK_NONE, plainFlag,
3312 "impconj",
3313 FLG_IMPCONJ,
3314 "make all alternate types implicit (useful for making system libraries",
3315 NULL, 0, 0
3316 } ,
3317 {
3318 FK_GLOBAL, FK_ERRORS, globalValueFlag,
3319 "expect",
3320 FLG_EXPECT,
3321 "expect <int> code errors",
3322 NULL, 0, 0
3323 },
3324 {
3325 FK_GLOBAL, FK_ERRORS, globalValueFlag,
3326 "lclexpect",
3327 FLG_LCLEXPECT,
3328 "expect <int> spec errors",
3329 NULL, 0, 0
3330 },
3331 {
3332 FK_GLOBAL, FK_USE, idemSpecialFlag,
3333 "partial",
3334 FLG_PARTIAL,
3335 "check as partial system (-specundef, -declundef, -exportlocal, "
3336 "don't check macros in headers without corresponding .c files)",
3337 NULL, 0, 0
3338 },
3339
3340 /*
3341 ** Appendix D. Specifications
3342 */
3343
3344 {
3345 FK_HEADERS, FK_SPEC, globalFlag,
3346 "lh",
3347 FLG_DOLH,
3348 "generate .lh files", NULL,
3349 0, 0
3350 },
3351 {
3352 FK_HEADERS, FK_SPEC, globalFlag,
3353 "lcs",
3354 FLG_DOLCS,
3355 "generate .lcs files", NULL,
3356 0, 0
3357 },
3358
3359 /*
3360 ** 1. Operation
3361 */
3362
3363 {
3364 FK_HELP, FK_NONE, plainFlag,
3365 "warnflags",
3366 FLG_WARNFLAGS,
3367 "warn when command line sets flag in abnormal way",
3368 "Command line sets flag in abnormal way",
3369 0, 0
3370 },
3371 {
3372 FK_HELP, FK_NONE, plainFlag,
3373 "warnrc",
3374 FLG_WARNRC,
3375 "warn when there are problems with reading the initialization files",
3376 "There was a problem reading an initialization file",
3377 0, 0
3378 },
3379 {
3380 FK_HELP, FK_NONE, plainFlag,
3381 "badflag",
3382 FLG_BADFLAG,
3383 "warn about bad command line flags",
3384 "A flag is not recognized or used in an incorrect way",
3385 0, 0
3386 },
3387 {
3388 FK_HELP, FK_NONE, plainFlag,
3389 "fileextensions",
3390 FLG_FILEEXTENSIONS,
3391 "warn when command line file does not have a recognized extension",
3392 NULL, 0, 0
3393 },
3394 {
3395 FK_HELP, FK_NONE, globalExtraArgFlag,
3396 "help",
3397 FLG_HELP,
3398 "-help <flags> will describe flags",
3399 "Display help",
3400 0, 0
3401 },
3402 {
3403 FK_INIT, FK_FILES, globalFileFlag,
3404 "f",
3405 FLG_OPTF,
3406 "read an options file (default ~/.splintrc not loaded)",
3407 "Read an options file (instead of loading default ~/.splintc)",
3408 0, 0
3409 },
3410 {
3411 FK_INIT, FK_FILES, globalFileFlag,
3412 "i",
3413 FLG_INIT,
3414 "set LCL initilization file",
3415 NULL, 0, 0
3416 },
3417 {
3418 FK_INIT, FK_FILES, globalFlag,
3419 "nof",
3420 FLG_NOF,
3421 "do not read options file",
3422 "Do not read the default options file (~/.splintrc)",
3423 0, 0
3424 },
3425 {
3426 FK_INIT, FK_COMMENTS, charFlag,
3427 "commentchar",
3428 FLG_COMMENTCHAR,
3429 "set marker character for syntactic comments (default is '@')",
3430 "Set the marker character for syntactic comments. Comments beginning "
3431 "with /*<char> are interpreted by Splint, where <char> is the "
3432 "comment marker character.",
3433 0, 0
3434 },
3435
3436 /*
3437 ** Limits
3438 */
3439
3440 {
3441 FK_LIMITS, FK_ANSI, modeValueFlag,
3442 "controlnestdepth",
3443 FLG_CONTROLNESTDEPTH,
3444 "set maximum nesting depth of compound statements, iteration control "
3445 "structures, and selection control structures (ANSI89 minimum is 15; ISO99 is 63)",
3446 "Maximum number of control levels exceeded.",
3447 0, 0
3448 },
3449 {
3450 FK_LIMITS, FK_ANSI, modeValueFlag,
3451 "stringliterallen",
3452 FLG_STRINGLITERALLEN,
3453 "set maximum length of string literals (ANSI89 minimum is 509; ISO99 is 4095)",
3454 "Maximum length of string literal exceeded.",
3455 0, 0
3456 },
3457 {
3458 FK_LIMITS, FK_ANSI, modeValueFlag,
3459 "numstructfields",
3460 FLG_NUMSTRUCTFIELDS,
3461 "set maximum number of fields in a struct or union (ANSI89 minimum is 127; ISO99 is 1023)",
3462 "Maximum number of fields in a struct or union exceeded.",
3463 0, 0
3464 },
3465 {
3466 FK_LIMITS, FK_ANSI, modeValueFlag,
3467 "numenummembers",
3468 FLG_NUMENUMMEMBERS,
3469 "set maximum number of members of an enum (ANSI89 minimum is 127; ISO99 is 1023)",
3470 "Limit on maximum number of members of an enum is exceeded.",
3471 0, 0
3472 },
3473 {
3474 FK_LIMITS, FK_ANSI, modeValueFlag,
3475 "includenest",
3476 FLG_INCLUDENEST,
3477 "set maximum number of nested #include files (ANSI89 minimum is 8; ISO99 is 63)",
3478 "Maximum number of nested #include files exceeded.",
3479 0, 0
3480 },
3481 {
3482 FK_LIMITS, FK_ANSI, specialFlag,
3483 "ansi89limits",
3484 FLG_ANSI89LIMITS,
3485 "check for violations of standard limits (controlnestdepth, "
3486 "stringliterallen, includenest, numstructfields, numenummembers) based on ANSI89 standard",
3487 NULL,
3488 0, 0
3489 },
3490 {
3491 FK_LIMITS, FK_ANSI, specialFlag,
3492 "iso99limits",
3493 FLG_ISO99LIMITS,
3494 "check for violations of standard limits (controlnestdepth, "
3495 "stringliterallen, includenest, numstructfields, numenummembers) based on ISO99 standard",
3496 NULL,
3497 0, 0
3498 },
3499
3500 {
3501 FK_PREPROC, FK_NONE, globalExtraArgFlag,
3502 "D<initializer>",
3503 FLG_DEFINE,
3504 "passed to pre-processor",
3505 NULL, 0, 0
3506 },
3507 {
3508 FK_PREPROC, FK_NONE, globalExtraArgFlag,
3509 "U<initializer>",
3510 FLG_UNDEFINE,
3511 "passed to pre-processor",
3512 NULL, 0, 0
3513 },
3514 {
3515 FK_PREPROC, FK_SYNTAX, plainFlag,
3516 "unrecogdirective",
3517 FLG_UNRECOGDIRECTIVE,
3518 "unrecognized pre-processor directive",
3519 "Pre-processor directive is not recognized.",
3520 0, 0
3521 },
3522 {
3523 FK_SUPPRESS, FK_COMMENTS, globalFlag,
3524 "supcounts",
3525 FLG_SUPCOUNTS,
3526 "The number of errors detected does not match number in /*@i<n>@*/.",
3527 NULL, 0, 0
3528 },
3529 {
3530 FK_SUPPRESS, FK_ERRORS, valueFlag,
3531 "limit",
3532 FLG_LIMIT,
3533 "limit <int> consecutive repeated errors",
3534 NULL, 0, 0
3535 },
3536 {
3537 FK_SYNTAX, FK_NONE, plainFlag,
3538 "syntax",
3539 FLG_SYNTAX,
3540 "syntax error in parsing",
3541 "Code cannot be parsed. For help on parse errors, see splint -help parseerrors.",
3542 0, 0
3543 },
3544 {
3545 FK_SYNTAX, FK_NONE, plainFlag,
3546 "trytorecover",
3547 FLG_TRYTORECOVER,
3548 "try to recover from parse error",
3549 "Try to recover from parse error. It really means try - this doesn't usually work.", 0, 0
3550 },
3551 {
3552 FK_SYNTAX, FK_PREPROC, plainFlag,
3553 "preproc",
3554 FLG_PREPROC,
3555 "preprocessing error",
3556 "Preprocessing error.",
3557 0, 0
3558 },
3559
3560 {
3561 FK_TYPE, FK_NONE, plainFlag,
3562 "type",
3563 FLG_TYPE,
3564 "type mismatch",
3565 "Types are incompatible.",
3566 0, 0
3567 },
3568
3569 {
3570 FK_TYPE, FK_NONE, plainFlag,
3571 "stringliteraltoolong",
3572 FLG_STRINGLITTOOLONG,
3573 "string literal too long for character array",
3574 "A string literal is assigned to a char array too small to hold it.",
3575 0, 0
3576 },
3577 {
3578 FK_TYPE, FK_NONE, modeFlag,
3579 "stringliteralnoroomfinalnull",
3580 FLG_STRINGLITNOROOMFINALNULL,
3581 "string literal leaves no room for null terminator",
3582 "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",
3583 0, 0
3584 },
3585 {
3586 FK_TYPE, FK_NONE, modeFlag,
3587 "stringliteralnoroom",
3588 FLG_STRINGLITNOROOM,
3589 "string literal leaves no room for null terminator",
3590 "A string literal is assigned to a char array that is not big enough to hold the null terminator.",
3591 0, 0
3592 },
3593 {
3594 FK_TYPE, FK_NONE, modeFlag,
3595 "stringliteralsmaller",
3596 FLG_STRINGLITSMALLER,
3597 "string literal is smaller than the char array it is assigned to",
3598 "A string literal is assigned to a char array that smaller than the string literal needs.",
3599 0, 0
3600 },
3601 {
3602 FK_TYPE, FK_NONE, modeFlag,
3603 "enummembers",
3604 FLG_ENUMMEMBERS,
3605 "enum members must be int values",
3606 "Type of initial values for enum members must be int.",
3607 0, 0
3608 },
3609
3610 {
3611 FK_TYPE, FK_NONE, plainFlag,
3612 "formattype",
3613 FLG_FORMATTYPE,
3614 "type-mismatch in parameter corresponding to format code in a printf or scanf-like function",
3615 "Type of parameter is not consistent with corresponding code in format string.",
3616 0, 0
3617 },
3618 {
3619 FK_TYPE, FK_NONE, modeFlag,
3620 "formatconst",
3621 FLG_FORMATCONST,
3622 "format parameter is not a string constant (hence variable arguments cannot be typechecked)",
3623 "Format parameter is not known at compile-time. This can lead to security vulnerabilities because the arguments cannot be type checked.",
3624 0, 0
3625 },
3626 {
3627 FK_TYPE, FK_NONE, plainFlag,
3628 "formatcode",
3629 FLG_FORMATCODE,
3630 "invalid format code in format string for printf or scanf-like function",
3631 "Format code in a format string is not valid.",
3632 0, 0
3633 },
3634 {
3635 FK_TYPEEQ, FK_ABSTRACT, modeFlag,
3636 "forwarddecl",
3637 FLG_FORWARDDECL,
3638 "forward declarations of pointers to abstract representation match abstract type",
3639 NULL, 0, 0
3640 },
3641 {
3642 FK_TYPEEQ, FK_ABSTRACT, modeFlag,
3643 "voidabstract",
3644 FLG_ABSTVOIDP,
3645 "void * matches pointers to abstract types, casting ok (dangerous)",
3646 "A pointer to void is cast to a pointer to an abstract type (or vice versa).",
3647 0, 0
3648 },
3649 {
3650 FK_TYPEEQ, FK_POINTER, plainFlag,
3651 "castfcnptr",
3652 FLG_CASTFCNPTR,
3653 "a pointer to a function is cast to a pointer to void (or vice versa)",
3654 "A pointer to a function is cast to (or used as) a pointer to void (or vice versa).",
3655 0, 0
3656 },
3657 {
3658 FK_TYPEEQ, FK_ARRAY, modeFlag,
3659 "charindex",
3660 FLG_CHARINDEX,
3661 "char can be used to index arrays",
3662 "To allow char types to index arrays, use +charindex.", 0, 0
3663 },
3664 {
3665 FK_TYPEEQ, FK_ARRAY, modeFlag,
3666 "enumindex",
3667 FLG_ENUMINDEX,
3668 "enum can be used to index arrays",
3669 "To allow enum types to index arrays, use +enumindex.", 0, 0
3670 },
3671 {
3672 FK_TYPEEQ, FK_BOOL, modeFlag,
3673 "boolint",
3674 FLG_BOOLINT,
3675 "bool and int are equivalent",
3676 "To make bool and int types equivalent, use +boolint.",
3677 0, 0
3678 },
3679 {
3680 FK_TYPEEQ, FK_NONE, modeFlag,
3681 "charint",
3682 FLG_CHARINT,
3683 "char and int are equivalent",
3684 "To make char and int types equivalent, use +charint.",
3685 0, 0
3686 },
3687 {
3688 FK_TYPEEQ, FK_NONE, modeFlag,
3689 "enumint",
3690 FLG_ENUMINT,
3691 "enum and int are equivalent",
3692 "To make enum and int types equivalent, use +enumint.",
3693 0, 0
3694 },
3695 {
3696 FK_TYPEEQ, FK_NONE, modeFlag,
3697 "floatdouble",
3698 FLG_FLOATDOUBLE,
3699 "float and double are equivalent",
3700 "To make float and double types equivalent, use +floatdouble.",
3701 0, 0
3702 },
3703 {
3704 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3705 "ignorequals",
3706 FLG_IGNOREQUALS,
3707 "ignore type qualifiers (long, short, unsigned)",
3708 "To ignore type qualifiers in type comparisons use +ignorequals.",
3709 0, 0
3710 },
3711 {
3712 FK_TYPEEQ, FK_SYNTAX, plainFlag,
3713 "duplicatequals",
3714 FLG_DUPLICATEQUALS,
3715 "report duplicate type qualifiers (e.g., unsigned unsigned)",
3716 "Duplicate type qualifiers not supported by ISO standard.",
3717 0, 0
3718 },
3719 {
3720 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3721 "ignoresigns",
3722 FLG_IGNORESIGNS,
3723 "ignore signs in type comparisons (unsigned matches signed)",
3724 "To ignore signs in type comparisons use +ignoresigns",
3725 0, 0
3726 },
3727 {
3728 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3729 "numliteral",
3730 FLG_NUMLITERAL,
3731 "int literals can be reals",
3732 "An int literal is used as any numeric type (including float and long long). Use +numliteral to "
3733 "allow int literals to be used as any numeric type.",
3734 0, 0
3735 },
3736 {
3737 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3738 "charintliteral",
3739 FLG_CHARINTLITERAL,
3740 "character constants (e.g., 'a') can be used as ints",
3741 "A character constant is used as an int. Use +charintliteral to "
3742 "allow character constants to be used as ints. (This is safe "
3743 "since the actual type of a char constant is int.)",
3744 0, 0
3745 },
3746 {
3747 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3748 "relaxquals",
3749 FLG_RELAXQUALS,
3750 "report qualifier mismatches only if dangerous",
3751 "To allow qualifier mismatches that are not dangerous, use +relaxquals.", 0, 0
3752 },
3753 {
3754 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3755 "relaxtypes",
3756 FLG_RELAXTYPES,
3757 "allow all numeric types to match",
3758 "To allow all numeric types to match, use +relaxtypes.", 0, 0
3759 },
3760 {
3761 FK_TYPEEQ, FK_NONE, modeFlag,
3762 "charunsignedchar",
3763 FLG_CHARUNSIGNEDCHAR,
3764 "allow char and unsigned char types to match",
3765 "To allow char and unsigned char types to match use +charunsignedchar.",
3766 0, 0
3767 },
3768 {
3769 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3770 "matchanyintegral",
3771 FLG_MATCHANYINTEGRAL,
3772 "allow any intergral type to match an arbitrary integral type (e.g., dev_t)",
3773 "To allow arbitrary integral types to match any integral type, use +matchanyintegral.",
3774 0, 0
3775 },
3776 {
3777 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3778 "longunsignedintegral",
3779 FLG_LONGUNSIGNEDINTEGRAL,
3780 "allow long unsigned type to match an arbitrary integral type (e.g., dev_t)",
3781 "To allow arbitrary integral types to match long unsigned, use +longunsignedintegral.",
3782 0, 0
3783 },
3784 {
3785 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3786 "longintegral",
3787 FLG_LONGINTEGRAL,
3788 "allow long type to match an arbitrary integral type (e.g., dev_t)",
3789 "To allow arbitrary integral types to match long unsigned, use +longintegral.",
3790 0, 0
3791 },
3792 {
3793 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3794 "longunsignedunsignedintegral",
3795 FLG_LONGUNSIGNEDUNSIGNEDINTEGRAL,
3796 "allow long unsigned type to match an arbitrary unsigned integral type (e.g., size_t)",
3797 "To allow arbitrary unsigned integral types to match long unsigned, "
3798 "use +longunsignedunsignedintegral.",
3799 0, 0
3800 },
3801 {
3802 FK_TYPEEQ, FK_NUMBERS, modeFlag,
3803 "longsignedintegral",
3804 FLG_LONGSIGNEDINTEGRAL,
3805 "allow long type to match an arbitrary signed integral type (e.g., ssize_t)",
3806 "To allow arbitrary signed integral types to match long unsigned, use +longsignedintegral.",
3807 0, 0
3808 },
3809 {
3810 FK_TYPEEQ, FK_POINTER, plainFlag,
3811 "zeroptr",
3812 FLG_ZEROPTR,
3813 "treat 0 as a pointer",
3814 NULL, 0, 0
3815 },
3816 {
3817 FK_TYPEEQ, FK_BOOL, modeFlag,
3818 "zerobool",
3819 FLG_ZEROBOOL,
3820 "treat 0 as a boolean",
3821 NULL, 0, 0
3822 },
3823 {
3824 FK_UNRECOG, FK_DISPLAY, plainFlag,
3825 "repeatunrecog",
3826 FLG_REPEATUNRECOG,
3827 "do not suppress repeated unrecognized identifier messages (instead of only reporting the first error)",
3828 "Identifier used in code has not been declared. (Message repeated for future uses in this file.)",
3829 0, 0
3830 },
3831 {
3832 FK_UNRECOG, FK_DISPLAY, plainFlag,
3833 "sysunrecog",
3834 FLG_SYSTEMUNRECOG,
3835 "report unrecognized identifiers with system (__) prefix",
3836 "Identifier used in code has not been declared. (Message repeated for "
3837 "future uses in this file.) Use +gnuextensions to make Splint "
3838 "recognize some keywords that are gnu extensions.",
3839 0, 0
3840 },
3841 {
3842 FK_UNRECOG, FK_NONE, plainFlag,
3843 "unrecog",
3844 FLG_UNRECOG,
3845 "unrecognized identifier",
3846 "Identifier used in code has not been declared.", 0, 0
3847 },
3848
3849
3850 {
3851 FK_DECL, FK_TYPE, plainFlag,
3852 "annotationerror",
3853 FLG_ANNOTATIONERROR,
3854 "annotation is used in inconsistent location",
3855 "A declaration uses an invalid annotation.",
3856 0, 0
3857 } ,
3858 {
3859 FK_DECL, FK_TYPE, plainFlag,
3860 "commenterror",
3861 FLG_COMMENTERROR,
3862 "inconsistent syntactic comment",
3863 "A syntactic comment is used inconsistently.",
3864 0, 0
3865 } ,
3866
3867 /*
3868 ** Use Warnings
3869 */
3870
3871 {
3872 FK_WARNUSE, FK_NONE, plainFlag,
3873 "warnuse",
3874 FLG_WARNUSE,
3875 "warn when declaration marked with warn is used",
3876 "Declaration marked with warn clause is used (can be suppresed by more specific flags).",
3877 0, 0
3878 },
3879 {
3880 FK_WARNUSE, FK_SECURITY, modeFlag,
3881 "bufferoverflow",
3882 FLG_BUFFEROVERFLOW,
3883 "possible buffer overflow vulnerability",
3884 "Use of function that may lead to buffer overflow.",
3885 0, 0
3886 },
3887 {
3888 FK_WARNUSE, FK_SECURITY, modeFlag,
3889 "bufferoverflowhigh",
3890 FLG_BUFFEROVERFLOWHIGH,
3891 "likely buffer overflow vulnerability",
3892 "Use of function that may lead to buffer overflow.",
3893 0, 0
3894 },
3895 {
3896 FK_WARNUSE, FK_SECURITY, modeFlag,
3897 "implementationoptional",
3898 FLG_IMPLEMENTATIONOPTIONAL,
3899 "declarator is implementation optional (ISO99 does not require an implementation to provide it)",
3900 "Use of a declarator that is implementation optional, not required by ISO99.",
3901 0, 0
3902 },
3903 {
3904 FK_WARNUSE, FK_NONE, modeFlag,
3905 "legacy",
3906 FLG_LEGACY,
3907 "legacy declaration in Unix Standard",
3908 "Use of a declarator that is marked as a legacy entry in the Unix Standard.",
3909 0, 0
3910 },
3911 {
3912 FK_WARNUSE, FK_SECURITY, modeFlag,
3913 "multithreaded",
3914 FLG_MULTITHREADED,
3915 "function is not reentrant",
3916 "Non-reentrant function should not be used in multithreaded code.",
3917 0, 0
3918 },
3919 {
3920 FK_WARNUSE, FK_SECURITY, modeFlag,
3921 "portability",
3922 FLG_PORTABILITY,
3923 "function may have undefined behavior",
3924 "Use of function that may have implementation-dependent behavior.",
3925 0, 0
3926 },
3927 {
3928 FK_WARNUSE, FK_SECURITY, modeFlag,
3929 "superuser",
3930 FLG_SUPERUSER,
3931 "function is restricted to superusers",
3932 "Call to function restricted to superusers.",
3933 0, 0
3934 },
3935 {
3936 FK_WARNUSE, FK_SECURITY, modeFlag,
3937 "toctou",
3938 FLG_TOCTOU,
3939 "possible time of check, time of use vulnerability",
3940 "Possible time of check, time of use vulnerability.",
3941 0, 0
3942 },
3943 {
3944 FK_WARNUSE, FK_SECURITY, modeFlag,
3945 "unixstandard",
3946 FLG_UNIXSTANDARD,
3947 "function is not required in Standard UNIX Specification",
3948 "Use of function that need not be provided by UNIX implementations",
3949 0, 0
3950 },
3951
3952 /*
3953 ** ITS4 Compability Flags
3954 **
3955 ** These flags flags must appear in order (most severe -> weakest).
3956 */
3957
3958 {
3959 FK_ITS4, FK_SECURITY, specialFlag,
3960 "its4mostrisky",
3961 FLG_ITS4MOSTRISKY,
3962 "most risky security vulnerabilities (from its4 database)",
3963 "Security vulnerability classified as most risky in its4 database.",
3964 0, 0
3965 },
3966 {
3967 FK_ITS4, FK_SECURITY, specialFlag,
3968 "its4veryrisky",
3969 FLG_ITS4VERYRISKY,
3970 "very risky security vulnerabilities (from its4 database)",
3971 "Security vulnerability classified as very risky in its4 database.",
3972 0, 0
3973 },
3974 {
3975 FK_ITS4, FK_SECURITY, specialFlag,
3976 "its4risky",
3977 FLG_ITS4RISKY,
3978 "risky security vulnerabilities (from its4 database)",
3979 "Security vulnerability classified as risky in its4 database.",
3980 0, 0
3981 },
3982 {
3983 FK_ITS4, FK_SECURITY, specialFlag,
3984 "its4moderate",
3985 FLG_ITS4MODERATERISK,
3986 "moderately risky security vulnerabilities (from its4 database)",
3987 "Security vulnerability classified as moderate risk in its4 database.",
3988 0, 0
3989 },
3990 {
3991 FK_ITS4, FK_SECURITY, specialFlag,
3992 "its4low",
3993 FLG_ITS4LOWRISK,
3994 "risky security vulnerabilities (from its4 database)",
3995 "Security vulnerability classified as risky in its4 database.",
3996 0, 0
3997 },
3998
3999 /*
4000 ** Syntactic comments
4001 */
4002
4003 {
4004 FK_SYNCOMMENTS, FK_SUPPRESS, plainFlag,
4005 "nocomments",
4006 FLG_NOCOMMENTS,
4007 "ignore all stylized comments",
4008 NULL, 0, 0
4009 },
4010 {
4011 FK_SYNCOMMENTS, FK_ABSTRACT, plainFlag,
4012 "noaccess",
4013 FLG_NOACCESS,
4014 "ignore access comments",
4015 NULL, 0, 0
4016 },
4017
4018 {
4019 FK_SYNCOMMENTS, FK_SYNTAX, plainFlag,
4020 "unrecogcomments",
4021 FLG_UNRECOGCOMMENTS,
4022 "stylized comment is unrecognized",
4023 "Word after a stylized comment marker does not correspond to a "
4024 "stylized comment.",
4025 0, 0
4026 },
4027 {
4028 FK_SYNCOMMENTS, FK_SYNTAX, plainFlag,
4029 "unrecogflagcomments",
4030 FLG_UNRECOGFLAGCOMMENTS,
4031 "stylized flag comment uses an unrecognized flag",
4032 "Semantic comment attempts to set a flag that is not recognized.",
4033 0, 0
4034 },
4035 {
4036 FK_SYNCOMMENTS, FK_SUPPRESS, modeFlag,
4037 "tmpcomments",
4038 FLG_TMPCOMMENTS,
4039 "interpret t comments (ignore errors in lines marked with /*@t<n>@*/",
4040 NULL, 0, 0
4041 },
4042 {
4043 FK_SYNCOMMENTS, FK_SUPPRESS, plainFlag,
4044 "lintcomments",
4045 FLG_LINTCOMMENTS,
4046 "interpret traditional lint comments (/*FALLTHROUGH*/, /*NOTREACHED*/)",
4047 NULL, 0, 0
4048 },
4049 {
4050 FK_SYNCOMMENTS, FK_SUPPRESS, modeFlag,
4051 "warnlintcomments",
4052 FLG_WARNLINTCOMMENTS,
4053 "warn when a traditional lint comment is used",
4054 "A traditional lint comment is used. Some traditional lint comments "
4055 "are interpreted by Splint to enable easier checking of legacy "
4056 "code. It is preferable to replace these comments with the "
4057 "suggested Splint alternative.",
4058 0, 0
4059 },
4060
4061 /*
4062 ** Comments
4063 */
4064
4065 {
4066 FK_COMMENTS, FK_SYNTAX, plainFlag,
4067 "continuecomment",
4068 FLG_CONTINUECOMMENT,
4069 "line continuation marker (\\) in comment before */ on same line",
4070 "A line continuation marker (\\) appears inside a comment on the same "
4071 "line as the comment close. Preprocessors should handle this "
4072 "correctly, but it causes problems for some preprocessors.",
4073 0, 0
4074 },
4075 {
4076 FK_COMMENTS, FK_SYNTAX, plainFlag,
4077 "slashslashcomment",
4078 FLG_SLASHSLASHCOMMENT,
4079 "use of // comment",
4080 "A // comment is used. ISO C99 allows // comments, but earlier standards did not.",
4081 0, 0
4082 },
4083 {
4084 FK_COMMENTS, FK_SYNTAX, plainFlag,
4085 "nestcomment",
4086 FLG_NESTCOMMENT,
4087 "comment begins inside comment",
4088 "A comment open sequence (/*) appears within a comment. This usually "
4089 "means an earlier comment was not closed.",
4090 0, 0
4091 },
4092
4093 /*
4094 ** Flags for controlling warning message printing.
4095 */
4096
4097 /* Display */
4098
4099 {
4100 FK_DISPLAY, FK_ERRORS, plainFlag,
4101 "quiet",
4102 FLG_QUIET,
4103 "suppress herald and error count",
4104 NULL, 0, 0
4105 },
4106
4107 /*
4108 ** Default is to send messages, warnings and errors to stderr
4109 */
4110
4111 {
4112 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4113 "messagestreamstdout",
4114 FLG_MESSAGESTREAMSTDOUT,
4115 "send status messages to standard output stream",
4116 NULL, 0, 0
4117 },
4118 {
4119 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4120 "messagestreamstderr",
4121 FLG_MESSAGESTREAMSTDERR,
4122 "send status messages to standard error stream",
4123 NULL, 0, 0
4124 },
4125 {
4126 FK_DISPLAY, FK_ERRORS, globalStringFlag, ARG_FILE,
4127 "messagestream",
4128 FLG_MESSAGESTREAM,
4129 "send status messages to <file>",
4130 NULL, 0, 0
4131 },
4132
4133 {
4134 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4135 "warningstreamstdout",
4136 FLG_WARNINGSTREAMSTDOUT,
4137 "send warnings to standard output stream",
4138 NULL, 0, 0
4139 },
4140 {
4141 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4142 "warningstreamstderr",
4143 FLG_WARNINGSTREAMSTDERR,
4144 "send warnings to standard error stream",
4145 NULL, 0, 0
4146 },
4147 {
4148 FK_DISPLAY, FK_ERRORS, globalStringFlag, ARG_FILE,
4149 "warningstream",
4150 FLG_WARNINGSTREAM,
4151 "send warnings to <file>",
4152 NULL, 0, 0
4153 },
4154
4155 {
4156 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4157 "errorstreamstdout",
4158 FLG_ERRORSTREAMSTDOUT,
4159 "send fatal errors to standard output stream",
4160 NULL, 0, 0
4161 },
4162 {
4163 FK_DISPLAY, FK_ERRORS, idemGlobalFlag,
4164 "errorstreamstderr",
4165 FLG_ERRORSTREAMSTDERR,
4166 "send fatal errors to standard error stream",
4167 NULL, 0, 0
4168 },
4169 {
4170 FK_DISPLAY, FK_ERRORS, globalStringFlag, ARG_FILE,
4171 "errorstream",
4172 FLG_ERRORSTREAM,
4173 "send fatal errors to <file>",
4174 NULL, 0, 0
4175 },
4176
4177 {
4178 FK_DISPLAY, FK_ERRORS, globalFlag,
4179 "streamoverwrite",
4180 FLG_STREAMOVERWRITE,
4181 "warn and exit if a stream output file would overwrite an existing file",
4182 NULL, 0, 0
4183 },
4184
4185
4186 {
4187 FK_DISPLAY, FK_ERRORS, plainFlag,
4188 "showsummary",
4189 FLG_SHOWSUMMARY,
4190 "show summary of all errors reported and suppressed",
4191 NULL, 0, 0
4192 },
4193 {
4194 FK_DISPLAY, FK_FILES, plainFlag,
4195 "showscan",
4196 FLG_SHOWSCAN,
4197 "show file names are they are processed",
4198 NULL, 0, 0
4199 },
4200 {
4201 FK_DISPLAY, FK_FILES, plainFlag,
4202 "warnsysfiles",
4203 FLG_WARNSYSFILES,
4204 "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.",
4205 NULL, 0, 0
4206 },
4207 {
4208 FK_DISPLAY, FK_NONE, globalFlag,
4209 "stats",
4210 FLG_STATS,
4211 "display lines processed and time",
4212 NULL, 0, 0
4213 },
4214 {
4215 FK_DISPLAY, FK_NONE, globalFlag,
4216 "timedist",
4217 FLG_TIMEDIST,
4218 "display time distribution",
4219 NULL, 0, 0
4220 },
4221 {
4222 FK_DISPLAY, FK_USE, globalFlag,
4223 "showalluses",
4224 FLG_SHOWUSES,
4225 "show sorted list of uses of all globals",
4226 NULL, 0, 0
4227 },
4228
4229 /* Hints */
4230
4231 {
4232 FK_HINTS, FK_FORMAT, plainFlag,
4233 "hints",
4234 FLG_HINTS,
4235 "provide a hint the first time a particular warning appears",
4236 "Provide a hint the first time a particular warning appears",
4237 0, 0
4238 },
4239 {
4240 FK_HINTS, FK_FORMAT, plainFlag,
4241 "forcehints",
4242 FLG_FORCEHINTS,
4243 "provide a hint for every warnings",
4244 "Provide a hint for every warning",
4245 0, 0
4246 },
4247
4248 /*
4249 ** Flags for debugging
4250 */
4251
4252 {
4253 FK_DEBUG, FK_NONE, valueFlag,
4254 "bugslimit",
4255 FLG_BUGSLIMIT,
4256 "set maximum number of bugs detected before giving up",
4257 NULL, 0, 0
4258 },
4259 {
4260 FK_DEBUG, FK_BOUNDS, plainFlag,
4261 "debugfcnconstraint",
4262 FLG_DEBUGFUNCTIONCONSTRAINT,
4263 "debug function constraints",
4264 "Perform buffer overflow checking even if the errors would be surpressed.",
4265 0, 0
4266 },
4267 {
4268 FK_DEBUG, FK_NONE, specialDebugFlag,
4269 "grammar",
4270 FLG_GRAMMAR,
4271 "debug parsing", NULL,
4272 0, 0
4273 },
4274 {
4275 FK_DEBUG, FK_NONE, debugFlag,
4276 "keep",
4277 FLG_KEEP,
4278 "do not delete temporary files", NULL,
4279 0, 0
4280 },
4281 {
4282 FK_DEBUG, FK_NONE, debugFlag,
4283 "nopp",
4284 FLG_NOPP,
4285 "do not pre-process input files", NULL,
4286 0, 0
4287 },
4288 {
4289 FK_DEBUG, FK_NONE, debugFlag,
4290 "showsourceloc",
4291 FLG_SHOWSOURCELOC,
4292 "display the source code location where a warning is produced", NULL,
4293 0, 0
4294 },
4295} ;
4296
4297
This page took 0.110315 seconds and 5 git commands to generate.