2 # Copyright (c) 2007-2009, Intel Corporation
3 # Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.
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 # $(INC_LIST) A file containing search pathes of current module
68 # $(LIBS) Static library files of current module
69 # $(<tool>_FLAGS) Tools flags of current module
70 # $(MODULE_NAME) Current module name
71 # $(MODULE_TYPE) Current module type
72 # $(MODULE_GUID) Current module guid
73 # $(ARCH) Architecture of current module
74 # $(TOOLCHAIN) Toolchain used to build current module
75 # $(TARGET) Target of current module (DEBUG/RELEASE)
76 # $(<tool>) Path of tool
77 # $(EDK_TOOLS_PATH) Path of build tools
78 # $(<FILE_TYPES>) File list of each file type
79 # (Note: The macro name is derived from file type name. For example,
80 # C-Code-File will have C_CODE_FILES macro.)
81 # $(<FILE_TYPES_LIST>) Macro point to a file containing list of files of a file type
83 # Note: The macro and file name are derived from file type name.
84 # For example, C-Code-File will have C_CODE_FILES_LIST macro pointing
85 # to $(OUTPUT_DIR)/c_code_files.lst. The list file and macro name
86 # will be generated only when this macro is used in command line.
87 # This is intended to get over the long command line limitation.
92 # $(RM) delete command
93 # $(MD) create dir command
94 # $(RD) remove dir command
99 # Don't change following names of file types and their associated files,
100 # which are also used in tools' code
104 # Dynamic-Library-File
105 # Static-Library-File
106 # Visual-Form-Representation-File
124 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
126 <Command.MSFT, Command.INTEL>
127 "$(CC)" /Fo${dst} $(CC_FLAGS) $(INC) ${src}
129 <Command.GCC, Command.RVCT>
130 # For RVCTCYGWIN CC_FLAGS must be first to work around pathing issues
131 "$(CC)" $(CC_FLAGS) -o ${dst} $(INC) ${src}
132 "$(SYMRENAME)" $(SYMRENAME_FLAGS) ${dst}
143 [Assembly-Code-File.COMMON.COMMON]
144 <InputFile.MSFT, InputFile.INTEL, InputFile.RVCT>
154 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
156 <Command.MSFT, Command.INTEL>
157 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
158 Trim --source-code --convert-hex -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
159 "$(ASM)" /Fo${dst} $(ASM_FLAGS) /I${s_path} $(INC) ${d_path}(+)${s_base}.iii
161 <Command.GCC, Command.RVCT>
162 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
163 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
164 # For RVCTCYGWIN ASM_FLAGS must be first to work around pathing issues
165 "$(ASM)" $(ASM_FLAGS) -o ${dst} $(INC) ${d_path}(+)${s_base}.iii
167 [Assembly-Code-File.COMMON.IPF]
175 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
177 <Command.MSFT, Command.INTEL>
178 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
179 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
180 # For RVCTCYGWIN ASM_FLAGS must be first to work around pathing issues
181 "$(ASM)" $(ASM_FLAGS) -o ${dst} ${d_path}(+)${s_base}.iii
183 [Visual-Form-Representation-File]
193 $(DEBUG_DIR)(+)${s_dir}(+)${s_base}.c
196 -$(MD) $(OUTPUT_DIR)(+)${s_dir} > NUL 2>&1
197 "$(VFRPP)" $(VFRPP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
198 -$(MD) ${d_path} > NUL 2>&1
199 "$(VFR)" $(VFR_FLAGS) --output-directory ${d_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
207 $(OUTPUT_DIR)(+)$(MODULE_NAME).lib
209 <Command.MSFT, Command.INTEL>
210 "$(SLINK)" $(SLINK_FLAGS) /OUT:${dst} @$(OBJECT_FILES_LIST)
213 "$(SLINK)" -cr ${dst} $(SLINK_FLAGS) @$(OBJECT_FILES_LIST)
216 "$(SLINK)" $(SLINK_FLAGS) ${dst} --via $(OBJECT_FILES_LIST)
219 # $(OBJECT_FILES_LIST) has wrong paths for cygwin
220 "$(SLINK)" $(SLINK_FLAGS) ${dst} $(OBJECT_FILES)
223 "$(SLINK)" $(SLINK_FLAGS) ${dst} -filelist $(OBJECT_FILES_LIST)
225 [Static-Library-File]
233 $(DEBUG_DIR)(+)$(MODULE_NAME).dll
235 <Command.MSFT, Command.INTEL>
236 "$(DLINK)" /OUT:${dst} $(DLINK_FLAGS) $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST)
239 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -\( $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST) -\) $(DLINK2_FLAGS)
240 "$(OBJCOPY)" $(OBJCOPY_FLAGS) ${dst}
243 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) --via $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
246 #$(STATIC_LIBRARY_FILES_LIST) has wrong paths for cygwin
247 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) $(STATIC_LIBRARY_FILES) $(DLINK2_FLAGS)
250 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) -filelist $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
253 [Static-Library-File.USER_DEFINED]
261 $(DEBUG_DIR)(+)$(MODULE_NAME)
263 <Command.MSFT, Command.INTEL>
264 "$(DLINK)" $(DLINK_FLAGS) $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST)
267 "$(DLINK)" $(DLINK_FLAGS) -\( $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST) -\) $(DLINK2_FLAGS)
270 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) --via $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
273 #$(STATIC_LIBRARY_FILES_LIST) has the wrong paths for cygwin
274 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) $(STATIC_LIBRARY_FILES) $(DLINK2_FLAGS)
277 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) $(DLINK_SPATH) -filelist $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
280 [Dynamic-Library-File]
285 $(DEBUG_DIR)(+)$(MODULE_NAME).efi
287 <Command.MSFT, Command.INTEL, Command.GCC, Command.RVCT>
288 GenFw -e $(MODULE_TYPE) -o ${dst} ${src}
289 $(CP) ${dst} $(OUTPUT_DIR)
290 $(CP) ${dst} $(BIN_DIR)
291 -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR)
294 # tool to convert Mach-O to PE/COFF
295 "$(MTOC)" -subsystem $(MODULE_TYPE) $(MTOC_FLAGS) ${src} $(DEBUG_DIR)(+)$(MODULE_NAME).pecoff
296 # create symbol file for GDB debug
298 GenFw -e $(MODULE_TYPE) -o ${dst} $(DEBUG_DIR)(+)$(MODULE_NAME).pecoff
299 $(CP) ${dst} $(OUTPUT_DIR)
300 $(CP) ${dst} $(BIN_DIR)
301 -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR)
303 [Dependency-Expression-File]
308 $(OUTPUT_DIR)(+)$(MODULE_NAME).depex
311 "$(PP)" $(CC_FLAGS) $(APP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
312 Trim --source-code -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
313 GenDepex -t $(MODULE_TYPE) -o ${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
315 [Acpi-Source-Language-File]
320 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml
325 <Command.MSFT, Command.INTEL>
326 Trim --asl-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i ${src}
327 "$(ASLPP)" $(ASLPP_FLAGS) $(INC) /I${s_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
328 "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
331 Trim --asl-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i ${src}
332 "$(ASLPP)" $(ASLPP_FLAGS) $(INC) -I${s_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
333 "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
335 [C-Code-File.AcpiTable]
340 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
345 <Command.MSFT, Command.INTEL>
346 "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
347 "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
348 GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
351 "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
352 "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
353 GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
355 [Acpi-Table-Code-File]
360 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
365 <Command.MSFT, Command.INTEL>
366 "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
367 "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
368 GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
371 "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
372 "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
373 GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
376 "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASLCC_FLAGS) $(INC) ${src}
377 "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
378 "$(MTOC)" -subsystem $(MODULE_TYPE) $(MTOC_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.efi
379 GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.efi
384 ?.asm16, ?.Asm16, ?.ASM16
390 $(OUTPUT_DIR)(+)${s_base}.com
392 <Command.MSFT, Command.INTEL>
393 cd $(OUTPUT_DIR)(+)${s_dir}
394 "$(ASM)" /nologo /c /omf /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj ${src}
395 "$(ASMLINK)" $(ASMLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj,${dst},,,,
398 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
399 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
400 "$(ASM)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASM_FLAGS) $(INC) ${d_path}(+)${s_base}.iii
401 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -( $(DLINK_SPATH) $(LIBS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj -)
404 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
405 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
406 "$(ASM)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASM_FLAGS) $(INC) ${d_path}(+)${s_base}.iii
407 "$(SLINK)" $(SLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.slib $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
408 otool -t $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.slib | hex2bin.py ${dst}
413 ?.txt, ?.TXT, ?.Txt, ?.mut
416 $(OUTPUT_DIR)(+)${s_base}.mcb
419 GenFw -o ${dst} -m ${src}
421 [Microcode-Binary-File]
426 $(OUTPUT_DIR)(+)$(MODULE_NAME).bin
429 GenFw -o ${dst} -j $(MICROCODE_BINARY_FILES)
430 -$(CP) ${dst} $(BIN_DIR)
445 $(DEBUG_DIR)(+)AutoGen.c
446 $(DEBUG_DIR)(+)$(MODULE_NAME)StrDefs.h
450 [Efi-Image.UEFI_OPTIONROM]
455 $(BIN_DIR)(+)$(MODULE_NAME).rom
458 $(OPTROM) -i $(PCI_DEVICE_ID) -f $(PCI_VENDOR_ID) -l $(PCI_CLASS_CODE) -r $(PCI_REVISION) -o $dst $(OPTROM_FLAGS) $src
460 [Unicode-Text-File.UEFI_HII]
465 $(OUTPUT_DIR)(+)$(MODULE_NAME)StrDefs.hpk
466 $(DEBUG_DIR)(+)$(MODULE_NAME)StrDefs.h
470 [Visual-Form-Representation-File.UEFI_HII]
480 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.hpk
483 -$(MD) $(OUTPUT_DIR)(+)${s_dir} > NUL 2>&1
484 "$(VFRPP)" $(VFRPP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
485 -$(MD) $(OUTPUT_DIR)(+)${s_dir} > NUL 2>&1
486 "$(VFR)" $(VFR_FLAGS) --create-ifr-package --output-directory $(OUTPUT_DIR)(+)${s_dir} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
488 [Hii-Binary-Package.UEFI_HII]
493 $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.lib
495 <Command.MSFT, Command.INTEL>
496 GenFw -o $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc -g $(MODULE_GUID) --hiipackage $(HII_BINARY_PACKAGES)
497 "$(RC)" /Fo${dst} $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc
500 GenFw -o $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc -g $(MODULE_GUID) --hiipackage $(HII_BINARY_PACKAGES)
501 "$(RC)" (RC_FLAGS) $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc ${dst}