[mirror_edk2.git] / BaseTools / Source / Python / GenFds / GuidSection.py

## @file\r
# process GUIDed section generation\r
#\r
#  Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>\r
#\r
#  This program and the accompanying materials\r
#  are licensed and made available under the terms and conditions of the BSD License\r
#  which accompanies this distribution.  The full text of the license may be found at\r
#  http://opensource.org/licenses/bsd-license.php\r
#\r
#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
#\r
\r
##\r
# Import Modules\r
#\r
import Section\r
import subprocess\r
from Ffs import Ffs\r
import Common.LongFilePathOs as os\r
from GenFdsGlobalVariable import GenFdsGlobalVariable\r
from CommonDataClass.FdfClass import GuidSectionClassObject\r
from Common import ToolDefClassObject\r
import sys\r
from Common import EdkLogger\r
from Common.BuildToolError import *\r
from FvImageSection import FvImageSection\r
from Common.LongFilePathSupport import OpenLongFilePath as open\r
\r
## generate GUIDed section\r
#\r
#\r
class GuidSection(GuidSectionClassObject) :\r
\r
    ## The constructor\r
    #\r
    #   @param  self        The object pointer\r
    #\r
    def __init__(self):\r
        GuidSectionClassObject.__init__(self)\r
\r
    ## GenSection() method\r
    #\r
    #   Generate GUIDed section\r
    #\r
    #   @param  self        The object pointer\r
    #   @param  OutputPath  Where to place output file\r
    #   @param  ModuleName  Which module this section belongs to\r
    #   @param  SecNum      Index of section\r
    #   @param  KeyStringList  Filter for inputs of section generation\r
    #   @param  FfsInf      FfsInfStatement object that contains this section data\r
    #   @param  Dict        dictionary contains macro and its value\r
    #   @retval tuple       (Generated file name, section alignment)\r
    #\r
    def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = None, Dict = {}):\r
        #\r
        # Generate all section\r
        #\r
        self.KeyStringList = KeyStringList\r
        self.CurrentArchList = GenFdsGlobalVariable.ArchList\r
        if FfsInf != None:\r
            self.Alignment = FfsInf.__ExtendMacro__(self.Alignment)\r
            self.NameGuid = FfsInf.__ExtendMacro__(self.NameGuid)\r
            self.SectionType = FfsInf.__ExtendMacro__(self.SectionType)\r
            self.CurrentArchList = [FfsInf.CurrentArch]\r
\r
        SectFile  = tuple()\r
        SectAlign = []\r
        Index = 0\r
        MaxAlign = None\r
        if self.FvAddr != []:\r
            FvAddrIsSet = True\r
        else:\r
            FvAddrIsSet = False\r
        \r
        if self.ProcessRequired in ("TRUE", "1"):\r
            if self.FvAddr != []:\r
                #no use FvAddr when the image is processed.\r
                self.FvAddr = []\r
            if self.FvParentAddr != None:\r
                #no use Parent Addr when the image is processed.\r
                self.FvParentAddr = None\r
\r
        for Sect in self.SectionList:\r
            Index = Index + 1\r
            SecIndex = '%s.%d' %(SecNum,Index)\r
            # set base address for inside FvImage\r
            if isinstance(Sect, FvImageSection):\r
                if self.FvAddr != []:\r
                    Sect.FvAddr = self.FvAddr.pop(0)\r
                self.IncludeFvSection = True\r
            elif isinstance(Sect, GuidSection):\r
                Sect.FvAddr = self.FvAddr\r
                Sect.FvParentAddr = self.FvParentAddr\r
            ReturnSectList, align = Sect.GenSection(OutputPath, ModuleName, SecIndex, KeyStringList,FfsInf, Dict)\r
            if isinstance(Sect, GuidSection):\r
                if Sect.IncludeFvSection:\r
                    self.IncludeFvSection = Sect.IncludeFvSection\r
\r
            if align != None:\r
                if MaxAlign == None:\r
                    MaxAlign = align\r
                if GenFdsGlobalVariable.GetAlignment (align) > GenFdsGlobalVariable.GetAlignment (MaxAlign):\r
                    MaxAlign = align\r
            if ReturnSectList != []:\r
                if align == None:\r
                    align = "1"\r
                for file in ReturnSectList:\r
                    SectFile += (file,)\r
                    SectAlign.append(align)\r
\r
        if MaxAlign != None:\r
            if self.Alignment == None:\r
                self.Alignment = MaxAlign\r
            else:\r
                if GenFdsGlobalVariable.GetAlignment (MaxAlign) > GenFdsGlobalVariable.GetAlignment (self.Alignment):\r
                    self.Alignment = MaxAlign\r
\r
        OutputFile = OutputPath + \\r
                     os.sep     + \\r
                     ModuleName + \\r
                     'SEC'      + \\r
                     SecNum     + \\r
                     Ffs.SectionSuffix['GUIDED']\r
        OutputFile = os.path.normpath(OutputFile)\r
\r
        ExternalTool = None\r
        ExternalOption = None\r
        if self.NameGuid != None:\r
            ExternalTool, ExternalOption = self.__FindExtendTool__()\r
\r
        #\r
        # If not have GUID , call default\r
        # GENCRC32 section\r
        #\r
        if self.NameGuid == None :\r
            GenFdsGlobalVariable.VerboseLogger( "Use GenSection function Generate CRC32 Section")\r
            GenFdsGlobalVariable.GenerateSection(OutputFile, SectFile, Section.Section.SectionType[self.SectionType], InputAlign=SectAlign)\r
            OutputFileList = []\r
            OutputFileList.append(OutputFile)\r
            return OutputFileList, self.Alignment\r
        #or GUID not in External Tool List\r
        elif ExternalTool == None:\r
            EdkLogger.error("GenFds", GENFDS_ERROR, "No tool found with GUID %s" % self.NameGuid)\r
        else:\r
            DummyFile = OutputFile+".dummy"\r
            #\r
            # Call GenSection with DUMMY section type.\r
            #\r
            GenFdsGlobalVariable.GenerateSection(DummyFile, SectFile, InputAlign=SectAlign)\r
            #\r
            # Use external tool process the Output\r
            #\r
            TempFile = OutputPath + \\r
                       os.sep     + \\r
                       ModuleName + \\r
                       'SEC'      + \\r
                       SecNum     + \\r
                       '.tmp'\r
            TempFile = os.path.normpath(TempFile)\r
            #\r
            # Remove temp file if its time stamp is older than dummy file\r
            # Just in case the external tool fails at this time but succeeded before\r
            # Error should be reported if the external tool does not generate a new output based on new input\r
            #\r
            if os.path.exists(TempFile) and os.path.exists(DummyFile) and os.path.getmtime(TempFile) < os.path.getmtime(DummyFile):\r
                os.remove(TempFile)\r
\r
            FirstCall = False\r
            CmdOption = '-e'\r
            if ExternalOption != None:\r
                CmdOption = CmdOption + ' ' + ExternalOption\r
            if self.ProcessRequired not in ("TRUE", "1") and self.IncludeFvSection and not FvAddrIsSet and self.FvParentAddr != None:\r
                #FirstCall is only set for the encapsulated flash FV image without process required attribute.\r
                FirstCall = True\r
            #\r
            # Call external tool\r
            #\r
            ReturnValue = [1]\r
            if FirstCall:\r
                #first try to call the guided tool with -z option and CmdOption for the no process required guided tool.\r
                GenFdsGlobalVariable.GuidTool(TempFile, [DummyFile], ExternalTool, '-z' + ' ' + CmdOption, ReturnValue)\r
\r
            #\r
            # when no call or first call failed, ReturnValue are not 1.\r
            # Call the guided tool with CmdOption\r
            #\r
            if ReturnValue[0] != 0:\r
                FirstCall = False\r
                ReturnValue[0] = 0\r
                GenFdsGlobalVariable.GuidTool(TempFile, [DummyFile], ExternalTool, CmdOption)\r
            #\r
            # There is external tool which does not follow standard rule which return nonzero if tool fails\r
            # The output file has to be checked\r
            #\r
            if not os.path.exists(TempFile):\r
                EdkLogger.error("GenFds", COMMAND_FAILURE, 'Fail to call %s, no output file was generated' % ExternalTool)\r
\r
            FileHandleIn = open(DummyFile,'rb')\r
            FileHandleIn.seek(0,2)\r
            InputFileSize = FileHandleIn.tell()\r
            \r
            FileHandleOut = open(TempFile,'rb')\r
            FileHandleOut.seek(0,2)\r
            TempFileSize = FileHandleOut.tell()\r
\r
            Attribute = []\r
            HeaderLength = None\r
            if self.ExtraHeaderSize != -1:\r
                HeaderLength = str(self.ExtraHeaderSize)\r
\r
            if self.ProcessRequired == "NONE" and HeaderLength == None:\r
                if TempFileSize > InputFileSize:\r
                    FileHandleIn.seek(0)\r
                    BufferIn  = FileHandleIn.read()\r
                    FileHandleOut.seek(0)\r
                    BufferOut = FileHandleOut.read()\r
                    if BufferIn == BufferOut[TempFileSize - InputFileSize:]:\r
                        HeaderLength = str(TempFileSize - InputFileSize)\r
                #auto sec guided attribute with process required\r
                if HeaderLength == None:\r
                    Attribute.append('PROCESSING_REQUIRED')\r
\r
            FileHandleIn.close()\r
            FileHandleOut.close()\r
            \r
            if FirstCall and 'PROCESSING_REQUIRED' in Attribute:\r
                # Guided data by -z option on first call is the process required data. Call the guided tool with the real option.\r
                GenFdsGlobalVariable.GuidTool(TempFile, [DummyFile], ExternalTool, CmdOption)\r
            \r
            #\r
            # Call Gensection Add Section Header\r
            #\r
            if self.ProcessRequired in ("TRUE", "1"):\r
                if 'PROCESSING_REQUIRED' not in Attribute:\r
                    Attribute.append('PROCESSING_REQUIRED')\r
  \r
            if self.AuthStatusValid in ("TRUE", "1"):\r
                Attribute.append('AUTH_STATUS_VALID')\r
            GenFdsGlobalVariable.GenerateSection(OutputFile, [TempFile], Section.Section.SectionType['GUIDED'],\r
                                                 Guid=self.NameGuid, GuidAttr=Attribute, GuidHdrLen=HeaderLength)\r
            OutputFileList = []\r
            OutputFileList.append(OutputFile)\r
            if 'PROCESSING_REQUIRED' in Attribute:\r
                # reset guided section alignment to none for the processed required guided data\r
                self.Alignment = None\r
                self.IncludeFvSection = False\r
                self.ProcessRequired = "TRUE"\r
            return OutputFileList, self.Alignment\r
\r
    ## __FindExtendTool()\r
    #\r
    #    Find location of tools to process section data\r
    #\r
    #   @param  self        The object pointer\r
    #\r
    def __FindExtendTool__(self):\r
        # if user not specify filter, try to deduce it from global data.\r
        if self.KeyStringList == None or self.KeyStringList == []:\r
            Target = GenFdsGlobalVariable.TargetName\r
            ToolChain = GenFdsGlobalVariable.ToolChainTag\r
            ToolDb = ToolDefClassObject.ToolDefDict(GenFdsGlobalVariable.ConfDir).ToolsDefTxtDatabase\r
            if ToolChain not in ToolDb['TOOL_CHAIN_TAG']:\r
                EdkLogger.error("GenFds", GENFDS_ERROR, "Can not find external tool because tool tag %s is not defined in tools_def.txt!" % ToolChain)\r
            self.KeyStringList = [Target+'_'+ToolChain+'_'+self.CurrentArchList[0]]\r
            for Arch in self.CurrentArchList:\r
                if Target + '_' + ToolChain + '_' + Arch not in self.KeyStringList:\r
                    self.KeyStringList.append(Target + '_' + ToolChain + '_' + Arch)\r
\r
        ToolDefinition = ToolDefClassObject.ToolDefDict(GenFdsGlobalVariable.ConfDir).ToolsDefTxtDictionary\r
        ToolPathTmp = None\r
        ToolOption = None\r
        for ToolDef in ToolDefinition.items():\r
            if self.NameGuid == ToolDef[1]:\r
                KeyList = ToolDef[0].split('_')\r
                Key = KeyList[0] + \\r
                      '_'        + \\r
                      KeyList[1] + \\r
                      '_'        + \\r
                      KeyList[2]\r
                if Key in self.KeyStringList and KeyList[4] == 'GUID':\r
\r
                    ToolPath = ToolDefinition.get( Key        + \\r
                                                   '_'        + \\r
                                                   KeyList[3] + \\r
                                                   '_'        + \\r
                                                   'PATH')\r
\r
                    ToolOption = ToolDefinition.get( Key        + \\r
                                                    '_'        + \\r
                                                    KeyList[3] + \\r
                                                    '_'        + \\r
                                                    'FLAGS')\r
                    if ToolPathTmp == None:\r
                        ToolPathTmp = ToolPath\r
                    else:\r
                        if ToolPathTmp != ToolPath:\r
                            EdkLogger.error("GenFds", GENFDS_ERROR, "Don't know which tool to use, %s or %s ?" % (ToolPathTmp, ToolPath))\r
                            \r
                    \r
        return ToolPathTmp, ToolOption\r
\r
\r
\r
Commit	Line	Data
30fdf114 LG	1	## @file\r
	2	# process GUIDed section generation\r
	3	#\r
1be2ed90	4	# Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>\r
30fdf114	5	#\r
40d841f6	6	# This program and the accompanying materials\r
30fdf114 LG	7	# are licensed and made available under the terms and conditions of the BSD License\r
	8	# which accompanies this distribution. The full text of the license may be found at\r
	9	# http://opensource.org/licenses/bsd-license.php\r
	10	#\r
	11	# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	12	# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	13	#\r
	14	\r
	15	##\r
	16	# Import Modules\r
	17	#\r
	18	import Section\r
	19	import subprocess\r
	20	from Ffs import Ffs\r
1be2ed90	21	import Common.LongFilePathOs as os\r
30fdf114 LG	22	from GenFdsGlobalVariable import GenFdsGlobalVariable\r
	23	from CommonDataClass.FdfClass import GuidSectionClassObject\r
	24	from Common import ToolDefClassObject\r
	25	import sys\r
	26	from Common import EdkLogger\r
	27	from Common.BuildToolError import *\r
52302d4d	28	from FvImageSection import FvImageSection\r
1be2ed90	29	from Common.LongFilePathSupport import OpenLongFilePath as open\r
30fdf114 LG	30	\r
	31	## generate GUIDed section\r
	32	#\r
	33	#\r
	34	class GuidSection(GuidSectionClassObject) :\r
	35	\r
	36	## The constructor\r
	37	#\r
	38	# @param self The object pointer\r
	39	#\r
	40	def __init__(self):\r
	41	GuidSectionClassObject.__init__(self)\r
	42	\r
	43	## GenSection() method\r
	44	#\r
	45	# Generate GUIDed section\r
	46	#\r
	47	# @param self The object pointer\r
	48	# @param OutputPath Where to place output file\r
	49	# @param ModuleName Which module this section belongs to\r
	50	# @param SecNum Index of section\r
	51	# @param KeyStringList Filter for inputs of section generation\r
	52	# @param FfsInf FfsInfStatement object that contains this section data\r
	53	# @param Dict dictionary contains macro and its value\r
	54	# @retval tuple (Generated file name, section alignment)\r
	55	#\r
	56	def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = None, Dict = {}):\r
	57	#\r
	58	# Generate all section\r
	59	#\r
	60	self.KeyStringList = KeyStringList\r
	61	self.CurrentArchList = GenFdsGlobalVariable.ArchList\r
	62	if FfsInf != None:\r
	63	self.Alignment = FfsInf.__ExtendMacro__(self.Alignment)\r
	64	self.NameGuid = FfsInf.__ExtendMacro__(self.NameGuid)\r
	65	self.SectionType = FfsInf.__ExtendMacro__(self.SectionType)\r
	66	self.CurrentArchList = [FfsInf.CurrentArch]\r
	67	\r
52302d4d LG	68	SectFile = tuple()\r
52302d4d LG	69	SectAlign = []\r
30fdf114	70	Index = 0\r
52302d4d LG	71	MaxAlign = None\r
	72	if self.FvAddr != []:\r
	73	FvAddrIsSet = True\r
	74	else:\r
	75	FvAddrIsSet = False\r
	76	\r
	77	if self.ProcessRequired in ("TRUE", "1"):\r
	78	if self.FvAddr != []:\r
	79	#no use FvAddr when the image is processed.\r
	80	self.FvAddr = []\r
	81	if self.FvParentAddr != None:\r
	82	#no use Parent Addr when the image is processed.\r
	83	self.FvParentAddr = None\r
	84	\r
30fdf114 LG	85	for Sect in self.SectionList:\r
	86	Index = Index + 1\r
	87	SecIndex = '%s.%d' %(SecNum,Index)\r
52302d4d LG	88	# set base address for inside FvImage\r
	89	if isinstance(Sect, FvImageSection):\r
	90	if self.FvAddr != []:\r
	91	Sect.FvAddr = self.FvAddr.pop(0)\r
	92	self.IncludeFvSection = True\r
	93	elif isinstance(Sect, GuidSection):\r
	94	Sect.FvAddr = self.FvAddr\r
	95	Sect.FvParentAddr = self.FvParentAddr\r
30fdf114	96	ReturnSectList, align = Sect.GenSection(OutputPath, ModuleName, SecIndex, KeyStringList,FfsInf, Dict)\r
52302d4d LG	97	if isinstance(Sect, GuidSection):\r
	98	if Sect.IncludeFvSection:\r
	99	self.IncludeFvSection = Sect.IncludeFvSection\r
	100	\r
	101	if align != None:\r
	102	if MaxAlign == None:\r
	103	MaxAlign = align\r
	104	if GenFdsGlobalVariable.GetAlignment (align) > GenFdsGlobalVariable.GetAlignment (MaxAlign):\r
	105	MaxAlign = align\r
30fdf114	106	if ReturnSectList != []:\r
52302d4d LG	107	if align == None:\r
52302d4d LG	108	align = "1"\r
30fdf114 LG	109	for file in ReturnSectList:\r
30fdf114 LG	110	SectFile += (file,)\r
52302d4d	111	SectAlign.append(align)\r
30fdf114	112	\r
52302d4d LG	113	if MaxAlign != None:\r
	114	if self.Alignment == None:\r
	115	self.Alignment = MaxAlign\r
	116	else:\r
	117	if GenFdsGlobalVariable.GetAlignment (MaxAlign) > GenFdsGlobalVariable.GetAlignment (self.Alignment):\r
	118	self.Alignment = MaxAlign\r
30fdf114 LG	119	\r
	120	OutputFile = OutputPath + \\r
	121	os.sep + \\r
	122	ModuleName + \\r
	123	'SEC' + \\r
	124	SecNum + \\r
	125	Ffs.SectionSuffix['GUIDED']\r
	126	OutputFile = os.path.normpath(OutputFile)\r
	127	\r
	128	ExternalTool = None\r
52302d4d	129	ExternalOption = None\r
30fdf114	130	if self.NameGuid != None:\r
52302d4d LG	131	ExternalTool, ExternalOption = self.__FindExtendTool__()\r
52302d4d LG	132	\r
30fdf114 LG	133	#\r
	134	# If not have GUID , call default\r
	135	# GENCRC32 section\r
	136	#\r
	137	if self.NameGuid == None :\r
	138	GenFdsGlobalVariable.VerboseLogger( "Use GenSection function Generate CRC32 Section")\r
52302d4d	139	GenFdsGlobalVariable.GenerateSection(OutputFile, SectFile, Section.Section.SectionType[self.SectionType], InputAlign=SectAlign)\r
30fdf114 LG	140	OutputFileList = []\r
	141	OutputFileList.append(OutputFile)\r
	142	return OutputFileList, self.Alignment\r
	143	#or GUID not in External Tool List\r
	144	elif ExternalTool == None:\r
	145	EdkLogger.error("GenFds", GENFDS_ERROR, "No tool found with GUID %s" % self.NameGuid)\r
	146	else:\r
52302d4d	147	DummyFile = OutputFile+".dummy"\r
30fdf114 LG	148	#\r
	149	# Call GenSection with DUMMY section type.\r
	150	#\r
52302d4d	151	GenFdsGlobalVariable.GenerateSection(DummyFile, SectFile, InputAlign=SectAlign)\r
30fdf114 LG	152	#\r
	153	# Use external tool process the Output\r
	154	#\r
30fdf114 LG	155	TempFile = OutputPath + \\r
	156	os.sep + \\r
	157	ModuleName + \\r
	158	'SEC' + \\r
	159	SecNum + \\r
	160	'.tmp'\r
	161	TempFile = os.path.normpath(TempFile)\r
edafa0bb YL	162	#\r
	163	# Remove temp file if its time stamp is older than dummy file\r
	164	# Just in case the external tool fails at this time but succeeded before\r
	165	# Error should be reported if the external tool does not generate a new output based on new input\r
	166	#\r
	167	if os.path.exists(TempFile) and os.path.exists(DummyFile) and os.path.getmtime(TempFile) < os.path.getmtime(DummyFile):\r
	168	os.remove(TempFile)\r
30fdf114	169	\r
52302d4d LG	170	FirstCall = False\r
	171	CmdOption = '-e'\r
	172	if ExternalOption != None:\r
	173	CmdOption = CmdOption + ' ' + ExternalOption\r
	174	if self.ProcessRequired not in ("TRUE", "1") and self.IncludeFvSection and not FvAddrIsSet and self.FvParentAddr != None:\r
	175	#FirstCall is only set for the encapsulated flash FV image without process required attribute.\r
	176	FirstCall = True\r
30fdf114 LG	177	#\r
	178	# Call external tool\r
	179	#\r
52302d4d LG	180	ReturnValue = [1]\r
	181	if FirstCall:\r
	182	#first try to call the guided tool with -z option and CmdOption for the no process required guided tool.\r
	183	GenFdsGlobalVariable.GuidTool(TempFile, [DummyFile], ExternalTool, '-z' + ' ' + CmdOption, ReturnValue)\r
30fdf114 LG	184	\r
30fdf114 LG	185	#\r
52302d4d LG	186	# when no call or first call failed, ReturnValue are not 1.\r
52302d4d LG	187	# Call the guided tool with CmdOption\r
30fdf114	188	#\r
52302d4d LG	189	if ReturnValue[0] != 0:\r
	190	FirstCall = False\r
	191	ReturnValue[0] = 0\r
	192	GenFdsGlobalVariable.GuidTool(TempFile, [DummyFile], ExternalTool, CmdOption)\r
edafa0bb YL	193	#\r
	194	# There is external tool which does not follow standard rule which return nonzero if tool fails\r
	195	# The output file has to be checked\r
	196	#\r
	197	if not os.path.exists(TempFile):\r
	198	EdkLogger.error("GenFds", COMMAND_FAILURE, 'Fail to call %s, no output file was generated' % ExternalTool)\r
52302d4d LG	199	\r
	200	FileHandleIn = open(DummyFile,'rb')\r
	201	FileHandleIn.seek(0,2)\r
	202	InputFileSize = FileHandleIn.tell()\r
	203	\r
	204	FileHandleOut = open(TempFile,'rb')\r
	205	FileHandleOut.seek(0,2)\r
	206	TempFileSize = FileHandleOut.tell()\r
	207	\r
	208	Attribute = []\r
	209	HeaderLength = None\r
25918452 LG	210	if self.ExtraHeaderSize != -1:\r
	211	HeaderLength = str(self.ExtraHeaderSize)\r
	212	\r
	213	if self.ProcessRequired == "NONE" and HeaderLength == None:\r
97fa0ee9	214	if TempFileSize > InputFileSize:\r
14c48571	215	FileHandleIn.seek(0)\r
	216	BufferIn = FileHandleIn.read()\r
	217	FileHandleOut.seek(0)\r
	218	BufferOut = FileHandleOut.read()\r
	219	if BufferIn == BufferOut[TempFileSize - InputFileSize:]:\r
	220	HeaderLength = str(TempFileSize - InputFileSize)\r
	221	#auto sec guided attribute with process required\r
	222	if HeaderLength == None:\r
	223	Attribute.append('PROCESSING_REQUIRED')\r
52302d4d LG	224	\r
	225	FileHandleIn.close()\r
	226	FileHandleOut.close()\r
	227	\r
	228	if FirstCall and 'PROCESSING_REQUIRED' in Attribute:\r
	229	# Guided data by -z option on first call is the process required data. Call the guided tool with the real option.\r
	230	GenFdsGlobalVariable.GuidTool(TempFile, [DummyFile], ExternalTool, CmdOption)\r
	231	\r
	232	#\r
	233	# Call Gensection Add Section Header\r
	234	#\r
	235	if self.ProcessRequired in ("TRUE", "1"):\r
	236	if 'PROCESSING_REQUIRED' not in Attribute:\r
	237	Attribute.append('PROCESSING_REQUIRED')\r
25918452	238	\r
52302d4d LG	239	if self.AuthStatusValid in ("TRUE", "1"):\r
52302d4d LG	240	Attribute.append('AUTH_STATUS_VALID')\r
30fdf114	241	GenFdsGlobalVariable.GenerateSection(OutputFile, [TempFile], Section.Section.SectionType['GUIDED'],\r
52302d4d	242	Guid=self.NameGuid, GuidAttr=Attribute, GuidHdrLen=HeaderLength)\r
30fdf114 LG	243	OutputFileList = []\r
30fdf114 LG	244	OutputFileList.append(OutputFile)\r
52302d4d LG	245	if 'PROCESSING_REQUIRED' in Attribute:\r
	246	# reset guided section alignment to none for the processed required guided data\r
	247	self.Alignment = None\r
	248	self.IncludeFvSection = False\r
	249	self.ProcessRequired = "TRUE"\r
30fdf114 LG	250	return OutputFileList, self.Alignment\r
	251	\r
	252	## __FindExtendTool()\r
	253	#\r
	254	# Find location of tools to process section data\r
	255	#\r
	256	# @param self The object pointer\r
	257	#\r
	258	def __FindExtendTool__(self):\r
	259	# if user not specify filter, try to deduce it from global data.\r
	260	if self.KeyStringList == None or self.KeyStringList == []:\r
	261	Target = GenFdsGlobalVariable.TargetName\r
	262	ToolChain = GenFdsGlobalVariable.ToolChainTag\r
97fa0ee9	263	ToolDb = ToolDefClassObject.ToolDefDict(GenFdsGlobalVariable.ConfDir).ToolsDefTxtDatabase\r
30fdf114 LG	264	if ToolChain not in ToolDb['TOOL_CHAIN_TAG']:\r
	265	EdkLogger.error("GenFds", GENFDS_ERROR, "Can not find external tool because tool tag %s is not defined in tools_def.txt!" % ToolChain)\r
	266	self.KeyStringList = [Target+'_'+ToolChain+'_'+self.CurrentArchList[0]]\r
	267	for Arch in self.CurrentArchList:\r
97fa0ee9 YL	268	if Target + '_' + ToolChain + '_' + Arch not in self.KeyStringList:\r
	269	self.KeyStringList.append(Target + '_' + ToolChain + '_' + Arch)\r
	270	\r
	271	ToolDefinition = ToolDefClassObject.ToolDefDict(GenFdsGlobalVariable.ConfDir).ToolsDefTxtDictionary\r
30fdf114	272	ToolPathTmp = None\r
edafa0bb	273	ToolOption = None\r
30fdf114 LG	274	for ToolDef in ToolDefinition.items():\r
	275	if self.NameGuid == ToolDef[1]:\r
	276	KeyList = ToolDef[0].split('_')\r
	277	Key = KeyList[0] + \\r
	278	'_' + \\r
	279	KeyList[1] + \\r
	280	'_' + \\r
	281	KeyList[2]\r
	282	if Key in self.KeyStringList and KeyList[4] == 'GUID':\r
	283	\r
	284	ToolPath = ToolDefinition.get( Key + \\r
	285	'_' + \\r
	286	KeyList[3] + \\r
	287	'_' + \\r
	288	'PATH')\r
52302d4d LG	289	\r
	290	ToolOption = ToolDefinition.get( Key + \\r
	291	'_' + \\r
	292	KeyList[3] + \\r
	293	'_' + \\r
	294	'FLAGS')\r
30fdf114 LG	295	if ToolPathTmp == None:\r
	296	ToolPathTmp = ToolPath\r
	297	else:\r
	298	if ToolPathTmp != ToolPath:\r
	299	EdkLogger.error("GenFds", GENFDS_ERROR, "Don't know which tool to use, %s or %s ?" % (ToolPathTmp, ToolPath))\r
	300	\r
	301	\r
52302d4d	302	return ToolPathTmp, ToolOption\r
30fdf114 LG	303	\r
	304	\r
	305	\r