2 # Create makefile for MS nmake and GNU make
4 # Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
5 # This program and the accompanying materials
6 # are licensed and made available under the terms and conditions of the BSD License
7 # which accompanies this distribution. The full text of the license may be found at
8 # http://opensource.org/licenses/bsd-license.php
10 # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 from __future__
import absolute_import
17 import Common
.LongFilePathOs
as os
21 import os
.path
as path
22 from Common
.LongFilePathSupport
import OpenLongFilePath
as open
23 from Common
.MultipleWorkspace
import MultipleWorkspace
as mws
24 from Common
.BuildToolError
import *
25 from Common
.Misc
import *
26 from Common
.StringUtils
import *
27 from .BuildEngine
import *
28 import Common
.GlobalData
as GlobalData
29 from collections
import OrderedDict
31 ## Regular expression for finding header file inclusions
32 gIncludePattern
= re
.compile(r
"^[ \t]*#?[ \t]*include(?:[ \t]*(?:\\(?:\r\n|\r|\n))*[ \t]*)*(?:\(?[\"<]?
[ \t]*)([-\w
.\\/() \t]+)(?
:[ \t]*[\">]?\
)?
)", re.MULTILINE | re.UNICODE | re.IGNORECASE)
34 ## Regular expression for matching macro used in header file inclusion
35 gMacroPattern = re.compile("([_A
-Z
][_A
-Z0
-9]*)[ \t]*\
((.+)\
)", re.UNICODE)
39 ## pattern for include style in Edk.x code
40 gProtocolDefinition = "Protocol
/%(HeaderKey)s/%(HeaderKey)s.h
"
41 gGuidDefinition = "Guid
/%(HeaderKey)s/%(HeaderKey)s.h
"
42 gArchProtocolDefinition = "ArchProtocol
/%(HeaderKey)s/%(HeaderKey)s.h
"
43 gPpiDefinition = "Ppi
/%(HeaderKey)s/%(HeaderKey)s.h
"
44 gIncludeMacroConversion = {
45 "EFI_PROTOCOL_DEFINITION
" : gProtocolDefinition,
46 "EFI_GUID_DEFINITION
" : gGuidDefinition,
47 "EFI_ARCH_PROTOCOL_DEFINITION
" : gArchProtocolDefinition,
48 "EFI_PROTOCOL_PRODUCER
" : gProtocolDefinition,
49 "EFI_PROTOCOL_CONSUMER
" : gProtocolDefinition,
50 "EFI_PROTOCOL_DEPENDENCY
" : gProtocolDefinition,
51 "EFI_ARCH_PROTOCOL_PRODUCER
" : gArchProtocolDefinition,
52 "EFI_ARCH_PROTOCOL_CONSUMER
" : gArchProtocolDefinition,
53 "EFI_ARCH_PROTOCOL_DEPENDENCY
" : gArchProtocolDefinition,
54 "EFI_PPI_DEFINITION
" : gPpiDefinition,
55 "EFI_PPI_PRODUCER
" : gPpiDefinition,
56 "EFI_PPI_CONSUMER
" : gPpiDefinition,
57 "EFI_PPI_DEPENDENCY
" : gPpiDefinition,
60 ## default makefile type
62 if sys.platform == "win32
":
70 # This base class encapsules build file and its generation. It uses template to generate
71 # the content of build file. The content of build file will be got from AutoGen objects.
73 class BuildFile(object):
74 ## template used to generate the build file (i.e. makefile if using make)
75 _TEMPLATE_ = TemplateString('')
77 _DEFAULT_FILE_NAME_ = "Makefile
"
79 ## default file name for each type of build file
82 "gmake
" : "GNUmakefile
"
85 ## Fixed header string for makefile
86 _MAKEFILE_HEADER = '''#
88 # This file is auto-generated by build utility
96 # Auto-generated makefile for building modules, libraries or platform
100 ## Header string for each type of build file
102 "nmake
" : _MAKEFILE_HEADER % _FILE_NAME_["nmake
"],
103 "gmake
" : _MAKEFILE_HEADER % _FILE_NAME_["gmake
"]
106 ## shell commands which can be used in build file in the form of macro
107 # $(CP) copy file command
108 # $(MV) move file command
109 # $(RM) remove file command
110 # $(MD) create dir command
111 # $(RD) remove dir command
119 "RD
" : "rmdir
/s
/q
",
131 ## directory separator
137 ## directory creation template
139 "nmake
" : 'if not exist %(dir)s $(MD) %(dir)s',
140 "gmake
" : "$
(MD
) %(dir)s"
143 ## directory removal template
145 "nmake
" : 'if exist %(dir)s $(RD) %(dir)s',
146 "gmake
" : "$
(RD
) %(dir)s"
150 "nmake
" : 'if exist %(Src)s $(CP) %(Src)s %(Dst)s',
151 "gmake
" : "test
-f
%(Src)s && $
(CP
) %(Src)s %(Dst)s"
155 "nmake
" : 'if exist %(dir)s cd %(dir)s',
156 "gmake
" : "test
-e
%(dir)s && cd
%(dir)s"
160 "nmake
" : 'if exist %(file)s "$
(MAKE
)" $(MAKE_FLAGS) -f %(file)s',
161 "gmake
" : 'test -e %(file)s && "$
(MAKE
)" $(MAKE_FLAGS) -f %(file)s'
165 "nmake
" : '!INCLUDE',
169 _INC_FLAG_ = {"MSFT
" : "/I
", "GCC
" : "-I
", "INTEL
" : "-I
", "RVCT
" : "-I
"}
171 ## Constructor of BuildFile
173 # @param AutoGenObject Object of AutoGen class
175 def __init__(self, AutoGenObject):
176 self._AutoGenObject = AutoGenObject
177 self._FileType = gMakeType
181 # @param FileType Type of build file. Only nmake and gmake are supported now.
183 # @retval TRUE The build file is created or re-created successfully
184 # @retval FALSE The build file exists and is the same as the one to be generated
186 def Generate(self, FileType=gMakeType):
187 if FileType not in self._FILE_NAME_:
188 EdkLogger.error("build
", PARAMETER_INVALID, "Invalid build
type [%s]" % FileType,
189 ExtraData="[%s]" % str(self._AutoGenObject))
190 self._FileType = FileType
191 FileContent = self._TEMPLATE_.Replace(self._TemplateDict)
192 FileName = self._FILE_NAME_[FileType]
193 return SaveFileOnChange(os.path.join(self._AutoGenObject.MakeFileDir, FileName), FileContent, False)
195 ## Return a list of directory creation command string
197 # @param DirList The list of directory to be created
199 # @retval list The directory creation command list
201 def GetCreateDirectoryCommand(self, DirList):
202 return [self._MD_TEMPLATE_[self._FileType] % {'dir':Dir} for Dir in DirList]
204 ## Return a list of directory removal command string
206 # @param DirList The list of directory to be removed
208 # @retval list The directory removal command list
210 def GetRemoveDirectoryCommand(self, DirList):
211 return [self._RD_TEMPLATE_[self._FileType] % {'dir':Dir} for Dir in DirList]
213 def PlaceMacro(self, Path, MacroDefinitions={}):
214 if Path.startswith("$
("):
217 PathLength = len(Path)
218 for MacroName in MacroDefinitions:
219 MacroValue = MacroDefinitions[MacroName]
220 MacroValueLength = len(MacroValue)
221 if MacroValueLength == 0:
223 if MacroValueLength <= PathLength and Path.startswith(MacroValue):
224 Path = "$
(%s)%s" % (MacroName, Path[MacroValueLength:])
228 ## ModuleMakefile class
230 # This class encapsules makefie and its generation for module. It uses template to generate
231 # the content of makefile. The content of makefile will be got from ModuleAutoGen object.
233 class ModuleMakefile(BuildFile):
234 ## template used to generate the makefile for module
235 _TEMPLATE_ = TemplateString('''\
239 # Platform Macro Definition
241 PLATFORM_NAME = ${platform_name}
242 PLATFORM_GUID = ${platform_guid}
243 PLATFORM_VERSION = ${platform_version}
244 PLATFORM_RELATIVE_DIR = ${platform_relative_directory}
245 PLATFORM_DIR = ${platform_dir}
246 PLATFORM_OUTPUT_DIR = ${platform_output_directory}
249 # Module Macro Definition
251 MODULE_NAME = ${module_name}
252 MODULE_GUID = ${module_guid}
253 MODULE_NAME_GUID = ${module_name_guid}
254 MODULE_VERSION = ${module_version}
255 MODULE_TYPE = ${module_type}
256 MODULE_FILE = ${module_file}
257 MODULE_FILE_BASE_NAME = ${module_file_base_name}
258 BASE_NAME = $(MODULE_NAME)
259 MODULE_RELATIVE_DIR = ${module_relative_directory}
260 PACKAGE_RELATIVE_DIR = ${package_relative_directory}
261 MODULE_DIR = ${module_dir}
262 FFS_OUTPUT_DIR = ${ffs_output_directory}
264 MODULE_ENTRY_POINT = ${module_entry_point}
265 ARCH_ENTRY_POINT = ${arch_entry_point}
266 IMAGE_ENTRY_POINT = ${image_entry_point}
268 ${BEGIN}${module_extra_defines}
271 # Build Configuration Macro Definition
273 ARCH = ${architecture}
274 TOOLCHAIN = ${toolchain_tag}
275 TOOLCHAIN_TAG = ${toolchain_tag}
276 TARGET = ${build_target}
279 # Build Directory Macro Definition
281 # PLATFORM_BUILD_DIR = ${platform_build_directory}
282 BUILD_DIR = ${platform_build_directory}
283 BIN_DIR = $(BUILD_DIR)${separator}${architecture}
285 MODULE_BUILD_DIR = ${module_build_directory}
286 OUTPUT_DIR = ${module_output_directory}
287 DEBUG_DIR = ${module_debug_directory}
288 DEST_DIR_OUTPUT = $(OUTPUT_DIR)
289 DEST_DIR_DEBUG = $(DEBUG_DIR)
292 # Shell Command Macro
294 ${BEGIN}${shell_command_code} = ${shell_command}
298 # Tools definitions specific to this module
300 ${BEGIN}${module_tool_definitions}
302 MAKE_FILE = ${makefile_path}
307 ${BEGIN}${file_macro}
310 COMMON_DEPS = ${BEGIN}${common_dependency_file} \\
314 # Overridable Target Macro Definitions
316 FORCE_REBUILD = force_build
319 BC_TARGET = ${BEGIN}${backward_compatible_target} ${END}
320 CODA_TARGET = ${BEGIN}${remaining_build_target} \\
324 # Default target, which will build dependent libraries in addition to source files
331 # Target used when called from platform makefile, which will bypass the build of dependent libraries
334 pbuild: $(INIT_TARGET) $(BC_TARGET) $(PCH_TARGET) $(CODA_TARGET)
340 mbuild: $(INIT_TARGET) $(BC_TARGET) gen_libs $(PCH_TARGET) $(CODA_TARGET)
343 # Build Target used in multi-thread build mode, which will bypass the init and gen_libs targets
346 tbuild: $(BC_TARGET) $(PCH_TARGET) $(CODA_TARGET)
349 # Phony target which is used to force executing commands for a target
355 # Target to update the FD
361 # Initialization target: print build information and create necessary directories
366 \t-@echo Building ... $(MODULE_DIR)${separator}$(MODULE_FILE) [$(ARCH)]
369 ${BEGIN}\t-@${create_directory_command}\n${END}
372 \t-@$(CP) $(DEBUG_DIR)${separator}AutoGen.h $(DEBUG_DIR)${separator}$(MODULE_NAME)StrDefs.h
378 \t${BEGIN}@"$
(MAKE
)" $(MAKE_FLAGS) -f ${dependent_library_build_directory}${separator}${makefile_name}
379 \t${END}@cd $(MODULE_BUILD_DIR)
382 # Build Flash Device Image
385 \t@"$
(MAKE
)" $(MAKE_FLAGS) -f $(BUILD_DIR)${separator}${makefile_name} fds
386 \t@cd $(MODULE_BUILD_DIR)
389 # Individual Object Build Targets
391 ${BEGIN}${file_build_target}
395 # clean all intermediate files
398 \t${BEGIN}${clean_command}
399 \t${END}\t$(RM) AutoGenTimeStamp
402 # clean all generated files
405 ${BEGIN}\t${cleanall_command}
406 ${END}\t$(RM) *.pdb *.idb > NUL 2>&1
407 \t$(RM) $(BIN_DIR)${separator}$(MODULE_NAME).efi
408 \t$(RM) AutoGenTimeStamp
411 # clean all dependent libraries built
414 \t${BEGIN}-@${library_build_command} cleanall
415 \t${END}@cd $(MODULE_BUILD_DIR)\n\n''')
417 _FILE_MACRO_TEMPLATE = TemplateString("${macro_name}
= ${BEGIN}
\\\n ${source_file}${END}
\n")
418 _BUILD_TARGET_TEMPLATE = TemplateString("${BEGIN}${target}
: ${deps}
\n${END}
\t${cmd}
\n")
420 ## Constructor of ModuleMakefile
422 # @param ModuleAutoGen Object of ModuleAutoGen class
424 def __init__(self, ModuleAutoGen):
425 BuildFile.__init__(self, ModuleAutoGen)
426 self.PlatformInfo = self._AutoGenObject.PlatformInfo
428 self.ResultFileList = []
429 self.IntermediateDirectoryList = ["$
(DEBUG_DIR
)", "$
(OUTPUT_DIR
)"]
431 self.FileBuildTargetList = [] # [(src, target string)]
432 self.BuildTargetList = [] # [target string]
433 self.PendingBuildTargetList = [] # [FileBuildRule objects]
434 self.CommonFileDependency = []
435 self.FileListMacros = {}
436 self.ListFileMacros = {}
439 self.FileDependency = []
440 self.LibraryBuildCommandList = []
441 self.LibraryFileList = []
442 self.LibraryMakefileList = []
443 self.LibraryBuildDirectoryList = []
444 self.SystemLibraryList = []
445 self.Macros = OrderedDict()
446 self.Macros["OUTPUT_DIR
" ] = self._AutoGenObject.Macros["OUTPUT_DIR
"]
447 self.Macros["DEBUG_DIR
" ] = self._AutoGenObject.Macros["DEBUG_DIR
"]
448 self.Macros["MODULE_BUILD_DIR
"] = self._AutoGenObject.Macros["MODULE_BUILD_DIR
"]
449 self.Macros["BIN_DIR
" ] = self._AutoGenObject.Macros["BIN_DIR
"]
450 self.Macros["BUILD_DIR
" ] = self._AutoGenObject.Macros["BUILD_DIR
"]
451 self.Macros["WORKSPACE
" ] = self._AutoGenObject.Macros["WORKSPACE
"]
452 self.Macros["FFS_OUTPUT_DIR
" ] = self._AutoGenObject.Macros["FFS_OUTPUT_DIR
"]
453 self.GenFfsList = ModuleAutoGen.GenFfsList
454 self.MacroList = ['FFS_OUTPUT_DIR', 'MODULE_GUID', 'OUTPUT_DIR']
455 self.FfsOutputFileList = []
457 # Compose a dict object containing information used to do replacement in template
458 def _CreateTemplateDict(self):
459 if self._FileType not in self._SEP_:
460 EdkLogger.error("build
", PARAMETER_INVALID, "Invalid Makefile
type [%s]" % self._FileType,
461 ExtraData="[%s]" % str(self._AutoGenObject))
462 MyAgo = self._AutoGenObject
463 Separator = self._SEP_[self._FileType]
465 # break build if no source files and binary files are found
466 if len(MyAgo.SourceFileList) == 0 and len(MyAgo.BinaryFileList) == 0:
467 EdkLogger.error("build
", AUTOGEN_ERROR, "No files to be built
in module
[%s, %s, %s]"
468 % (MyAgo.BuildTarget, MyAgo.ToolChain, MyAgo.Arch),
469 ExtraData="[%s]" % str(MyAgo))
471 # convert dependent libraries to build command
472 self.ProcessDependentLibrary()
473 if len(MyAgo.Module.ModuleEntryPointList) > 0:
474 ModuleEntryPoint = MyAgo.Module.ModuleEntryPointList[0]
476 ModuleEntryPoint = "_ModuleEntryPoint
"
478 # Intel EBC compiler enforces EfiMain
479 if MyAgo.AutoGenVersion < 0x00010005 and MyAgo.Arch == "EBC
":
480 ArchEntryPoint = "EfiMain
"
482 ArchEntryPoint = ModuleEntryPoint
484 if MyAgo.Arch == "EBC
":
485 # EBC compiler always use "EfiStart
" as entry point. Only applies to EdkII modules
486 ImageEntryPoint = "EfiStart
"
487 elif MyAgo.AutoGenVersion < 0x00010005:
488 # Edk modules use entry point specified in INF file
489 ImageEntryPoint = ModuleEntryPoint
491 # EdkII modules always use "_ModuleEntryPoint
" as entry point
492 ImageEntryPoint = "_ModuleEntryPoint
"
494 for k, v in MyAgo.Module.Defines.iteritems():
495 if k not in MyAgo.Macros:
498 if 'MODULE_ENTRY_POINT' not in MyAgo.Macros:
499 MyAgo.Macros['MODULE_ENTRY_POINT'] = ModuleEntryPoint
500 if 'ARCH_ENTRY_POINT' not in MyAgo.Macros:
501 MyAgo.Macros['ARCH_ENTRY_POINT'] = ArchEntryPoint
502 if 'IMAGE_ENTRY_POINT' not in MyAgo.Macros:
503 MyAgo.Macros['IMAGE_ENTRY_POINT'] = ImageEntryPoint
505 PCI_COMPRESS_Flag = False
506 for k, v in MyAgo.Module.Defines.iteritems():
507 if 'PCI_COMPRESS' == k and 'TRUE' == v:
508 PCI_COMPRESS_Flag = True
512 IncPrefix = self._INC_FLAG_[MyAgo.ToolChainFamily]
513 for Tool in MyAgo.BuildOption:
514 for Attr in MyAgo.BuildOption[Tool]:
515 Value = MyAgo.BuildOption[Tool][Attr]
519 ToolsDef.append("%s = %s" % (Tool, Value))
521 # Don't generate MAKE_FLAGS in makefile. It's put in environment variable.
524 # Remove duplicated include path, if any
526 Value = RemoveDupOption(Value, IncPrefix, MyAgo.IncludePathList)
527 if Tool == "OPTROM
" and PCI_COMPRESS_Flag:
528 ValueList = Value.split()
530 for i, v in enumerate(ValueList):
533 Value = ' '.join(ValueList)
535 ToolsDef.append("%s_%s = %s" % (Tool, Attr, Value))
538 # generate the Response file and Response flag
539 RespDict = self.CommandExceedLimit()
540 RespFileList = os.path.join(MyAgo.OutputDir, 'respfilelist.txt')
542 RespFileListContent = ''
543 for Resp in RespDict:
544 RespFile = os.path.join(MyAgo.OutputDir, str(Resp).lower() + '.txt')
545 StrList = RespDict[Resp].split(' ')
550 UnexpandMacro.append(Str)
553 UnexpandMacroStr = ' '.join(UnexpandMacro)
554 NewRespStr = ' '.join(NewStr)
555 SaveFileOnChange(RespFile, NewRespStr, False)
556 ToolsDef.append("%s = %s" % (Resp, UnexpandMacroStr + ' @' + RespFile))
557 RespFileListContent += '@' + RespFile + os.linesep
558 RespFileListContent += NewRespStr + os.linesep
559 SaveFileOnChange(RespFileList, RespFileListContent, False)
561 if os.path.exists(RespFileList):
562 os.remove(RespFileList)
564 # convert source files and binary files to build targets
565 self.ResultFileList = [str(T.Target) for T in MyAgo.CodaTargetList]
566 if len(self.ResultFileList) == 0 and len(MyAgo.SourceFileList) != 0:
567 EdkLogger.error("build
", AUTOGEN_ERROR, "Nothing to build
",
568 ExtraData="[%s]" % str(MyAgo))
570 self.ProcessBuildTargetList()
571 self.ParserGenerateFfsCmd()
573 # Generate macros used to represent input files
574 FileMacroList = [] # macro name = file list
575 for FileListMacro in self.FileListMacros:
576 FileMacro = self._FILE_MACRO_TEMPLATE.Replace(
578 "macro_name
" : FileListMacro,
579 "source_file
" : self.FileListMacros[FileListMacro]
582 FileMacroList.append(FileMacro)
584 # INC_LIST is special
587 for P in MyAgo.IncludePathList:
588 IncludePathList.append(IncPrefix + self.PlaceMacro(P, self.Macros))
589 if FileBuildRule.INC_LIST_MACRO in self.ListFileMacros:
590 self.ListFileMacros[FileBuildRule.INC_LIST_MACRO].append(IncPrefix + P)
591 FileMacro += self._FILE_MACRO_TEMPLATE.Replace(
593 "macro_name
" : "INC
",
594 "source_file
" : IncludePathList
597 FileMacroList.append(FileMacro)
599 # Generate macros used to represent files containing list of input files
600 for ListFileMacro in self.ListFileMacros:
601 ListFileName = os.path.join(MyAgo.OutputDir, "%s.lst
" % ListFileMacro.lower()[:len(ListFileMacro) - 5])
602 FileMacroList.append("%s = %s" % (ListFileMacro, ListFileName))
605 "\n".join(self.ListFileMacros[ListFileMacro]),
609 # Edk modules need <BaseName>StrDefs.h for string ID
610 #if MyAgo.AutoGenVersion < 0x00010005 and len(MyAgo.UnicodeFileList) > 0:
611 # BcTargetList = ['strdefs']
616 MakefileName = self._FILE_NAME_[self._FileType]
617 LibraryMakeCommandList = []
618 for D in self.LibraryBuildDirectoryList:
619 Command = self._MAKE_TEMPLATE_[self._FileType] % {"file":os.path.join(D, MakefileName)}
620 LibraryMakeCommandList.append(Command)
622 package_rel_dir = MyAgo.SourceDir
623 current_dir = self.Macros["WORKSPACE
"]
625 while not found and os.sep in package_rel_dir:
626 index = package_rel_dir.index(os.sep)
627 current_dir = mws.join(current_dir, package_rel_dir[:index])
628 if os.path.exists(current_dir):
629 for fl in os.listdir(current_dir):
630 if fl.endswith('.dec'):
633 package_rel_dir = package_rel_dir[index + 1:]
635 MakefileTemplateDict = {
636 "makefile_header
" : self._FILE_HEADER_[self._FileType],
637 "makefile_path
" : os.path.join("$
(MODULE_BUILD_DIR
)", MakefileName),
638 "makefile_name
" : MakefileName,
639 "platform_name
" : self.PlatformInfo.Name,
640 "platform_guid
" : self.PlatformInfo.Guid,
641 "platform_version
" : self.PlatformInfo.Version,
642 "platform_relative_directory
": self.PlatformInfo.SourceDir,
643 "platform_output_directory
" : self.PlatformInfo.OutputDir,
644 "ffs_output_directory
" : MyAgo.Macros["FFS_OUTPUT_DIR
"],
645 "platform_dir
" : MyAgo.Macros["PLATFORM_DIR
"],
647 "module_name
" : MyAgo.Name,
648 "module_guid
" : MyAgo.Guid,
649 "module_name_guid
" : MyAgo.UniqueBaseName,
650 "module_version
" : MyAgo.Version,
651 "module_type
" : MyAgo.ModuleType,
652 "module_file
" : MyAgo.MetaFile.Name,
653 "module_file_base_name
" : MyAgo.MetaFile.BaseName,
654 "module_relative_directory
" : MyAgo.SourceDir,
655 "module_dir
" : mws.join (self.Macros["WORKSPACE
"], MyAgo.SourceDir),
656 "package_relative_directory
": package_rel_dir,
657 "module_extra_defines
" : ["%s = %s" % (k, v) for k, v in MyAgo.Module.Defines.iteritems()],
659 "architecture
" : MyAgo.Arch,
660 "toolchain_tag
" : MyAgo.ToolChain,
661 "build_target
" : MyAgo.BuildTarget,
663 "platform_build_directory
" : self.PlatformInfo.BuildDir,
664 "module_build_directory
" : MyAgo.BuildDir,
665 "module_output_directory
" : MyAgo.OutputDir,
666 "module_debug_directory
" : MyAgo.DebugDir,
668 "separator
" : Separator,
669 "module_tool_definitions
" : ToolsDef,
671 "shell_command_code
" : self._SHELL_CMD_[self._FileType].keys(),
672 "shell_command
" : self._SHELL_CMD_[self._FileType].values(),
674 "module_entry_point
" : ModuleEntryPoint,
675 "image_entry_point
" : ImageEntryPoint,
676 "arch_entry_point
" : ArchEntryPoint,
677 "remaining_build_target
" : self.ResultFileList,
678 "common_dependency_file
" : self.CommonFileDependency,
679 "create_directory_command
" : self.GetCreateDirectoryCommand(self.IntermediateDirectoryList),
680 "clean_command
" : self.GetRemoveDirectoryCommand(["$
(OUTPUT_DIR
)"]),
681 "cleanall_command
" : self.GetRemoveDirectoryCommand(["$
(DEBUG_DIR
)", "$
(OUTPUT_DIR
)"]),
682 "dependent_library_build_directory
" : self.LibraryBuildDirectoryList,
683 "library_build_command
" : LibraryMakeCommandList,
684 "file_macro
" : FileMacroList,
685 "file_build_target
" : self.BuildTargetList,
686 "backward_compatible_target
": BcTargetList,
689 return MakefileTemplateDict
691 def ParserGenerateFfsCmd(self):
692 #Add Ffs cmd to self.BuildTargetList
696 for Cmd in self.GenFfsList:
698 for CopyCmd in Cmd[2]:
700 Src = self.ReplaceMacro(Src)
701 Dst = self.ReplaceMacro(Dst)
702 if Dst not in self.ResultFileList:
703 self.ResultFileList.append(Dst)
704 if '%s :' %(Dst) not in self.BuildTargetList:
705 self.BuildTargetList.append("%s :" %(Dst))
706 self.BuildTargetList.append('\t' + self._CP_TEMPLATE_[self._FileType] %{'Src': Src, 'Dst': Dst})
709 for index, Str in enumerate(FfsCmdList):
711 OutputFile = FfsCmdList[index + 1]
713 if DepsFileList == []:
714 DepsFileList = [FfsCmdList[index + 1]]
716 DepsFileList.append(FfsCmdList[index + 1])
717 DepsFileString = ' '.join(DepsFileList).strip()
718 if DepsFileString == '':
720 OutputFile = self.ReplaceMacro(OutputFile)
721 self.ResultFileList.append(OutputFile)
722 DepsFileString = self.ReplaceMacro(DepsFileString)
723 self.BuildTargetList.append('%s : %s' % (OutputFile, DepsFileString))
724 CmdString = ' '.join(FfsCmdList).strip()
725 CmdString = self.ReplaceMacro(CmdString)
726 self.BuildTargetList.append('\t%s' % CmdString)
728 self.ParseSecCmd(DepsFileList, Cmd[1])
729 for SecOutputFile, SecDepsFile, SecCmd in self.FfsOutputFileList :
730 self.BuildTargetList.append('%s : %s' % (self.ReplaceMacro(SecOutputFile), self.ReplaceMacro(SecDepsFile)))
731 self.BuildTargetList.append('\t%s' % self.ReplaceMacro(SecCmd))
732 self.FfsOutputFileList = []
734 def ParseSecCmd(self, OutputFileList, CmdTuple):
735 for OutputFile in OutputFileList:
736 for SecCmdStr in CmdTuple:
738 SecCmdList = SecCmdStr.split()
739 CmdName = SecCmdList[0]
740 for index, CmdItem in enumerate(SecCmdList):
741 if '-o' == CmdItem and OutputFile == SecCmdList[index + 1]:
743 while index + 1 < len(SecCmdList):
744 if not SecCmdList[index+1].startswith('-'):
745 SecDepsFileList.append(SecCmdList[index + 1])
747 if CmdName == 'Trim':
748 SecDepsFileList.append(os.path.join('$(DEBUG_DIR)', os.path.basename(OutputFile).replace('offset', 'efi')))
749 if OutputFile.endswith('.ui') or OutputFile.endswith('.ver'):
750 SecDepsFileList.append(os.path.join('$(MODULE_DIR)', '$(MODULE_FILE)'))
751 self.FfsOutputFileList.append((OutputFile, ' '.join(SecDepsFileList), SecCmdStr))
752 if len(SecDepsFileList) > 0:
753 self.ParseSecCmd(SecDepsFileList, CmdTuple)
758 def ReplaceMacro(self, str):
759 for Macro in self.MacroList:
760 if self._AutoGenObject.Macros[Macro] and self._AutoGenObject.Macros[Macro] in str:
761 str = str.replace(self._AutoGenObject.Macros[Macro], '$(' + Macro + ')')
764 def CommandExceedLimit(self):
766 'CC' : { 'Macro' : '$(CC_FLAGS)', 'Value' : False},
767 'PP' : { 'Macro' : '$(PP_FLAGS)', 'Value' : False},
768 'APP' : { 'Macro' : '$(APP_FLAGS)', 'Value' : False},
769 'ASLPP' : { 'Macro' : '$(ASLPP_FLAGS)', 'Value' : False},
770 'VFRPP' : { 'Macro' : '$(VFRPP_FLAGS)', 'Value' : False},
771 'ASM' : { 'Macro' : '$(ASM_FLAGS)', 'Value' : False},
772 'ASLCC' : { 'Macro' : '$(ASLCC_FLAGS)', 'Value' : False},
777 IncPrefix = self._INC_FLAG_[self._AutoGenObject.ToolChainFamily]
779 # base on the source files to decide the file type
780 for File in self._AutoGenObject.SourceFileList:
781 for type in self._AutoGenObject.FileTypes:
782 if File in self._AutoGenObject.FileTypes[type]:
783 if type not in FileTypeList:
784 FileTypeList.append(type)
786 # calculate the command-line length
788 for type in FileTypeList:
789 BuildTargets = self._AutoGenObject.BuildRules[type].BuildTargets
790 for Target in BuildTargets:
791 CommandList = BuildTargets[Target].Commands
792 for SingleCommand in CommandList:
794 SingleCommandLength = len(SingleCommand)
795 SingleCommandList = SingleCommand.split()
796 if len(SingleCommandList) > 0:
797 for Flag in FlagDict:
798 if '$('+ Flag +')' in SingleCommandList[0]:
802 if 'PATH' not in self._AutoGenObject._BuildOption[Tool]:
803 EdkLogger.error("build
", AUTOGEN_ERROR, "%s_PATH doesn
't exist in %s ToolChain and %s Arch." %(Tool, self._AutoGenObject.ToolChain, self._AutoGenObject.Arch), ExtraData="[%s]" % str(self._AutoGenObject))
804 SingleCommandLength += len(self._AutoGenObject._BuildOption[Tool]['PATH
'])
805 for item in SingleCommandList[1:]:
806 if FlagDict[Tool]['Macro
'] in item:
807 if 'FLAGS
' not in self._AutoGenObject._BuildOption[Tool]:
808 EdkLogger.error("build", AUTOGEN_ERROR, "%s_FLAGS doesn't exist
in %s ToolChain
and %s Arch
." %(Tool, self._AutoGenObject.ToolChain, self._AutoGenObject.Arch), ExtraData="[%s]" % str(self._AutoGenObject))
809 Str = self._AutoGenObject._BuildOption[Tool]['FLAGS']
810 for Option in self._AutoGenObject.BuildOption:
811 for Attr in self._AutoGenObject.BuildOption[Option]:
812 if Str.find(Option + '_' + Attr) != -1:
813 Str = Str.replace('$(' + Option + '_' + Attr + ')', self._AutoGenObject.BuildOption[Option][Attr])
814 while(Str.find('$(') != -1):
815 for macro in self._AutoGenObject.Macros:
816 MacroName = '$('+ macro + ')'
817 if (Str.find(MacroName) != -1):
818 Str = Str.replace(MacroName, self._AutoGenObject.Macros[macro])
822 SingleCommandLength += len(Str)
823 elif '$(INC)' in item:
824 SingleCommandLength += self._AutoGenObject.IncludePathLength + len(IncPrefix) * len(self._AutoGenObject._IncludePathList)
825 elif item.find('$(') != -1:
827 for Option in self._AutoGenObject.BuildOption:
828 for Attr in self._AutoGenObject.BuildOption[Option]:
829 if Str.find(Option + '_' + Attr) != -1:
830 Str = Str.replace('$(' + Option + '_' + Attr + ')', self._AutoGenObject.BuildOption[Option][Attr])
831 while(Str.find('$(') != -1):
832 for macro in self._AutoGenObject.Macros:
833 MacroName = '$('+ macro + ')'
834 if (Str.find(MacroName) != -1):
835 Str = Str.replace(MacroName, self._AutoGenObject.Macros[macro])
839 SingleCommandLength += len(Str)
841 if SingleCommandLength > GlobalData.gCommandMaxLength:
842 FlagDict[Tool]['Value'] = True
844 # generate the response file content by combine the FLAGS and INC
845 for Flag in FlagDict:
846 if FlagDict[Flag]['Value']:
848 RespMacro = FlagDict[Flag]['Macro'].replace('FLAGS', 'RESP')
849 Value = self._AutoGenObject.BuildOption[Flag]['FLAGS']
850 for inc in self._AutoGenObject._IncludePathList:
851 Value += ' ' + IncPrefix + inc
852 for Option in self._AutoGenObject.BuildOption:
853 for Attr in self._AutoGenObject.BuildOption[Option]:
854 if Value.find(Option + '_' + Attr) != -1:
855 Value = Value.replace('$(' + Option + '_' + Attr + ')', self._AutoGenObject.BuildOption[Option][Attr])
856 while (Value.find('$(') != -1):
857 for macro in self._AutoGenObject.Macros:
858 MacroName = '$('+ macro + ')'
859 if (Value.find(MacroName) != -1):
860 Value = Value.replace(MacroName, self._AutoGenObject.Macros[macro])
865 if self._AutoGenObject.ToolChainFamily == 'GCC':
866 RespDict[Key] = Value.replace('\\', '/')
868 RespDict[Key] = Value
869 for Target in BuildTargets:
870 for i, SingleCommand in enumerate(BuildTargets[Target].Commands):
871 if FlagDict[Flag]['Macro'] in SingleCommand:
872 BuildTargets[Target].Commands[i] = SingleCommand.replace('$(INC)', '').replace(FlagDict[Flag]['Macro'], RespMacro)
875 def ProcessBuildTargetList(self):
877 # Search dependency file list for each source file
879 ForceIncludedFile = []
880 for File in self._AutoGenObject.AutoGenFileList:
882 ForceIncludedFile.append(File)
885 for Target in self._AutoGenObject.IntroTargetList:
886 SourceFileList.extend(Target.Inputs)
887 OutPutFileList.extend(Target.Outputs)
890 for Item in OutPutFileList:
891 if Item in SourceFileList:
892 SourceFileList.remove(Item)
894 self.FileDependency = self.GetFileDependency(
897 self._AutoGenObject.IncludePathList + self._AutoGenObject.BuildOptionIncPathList
900 for File in self.FileDependency:
901 if not self.FileDependency[File]:
902 self.FileDependency[File] = ['$(FORCE_REBUILD)']
905 self._AutoGenObject.AutoGenDepSet |= set(self.FileDependency[File])
908 if File.Ext not in [".c
", ".C
"] or File.Name == "AutoGen
.c
":
911 DepSet = set(self.FileDependency[File])
913 DepSet &= set(self.FileDependency[File])
914 # in case nothing in SourceFileList
918 # Extract common files list in the dependency files
921 self.CommonFileDependency.append(self.PlaceMacro(File.Path, self.Macros))
923 for File in self.FileDependency:
925 if File.Ext not in [".c
", ".C
"] or File.Name == "AutoGen
.c
":
927 NewDepSet = set(self.FileDependency[File])
929 self.FileDependency[File] = ["$
(COMMON_DEPS
)"] + list(NewDepSet)
931 # Convert target description object to target string in makefile
932 for Type in self._AutoGenObject.Targets:
933 for T in self._AutoGenObject.Targets[Type]:
934 # Generate related macros if needed
935 if T.GenFileListMacro and T.FileListMacro not in self.FileListMacros:
936 self.FileListMacros[T.FileListMacro] = []
937 if T.GenListFile and T.ListFileMacro not in self.ListFileMacros:
938 self.ListFileMacros[T.ListFileMacro] = []
939 if T.GenIncListFile and T.IncListFileMacro not in self.ListFileMacros:
940 self.ListFileMacros[T.IncListFileMacro] = []
943 # Add force-dependencies
944 for Dep in T.Dependencies:
945 Deps.append(self.PlaceMacro(str(Dep), self.Macros))
946 # Add inclusion-dependencies
947 if len(T.Inputs) == 1 and T.Inputs[0] in self.FileDependency:
948 for F in self.FileDependency[T.Inputs[0]]:
949 Deps.append(self.PlaceMacro(str(F), self.Macros))
950 # Add source-dependencies
952 NewFile = self.PlaceMacro(str(F), self.Macros)
953 # In order to use file list macro as dependency
955 # gnu tools need forward slash path separater, even on Windows
956 self.ListFileMacros[T.ListFileMacro].append(str(F).replace ('\\', '/'))
957 self.FileListMacros[T.FileListMacro].append(NewFile)
958 elif T.GenFileListMacro:
959 self.FileListMacros[T.FileListMacro].append(NewFile)
963 # Use file list macro as dependency
964 if T.GenFileListMacro:
965 Deps.append("$
(%s)" % T.FileListMacro)
966 if Type in [TAB_OBJECT_FILE, TAB_STATIC_LIBRARY]:
967 Deps.append("$
(%s)" % T.ListFileMacro)
970 "target
" : self.PlaceMacro(T.Target.Path, self.Macros),
971 "cmd
" : "\n\t".join(T.Commands),
974 self.BuildTargetList.append(self._BUILD_TARGET_TEMPLATE.Replace(TargetDict))
976 ## For creating makefile targets for dependent libraries
977 def ProcessDependentLibrary(self):
978 for LibraryAutoGen in self._AutoGenObject.LibraryAutoGenList:
979 if not LibraryAutoGen.IsBinaryModule:
980 self.LibraryBuildDirectoryList.append(self.PlaceMacro(LibraryAutoGen.BuildDir, self.Macros))
982 ## Return a list containing source file's dependencies
984 # @param FileList The list of source files
985 # @param ForceInculeList The list of files which will be included forcely
986 # @param SearchPathList The list of search path
988 # @retval dict The mapping between source file path and its dependencies
990 def GetFileDependency(self, FileList, ForceInculeList, SearchPathList):
993 Dependency[F] = self.GetDependencyList(F, ForceInculeList, SearchPathList)
996 ## Find dependencies for one source file
998 # By searching recursively "#include" directive in file, find out all the
999 # files needed by given source file. The dependecies will be only searched
1000 # in given search path list.
1002 # @param File The source file
1003 # @param ForceInculeList The list of files which will be included forcely
1004 # @param SearchPathList The list of search path
1006 # @retval list The list of files the given source file depends on
1008 def GetDependencyList(self
, File
, ForceList
, SearchPathList
):
1009 EdkLogger
.debug(EdkLogger
.DEBUG_1
, "Try to get dependency files for %s" % File
)
1010 FileStack
= [File
] + ForceList
1011 DependencySet
= set()
1013 if self
._AutoGenObject
.Arch
not in gDependencyDatabase
:
1014 gDependencyDatabase
[self
._AutoGenObject
.Arch
] = {}
1015 DepDb
= gDependencyDatabase
[self
._AutoGenObject
.Arch
]
1017 while len(FileStack
) > 0:
1020 FullPathDependList
= []
1021 if F
in self
.FileCache
:
1022 for CacheFile
in self
.FileCache
[F
]:
1023 FullPathDependList
.append(CacheFile
)
1024 if CacheFile
not in DependencySet
:
1025 FileStack
.append(CacheFile
)
1026 DependencySet
.update(FullPathDependList
)
1029 CurrentFileDependencyList
= []
1031 CurrentFileDependencyList
= DepDb
[F
]
1034 Fd
= open(F
.Path
, 'r')
1035 except BaseException
as X
:
1036 EdkLogger
.error("build", FILE_OPEN_FAILURE
, ExtraData
=F
.Path
+ "\n\t" + str(X
))
1038 FileContent
= Fd
.read()
1040 if len(FileContent
) == 0:
1043 if FileContent
[0] == 0xff or FileContent
[0] == 0xfe:
1044 FileContent
= unicode(FileContent
, "utf-16")
1045 IncludedFileList
= gIncludePattern
.findall(FileContent
)
1047 for Inc
in IncludedFileList
:
1049 # if there's macro used to reference header file, expand it
1050 HeaderList
= gMacroPattern
.findall(Inc
)
1051 if len(HeaderList
) == 1 and len(HeaderList
[0]) == 2:
1052 HeaderType
= HeaderList
[0][0]
1053 HeaderKey
= HeaderList
[0][1]
1054 if HeaderType
in gIncludeMacroConversion
:
1055 Inc
= gIncludeMacroConversion
[HeaderType
] % {"HeaderKey" : HeaderKey
}
1057 # not known macro used in #include, always build the file by
1058 # returning a empty dependency
1059 self
.FileCache
[File
] = []
1061 Inc
= os
.path
.normpath(Inc
)
1062 CurrentFileDependencyList
.append(Inc
)
1063 DepDb
[F
] = CurrentFileDependencyList
1065 CurrentFilePath
= F
.Dir
1066 PathList
= [CurrentFilePath
] + SearchPathList
1067 for Inc
in CurrentFileDependencyList
:
1068 for SearchPath
in PathList
:
1069 FilePath
= os
.path
.join(SearchPath
, Inc
)
1070 if FilePath
in gIsFileMap
:
1071 if not gIsFileMap
[FilePath
]:
1073 # If isfile is called too many times, the performance is slow down.
1074 elif not os
.path
.isfile(FilePath
):
1075 gIsFileMap
[FilePath
] = False
1078 gIsFileMap
[FilePath
] = True
1079 FilePath
= PathClass(FilePath
)
1080 FullPathDependList
.append(FilePath
)
1081 if FilePath
not in DependencySet
:
1082 FileStack
.append(FilePath
)
1085 EdkLogger
.debug(EdkLogger
.DEBUG_9
, "%s included by %s was not found "\
1086 "in any given path:\n\t%s" % (Inc
, F
, "\n\t".join(SearchPathList
)))
1088 self
.FileCache
[F
] = FullPathDependList
1089 DependencySet
.update(FullPathDependList
)
1091 DependencySet
.update(ForceList
)
1092 if File
in DependencySet
:
1093 DependencySet
.remove(File
)
1094 DependencyList
= list(DependencySet
) # remove duplicate ones
1096 return DependencyList
1098 _TemplateDict
= property(_CreateTemplateDict
)
1100 ## CustomMakefile class
1102 # This class encapsules makefie and its generation for module. It uses template to generate
1103 # the content of makefile. The content of makefile will be got from ModuleAutoGen object.
1105 class CustomMakefile(BuildFile
):
1106 ## template used to generate the makefile for module with custom makefile
1107 _TEMPLATE_
= TemplateString('''\
1111 # Platform Macro Definition
1113 PLATFORM_NAME = ${platform_name}
1114 PLATFORM_GUID = ${platform_guid}
1115 PLATFORM_VERSION = ${platform_version}
1116 PLATFORM_RELATIVE_DIR = ${platform_relative_directory}
1117 PLATFORM_DIR = ${platform_dir}
1118 PLATFORM_OUTPUT_DIR = ${platform_output_directory}
1121 # Module Macro Definition
1123 MODULE_NAME = ${module_name}
1124 MODULE_GUID = ${module_guid}
1125 MODULE_NAME_GUID = ${module_name_guid}
1126 MODULE_VERSION = ${module_version}
1127 MODULE_TYPE = ${module_type}
1128 MODULE_FILE = ${module_file}
1129 MODULE_FILE_BASE_NAME = ${module_file_base_name}
1130 BASE_NAME = $(MODULE_NAME)
1131 MODULE_RELATIVE_DIR = ${module_relative_directory}
1132 MODULE_DIR = ${module_dir}
1135 # Build Configuration Macro Definition
1137 ARCH = ${architecture}
1138 TOOLCHAIN = ${toolchain_tag}
1139 TOOLCHAIN_TAG = ${toolchain_tag}
1140 TARGET = ${build_target}
1143 # Build Directory Macro Definition
1145 # PLATFORM_BUILD_DIR = ${platform_build_directory}
1146 BUILD_DIR = ${platform_build_directory}
1147 BIN_DIR = $(BUILD_DIR)${separator}${architecture}
1148 LIB_DIR = $(BIN_DIR)
1149 MODULE_BUILD_DIR = ${module_build_directory}
1150 OUTPUT_DIR = ${module_output_directory}
1151 DEBUG_DIR = ${module_debug_directory}
1152 DEST_DIR_OUTPUT = $(OUTPUT_DIR)
1153 DEST_DIR_DEBUG = $(DEBUG_DIR)
1156 # Tools definitions specific to this module
1158 ${BEGIN}${module_tool_definitions}
1160 MAKE_FILE = ${makefile_path}
1163 # Shell Command Macro
1165 ${BEGIN}${shell_command_code} = ${shell_command}
1168 ${custom_makefile_content}
1171 # Target used when called from platform makefile, which will bypass the build of dependent libraries
1184 # Build Target used in multi-thread build mode, which no init target is needed
1190 # Initialization target: print build information and create necessary directories
1193 \t-@echo Building ... $(MODULE_DIR)${separator}$(MODULE_FILE) [$(ARCH)]
1194 ${BEGIN}\t-@${create_directory_command}\n${END}\
1198 ## Constructor of CustomMakefile
1200 # @param ModuleAutoGen Object of ModuleAutoGen class
1202 def __init__(self
, ModuleAutoGen
):
1203 BuildFile
.__init
__(self
, ModuleAutoGen
)
1204 self
.PlatformInfo
= self
._AutoGenObject
.PlatformInfo
1205 self
.IntermediateDirectoryList
= ["$(DEBUG_DIR)", "$(OUTPUT_DIR)"]
1207 # Compose a dict object containing information used to do replacement in template
1208 def _CreateTemplateDict(self
):
1209 Separator
= self
._SEP
_[self
._FileType
]
1210 MyAgo
= self
._AutoGenObject
1211 if self
._FileType
not in MyAgo
.CustomMakefile
:
1212 EdkLogger
.error('build', OPTION_NOT_SUPPORTED
, "No custom makefile for %s" % self
._FileType
,
1213 ExtraData
="[%s]" % str(MyAgo
))
1214 MakefilePath
= mws
.join(
1216 MyAgo
.CustomMakefile
[self
._FileType
]
1219 CustomMakefile
= open(MakefilePath
, 'r').read()
1221 EdkLogger
.error('build', FILE_OPEN_FAILURE
, File
=str(MyAgo
),
1222 ExtraData
=MyAgo
.CustomMakefile
[self
._FileType
])
1226 for Tool
in MyAgo
.BuildOption
:
1227 # Don't generate MAKE_FLAGS in makefile. It's put in environment variable.
1230 for Attr
in MyAgo
.BuildOption
[Tool
]:
1231 if Attr
== "FAMILY":
1233 elif Attr
== "PATH":
1234 ToolsDef
.append("%s = %s" % (Tool
, MyAgo
.BuildOption
[Tool
][Attr
]))
1236 ToolsDef
.append("%s_%s = %s" % (Tool
, Attr
, MyAgo
.BuildOption
[Tool
][Attr
]))
1239 MakefileName
= self
._FILE
_NAME
_[self
._FileType
]
1240 MakefileTemplateDict
= {
1241 "makefile_header" : self
._FILE
_HEADER
_[self
._FileType
],
1242 "makefile_path" : os
.path
.join("$(MODULE_BUILD_DIR)", MakefileName
),
1243 "platform_name" : self
.PlatformInfo
.Name
,
1244 "platform_guid" : self
.PlatformInfo
.Guid
,
1245 "platform_version" : self
.PlatformInfo
.Version
,
1246 "platform_relative_directory": self
.PlatformInfo
.SourceDir
,
1247 "platform_output_directory" : self
.PlatformInfo
.OutputDir
,
1248 "platform_dir" : MyAgo
.Macros
["PLATFORM_DIR"],
1250 "module_name" : MyAgo
.Name
,
1251 "module_guid" : MyAgo
.Guid
,
1252 "module_name_guid" : MyAgo
.UniqueBaseName
,
1253 "module_version" : MyAgo
.Version
,
1254 "module_type" : MyAgo
.ModuleType
,
1255 "module_file" : MyAgo
.MetaFile
,
1256 "module_file_base_name" : MyAgo
.MetaFile
.BaseName
,
1257 "module_relative_directory" : MyAgo
.SourceDir
,
1258 "module_dir" : mws
.join (MyAgo
.WorkspaceDir
, MyAgo
.SourceDir
),
1260 "architecture" : MyAgo
.Arch
,
1261 "toolchain_tag" : MyAgo
.ToolChain
,
1262 "build_target" : MyAgo
.BuildTarget
,
1264 "platform_build_directory" : self
.PlatformInfo
.BuildDir
,
1265 "module_build_directory" : MyAgo
.BuildDir
,
1266 "module_output_directory" : MyAgo
.OutputDir
,
1267 "module_debug_directory" : MyAgo
.DebugDir
,
1269 "separator" : Separator
,
1270 "module_tool_definitions" : ToolsDef
,
1272 "shell_command_code" : self
._SHELL
_CMD
_[self
._FileType
].keys(),
1273 "shell_command" : self
._SHELL
_CMD
_[self
._FileType
].values(),
1275 "create_directory_command" : self
.GetCreateDirectoryCommand(self
.IntermediateDirectoryList
),
1276 "custom_makefile_content" : CustomMakefile
1279 return MakefileTemplateDict
1281 _TemplateDict
= property(_CreateTemplateDict
)
1283 ## PlatformMakefile class
1285 # This class encapsules makefie and its generation for platform. It uses
1286 # template to generate the content of makefile. The content of makefile will be
1287 # got from PlatformAutoGen object.
1289 class PlatformMakefile(BuildFile
):
1290 ## template used to generate the makefile for platform
1291 _TEMPLATE_
= TemplateString('''\
1295 # Platform Macro Definition
1297 PLATFORM_NAME = ${platform_name}
1298 PLATFORM_GUID = ${platform_guid}
1299 PLATFORM_VERSION = ${platform_version}
1300 PLATFORM_FILE = ${platform_file}
1301 PLATFORM_DIR = ${platform_dir}
1302 PLATFORM_OUTPUT_DIR = ${platform_output_directory}
1305 # Build Configuration Macro Definition
1307 TOOLCHAIN = ${toolchain_tag}
1308 TOOLCHAIN_TAG = ${toolchain_tag}
1309 TARGET = ${build_target}
1312 # Build Directory Macro Definition
1314 BUILD_DIR = ${platform_build_directory}
1315 FV_DIR = ${platform_build_directory}${separator}FV
1318 # Shell Command Macro
1320 ${BEGIN}${shell_command_code} = ${shell_command}
1324 MAKE_FILE = ${makefile_path}
1329 all: init build_libraries build_modules
1332 # Initialization target: print build information and create necessary directories
1335 \t-@echo Building ... $(PLATFORM_FILE) [${build_architecture_list}]
1336 \t${BEGIN}-@${create_directory_command}
1339 # library build target
1341 libraries: init build_libraries
1344 # module build target
1346 modules: init build_libraries build_modules
1349 # Build all libraries:
1352 ${BEGIN}\t@"$(MAKE)" $(MAKE_FLAGS) -f ${library_makefile_list} pbuild
1353 ${END}\t@cd $(BUILD_DIR)
1356 # Build all modules:
1359 ${BEGIN}\t@"$(MAKE)" $(MAKE_FLAGS) -f ${module_makefile_list} pbuild
1360 ${END}\t@cd $(BUILD_DIR)
1363 # Clean intermediate files
1366 \t${BEGIN}-@${library_build_command} clean
1367 \t${END}${BEGIN}-@${module_build_command} clean
1368 \t${END}@cd $(BUILD_DIR)
1371 # Clean all generated files except to makefile
1374 ${BEGIN}\t${cleanall_command}
1378 # Clean all library files
1381 \t${BEGIN}-@${library_build_command} cleanall
1382 \t${END}@cd $(BUILD_DIR)\n
1385 ## Constructor of PlatformMakefile
1387 # @param ModuleAutoGen Object of PlatformAutoGen class
1389 def __init__(self
, PlatformAutoGen
):
1390 BuildFile
.__init
__(self
, PlatformAutoGen
)
1391 self
.ModuleBuildCommandList
= []
1392 self
.ModuleMakefileList
= []
1393 self
.IntermediateDirectoryList
= []
1394 self
.ModuleBuildDirectoryList
= []
1395 self
.LibraryBuildDirectoryList
= []
1396 self
.LibraryMakeCommandList
= []
1398 # Compose a dict object containing information used to do replacement in template
1399 def _CreateTemplateDict(self
):
1400 Separator
= self
._SEP
_[self
._FileType
]
1402 MyAgo
= self
._AutoGenObject
1403 if "MAKE" not in MyAgo
.ToolDefinition
or "PATH" not in MyAgo
.ToolDefinition
["MAKE"]:
1404 EdkLogger
.error("build", OPTION_MISSING
, "No MAKE command defined. Please check your tools_def.txt!",
1405 ExtraData
="[%s]" % str(MyAgo
))
1407 self
.IntermediateDirectoryList
= ["$(BUILD_DIR)"]
1408 self
.ModuleBuildDirectoryList
= self
.GetModuleBuildDirectoryList()
1409 self
.LibraryBuildDirectoryList
= self
.GetLibraryBuildDirectoryList()
1411 MakefileName
= self
._FILE
_NAME
_[self
._FileType
]
1412 LibraryMakefileList
= []
1413 LibraryMakeCommandList
= []
1414 for D
in self
.LibraryBuildDirectoryList
:
1415 D
= self
.PlaceMacro(D
, {"BUILD_DIR":MyAgo
.BuildDir
})
1416 Makefile
= os
.path
.join(D
, MakefileName
)
1417 Command
= self
._MAKE
_TEMPLATE
_[self
._FileType
] % {"file":Makefile
}
1418 LibraryMakefileList
.append(Makefile
)
1419 LibraryMakeCommandList
.append(Command
)
1420 self
.LibraryMakeCommandList
= LibraryMakeCommandList
1422 ModuleMakefileList
= []
1423 ModuleMakeCommandList
= []
1424 for D
in self
.ModuleBuildDirectoryList
:
1425 D
= self
.PlaceMacro(D
, {"BUILD_DIR":MyAgo
.BuildDir
})
1426 Makefile
= os
.path
.join(D
, MakefileName
)
1427 Command
= self
._MAKE
_TEMPLATE
_[self
._FileType
] % {"file":Makefile
}
1428 ModuleMakefileList
.append(Makefile
)
1429 ModuleMakeCommandList
.append(Command
)
1431 MakefileTemplateDict
= {
1432 "makefile_header" : self
._FILE
_HEADER
_[self
._FileType
],
1433 "makefile_path" : os
.path
.join("$(BUILD_DIR)", MakefileName
),
1434 "make_path" : MyAgo
.ToolDefinition
["MAKE"]["PATH"],
1435 "makefile_name" : MakefileName
,
1436 "platform_name" : MyAgo
.Name
,
1437 "platform_guid" : MyAgo
.Guid
,
1438 "platform_version" : MyAgo
.Version
,
1439 "platform_file" : MyAgo
.MetaFile
,
1440 "platform_relative_directory": MyAgo
.SourceDir
,
1441 "platform_output_directory" : MyAgo
.OutputDir
,
1442 "platform_build_directory" : MyAgo
.BuildDir
,
1443 "platform_dir" : MyAgo
.Macros
["PLATFORM_DIR"],
1445 "toolchain_tag" : MyAgo
.ToolChain
,
1446 "build_target" : MyAgo
.BuildTarget
,
1447 "shell_command_code" : self
._SHELL
_CMD
_[self
._FileType
].keys(),
1448 "shell_command" : self
._SHELL
_CMD
_[self
._FileType
].values(),
1449 "build_architecture_list" : MyAgo
.Arch
,
1450 "architecture" : MyAgo
.Arch
,
1451 "separator" : Separator
,
1452 "create_directory_command" : self
.GetCreateDirectoryCommand(self
.IntermediateDirectoryList
),
1453 "cleanall_command" : self
.GetRemoveDirectoryCommand(self
.IntermediateDirectoryList
),
1454 "library_makefile_list" : LibraryMakefileList
,
1455 "module_makefile_list" : ModuleMakefileList
,
1456 "library_build_command" : LibraryMakeCommandList
,
1457 "module_build_command" : ModuleMakeCommandList
,
1460 return MakefileTemplateDict
1462 ## Get the root directory list for intermediate files of all modules build
1464 # @retval list The list of directory
1466 def GetModuleBuildDirectoryList(self
):
1468 for ModuleAutoGen
in self
._AutoGenObject
.ModuleAutoGenList
:
1469 if not ModuleAutoGen
.IsBinaryModule
:
1470 DirList
.append(os
.path
.join(self
._AutoGenObject
.BuildDir
, ModuleAutoGen
.BuildDir
))
1473 ## Get the root directory list for intermediate files of all libraries build
1475 # @retval list The list of directory
1477 def GetLibraryBuildDirectoryList(self
):
1479 for LibraryAutoGen
in self
._AutoGenObject
.LibraryAutoGenList
:
1480 if not LibraryAutoGen
.IsBinaryModule
:
1481 DirList
.append(os
.path
.join(self
._AutoGenObject
.BuildDir
, LibraryAutoGen
.BuildDir
))
1484 _TemplateDict
= property(_CreateTemplateDict
)
1486 ## TopLevelMakefile class
1488 # This class encapsules makefie and its generation for entrance makefile. It
1489 # uses template to generate the content of makefile. The content of makefile
1490 # will be got from WorkspaceAutoGen object.
1492 class TopLevelMakefile(BuildFile
):
1493 ## template used to generate toplevel makefile
1494 _TEMPLATE_
= TemplateString('''${BEGIN}\tGenFds -f ${fdf_file} --conf=${conf_directory} -o ${platform_build_directory} -t ${toolchain_tag} -b ${build_target} -p ${active_platform} -a ${build_architecture_list} ${extra_options}${END}${BEGIN} -r ${fd} ${END}${BEGIN} -i ${fv} ${END}${BEGIN} -C ${cap} ${END}${BEGIN} -D ${macro} ${END}''')
1496 ## Constructor of TopLevelMakefile
1498 # @param Workspace Object of WorkspaceAutoGen class
1500 def __init__(self
, Workspace
):
1501 BuildFile
.__init
__(self
, Workspace
)
1502 self
.IntermediateDirectoryList
= []
1504 # Compose a dict object containing information used to do replacement in template
1505 def _CreateTemplateDict(self
):
1506 Separator
= self
._SEP
_[self
._FileType
]
1508 # any platform autogen object is ok because we just need common information
1509 MyAgo
= self
._AutoGenObject
1511 if "MAKE" not in MyAgo
.ToolDefinition
or "PATH" not in MyAgo
.ToolDefinition
["MAKE"]:
1512 EdkLogger
.error("build", OPTION_MISSING
, "No MAKE command defined. Please check your tools_def.txt!",
1513 ExtraData
="[%s]" % str(MyAgo
))
1515 for Arch
in MyAgo
.ArchList
:
1516 self
.IntermediateDirectoryList
.append(Separator
.join(["$(BUILD_DIR)", Arch
]))
1517 self
.IntermediateDirectoryList
.append("$(FV_DIR)")
1519 # TRICK: for not generating GenFds call in makefile if no FDF file
1521 if MyAgo
.FdfFile
is not None and MyAgo
.FdfFile
!= "":
1522 FdfFileList
= [MyAgo
.FdfFile
]
1523 # macros passed to GenFds
1524 MacroList
.append('"%s=%s"' % ("EFI_SOURCE", GlobalData
.gEfiSource
.replace('\\', '\\\\')))
1525 MacroList
.append('"%s=%s"' % ("EDK_SOURCE", GlobalData
.gEdkSource
.replace('\\', '\\\\')))
1527 MacroDict
.update(GlobalData
.gGlobalDefines
)
1528 MacroDict
.update(GlobalData
.gCommandLineDefines
)
1529 MacroDict
.pop("EFI_SOURCE", "dummy")
1530 MacroDict
.pop("EDK_SOURCE", "dummy")
1531 for MacroName
in MacroDict
:
1532 if MacroDict
[MacroName
] != "":
1533 MacroList
.append('"%s=%s"' % (MacroName
, MacroDict
[MacroName
].replace('\\', '\\\\')))
1535 MacroList
.append('"%s"' % MacroName
)
1539 # pass extra common options to external program called in makefile, currently GenFds.exe
1541 LogLevel
= EdkLogger
.GetLevel()
1542 if LogLevel
== EdkLogger
.VERBOSE
:
1543 ExtraOption
+= " -v"
1544 elif LogLevel
<= EdkLogger
.DEBUG_9
:
1545 ExtraOption
+= " -d %d" % (LogLevel
- 1)
1546 elif LogLevel
== EdkLogger
.QUIET
:
1547 ExtraOption
+= " -q"
1549 if GlobalData
.gCaseInsensitive
:
1550 ExtraOption
+= " -c"
1551 if GlobalData
.gEnableGenfdsMultiThread
:
1552 ExtraOption
+= " --genfds-multi-thread"
1553 if GlobalData
.gIgnoreSource
:
1554 ExtraOption
+= " --ignore-sources"
1556 for pcd
in GlobalData
.BuildOptionPcd
:
1558 pcdname
= '.'.join(pcd
[0:3])
1560 pcdname
= '.'.join(pcd
[0:2])
1561 if pcd
[3].startswith('{'):
1562 ExtraOption
+= " --pcd " + pcdname
+ '=' + 'H' + '"' + pcd
[3] + '"'
1564 ExtraOption
+= " --pcd " + pcdname
+ '=' + pcd
[3]
1566 MakefileName
= self
._FILE
_NAME
_[self
._FileType
]
1567 SubBuildCommandList
= []
1568 for A
in MyAgo
.ArchList
:
1569 Command
= self
._MAKE
_TEMPLATE
_[self
._FileType
] % {"file":os
.path
.join("$(BUILD_DIR)", A
, MakefileName
)}
1570 SubBuildCommandList
.append(Command
)
1572 MakefileTemplateDict
= {
1573 "makefile_header" : self
._FILE
_HEADER
_[self
._FileType
],
1574 "makefile_path" : os
.path
.join("$(BUILD_DIR)", MakefileName
),
1575 "make_path" : MyAgo
.ToolDefinition
["MAKE"]["PATH"],
1576 "platform_name" : MyAgo
.Name
,
1577 "platform_guid" : MyAgo
.Guid
,
1578 "platform_version" : MyAgo
.Version
,
1579 "platform_build_directory" : MyAgo
.BuildDir
,
1580 "conf_directory" : GlobalData
.gConfDirectory
,
1582 "toolchain_tag" : MyAgo
.ToolChain
,
1583 "build_target" : MyAgo
.BuildTarget
,
1584 "shell_command_code" : self
._SHELL
_CMD
_[self
._FileType
].keys(),
1585 "shell_command" : self
._SHELL
_CMD
_[self
._FileType
].values(),
1586 'arch' : list(MyAgo
.ArchList
),
1587 "build_architecture_list" : ','.join(MyAgo
.ArchList
),
1588 "separator" : Separator
,
1589 "create_directory_command" : self
.GetCreateDirectoryCommand(self
.IntermediateDirectoryList
),
1590 "cleanall_command" : self
.GetRemoveDirectoryCommand(self
.IntermediateDirectoryList
),
1591 "sub_build_command" : SubBuildCommandList
,
1592 "fdf_file" : FdfFileList
,
1593 "active_platform" : str(MyAgo
),
1594 "fd" : MyAgo
.FdTargetList
,
1595 "fv" : MyAgo
.FvTargetList
,
1596 "cap" : MyAgo
.CapTargetList
,
1597 "extra_options" : ExtraOption
,
1598 "macro" : MacroList
,
1601 return MakefileTemplateDict
1603 ## Get the root directory list for intermediate files of all modules build
1605 # @retval list The list of directory
1607 def GetModuleBuildDirectoryList(self
):
1609 for ModuleAutoGen
in self
._AutoGenObject
.ModuleAutoGenList
:
1610 if not ModuleAutoGen
.IsBinaryModule
:
1611 DirList
.append(os
.path
.join(self
._AutoGenObject
.BuildDir
, ModuleAutoGen
.BuildDir
))
1614 ## Get the root directory list for intermediate files of all libraries build
1616 # @retval list The list of directory
1618 def GetLibraryBuildDirectoryList(self
):
1620 for LibraryAutoGen
in self
._AutoGenObject
.LibraryAutoGenList
:
1621 if not LibraryAutoGen
.IsBinaryModule
:
1622 DirList
.append(os
.path
.join(self
._AutoGenObject
.BuildDir
, LibraryAutoGen
.BuildDir
))
1625 _TemplateDict
= property(_CreateTemplateDict
)
1627 # This acts like the main() function for the script, unless it is 'import'ed into another script.
1628 if __name__
== '__main__':