# # Copyright (c) 2007, Intel Corporation # # All rights reserved. This program and the accompanying materials # are licensed and made available under the terms and conditions of the BSD License # which accompanies this distribution. The full text of the license may be found at # http://opensource.org/licenses/bsd-license.php # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. # # Filename: build_rule.template # ## Syntax # # "*" is used to indicate that the source files will be processed at the same time. # "?" is used to indicate that the source files will be processed one by one. # # "[" Build.[.][, Build.[.]] "]" # ]> # [File-Type =] (?|*). [(\n|,|;) (?|*).] # # ]> # # # ]> # # [] # ## Placeholders for string substitution # # ${src} Source file(s) to be built (full path) # ${s_path} Source file directory (absolute path) # ${s_dir} Source file relative directory within a module # (Note: ${s_dir} is always equals to "." if source file is given in absolute path.) # ${s_name} Source file name without path # ${s_base} Source file name without extension and path # ${s_ext} Source file extension # # ${dst} Destination file(s) built from ${src} (full path) # ${d_path} Destination file directory (absolute path) # ${d_name} Destination file name without path # ${d_base} Destination file name without extension and path # ${d_ext} Destination file extension # # (+) Directory separator # ## Macro # $(WORKSPACE) Workspace directory # $(OUTPUT_DIR) Directory for intermediate files for building a module # $(DEBUG_DIR) Directory for files used to debug a module # $(BUILD_DIR) All files for building a platform will be put in this directory # $(BIN_DIR) Common directory for executable files # $(FV_DIR) Directory to store flash image files # $(INC) Search path of current module # $(LIBS) Static library files of current module # $(_FLAGS) Tools flags of current module # $(MODULE_NAME) Current module name # $(MODULE_TYPE) Current module type # $(ARCH) Architecture of current module # $(TOOLCHAIN) Toolchain used to build current module # $(TARGET) Target of current module (DEBUG/RELEASE) # $() Path of tool # $(EDK_TOOLS_PATH) Path of build tools # $() File list of each file type # (Note: The macro name is derived from file type name. For example, # C-Code-File will have C_CODE_FILE_LIST macro.) # # $(CP) copy command # $(MV) move command # $(RM) delete command # $(MD) create dir command # $(RD) remove dir command # ## Reserved File-Type # # Dont't change following names of file types and their associated files, # which are also used in tools' code # # C-Code-File # C-Header-File # Dynamic-Library-File # Static-Library-File # Visual-Form-Representation-File # Unicode-Text-File # [Build.C-Code-File] ?.c ?.C ?.cc ?.CC ?.cpp ?.Cpp ?.CPP $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj "$(CC)" /Fo${dst} $(CC_FLAGS) $(INC) ${src} "$(CC)" -o ${dst} $(CC_FLAGS) $(INC) ${src} [Build.C-Header-File] *.h, *.H $(OUTPUT_DIR)(+)$(MODULE_NAME).gch $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj [Build.Assembly-Code-File] Assembly-Code-File = ?.asm, ?.Asm, ?.ASM ?.S $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i Trim --source-code --convert-hex -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i "$(ASM)" /Fo${dst} $(ASM_FLAGS) $(INC) ${d_path}(+)${s_base}.iii "$(ASM)" -o ${dst} $(ASM_FLAGS) $(INC) ${src} [Build.Iasm-Code-File] ?.s $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj "$(PP)" $(PP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i "$(ASM)" -o ${dst} $(ASM_FLAGS) ${d_path}(+)${s_base}.iii [Build.Visual-Form-Representation-File] ?.vfr ?.Vfr ?.VFR $(DEBUG_DIR)(+)${s_dir}(+)${s_base}.c "$(PP)" $(VFRPP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i Trim --vfr-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i -mkdir ${d_path} > NUL 2>&1 VfrCompile -od ${d_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii [Build.Object-File] *.obj *.o $(OUTPUT_DIR)(+)$(MODULE_NAME).lib "$(SLINK)" $(SLINK_FLAGS) /OUT:${dst} ${src} "$(SLINK)" -cr ${dst} $(SLINK_FLAGS) ${src} #[Build.Object-File, Build.Static-Library-File] #BUILD_VERSION = 0x00010000 # # # Object-File = *.obj # Static-Library-File = *.lib, *.a # # # $(OUTPUT_DIR)(+)$(MODULE_NAME).lib # # # "$(SLINK)" /OUT:${dst} $(SLINK_FLAGS) ${src} # # # "$(SLINK)" -cr ${dst} $(SLINK_FLAGS) ${src1} -( ${src2} -) # [Build.Static-Library-File] ?.lib $(LIBS) $(DEBUG_DIR)(+)$(MODULE_NAME).dll "$(DLINK)" /OUT:${dst} $(DLINK_FLAGS) $(DLINK_SPATH) $(LIBS) ${src} "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -( $(DLINK_SPATH) $(LIBS) ${src} -) [Build.Dynamic-Library-File] ?.dll $(DEBUG_DIR)(+)$(MODULE_NAME).efi GenFw -e $(MODULE_TYPE) -o ${dst} ${src} $(CP) ${dst} $(OUTPUT_DIR) $(CP) ${dst} $(BIN_DIR) -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR) [Build.Dependency-Expression-File] ?.dxs, ?.Dxs, ?.DXS $(OUTPUT_DIR)(+)$(MODULE_NAME).depex # GenDepex -o ${dst} ${src} [Build.Acpi-Source-Language-File] ?.asl, ?.Asl, ?.ASL $(OUTPUT_DIR)(+)${s_base}.aml "$(PP)" $(APP_FLAGS) $(INC) ${src} > ${d_path}(+)${s_base}.i Trim --source-code -o ${d_path}(+)${s_base}.iii ${d_path}(+)${s_base}.i "$(ASL)" -p ${dst} ${d_path}(+)${s_base}.iii [Build.Acpi-Table-Code-File] ?.aslc $(OUTPUT_DIR)(+)${s_base}.acpi "$(CC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(INC) ${src} "$(DLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(SLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll [Build.Masm16-Code-File] ?.asm16, ?.Asm16, ?.ASM16 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.com pushd . cd $(OUTPUT_DIR)(+)${s_dir} "$(ASM)" /nologo /omf ${src} /Bl"$(ASMLINK)" $(ASMLINK_FLAGS) -$(CP) ${dst} $(OUTPUT_DIR) & popd [Build.Microcode-File] ?.txt, ?.TXT, ?.Txt $(OUTPUT_DIR)(+)${s_base}.mcb GenFw -o ${dst} -m ${src} [Build.Microcode-Binary-File] *.mcb $(OUTPUT_DIR)(+)$(MODULE_NAME).bin GenFw -o ${dst} -j ${src} [Build.Unicode-Text-File] *.uni, *.Uni, *.UNI $(DEBUG_DIR)(+)AutoGen.c $(DEBUG_DIR)(+)AutoGen.h