2 # Copyright (c) 2007-2008, Intel Corporation
4 # All rights reserved. This program and the accompanying materials
5 # are licensed and made available under the terms and conditions of the BSD License
6 # which accompanies this distribution. The full text of the license may be found at
7 # http://opensource.org/licenses/bsd-license.php
9 # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
12 # Filename: build_rule.template
17 # "*" is used to indicate that the source files will be processed at the same time.
18 # "?" is used to indicate that the source files will be processed one by one.
20 # "[" <File-Type>[.<Build-Type>][.<Arch>][, <File-Type>[.<Build-Type>][.<Arch>]] "]" <EOL>
21 # <InputFile[.<ToolChainFamily>]> <EOL>
22 # (?|*).<File-Extension> [(\n|,) (?|*).<File-Extension>]
24 # <OutputFile[.<ToolChainFamily>]> <EOL>
30 # <Command[.<ToolChainFamily>]> <EOL>
34 # <Build-Type> is the MODULE_TYPE in EDK2 or COMPONENT_TYPE in EDK.
35 # Missing <InputFile> will cause an exception and break build.
36 # Missing <Command> will cause that related build target won't be generated but
40 ## Placeholders for string substitution
42 # ${src} Source file(s) to be built (full path)
43 # ${s_path} Source file directory (absolute path)
44 # ${s_dir} Source file relative directory within a module
45 # (Note: ${s_dir} is always equals to "." if source file is given in absolute path.)
46 # ${s_name} Source file name without path
47 # ${s_base} Source file name without extension and path
48 # ${s_ext} Source file extension
50 # ${dst} Destination file(s) built from ${src} (full path)
51 # ${d_path} Destination file directory (absolute path)
52 # ${d_name} Destination file name without path
53 # ${d_base} Destination file name without extension and path
54 # ${d_ext} Destination file extension
56 # (+) Directory separator
60 # $(WORKSPACE) Workspace directory
61 # $(OUTPUT_DIR) Directory for intermediate files for building a module
62 # $(DEBUG_DIR) Directory for files used to debug a module
63 # $(BUILD_DIR) All files for building a platform will be put in this directory
64 # $(BIN_DIR) Common directory for executable files
65 # $(FV_DIR) Directory to store flash image files
66 # $(INC) Search path of current module
67 # $(LIBS) Static library files of current module
68 # $(<tool>_FLAGS) Tools flags of current module
69 # $(MODULE_NAME) Current module name
70 # $(MODULE_TYPE) Current module type
71 # $(ARCH) Architecture of current module
72 # $(TOOLCHAIN) Toolchain used to build current module
73 # $(TARGET) Target of current module (DEBUG/RELEASE)
74 # $(<tool>) Path of tool
75 # $(EDK_TOOLS_PATH) Path of build tools
76 # $(<FILE_TYPE_LIST>) File list of each file type
77 # (Note: The macro name is derived from file type name. For example,
78 # C-Code-File will have C_CODE_FILE_LIST macro.)
82 # $(RM) delete command
83 # $(MD) create dir command
84 # $(RD) remove dir command
89 # Don't change following names of file types and their associated files,
90 # which are also used in tools' code
94 # Dynamic-Library-File
96 # Visual-Form-Representation-File
114 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
116 <Command.MSFT, Command.INTEL>
117 "$(CC)" /Fo${dst} $(CC_FLAGS) $(INC) ${src}
120 "$(CC)" -o ${dst} $(CC_FLAGS) $(INC) ${src}
131 [Assembly-Code-File.COMMON.COMMON]
132 <InputFile.MSFT, InputFile.INTEL>
142 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
144 <Command.MSFT, Command.INTEL>
145 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
146 Trim --source-code --convert-hex -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
147 "$(ASM)" /Fo${dst} $(ASM_FLAGS) /I${s_path} $(INC) ${d_path}(+)${s_base}.iii
150 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
151 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
152 "$(ASM)" -o ${dst} $(ASM_FLAGS) $(INC) ${d_path}(+)${s_base}.iii
154 [Assembly-Code-File.COMMON.IPF]
162 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
164 <Command.MSFT, Command.INTEL>
165 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
166 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
167 "$(ASM)" -o ${dst} $(ASM_FLAGS) ${d_path}(+)${s_base}.iii
169 [Visual-Form-Representation-File]
179 $(DEBUG_DIR)(+)${s_dir}(+)${s_base}.c
182 "$(VFRPP)" $(VFRPP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
183 Trim --vfr-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
184 -mkdir ${d_path} > NUL 2>&1
185 "$(VFR)" $(VFR_FLAGS) --output-directory ${d_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
193 $(OUTPUT_DIR)(+)$(MODULE_NAME).lib
195 <Command.MSFT, Command.INTEL>
196 "$(SLINK)" $(SLINK_FLAGS) /OUT:${dst} ${src}
199 "$(SLINK)" -cr ${dst} $(SLINK_FLAGS) ${src}
201 [Static-Library-File]
210 $(DEBUG_DIR)(+)$(MODULE_NAME).dll
212 <Command.MSFT, Command.INTEL>
213 "$(DLINK)" /OUT:${dst} $(DLINK_FLAGS) $(DLINK_SPATH) $(LIBS) ${src}
216 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -\( $(DLINK_SPATH) $(LIBS) ${src} -\) $(DLINK2_FLAGS)
218 [Dynamic-Library-File]
223 $(DEBUG_DIR)(+)$(MODULE_NAME).efi
226 GenFw -e $(MODULE_TYPE) -o ${dst} ${src}
227 $(CP) ${dst} $(OUTPUT_DIR)
228 $(CP) ${dst} $(BIN_DIR)
229 -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR)
231 [Dependency-Expression-File]
236 $(OUTPUT_DIR)(+)$(MODULE_NAME).depex
239 "$(PP)" $(CC_FLAGS) $(APP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
240 Trim --source-code -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
241 GenDepex -t $(MODULE_TYPE) -o ${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
243 [Acpi-Source-Language-File]
248 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml
253 <Command.MSFT, Command.INTEL>
254 Trim --asl-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i ${src}
255 "$(ASLPP)" $(ASLPP_FLAGS) $(INC) /I${s_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
256 "$(ASL)" -p ${dst} $(ASL_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
258 [C-Code-File.AcpiTable]
263 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
268 <Command.MSFT, Command.INTEL>
269 "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
270 "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
271 GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
273 [Acpi-Table-Code-File]
278 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
283 <Command.MSFT, Command.INTEL>
284 "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
285 "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
286 GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
290 ?.asm16, ?.Asm16, ?.ASM16
296 $(OUTPUT_DIR)(+)${s_base}.com
298 <Command.MSFT, Command.INTEL>
299 cd $(OUTPUT_DIR)(+)${s_dir}
300 "$(ASM)" /nologo /c /omf /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj ${src}
301 "$(ASMLINK)" $(ASMLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj,${dst},,,,
305 ?.txt, ?.TXT, ?.Txt, ?.mut
308 $(OUTPUT_DIR)(+)${s_base}.mcb
311 GenFw -o ${dst} -m ${src}
313 [Microcode-Binary-File]
318 $(OUTPUT_DIR)(+)$(MODULE_NAME).bin
321 GenFw -o ${dst} -j ${src}
322 -$(CP) ${dst} $(BIN_DIR)
329 $(DEBUG_DIR)(+)AutoGen.c
330 $(DEBUG_DIR)(+)AutoGen.h