2 # Copyright (c) 2007 - 2011, Intel Corporation. All rights reserved.<BR>
3 # Portions copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>
4 # 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.
15 # "*" is used to indicate that the source files will be processed at the same time.
16 # "?" is used to indicate that the source files will be processed one by one.
18 # "[" <File-Type>[.<Build-Type>][.<Arch>][, <File-Type>[.<Build-Type>][.<Arch>]] "]" <EOL>
19 # <InputFile[.<ToolChainFamily>]> <EOL>
20 # (?|*).<File-Extension> [(\n|,) (?|*).<File-Extension>]
22 # <OutputFile[.<ToolChainFamily>]> <EOL>
28 # <Command[.<ToolChainFamily>]> <EOL>
32 # <Build-Type> is the MODULE_TYPE in EDK2 or COMPONENT_TYPE in EDK.
33 # Missing <InputFile> will cause an exception and break build.
34 # Missing <Command> will cause that related build target won't be generated but
38 ## Placeholders for string substitution
40 # ${src} Source file(s) to be built (full path)
41 # ${s_path} Source file directory (absolute path)
42 # ${s_dir} Source file relative directory within a module
43 # (Note: ${s_dir} is always equals to "." if source file is given in absolute path.)
44 # ${s_name} Source file name without path
45 # ${s_base} Source file name without extension and path
46 # ${s_ext} Source file extension
48 # ${dst} Destination file(s) built from ${src} (full path)
49 # ${d_path} Destination file directory (absolute path)
50 # ${d_name} Destination file name without path
51 # ${d_base} Destination file name without extension and path
52 # ${d_ext} Destination file extension
54 # (+) Directory separator
58 # $(WORKSPACE) Workspace directory
59 # $(OUTPUT_DIR) Directory for intermediate files for building a module
60 # $(DEBUG_DIR) Directory for files used to debug a module
61 # $(BUILD_DIR) All files for building a platform will be put in this directory
62 # $(BIN_DIR) Common directory for executable files
63 # $(FV_DIR) Directory to store flash image files
64 # $(INC) Search path of current module
65 # $(INC_LIST) A file containing search pathes of current module
66 # $(LIBS) Static library files of current module
67 # $(<tool>_FLAGS) Tools flags of current module
68 # $(MODULE_NAME) Current module name
69 # $(MODULE_TYPE) Current module type
70 # $(MODULE_GUID) Current module guid
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_TYPES>) 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_FILES macro.)
79 # $(<FILE_TYPES_LIST>) Macro point to a file containing list of files of a file type
81 # Note: The macro and file name are derived from file type name.
82 # For example, C-Code-File will have C_CODE_FILES_LIST macro pointing
83 # to $(OUTPUT_DIR)/c_code_files.lst. The list file and macro name
84 # will be generated only when this macro is used in command line.
85 # This is intended to get over the long command line limitation.
90 # $(RM) delete command
91 # $(MD) create dir command
92 # $(RD) remove dir command
97 # Don't change following names of file types and their associated files,
98 # which are also used in tools' code
102 # Dynamic-Library-File
103 # Static-Library-File
104 # Visual-Form-Representation-File
122 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
124 <Command.MSFT, Command.INTEL>
125 "$(CC)" /Fo${dst} $(CC_FLAGS) $(INC) ${src}
127 <Command.GCC, Command.RVCT>
128 # For RVCTCYGWIN CC_FLAGS must be first to work around pathing issues
129 "$(CC)" $(CC_FLAGS) -o ${dst} $(INC) ${src}
130 "$(SYMRENAME)" $(SYMRENAME_FLAGS) ${dst}
133 "$(CC)" $(CC_FLAGS) -o ${dst} $(INC) ${src}
145 [Assembly-Code-File.COMMON.COMMON]
146 <InputFile.MSFT, InputFile.INTEL, InputFile.RVCT>
156 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
158 <Command.MSFT, Command.INTEL>
159 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
160 Trim --source-code --convert-hex -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
161 "$(ASM)" /Fo${dst} $(ASM_FLAGS) /I${s_path} $(INC) ${d_path}(+)${s_base}.iii
163 <Command.GCC, Command.RVCT>
164 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
165 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
166 # For RVCTCYGWIN ASM_FLAGS must be first to work around pathing issues
167 "$(ASM)" $(ASM_FLAGS) -o ${dst} $(INC) ${d_path}(+)${s_base}.iii
169 [Assembly-Code-File.COMMON.IPF]
177 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
179 <Command.MSFT, Command.INTEL>
180 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
181 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
182 # For RVCTCYGWIN ASM_FLAGS must be first to work around pathing issues
183 "$(ASM)" $(ASM_FLAGS) -o ${dst} ${d_path}(+)${s_base}.iii
185 [Visual-Form-Representation-File]
195 $(DEBUG_DIR)(+)${s_dir}(+)${s_base}.c
198 -$(MD) $(OUTPUT_DIR)(+)${s_dir} > NUL 2>&1
199 "$(VFRPP)" $(VFRPP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
200 -$(MD) ${d_path} > NUL 2>&1
201 "$(VFR)" $(VFR_FLAGS) --string-db $(OUTPUT_DIR)(+)$(MODULE_NAME)StrDefs.hpk --output-directory ${d_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
209 $(OUTPUT_DIR)(+)$(MODULE_NAME).lib
211 <Command.MSFT, Command.INTEL>
212 "$(SLINK)" $(SLINK_FLAGS) /OUT:${dst} @$(OBJECT_FILES_LIST)
215 "$(SLINK)" -cr ${dst} $(SLINK_FLAGS) @$(OBJECT_FILES_LIST)
218 "$(SLINK)" $(SLINK_FLAGS) ${dst} --via $(OBJECT_FILES_LIST)
220 <Command.RVCTCYGWIN, Command.ARMGCC>
221 # $(OBJECT_FILES_LIST) has wrong paths for cygwin
222 "$(SLINK)" $(SLINK_FLAGS) ${dst} $(OBJECT_FILES)
225 "$(SLINK)" $(SLINK_FLAGS) ${dst} -filelist $(OBJECT_FILES_LIST)
227 [Static-Library-File]
235 $(DEBUG_DIR)(+)$(MODULE_NAME).dll
237 <Command.MSFT, Command.INTEL>
238 "$(DLINK)" /OUT:${dst} $(DLINK_FLAGS) $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST)
241 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -\( $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST) -\) $(DLINK2_FLAGS)
242 "$(OBJCOPY)" $(OBJCOPY_FLAGS) ${dst}
245 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -\( $(DLINK_SPATH) $(STATIC_LIBRARY_FILES) -\) $(DLINK2_FLAGS)
248 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) --via $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
251 #$(STATIC_LIBRARY_FILES_LIST) has wrong paths for cygwin
252 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) $(STATIC_LIBRARY_FILES) $(DLINK2_FLAGS)
255 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) -filelist $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
258 [Static-Library-File.USER_DEFINED]
266 $(DEBUG_DIR)(+)$(MODULE_NAME)
268 <Command.MSFT, Command.INTEL>
269 "$(DLINK)" $(DLINK_FLAGS) $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST)
272 "$(DLINK)" $(DLINK_FLAGS) -\( $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST) -\) $(DLINK2_FLAGS)
275 "$(DLINK)" $(DLINK_FLAGS) -\( $(DLINK_SPATH) $(STATIC_LIBRARY_FILES) -\) $(DLINK2_FLAGS)
278 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) --via $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
281 #$(STATIC_LIBRARY_FILES_LIST) has the wrong paths for cygwin
282 "$(DLINK)" $(DLINK_FLAGS) -o ${dst} $(DLINK_SPATH) $(STATIC_LIBRARY_FILES) $(DLINK2_FLAGS)
285 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) $(DLINK_SPATH) -filelist $(STATIC_LIBRARY_FILES_LIST) $(DLINK2_FLAGS)
288 [Dynamic-Library-File]
293 $(DEBUG_DIR)(+)$(MODULE_NAME).efi
295 <Command.MSFT, Command.INTEL, Command.RVCT, Command.ARMGCC>
296 "$(GENFW)" -e $(MODULE_TYPE) -o ${dst} ${src} $(GENFW_FLAGS)
297 $(CP) ${dst} $(OUTPUT_DIR)
298 $(CP) ${dst} $(BIN_DIR)
299 -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR)
302 $(OBJCOPY) --only-keep-debug ${src} $(DEBUG_DIR)(+)$(MODULE_NAME).debug
303 $(OBJCOPY) --strip-unneeded ${src}
306 #The below 2 lines are only needed for UNIXGCC tool chain, which genereates PE image directly
308 -$(OBJCOPY) $(OBJCOPY_ADDDEBUGFLAG) ${src}
309 -$(CP) $(DEBUG_DIR)(+)$(MODULE_NAME).debug $(BIN_DIR)
311 "$(GENFW)" -e $(MODULE_TYPE) -o ${dst} ${src} $(GENFW_FLAGS)
312 $(CP) ${dst} $(OUTPUT_DIR)
313 $(CP) ${dst} $(BIN_DIR)
314 -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR)
317 # tool to convert Mach-O to PE/COFF
318 "$(MTOC)" -subsystem $(MODULE_TYPE) $(MTOC_FLAGS) ${src} $(DEBUG_DIR)(+)$(MODULE_NAME).pecoff
319 # create symbol file for GDB debug
321 "$(GENFW)" -e $(MODULE_TYPE) -o ${dst} $(DEBUG_DIR)(+)$(MODULE_NAME).pecoff $(GENFW_FLAGS)
322 $(CP) ${dst} $(OUTPUT_DIR)
323 $(CP) ${dst} $(BIN_DIR)
324 -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR)
326 [Dependency-Expression-File]
331 $(OUTPUT_DIR)(+)$(MODULE_NAME).depex
337 "$(PP)" $(APP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
338 Trim --source-code -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
339 GenDepex -t $(MODULE_TYPE) -o ${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
341 [Acpi-Source-Language-File]
346 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml
351 <Command.MSFT, Command.INTEL>
352 Trim --asl-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i -i $(INC_LIST) ${src}
353 "$(ASLPP)" $(ASLPP_FLAGS) $(INC) /I${s_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
354 Trim --source-code -l -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iiii $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
355 "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iiii
358 Trim --asl-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i -i $(INC_LIST) ${src}
359 "$(ASLPP)" $(ASLPP_FLAGS) $(INC) -I${s_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
360 "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
362 [C-Code-File.AcpiTable]
367 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
372 <Command.MSFT, Command.INTEL>
373 "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASLCC_FLAGS) $(INC) ${src}
374 "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
375 "$(GENFW)" -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(GENFW_FLAGS)
378 "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
379 "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
380 "$(GENFW)" -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(GENFW_FLAGS)
382 [Acpi-Table-Code-File]
387 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
392 <Command.MSFT, Command.INTEL>
393 "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASLCC_FLAGS) $(INC) ${src}
394 "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
395 "$(GENFW)" -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(GENFW_FLAGS)
398 "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
399 "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
400 "$(GENFW)" -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(GENFW_FLAGS)
403 "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASLCC_FLAGS) $(INC) ${src}
404 "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
405 "$(MTOC)" -subsystem $(MODULE_TYPE) $(MTOC_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.efi
406 "$(GENFW)" -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.efi $(GENFW_FLAGS)
411 ?.asm16, ?.Asm16, ?.ASM16
417 $(OUTPUT_DIR)(+)${s_base}.com
419 <Command.MSFT, Command.INTEL>
420 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
421 Trim --source-code --convert-hex -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
422 cd $(OUTPUT_DIR)(+)${s_dir}
423 "$(ASM16)" /nologo /c /omf $(INC) /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj ${d_path}(+)${s_base}.iii
424 "$(ASMLINK)" $(ASMLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj,${dst},,,,
427 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
428 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
429 "$(ASM)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASM_FLAGS) $(INC) ${d_path}(+)${s_base}.iii
430 "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -\( $(DLINK_SPATH) $(LIBS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj -\)
433 "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i
434 Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i
435 "$(ASM)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(ASM_FLAGS) $(INC) ${d_path}(+)${s_base}.iii
436 "$(SLINK)" $(SLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.slib $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
437 otool -t $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.slib | hex2bin.py ${dst}
440 [Microcode-File.USER_DEFINED, Microcode-File.Microcode]
442 ?.txt, ?.TXT, ?.Txt, ?.mut, ?.inc
445 $(OUTPUT_DIR)(+)${s_base}.mcb
448 "$(GENFW)" -o ${dst} -m ${src} $(GENFW_FLAGS)
450 [Microcode-Binary-File]
458 $(OUTPUT_DIR)(+)$(MODULE_NAME).bin
461 "$(GENFW)" -o ${dst} -j $(MICROCODE_BINARY_FILES) $(GENFW_FLAGS)
462 -$(CP) ${dst} $(BIN_DIR)
477 $(DEBUG_DIR)(+)AutoGen.c
478 $(DEBUG_DIR)(+)$(MODULE_NAME)StrDefs.h
479 $(OUTPUT_DIR)(+)$(MODULE_NAME)StrDefs.hpk
483 [Efi-Image.UEFI_OPTIONROM]
488 $(BIN_DIR)(+)$(MODULE_NAME).rom
491 $(OPTROM) -i $(PCI_DEVICE_ID) -f $(PCI_VENDOR_ID) -l $(PCI_CLASS_CODE) -r $(PCI_REVISION) -o $dst $(OPTROM_FLAGS) $src
493 [Unicode-Text-File.UEFI_HII]
498 $(OUTPUT_DIR)(+)$(MODULE_NAME)StrDefs.hpk
499 $(DEBUG_DIR)(+)$(MODULE_NAME)StrDefs.h
503 [Visual-Form-Representation-File.UEFI_HII]
513 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.hpk
516 -$(MD) $(OUTPUT_DIR)(+)${s_dir} > NUL 2>&1
517 "$(VFRPP)" $(VFRPP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
518 -$(MD) $(OUTPUT_DIR)(+)${s_dir} > NUL 2>&1
519 "$(VFR)" $(VFR_FLAGS) --create-ifr-package --string-db $(OUTPUT_DIR)(+)$(MODULE_NAME)StrDefs.hpk --output-directory $(OUTPUT_DIR)(+)${s_dir} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
521 [Hii-Binary-Package.UEFI_HII]
525 <OutputFile.MSFT, OutputFile.INTEL, OutputFile.GCC>
526 $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.lib
528 <OutputFile.XCODE, OutputFile.RVCT, OutputFile.ARMGCC>
529 $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc
531 <Command.MSFT, Command.INTEL>
532 "$(GENFW)" -o $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc -g $(MODULE_GUID) --hiipackage $(HII_BINARY_PACKAGES) $(GENFW_FLAGS)
533 "$(RC)" /Fo${dst} $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc
536 "$(GENFW)" -o $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc -g $(MODULE_GUID) --hiibinpackage $(HII_BINARY_PACKAGES) $(GENFW_FLAGS)
537 "$(RC)" $(RC_FLAGS) $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc ${dst}
539 <Command.XCODE, Command.RVCT, Command.ARMGCC>
540 GenFw -o $(OUTPUT_DIR)(+)$(MODULE_NAME)hii.rc -g $(MODULE_GUID) --hiibinpackage $(HII_BINARY_PACKAGES)