mirror of
				https://git.proxmox.com/git/mirror_edk2
				synced 2025-10-31 03:58:31 +00:00 
			
		
		
		
	 c9c705a855
			
		
	
	
		c9c705a855
		
	
	
	
	
		
			
			git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8762 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			394 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			394 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| #
 | |
| #  Copyright (c) 2007-2009, 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.
 | |
| #
 | |
| # "[" <File-Type>[.<Build-Type>][.<Arch>][, <File-Type>[.<Build-Type>][.<Arch>]] "]" <EOL>
 | |
| #   <InputFile[.<ToolChainFamily>]> <EOL>
 | |
| #       (?|*).<File-Extension> [(\n|,) (?|*).<File-Extension>]
 | |
| #
 | |
| #   <OutputFile[.<ToolChainFamily>]> <EOL>
 | |
| #       <FileFullPath>
 | |
| #
 | |
| #   <ExtraDependency>
 | |
| #       <FileFullPath>
 | |
| #
 | |
| #   <Command[.<ToolChainFamily>]> <EOL>
 | |
| #       <Command1>
 | |
| #       [<Command2>]
 | |
| #
 | |
| # <Build-Type> is the MODULE_TYPE in EDK2 or COMPONENT_TYPE  in EDK.
 | |
| # Missing <InputFile> will cause an exception and break build.
 | |
| # Missing <Command> will cause that related build target won't be generated but
 | |
| #   won't break build.
 | |
| #
 | |
| 
 | |
| ## 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
 | |
| #   $(INC_LIST)         A file containing search pathes of current module
 | |
| #   $(LIBS)             Static library files of current module
 | |
| #   $(<tool>_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)
 | |
| #   $(<tool>)           Path of tool
 | |
| #   $(EDK_TOOLS_PATH)   Path of build tools
 | |
| #   $(<FILE_TYPES>)     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_FILES macro.)
 | |
| #   $(<FILE_TYPES_LIST>) Macro point to a file containing list of files of a file type
 | |
| #                       (
 | |
| #                        Note: The macro and file name are derived from file type name.
 | |
| #                        For example, C-Code-File will have C_CODE_FILES_LIST macro pointing
 | |
| #                        to $(OUTPUT_DIR)/c_code_files.lst. The list file and macro name
 | |
| #                        will be generated only when this macro is used in command line.
 | |
| #                        This is intended to get over the long command line limitation.
 | |
| #                       )
 | |
| #
 | |
| #   $(CP)     copy command
 | |
| #   $(MV)     move command
 | |
| #   $(RM)     delete command
 | |
| #   $(MD)     create dir command
 | |
| #   $(RD)     remove dir command
 | |
| #
 | |
| 
 | |
| ## Reserved File-Type
 | |
| #
 | |
| # Don'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
 | |
| #
 | |
| 
 | |
| [C-Code-File]
 | |
|     <InputFile>
 | |
|         ?.c
 | |
|         ?.C
 | |
|         ?.cc
 | |
|         ?.CC
 | |
|         ?.cpp
 | |
|         ?.Cpp
 | |
|         ?.CPP
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(CC)" /Fo${dst} $(CC_FLAGS) $(INC) ${src}
 | |
| 
 | |
|     <Command.GCC>
 | |
|         "$(CC)" -o ${dst} $(CC_FLAGS) $(INC) ${src}
 | |
|         "$(SYMRENAME)" $(SYMRENAME_FLAGS) ${dst}
 | |
| 
 | |
| [C-Header-File]
 | |
|     <InputFile>
 | |
|         *.h, *.H
 | |
| 
 | |
|     <OutputFile>
 | |
| 
 | |
|     <Command>
 | |
| 
 | |
| 
 | |
| [Assembly-Code-File.COMMON.COMMON]
 | |
|     <InputFile.MSFT, InputFile.INTEL>
 | |
|         ?.asm, ?.Asm, ?.ASM
 | |
| 
 | |
|     <InputFile.GCC>
 | |
|         ?.S, ?.s
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(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) /I${s_path} $(INC) ${d_path}(+)${s_base}.iii
 | |
| 
 | |
|     <Command.GCC>
 | |
|         "$(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) $(INC) ${d_path}(+)${s_base}.iii
 | |
| 
 | |
| [Assembly-Code-File.COMMON.IPF]
 | |
|     <InputFile>
 | |
|         ?.s
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(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
 | |
| 
 | |
| [Visual-Form-Representation-File]
 | |
|     <InputFile>
 | |
|         ?.vfr
 | |
|         ?.Vfr
 | |
|         ?.VFR
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(DEBUG_DIR)(+)${s_dir}(+)${s_base}.c
 | |
| 
 | |
|     <Command>
 | |
|         -$(MD) $(OUTPUT_DIR)(+)${s_dir} > NUL 2>&1
 | |
|         "$(VFRPP)" $(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
 | |
|         -$(MD) ${d_path} > NUL 2>&1
 | |
|         "$(VFR)" $(VFR_FLAGS) --output-directory ${d_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
 | |
| 
 | |
| [Object-File]
 | |
|     <InputFile>
 | |
|         *.obj
 | |
|         *.o
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)$(MODULE_NAME).lib
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(SLINK)" $(SLINK_FLAGS) /OUT:${dst} @$(OBJECT_FILES_LIST)
 | |
| 
 | |
|     <Command.GCC>
 | |
|         "$(SLINK)" -cr ${dst} $(SLINK_FLAGS) @"$(OBJECT_FILES_LIST)"
 | |
| 
 | |
| [Static-Library-File]
 | |
|     <InputFile>
 | |
|         *.lib
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(DEBUG_DIR)(+)$(MODULE_NAME).dll
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(DLINK)" /OUT:${dst} $(DLINK_FLAGS) $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST)
 | |
| 
 | |
|     <Command.GCC>
 | |
|         "$(DLINK)" -o ${dst} $(DLINK_FLAGS) -\( $(DLINK_SPATH) @"$(STATIC_LIBRARY_FILES_LIST)" -\) $(DLINK2_FLAGS)
 | |
|         "$(OBJCOPY)" $(OBJCOPY_FLAGS) ${dst}
 | |
| 
 | |
| [Static-Library-File.USER_DEFINED]
 | |
|     <InputFile>
 | |
|         *.lib
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(DEBUG_DIR)(+)$(MODULE_NAME)
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(DLINK)" $(DLINK_FLAGS) $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST)
 | |
| 
 | |
|     <Command.GCC>
 | |
|         "$(DLINK)" $(DLINK_FLAGS) -\( $(DLINK_SPATH) @$(STATIC_LIBRARY_FILES_LIST) -\) $(DLINK2_FLAGS)
 | |
| 
 | |
| [Dynamic-Library-File]
 | |
|     <InputFile>
 | |
|         ?.dll
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(DEBUG_DIR)(+)$(MODULE_NAME).efi
 | |
| 
 | |
|     <Command>
 | |
|         GenFw -e $(MODULE_TYPE) -o ${dst} ${src}
 | |
|         $(CP) ${dst} $(OUTPUT_DIR)
 | |
|         $(CP) ${dst} $(BIN_DIR)
 | |
|         -$(CP) $(DEBUG_DIR)(+)*.map $(OUTPUT_DIR)
 | |
| 
 | |
| [Dependency-Expression-File]
 | |
|     <InputFile>
 | |
|         ?.dxs, ?.Dxs, ?.DXS
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)$(MODULE_NAME).depex
 | |
| 
 | |
|     <Command>
 | |
|         "$(PP)" $(CC_FLAGS) $(APP_FLAGS) $(INC) ${src} > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
 | |
|         Trim --source-code -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i
 | |
|         GenDepex -t $(MODULE_TYPE) -o ${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
 | |
| 
 | |
| [Acpi-Source-Language-File]
 | |
|     <InputFile>
 | |
|         ?.asl, ?.Asl, ?.ASL
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         Trim --asl-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i ${src}
 | |
|         "$(ASLPP)" $(ASLPP_FLAGS) $(INC) /I${s_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
 | |
|         "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
 | |
| 
 | |
|     <Command.GCC>
 | |
|         Trim --asl-file -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i ${src}
 | |
|         "$(ASLPP)" $(ASLPP_FLAGS) $(INC) -I${s_path} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
 | |
|         "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii
 | |
| 
 | |
| [C-Code-File.AcpiTable]
 | |
|     <InputFile>
 | |
|         ?.c
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
 | |
|         "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
 | |
|         GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
 | |
| 
 | |
|     <Command.GCC>
 | |
|         "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
 | |
|         "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
 | |
|         GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
 | |
| 
 | |
| [Acpi-Table-Code-File]
 | |
|     <InputFile>
 | |
|         ?.aslc, ?.act
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.acpi
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         "$(ASLCC)" /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
 | |
|         "$(ASLDLINK)" /OUT:$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
 | |
|         GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
 | |
| 
 | |
|     <Command.GCC>
 | |
|         "$(ASLCC)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj $(CC_FLAGS) $(ASLCC_FLAGS) $(INC) ${src}
 | |
|         "$(ASLDLINK)" -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll $(ASLDLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
 | |
|         GenFw -o ${dst} -c $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.dll
 | |
| 
 | |
| [Masm16-Code-File]
 | |
|     <InputFile>
 | |
|         ?.asm16, ?.Asm16, ?.ASM16
 | |
| 
 | |
|     <ExtraDependency>
 | |
|         $(MAKE_FILE)
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_base}.com
 | |
| 
 | |
|     <Command.MSFT, Command.INTEL>
 | |
|         cd $(OUTPUT_DIR)(+)${s_dir}
 | |
|         "$(ASM)" /nologo /c /omf /Fo$(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj ${src}
 | |
|         "$(ASMLINK)" $(ASMLINK_FLAGS) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj,${dst},,,,
 | |
| 
 | |
| [Microcode-File]
 | |
|     <InputFile>
 | |
|         ?.txt, ?.TXT, ?.Txt, ?.mut
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)${s_base}.mcb
 | |
| 
 | |
|     <Command>
 | |
|         GenFw -o ${dst} -m ${src}
 | |
| 
 | |
| [Microcode-Binary-File]
 | |
|     <InputFile>
 | |
|         *.mcb
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(OUTPUT_DIR)(+)$(MODULE_NAME).bin
 | |
| 
 | |
|     <Command>
 | |
|         GenFw -o ${dst} -j $(MICROCODE_BINARY_FILES)
 | |
|         -$(CP) ${dst} $(BIN_DIR)
 | |
| 
 | |
| [EFI-Image-File]
 | |
|     <InputFile>
 | |
|         ?.efi, ?.Efi, ?.EFI
 | |
| 
 | |
|     <OutputFile>
 | |
| 
 | |
|     <Command>
 | |
| 
 | |
| [Unicode-Text-File]
 | |
|     <InputFile>
 | |
|         *.uni, *.Uni, *.UNI
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(DEBUG_DIR)(+)AutoGen.c
 | |
|         $(DEBUG_DIR)(+)$(MODULE_NAME)StrDefs.h
 | |
| 
 | |
|     <Command>
 | |
| 
 | |
| [Efi-Image.UEFI_OPTIONROM]
 | |
|     <InputFile>
 | |
|         ?.efi, ?.EFI, ?.Efi
 | |
| 
 | |
|     <OutputFile>
 | |
|         $(BIN_DIR)(+)$(MODULE_NAME).rom
 | |
| 
 | |
|     <Command>
 | |
|         $(OPTROM) -i $(PCI_DEVICE_ID) -f $(PCI_VENDOR_ID) -l $(PCI_CLASS_CODE) -r $(PCI_REVISION) -o $dst $(OPTROM_FLAGS) $src
 | |
| 
 |