- 2009 patch
[cparser] / warning.h
1 /*
2  * This file is part of cparser.
3  * Copyright (C) 2007-2009 Matthias Braun <matze@braunis.de>
4  *
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU General Public License
7  * as published by the Free Software Foundation; either version 2
8  * of the License, or (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
18  * 02111-1307, USA.
19  */
20 #ifndef WARNING_H
21 #define WARNING_H
22
23 #include <stdbool.h>
24
25 void set_warning_opt(const char *opt);
26
27 typedef struct warning_t {
28         bool other:1;                               /**< Warnings not covered by any option below */
29
30         bool address:1;                             /**< Warn about suspicious uses of memory addresses */
31         bool aggregate_return:1;                    /**< Warn if any functions that return structures or unions are defined or called */
32         bool attribute:1;                           /**< Warn if an unexpected `__attribute__' is used or function attributes applied to variables, etc. */
33 #if 0 // TODO
34         bool bad_function_cast:1;                   /**< Warn whenever a function call is cast to a non-matching type */
35         bool cast_align:1;                          /**< Warn whenever a pointer is cast such that the required alignment of the target is increased */
36 #endif
37         bool cast_qual:1;                           /**< Warn whenever a pointer is cast so as to remove a type qualifier from the target type */
38         bool char_subscripts:1;                     /**< Warn if an array subscript has the type 'char' */
39         bool comment:1;                             /**< Warn whenever a comment-start sequence appears in a comment, or whenever a Backslash-Newline appears in a '//' comment. */
40         bool conversion:1;                          /**< Warn if a prototype causes a type conversion that is different from what would happen to the same argument in the absence of a prototype */
41 #if 0 // TODO
42         bool cpp_compat:1;                          /**< Warn about ISO C constructs that are outside of the common subset of ISO C and ISO C++. */
43 #endif
44         bool declaration_after_statement:1;         /**< Warn when a declaration is found after a statement in a block */
45         bool deprecated_declarations:1;             /* TODO implement for types */ /**< Warn about uses of functions, variables and types marked as deprecated by using the 'deprecated' attribute */
46         bool div_by_zero:1;                         /**< Warn about compile-time integer division by zero */
47         bool empty_statement:1;                     /**< Warn about empty statements, i.e. lone ';'  */
48 #if 0 // TODO
49         bool endif_labels:1;                        /**< Warn whenever an '#else' or an '#endif' are followed by text */
50 #endif
51         bool error_implicit_function_declaration:1; /**< Generate an error, when calling a function without a prior declaration */
52         bool fatal_errors:1;                        /**< First error stops the compilation */
53         bool float_equal:1;                         /**< Warn if floating point values are used in equality comparisons */
54         bool format:1;                              /**< Check printf-style format strings */
55         bool implicit_function_declaration:1;       /**< Warn whenever a function is used before being declared */
56         bool implicit_int:1;                        /**< Warn when a declaration does not specify a type */
57         bool init_self:1;                           /**< Warn about uninitialized variables which are initialized with themselves. */
58 #if 0 // TODO
59         bool inline:1;                              /**< Warn if a function can not be inlined and it was declared as inline */
60         bool int_to_pointer_cast:1;                 /**< Warn if cast from integer to pointer of different size. */
61 #endif
62         bool long_long:1;                           /**< Warn if 'long long' type is used */
63         bool main:1;                                /**< Warn if the type of 'main' is suspicious */
64 #if 0 // TODO
65         bool missing_braces:1;                      /**< Warn if an aggregate or union initializer is not fully bracketed */
66 #endif
67         bool missing_declarations:1;                /**< Warn if a global function is defined without a previous declaration */
68 #if 0 // TODO
69         bool missing_field_initializers:1;          /**< Warn if a structure's initializer has some fields missing. */
70         bool missing_format_attribute:1;            /**< If '-Wformat' is enabled, also warn about functions which might be candidates for 'format' attributes */
71 #endif
72         bool missing_noreturn:1;                    /**< Warn about functions which might be candidates for attribute 'noreturn' */
73         bool missing_prototypes:1;                  /**< Warn if a global function is defined without a previous prototype declaration */
74         bool multichar:1;                           /**< Warn if a multicharacter constant ('FOOF') is used. */
75         bool nested_externs:1;                      /**< Warn if an 'extern' declaration is encountered within a function. */
76         bool nonnull:1;                             /**< Warn about passing a null pointer for arguments marked nonnull. */
77         bool old_style_definition:1;                /**< Warn if an old-style function definition is used. */
78         bool packed:1;                              /**< Warn if a structure is given the packed attribute, but the packed attribute has no effect on the layout or size of the structure */
79         bool padded:1;                              /**< Warn if padding is included in a structure, either to align an element of the structure or to align the whole structure */
80         bool parentheses:1;                         /**< Warn if parentheses are omitted in certain contexts (assignment where truth value is expected, if-else-braces) */
81         bool pointer_arith:1;                       /**< Warn about anything that depends on the "size of" a function type or of 'void' */
82 #if 0 // TODO
83         bool pointer_to_int_cast:1;                 /**< Warn if cast from pointer to integer of different size. */
84 #endif
85         bool redundant_decls:1;                     /**< Warn about redundant declarations */
86         bool return_type:1;                         /* TODO not fully implemented */ /**< Warn about function definitions with a return-type that defaults to 'int'.  Also warn about any 'return' statement with no return-value in a function whose return-type is not 'void'. */
87         bool s_are_errors:1;                        /**< Treat warnings as errors */
88 #if 0 // TODO
89         bool sequence_point:1;                      /**< Warn about code that may have undefined semantics because of violations of sequence point rules */
90 #endif
91         bool shadow:1;                              /**< Warn whenever a local variable shadows another local variable, parameter or global variable or whenever a built-in function is shadowed */
92         bool sign_compare:1;                        /**< Warn when a comparison between signed and unsigned values could produce an incorrect result when the signed value is converted to unsigned */
93 #if 0 // TODO
94         bool strict_aliasing:1;                     /**< Warn about code which might break the strict aliasing rules that the compiler is using for optimization. */
95 #endif
96         bool strict_prototypes:1;                   /**< Warn if a function declaration has an unspecified parameter list */
97         bool switch_default:1;                      /**< Warn whenever a 'switch' statement does not have a 'default' case */
98         bool switch_enum:1;                         /**< Warn about 'switch' statements with an enum as index type and missing case labels or case labels outside the enum range TODO has an alias -Wswitch? */
99         bool traditional:1;                         /**< Warn about certain constructs that behave differently in traditional and ISO C */
100 #if 0 // TODO
101         bool undef:1;                               /**< Warn if an undefined identifier is evaluated in an '#if' directive */
102         bool uninitialized:1;                       /**< Warn if an automatic variable is used without being initialized or if a variable may be clobbered by a 'setjmp' call. */
103 #endif
104         bool unknown_pragmas:1;                     /**< Warn when a #pragma directive is encountered which is not understood */
105         bool unreachable_code:1;                    /**< Warn if the compiler detects that code will never be executed */
106         bool unused_function:1;                     /**< Warn whenever a static function is declared but not defined or a non-inline static function is unused */
107         bool unused_label:1;                        /**< Warn whenever a label is declared but not used */
108         bool unused_parameter:1;                    /**< Warn whenever a function parameter is unused aside from its declaration */
109         bool unused_value:1;                        /**< Warn whenever a statement computes a result that is explicitly not used */
110         bool unused_variable:1;                     /**< Warn whenever a local variable or non-constant static variable is unused aside from its declaration */
111         bool write_strings:1;                       /**< Give string constants the type 'const char[LENGTH]' so that copying the address of one into a 'char *' pointer will get a warning */
112 } warning_t;
113
114 extern warning_t warning;
115
116 #endif