]> git.proxmox.com Git - mirror_edk2.git/blame - BaseTools/Source/Python/Ecc/config.ini
BaseTools/Capsule: Do not support -o with --dump-info
[mirror_edk2.git] / BaseTools / Source / Python / Ecc / config.ini
CommitLineData
30fdf114
LG
1## @file\r
2# This file is used to set configuration of ECC tool\r
3# For the items listed below, 1 means valid, 0 means invalid\r
4#\r
1b2467c5 5# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>\r
40d841f6 6# This program and the accompanying materials\r
30fdf114
LG
7# are licensed and made available under the terms and conditions of the BSD License\r
8# which accompanies this distribution. The full text of the license may be found at\r
9# http://opensource.org/licenses/bsd-license.php\r
10#\r
11# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
12# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
13#\r
14\r
15#\r
16# Identify the version of current configuration\r
17#\r
18Version = 0.1\r
19\r
20#\r
21# Identify to if check all items\r
22# 1 - Check all items and ignore all other detailed items\r
23# 0 - Not check all items, the tool will go through all other detailed items to decide to check or not\r
e56468c0 24#\r
30fdf114
LG
25CheckAll = 0\r
26\r
27#\r
28# Identify to if automatically correct mistakes\r
29# 1 - Automatically correct\r
30# 0 - Not automatically correct\r
31# Only the following check points can be automatically corrected, others not listed below are not supported even it is 1\r
32#\r
33# GeneralCheckTab\r
34# GeneralCheckIndentation\r
35# GeneralCheckLine\r
36# GeneralCheckCarriageReturn\r
37# SpaceCheckAll\r
38#\r
39AutoCorrect = 1\r
40\r
41#\r
42# List customized Modifer here, split with ','\r
43#\r
72358997 44ModifierList = IN, OUT, OPTIONAL, UNALIGNED, EFI_RUNTIMESERVICE, EFI_BOOTSERVICE, EFIAPI, TPMINTERNALAPI, STATIC\r
30fdf114
LG
45\r
46#\r
47# General Checking\r
48#\r
49GeneralCheckAll = 0\r
50\r
51# Check whether NO Tab is used, replaced with spaces\r
52GeneralCheckNoTab = 1\r
53# The width of Tab\r
54GeneralCheckTabWidth = 2\r
55# Check whether the indentation is followed coding style\r
56GeneralCheckIndentation = 1\r
57# The width of indentation\r
58GeneralCheckIndentationWidth = 2\r
59# Check whether no line is exceeding defined widty\r
60GeneralCheckLine = 1\r
61# The width of a line\r
62GeneralCheckLineWidth = 120\r
63# Check whether no use of _asm in the source file\r
64GeneralCheckNo_Asm = 1\r
65# Check whether no use of "#progma" in source file except "#pragma pack(#)".\r
66GeneralCheckNoProgma = 1\r
67# Check whether there is a carriage return at the end of the file\r
68GeneralCheckCarriageReturn = 1\r
69# Check whether the file exists\r
70GeneralCheckFileExistence = 1\r
e56468c0 71# Check whether file has non ACSII char\r
72GeneralCheckNonAcsii = 1\r
b3d07ff8
HC
73# Check whether UNI file is valid\r
74GeneralCheckUni = 1\r
a1583a87
HC
75# Check Only use CRLF (Carriage Return Line Feed) line endings.\r
76self.GeneralCheckLineEnding = 1\r
77# Check if there is no trailing white space in one line.\r
78self.GeneralCheckTrailingWhiteSpaceLine = 1\r
30fdf114
LG
79\r
80#\r
81# Space Checking\r
82#\r
83SpaceCheckAll = 1\r
84\r
85#\r
86# Predicate Expression Checking\r
87#\r
88PredicateExpressionCheckAll = 0\r
89\r
90# Check whether Boolean values, variable type BOOLEAN not use explicit comparisons to TRUE or FALSE\r
91PredicateExpressionCheckBooleanValue = 1\r
e56468c0 92# Check whether Non-Boolean comparisons use a compare operator (==, !=, >, < >=, <=).\r
30fdf114
LG
93PredicateExpressionCheckNonBooleanOperator = 1\r
94# Check whether a comparison of any pointer to zero must be done via the NULL type\r
95PredicateExpressionCheckComparisonNullType = 1\r
96\r
97#\r
98# Headers Checking\r
99#\r
100HeaderCheckAll = 0\r
101\r
102# Check whether File header exists\r
103HeaderCheckFile = 1\r
104# Check whether Function header exists\r
105HeaderCheckFunction = 1\r
d0acc87a
LG
106# Check whether Meta data File header Comment End with '##'\r
107HeaderCheckFileCommentEnd = 0\r
108# Check whether C File header Comment content start with two spaces\r
109HeaderCheckCFileCommentStartSpacesNum = 0\r
110# Check whether C File header Comment's each reference at list should begin with a bullet character '-'\r
111HeaderCheckCFileCommentReferenceFormat = 0\r
112# Check whether C File header Comment have the License immediately after the ""Copyright"" line\r
113HeaderCheckCFileCommentLicenseFormat = 0\r
30fdf114
LG
114\r
115#\r
116# C Function Layout Checking\r
117#\r
118CFunctionLayoutCheckAll = 0\r
119\r
120# Check whether return type exists and in the first line\r
121CFunctionLayoutCheckReturnType = 1\r
122# Check whether any optional functional modifiers exist and next to the return type\r
123CFunctionLayoutCheckOptionalFunctionalModifier = 1\r
124# Check whether the next line contains the function name, left justified, followed by the beginning of the parameter list\r
125# Check whether the closing parenthesis is on its own line and also indented two spaces\r
126CFunctionLayoutCheckFunctionName = 1\r
127# Check whether the function prototypes in include files have the same form as function definitions\r
128CFunctionLayoutCheckFunctionPrototype = 1\r
129# Check whether the body of a function is contained by open and close braces that must be in the first column\r
130CFunctionLayoutCheckFunctionBody = 1\r
131# Check whether the data declarations is the first code in a module.\r
132CFunctionLayoutCheckDataDeclaration = 1\r
133# Check whether no initialization of a variable as part of its declaration\r
134CFunctionLayoutCheckNoInitOfVariable = 1\r
135# Check whether no use of STATIC for functions\r
136CFunctionLayoutCheckNoStatic = 1\r
137\r
138#\r
139# Include Files Checking\r
140#\r
141IncludeFileCheckAll = 0\r
142\r
143#Check whether having include files with same name\r
144IncludeFileCheckSameName = 1\r
145# Check whether all include file contents is guarded by a #ifndef statement.\r
146# the #ifndef must be the first line of code following the file header comment\r
147# the #endif must appear on the last line in the file\r
148IncludeFileCheckIfndefStatement = 1\r
149# Check whether include files contain only public or only private data\r
150# Check whether include files NOT contain code or define data variables\r
151IncludeFileCheckData = 1\r
152\r
153#\r
154# Declarations and Data Types Checking\r
155#\r
156DeclarationDataTypeCheckAll = 0\r
157\r
158# Check whether no use of int, unsigned, char, void, static, long in any .c, .h or .asl files.\r
159DeclarationDataTypeCheckNoUseCType = 1\r
160# Check whether the modifiers IN, OUT, OPTIONAL, and UNALIGNED are used only to qualify arguments to a function and should not appear in a data type declaration\r
161DeclarationDataTypeCheckInOutModifier = 1\r
162# Check whether the EFIAPI modifier should be used at the entry of drivers, events, and member functions of protocols\r
163DeclarationDataTypeCheckEFIAPIModifier = 1\r
164# Check whether Enumerated Type has a 'typedef' and the name is capital\r
165DeclarationDataTypeCheckEnumeratedType = 1\r
166# Check whether Structure Type has a 'typedef' and the name is capital\r
167DeclarationDataTypeCheckStructureDeclaration = 1\r
168# Check whether having same Structure\r
169DeclarationDataTypeCheckSameStructure = 1\r
170# Check whether Union Type has a 'typedef' and the name is capital\r
171DeclarationDataTypeCheckUnionType = 1\r
172\r
173\r
174#\r
175# Naming Conventions Checking\r
176#\r
177NamingConventionCheckAll = 0\r
178\r
179# Check whether only capital letters are used for #define declarations\r
180NamingConventionCheckDefineStatement = 1\r
181# Check whether only capital letters are used for typedef declarations\r
182NamingConventionCheckTypedefStatement = 1\r
183# Check whether the #ifndef at the start of an include file uses both prefix and postfix underscore characters, '_'.\r
184NamingConventionCheckIfndefStatement = 1\r
185# Rule for path name, variable name and function name\r
186# 1. First character should be upper case\r
187# 2. Existing lower case in a word\r
188# 3. No space existence\r
189# 4. Global variable name must start by a 'g'\r
190# Check whether the path name followed the rule\r
191NamingConventionCheckPathName = 1\r
192# Check whether the variable name followed the rule\r
193NamingConventionCheckVariableName = 1\r
194# Check whether the function name followed the rule\r
195NamingConventionCheckFunctionName = 1\r
196# Check whether NO use short variable name with single character\r
197NamingConventionCheckSingleCharacterVariable = 1\r
198\r
199#\r
200# Doxygen Checking\r
201#\r
202DoxygenCheckAll = 0\r
203\r
204# Check whether the file headers are followed Doxygen special documentation blocks in section 2.3.5\r
205DoxygenCheckFileHeader = 1\r
206# Check whether the function headers are followed Doxygen special documentation blocks in section 2.3.5\r
207DoxygenCheckFunctionHeader = 1\r
e56468c0 208# Check whether the first line of text in a comment block is a brief description of the element being documented.\r
30fdf114
LG
209# The brief description must end with a period.\r
210DoxygenCheckCommentDescription = 1\r
211# Check whether comment lines with '///< ... text ...' format, if it is used, it should be after the code section.\r
212DoxygenCheckCommentFormat = 1\r
213# Check whether only Doxygen commands allowed to mark the code are @bug and @todo.\r
214DoxygenCheckCommand = 1\r
215\r
216#\r
217# Meta-Data File Processing Checking\r
218#\r
219MetaDataFileCheckAll = 0\r
220\r
221# Check whether each file defined in meta-data exists\r
222MetaDataFileCheckPathName = 1\r
223# Generate a list for all files defined in meta-data files\r
224MetaDataFileCheckGenerateFileList = 1\r
225# The path of log file\r
226MetaDataFileCheckPathOfGenerateFileList = File.log\r
e56468c0 227# Check whether all Library Instances defined for a given module (or dependent library instance) match the module's type.\r
228# Each Library Instance must specify the Supported Module Types in its INF file,\r
30fdf114
LG
229# and any module specifying the library instance must be one of the supported types.\r
230MetaDataFileCheckLibraryInstance = 1\r
231# Check whether a Library Instance has been defined for all dependent library classes\r
232MetaDataFileCheckLibraryInstanceDependent = 1\r
233# Check whether the Library Instances specified by the LibraryClasses sections are listed in order of dependencies\r
234MetaDataFileCheckLibraryInstanceOrder = 1\r
235# Check whether the unnecessary inclusion of library classes in the INF file\r
236MetaDataFileCheckLibraryNoUse = 1\r
14239f66
HC
237# Check the header file in Include\Library directory whether be defined in the package DEC file.\r
238MetaDataFileCheckLibraryDefinedInDec = 1\r
30fdf114
LG
239# Check whether an INF file is specified in the FDF file, but not in the DSC file, then the INF file must be for a Binary module only\r
240MetaDataFileCheckBinaryInfInFdf = 1\r
241# Not to report error and warning related OS include file such as "windows.h" and "stdio.h".\r
242# Check whether a PCD is set in a DSC file or the FDF file, but not in both.\r
243MetaDataFileCheckPcdDuplicate = 1\r
244# Check whether PCD settings in the FDF file can only be related to flash.\r
245MetaDataFileCheckPcdFlash = 1\r
246# Check whether PCDs used in INF files but not specified in DSC or FDF files\r
b3d07ff8 247MetaDataFileCheckPcdNoUse = 0\r
30fdf114
LG
248# Check whether having duplicate guids defined for Guid/Protocol/Ppi\r
249MetaDataFileCheckGuidDuplicate = 1\r
250# Check whether all files under module directory are described in INF files\r
251MetaDataFileCheckModuleFileNoUse = 1\r
252# Check whether the PCD is correctly used in C function via its type\r
253MetaDataFileCheckPcdType = 1\r
40d841f6
LG
254# Check whether there are FILE_GUID duplication among different INF files\r
255MetaDataFileCheckModuleFileGuidDuplication = 1\r
30fdf114 256\r
1b2467c5
HC
257#\r
258# Uni File Processing Checking\r
259#\r
260UniCheckAll = 0\r
261# Check INF or DEC file whether defined the localized information in the associated UNI file.\r
262UniCheckHelpInfo = 1\r
263# Check PCD whether defined the prompt, help in the DEC file and localized information in the associated UNI file.\r
264UniCheckPCDInfo = 1\r
b739e14d
HC
265# Uncheck whether UNI file is in UTF-16 format\r
266GeneralCheckUni = -1\r
1b2467c5 267\r
703ef6cf
HC
268#\r
269# SMM Communicate Function Parameter Checking\r
270#\r
271SmmCommParaCheckAll = 0\r
272# Check if the EFI_SMM_COMMUNICATION_PROTOCOL parameter buffer type is Reserved / ACPI NVS or UEFI RT code/data\r
273SmmCommParaCheckBufferType = 1\r
274\r
30fdf114
LG
275#\r
276# The check points in this section are reserved\r
277#\r
278# GotoStatementCheckAll = 0\r
279# SpellingCheckAll = 0\r
280#\r
e56468c0 281\r
282# A list for binary file ext name\r
283BinaryExtList = EXE, EFI, FV, ROM, DLL, COM, BMP, GIF, PYD, CMP, BIN, JPG, UNI, RAW, COM2, LIB, DEPEX, SYS, DB\r
e4ac870f
LG
284# A list for only scanning dirs, the dirs should be the top folder(s) under workspace\r
285ScanOnlyDirList = ScanFolder1 ScanFolder2\r