]> git.proxmox.com Git - mirror_edk2.git/blame - BaseTools/Source/Python/Ecc/EccToolError.py
UefiCpuPkg: Move AsmRelocateApLoopStart from Mpfuncs.nasm to AmdSev.nasm
[mirror_edk2.git] / BaseTools / Source / Python / Ecc / EccToolError.py
CommitLineData
30fdf114 1## @file\r
fb0b35e0 2# Standardized Error Handling infrastructures.\r
30fdf114 3#\r
6ffbb358 4# Copyright (c) 2021, Arm Limited. All rights reserved.<BR>\r
a1583a87 5# Copyright (c) 2008 - 2018, Intel Corporation. All rights reserved.<BR>\r
2e351cbe 6# SPDX-License-Identifier: BSD-2-Clause-Patent\r
30fdf114
LG
7#\r
8\r
9ERROR_GENERAL_CHECK_ALL = 1000\r
10ERROR_GENERAL_CHECK_NO_TAB = 1001\r
11ERROR_GENERAL_CHECK_INDENTATION = 1002\r
12ERROR_GENERAL_CHECK_LINE = 1003\r
13ERROR_GENERAL_CHECK_NO_ASM = 1004\r
14ERROR_GENERAL_CHECK_NO_PROGMA = 1005\r
15ERROR_GENERAL_CHECK_CARRIAGE_RETURN = 1006\r
16ERROR_GENERAL_CHECK_FILE_EXISTENCE = 1007\r
e56468c0 17ERROR_GENERAL_CHECK_NON_ACSII = 1008\r
b3d07ff8 18ERROR_GENERAL_CHECK_UNI = 1009\r
1b2467c5 19ERROR_GENERAL_CHECK_UNI_HELP_INFO = 1010\r
a1583a87
HC
20ERROR_GENERAL_CHECK_INVALID_LINE_ENDING = 1011\r
21ERROR_GENERAL_CHECK_TRAILING_WHITE_SPACE_LINE = 1012\r
30fdf114
LG
22\r
23ERROR_SPACE_CHECK_ALL = 2000\r
24\r
25ERROR_PREDICATE_EXPRESSION_CHECK_ALL = 3000\r
26ERROR_PREDICATE_EXPRESSION_CHECK_BOOLEAN_VALUE = 3001\r
27ERROR_PREDICATE_EXPRESSION_CHECK_NO_BOOLEAN_OPERATOR = 3002\r
28ERROR_PREDICATE_EXPRESSION_CHECK_COMPARISON_NULL_TYPE = 3003\r
29\r
30ERROR_HEADER_CHECK_ALL = 4000\r
31ERROR_HEADER_CHECK_FILE = 4001\r
32ERROR_HEADER_CHECK_FUNCTION = 4002\r
33\r
34ERROR_C_FUNCTION_LAYOUT_CHECK_ALL = 5000\r
35ERROR_C_FUNCTION_LAYOUT_CHECK_RETURN_TYPE = 5001\r
36ERROR_C_FUNCTION_LAYOUT_CHECK_OPTIONAL_FUNCTIONAL_MODIFIER = 5002\r
37ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_NAME = 5003\r
38ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_PROTO_TYPE = 5004\r
39ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_BODY = 5005\r
40ERROR_C_FUNCTION_LAYOUT_CHECK_DATA_DECLARATION = 5006\r
41ERROR_C_FUNCTION_LAYOUT_CHECK_NO_INIT_OF_VARIABLE = 5007\r
42ERROR_C_FUNCTION_LAYOUT_CHECK_NO_STATIC = 5008\r
52302d4d
LG
43ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_PROTO_TYPE_2 = 5009\r
44ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_PROTO_TYPE_3 = 5010\r
30fdf114
LG
45\r
46ERROR_INCLUDE_FILE_CHECK_ALL = 6000\r
47ERROR_INCLUDE_FILE_CHECK_IFNDEF_STATEMENT_1 = 6001\r
48ERROR_INCLUDE_FILE_CHECK_IFNDEF_STATEMENT_2 = 6002\r
49ERROR_INCLUDE_FILE_CHECK_IFNDEF_STATEMENT_3 = 6003\r
50ERROR_INCLUDE_FILE_CHECK_DATA = 6004\r
51ERROR_INCLUDE_FILE_CHECK_NAME = 6005\r
52\r
53ERROR_DECLARATION_DATA_TYPE_CHECK_ALL = 7000\r
54ERROR_DECLARATION_DATA_TYPE_CHECK_NO_USE_C_TYPE = 7001\r
55ERROR_DECLARATION_DATA_TYPE_CHECK_IN_OUT_MODIFIER = 7002\r
56ERROR_DECLARATION_DATA_TYPE_CHECK_EFI_API_MODIFIER = 7003\r
57ERROR_DECLARATION_DATA_TYPE_CHECK_ENUMERATED_TYPE = 7004\r
58ERROR_DECLARATION_DATA_TYPE_CHECK_STRUCTURE_DECLARATION = 7005\r
59ERROR_DECLARATION_DATA_TYPE_CHECK_SAME_STRUCTURE = 7007\r
60ERROR_DECLARATION_DATA_TYPE_CHECK_UNION_TYPE = 7006\r
61ERROR_DECLARATION_DATA_TYPE_CHECK_NESTED_STRUCTURE = 7008\r
62\r
63ERROR_NAMING_CONVENTION_CHECK_ALL = 8000\r
64ERROR_NAMING_CONVENTION_CHECK_DEFINE_STATEMENT = 8001\r
65ERROR_NAMING_CONVENTION_CHECK_TYPEDEF_STATEMENT = 8002\r
66ERROR_NAMING_CONVENTION_CHECK_IFNDEF_STATEMENT = 8003\r
67ERROR_NAMING_CONVENTION_CHECK_PATH_NAME = 8004\r
68ERROR_NAMING_CONVENTION_CHECK_VARIABLE_NAME = 8005\r
69ERROR_NAMING_CONVENTION_CHECK_FUNCTION_NAME = 8006\r
70ERROR_NAMING_CONVENTION_CHECK_SINGLE_CHARACTER_VARIABLE = 8007\r
71\r
72ERROR_DOXYGEN_CHECK_ALL = 9000\r
73ERROR_DOXYGEN_CHECK_FILE_HEADER = 9001\r
74ERROR_DOXYGEN_CHECK_FUNCTION_HEADER = 9002\r
75ERROR_DOXYGEN_CHECK_COMMENT_DESCRIPTION = 9003\r
76ERROR_DOXYGEN_CHECK_COMMENT_FORMAT = 9004\r
77ERROR_DOXYGEN_CHECK_COMMAND = 9005\r
78\r
79ERROR_META_DATA_FILE_CHECK_ALL = 10000\r
80ERROR_META_DATA_FILE_CHECK_PATH_NAME = 10001\r
81ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_1 = 10002\r
82ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_2 = 10003\r
83ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_DEPENDENT = 10004\r
84ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_ORDER = 10005\r
85ERROR_META_DATA_FILE_CHECK_LIBRARY_NO_USE = 10006\r
86ERROR_META_DATA_FILE_CHECK_BINARY_INF_IN_FDF = 10007\r
87ERROR_META_DATA_FILE_CHECK_PCD_DUPLICATE = 10008\r
88ERROR_META_DATA_FILE_CHECK_PCD_FLASH = 10009\r
89ERROR_META_DATA_FILE_CHECK_PCD_NO_USE = 10010\r
90ERROR_META_DATA_FILE_CHECK_DUPLICATE_GUID = 10011\r
91ERROR_META_DATA_FILE_CHECK_DUPLICATE_PROTOCOL = 10012\r
92ERROR_META_DATA_FILE_CHECK_DUPLICATE_PPI = 10013\r
93ERROR_META_DATA_FILE_CHECK_MODULE_FILE_NO_USE = 10014\r
94ERROR_META_DATA_FILE_CHECK_PCD_TYPE = 10015\r
40d841f6 95ERROR_META_DATA_FILE_CHECK_MODULE_FILE_GUID_DUPLICATION = 10016\r
2bcc713e 96ERROR_META_DATA_FILE_CHECK_LIBRARY_NAME_DUPLICATE = 10017\r
b3d07ff8
HC
97ERROR_META_DATA_FILE_CHECK_FORMAT_GUID = 10018\r
98ERROR_META_DATA_FILE_CHECK_FORMAT_PROTOCOL = 10019\r
99ERROR_META_DATA_FILE_CHECK_FORMAT_PPI = 10020\r
100ERROR_META_DATA_FILE_CHECK_FORMAT_PCD = 10021\r
14239f66 101ERROR_META_DATA_FILE_CHECK_LIBRARY_NOT_DEFINED = 10022\r
30fdf114
LG
102\r
103ERROR_SPELLING_CHECK_ALL = 11000\r
104\r
703ef6cf
HC
105ERROR_SMM_COMM_PARA_CHECK_BUFFER_TYPE = 12001\r
106\r
30fdf114
LG
107gEccErrorMessage = {\r
108 ERROR_GENERAL_CHECK_ALL : "",\r
a1583a87 109 ERROR_GENERAL_CHECK_NO_TAB : "'TAB' character is not allowed in source code, please replace each 'TAB' with two spaces.",\r
30fdf114
LG
110 ERROR_GENERAL_CHECK_INDENTATION : "Indentation does not follow coding style",\r
111 ERROR_GENERAL_CHECK_LINE : "The width of each line does not follow coding style",\r
112 ERROR_GENERAL_CHECK_NO_ASM : "There should be no use of _asm in the source file",\r
113 ERROR_GENERAL_CHECK_NO_PROGMA : """There should be no use of "#progma" in source file except "#pragma pack(#)\"""",\r
114 ERROR_GENERAL_CHECK_CARRIAGE_RETURN : "There should be a carriage return at the end of the file",\r
115 ERROR_GENERAL_CHECK_FILE_EXISTENCE : "File not found",\r
e56468c0 116 ERROR_GENERAL_CHECK_NON_ACSII : "File has invalid Non-ACSII char",\r
b3d07ff8 117 ERROR_GENERAL_CHECK_UNI : "File is not a valid UTF-16 UNI file",\r
1b2467c5 118 ERROR_GENERAL_CHECK_UNI_HELP_INFO : "UNI file that is associated by INF or DEC file need define the prompt and help information.",\r
a1583a87
HC
119 ERROR_GENERAL_CHECK_INVALID_LINE_ENDING : "Only CRLF (Carriage Return Line Feed) is allowed to line ending.",\r
120 ERROR_GENERAL_CHECK_TRAILING_WHITE_SPACE_LINE : "There should be no trailing white space in one line.",\r
52302d4d 121\r
30fdf114 122 ERROR_SPACE_CHECK_ALL : "",\r
52302d4d 123\r
30fdf114
LG
124 ERROR_PREDICATE_EXPRESSION_CHECK_ALL : "",\r
125 ERROR_PREDICATE_EXPRESSION_CHECK_BOOLEAN_VALUE : "Boolean values and variable type BOOLEAN should not use explicit comparisons to TRUE or FALSE",\r
126 ERROR_PREDICATE_EXPRESSION_CHECK_NO_BOOLEAN_OPERATOR : "Non-Boolean comparisons should use a compare operator (==, !=, >, < >=, <=)",\r
127 ERROR_PREDICATE_EXPRESSION_CHECK_COMPARISON_NULL_TYPE : "A comparison of any pointer to zero must be done via the NULL type",\r
52302d4d 128\r
30fdf114
LG
129 ERROR_HEADER_CHECK_ALL : "",\r
130 ERROR_HEADER_CHECK_FILE : "File header doesn't exist",\r
131 ERROR_HEADER_CHECK_FUNCTION : "Function header doesn't exist",\r
52302d4d 132\r
30fdf114
LG
133 ERROR_C_FUNCTION_LAYOUT_CHECK_ALL : "",\r
134 ERROR_C_FUNCTION_LAYOUT_CHECK_RETURN_TYPE : "Return type of a function should exist and in the first line",\r
135 ERROR_C_FUNCTION_LAYOUT_CHECK_OPTIONAL_FUNCTIONAL_MODIFIER : "Any optional functional modifiers should exist and next to the return type",\r
136 ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_NAME : """Function name should be left justified, followed by the beginning of the parameter list, with the closing parenthesis on its own line, indented two spaces""",\r
137 ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_PROTO_TYPE : "Function prototypes in include files have the same form as function definitions",\r
52302d4d
LG
138 ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_PROTO_TYPE_2 : "Function prototypes in include files have different parameter number with function definitions",\r
139 ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_PROTO_TYPE_3 : "Function prototypes in include files have different parameter modifier with function definitions",\r
30fdf114
LG
140 ERROR_C_FUNCTION_LAYOUT_CHECK_FUNCTION_BODY : "The body of a function should be contained by open and close braces that must be in the first column",\r
141 ERROR_C_FUNCTION_LAYOUT_CHECK_DATA_DECLARATION : "The data declarations should be the first code in a module",\r
142 ERROR_C_FUNCTION_LAYOUT_CHECK_NO_INIT_OF_VARIABLE : "There should be no initialization of a variable as part of its declaration",\r
143 ERROR_C_FUNCTION_LAYOUT_CHECK_NO_STATIC : "There should be no use of STATIC for functions",\r
52302d4d 144\r
30fdf114
LG
145 ERROR_INCLUDE_FILE_CHECK_ALL : "",\r
146 ERROR_INCLUDE_FILE_CHECK_IFNDEF_STATEMENT_1 : "All include file contents should be guarded by a #ifndef statement.",\r
147 ERROR_INCLUDE_FILE_CHECK_IFNDEF_STATEMENT_2 : "The #ifndef must be the first line of code following the file header comment",\r
148 ERROR_INCLUDE_FILE_CHECK_IFNDEF_STATEMENT_3 : "The #endif must appear on the last line in the file",\r
149 ERROR_INCLUDE_FILE_CHECK_DATA : "Include files should contain only public or only private data and cannot contain code or define data variables",\r
fb0b35e0 150 ERROR_INCLUDE_FILE_CHECK_NAME : "No permission for the include file with same names",\r
52302d4d 151\r
30fdf114 152 ERROR_DECLARATION_DATA_TYPE_CHECK_ALL : "",\r
d6f5a505 153 ERROR_DECLARATION_DATA_TYPE_CHECK_NO_USE_C_TYPE : "There should be no use of int, unsigned, char, void, long in any .c, .h or .asl files",\r
30fdf114
LG
154 ERROR_DECLARATION_DATA_TYPE_CHECK_IN_OUT_MODIFIER : """The modifiers IN, OUT, OPTIONAL, and UNALIGNED should be used only to qualify arguments to a function and should not appear in a data type declaration""",\r
155 ERROR_DECLARATION_DATA_TYPE_CHECK_EFI_API_MODIFIER : "The EFIAPI modifier should be used at the entry of drivers, events, and member functions of protocols",\r
156 ERROR_DECLARATION_DATA_TYPE_CHECK_ENUMERATED_TYPE : "Enumerated Type should have a 'typedef' and the name must be in capital letters",\r
157 ERROR_DECLARATION_DATA_TYPE_CHECK_STRUCTURE_DECLARATION : "Structure Type should have a 'typedef' and the name must be in capital letters",\r
158 ERROR_DECLARATION_DATA_TYPE_CHECK_SAME_STRUCTURE : "No permission for the structure with same names",\r
159 ERROR_DECLARATION_DATA_TYPE_CHECK_UNION_TYPE : "Union Type should have a 'typedef' and the name must be in capital letters",\r
160 ERROR_DECLARATION_DATA_TYPE_CHECK_NESTED_STRUCTURE : "Complex types should be typedef-ed",\r
52302d4d 161\r
30fdf114
LG
162 ERROR_NAMING_CONVENTION_CHECK_ALL : "",\r
163 ERROR_NAMING_CONVENTION_CHECK_DEFINE_STATEMENT : "Only capital letters are allowed to be used for #define declarations",\r
164 ERROR_NAMING_CONVENTION_CHECK_TYPEDEF_STATEMENT : "Only capital letters are allowed to be used for typedef declarations",\r
6ffbb358 165 ERROR_NAMING_CONVENTION_CHECK_IFNDEF_STATEMENT : "The #ifndef at the start of an include file should have one postfix underscore, and no prefix underscore character '_'",\r
30fdf114
LG
166 ERROR_NAMING_CONVENTION_CHECK_PATH_NAME : """Path name does not follow the rules: 1. First character should be upper case 2. Must contain lower case characters 3. No white space characters""",\r
167 ERROR_NAMING_CONVENTION_CHECK_VARIABLE_NAME : """Variable name does not follow the rules: 1. First character should be upper case 2. Must contain lower case characters 3. No white space characters 4. Global variable name must start with a 'g'""",\r
168 ERROR_NAMING_CONVENTION_CHECK_FUNCTION_NAME : """Function name does not follow the rules: 1. First character should be upper case 2. Must contain lower case characters 3. No white space characters""",\r
169 ERROR_NAMING_CONVENTION_CHECK_SINGLE_CHARACTER_VARIABLE : "There should be no use of short (single character) variable names",\r
52302d4d 170\r
30fdf114
LG
171 ERROR_DOXYGEN_CHECK_ALL : "",\r
172 ERROR_DOXYGEN_CHECK_FILE_HEADER : "The file headers should follow Doxygen special documentation blocks in section 2.3.5",\r
173 ERROR_DOXYGEN_CHECK_FUNCTION_HEADER : "The function headers should follow Doxygen special documentation blocks in section 2.3.5",\r
174 ERROR_DOXYGEN_CHECK_COMMENT_DESCRIPTION : """The first line of text in a comment block should be a brief description of the element being documented and the brief description must end with a period.""",\r
175 ERROR_DOXYGEN_CHECK_COMMENT_FORMAT : "For comment line with '///< ... text ...' format, if it is used, it should be after the code section",\r
f8895c2a 176 ERROR_DOXYGEN_CHECK_COMMAND : "Only Doxygen commands '@bug', '@todo', '@example', '@file', '@attention', '@param', '@post', '@pre', '@retval', '@return', '@sa', '@since', '@test', '@note', '@par', '@endcode', '@code', '@{', '@}' are allowed to mark the code",\r
52302d4d 177\r
30fdf114
LG
178 ERROR_META_DATA_FILE_CHECK_ALL : "",\r
179 ERROR_META_DATA_FILE_CHECK_PATH_NAME : "The file defined in meta-data does not exist",\r
52302d4d 180 ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_1 : "A library instances defined for a given module (or dependent library instance) doesn't match the module's type.",\r
30fdf114
LG
181 ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_2 : "A library instance must specify the Supported Module Types in its INF file",\r
182 ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_DEPENDENT : "A library instance must be defined for all dependent library classes",\r
183 ERROR_META_DATA_FILE_CHECK_LIBRARY_INSTANCE_ORDER : "The library Instances specified by the LibraryClasses sections should be listed in order of dependencies",\r
184 ERROR_META_DATA_FILE_CHECK_LIBRARY_NO_USE : "There should be no unnecessary inclusion of library classes in the INF file",\r
2bcc713e 185 ERROR_META_DATA_FILE_CHECK_LIBRARY_NAME_DUPLICATE : "Duplicate Library Class Name found",\r
30fdf114
LG
186 ERROR_META_DATA_FILE_CHECK_BINARY_INF_IN_FDF : "An INF file is specified in the FDF file, but not in the DSC file, therefore the INF file must be for a Binary module only",\r
187 ERROR_META_DATA_FILE_CHECK_PCD_DUPLICATE : "Duplicate PCDs found",\r
188 ERROR_META_DATA_FILE_CHECK_PCD_FLASH : "PCD settings in the FDF file should only be related to flash",\r
b03dceb8 189 ERROR_META_DATA_FILE_CHECK_PCD_NO_USE : "There should be no PCDs declared in INF files that are not specified in either a DSC or FDF file",\r
30fdf114
LG
190 ERROR_META_DATA_FILE_CHECK_DUPLICATE_GUID : "Duplicate GUID found",\r
191 ERROR_META_DATA_FILE_CHECK_DUPLICATE_PROTOCOL : "Duplicate PROTOCOL found",\r
192 ERROR_META_DATA_FILE_CHECK_DUPLICATE_PPI : "Duplicate PPI found",\r
52302d4d 193 ERROR_META_DATA_FILE_CHECK_MODULE_FILE_NO_USE : "No used module files found",\r
30fdf114 194 ERROR_META_DATA_FILE_CHECK_PCD_TYPE : "Wrong C code function used for this kind of PCD",\r
40d841f6 195 ERROR_META_DATA_FILE_CHECK_MODULE_FILE_GUID_DUPLICATION : "Module file has FILE_GUID collision with other module file",\r
b3d07ff8
HC
196 ERROR_META_DATA_FILE_CHECK_FORMAT_GUID : "Wrong GUID Format used in Module file",\r
197 ERROR_META_DATA_FILE_CHECK_FORMAT_PROTOCOL : "Wrong Protocol Format used in Module file",\r
198 ERROR_META_DATA_FILE_CHECK_FORMAT_PPI : "Wrong Ppi Format used in Module file",\r
199 ERROR_META_DATA_FILE_CHECK_FORMAT_PCD : "Wrong Pcd Format used in Module file",\r
14239f66 200 ERROR_META_DATA_FILE_CHECK_LIBRARY_NOT_DEFINED : "Not defined LibraryClass used in the Module file.",\r
30fdf114 201 ERROR_SPELLING_CHECK_ALL : "",\r
703ef6cf
HC
202\r
203 ERROR_SMM_COMM_PARA_CHECK_BUFFER_TYPE : "SMM communication function may use wrong parameter type",\r
30fdf114
LG
204 }\r
205\r