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