From nobody Tue Apr 16 17:08:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+61740+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61740+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1593171623; cv=none; d=zohomail.com; s=zohoarc; b=AzJNoSi0PlCOjtjrYmKL6iBv0RNikLjmO/JZJLRVbZ/dRtaTNK+Lczp+9uRNT6GuL/hmyaYI4HWPXW5ilQrG4Y0iqWAk2ZLLfF5cgn+jsY1VF06qYBjey1ttqNslDNj/rx5AUz0LAcYoxdnQT7BomTKrdMmNbmtuXJPcysg3kB4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1593171623; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=qob/bA6jO0y3IpZ73nnpkJhD9+PeiQhSB2dqXtF4vQE=; b=cbUYfOeVJz4o9Zy1xzf2Hq6Ng/8PBhJk81SS+M3u+GyIjCFpv1bXlE5Y2P0uBaUGlSlXLtB8xOeVc0y72AbdYA27QI+84w+7Mu2gIQGatWaHTy3L31cLukPFudhKdxAY1srGYlmic9Y4KJZKHqVI1mNFS2gM22INOnTNHkIGD8I= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61740+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593171623372909.1278548783937; Fri, 26 Jun 2020 04:40:23 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id S4k8YY1788612xLTCQh925hE; Fri, 26 Jun 2020 04:40:22 -0700 X-Received: from cam-smtp0.cambridge.arm.com (cam-smtp0.cambridge.arm.com [217.140.106.51]) by mx.groups.io with SMTP id smtpd.web10.5807.1593171621784526385 for ; Fri, 26 Jun 2020 04:40:22 -0700 X-Received: from E119881.Arm.com (E119881.Arm.com [10.1.197.28]) by cam-smtp0.cambridge.arm.com (8.13.8/8.13.8) with ESMTP id 05QBeI74004773; Fri, 26 Jun 2020 12:40:19 +0100 From: "PierreGondois" To: devel@edk2.groups.io Cc: Pierre Gondois , sami.mujawar@arm.com, tomas.pilar@arm.com, bob.c.feng@intel.com, liming.gao@intel.com, nd@arm.com Subject: [edk2-devel] [PATCH v4 1/4] BaseTools: Generate multiple rules when multiple output files Date: Fri, 26 Jun 2020 12:40:10 +0100 Message-Id: <20200626114013.125524-2-pierre.gondois@arm.com> In-Reply-To: <20200626114013.125524-1-pierre.gondois@arm.com> References: <20200626114013.125524-1-pierre.gondois@arm.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,pierre.gondois@arm.com X-Gm-Message-State: nDlp6e9tf1SBPUV81bW4YG01x1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593171622; bh=PWzPffQfqDmGE1GTZVqbnGOvxvGEApp3CBwNfdSkOpo=; h=Cc:Date:From:Reply-To:Subject:To; b=KNcFwprjDZSjDF8y1lQEqv4wPJkxzqXuW7WcTDwoxxFVINeV+Rf+Xjl7Arnl2BTzFYQ m7cDcekSIGABGiw+n/P8duTgRXxC5w/fpYUB1BDl2OC6tjOQtVJCGrjBHGHUjrTZB+4UU JriIIJfh1XcAhnGtXSYtiBpnOmV6j+6Zct0= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: Pierre Gondois This patch modifies the Makefile generation not to stop adding Makfile rules when the first final target is found. E.g.: If the following rules are described in build_rule.txt: -[Rule1]: .X files generate .Y and .Z files; -[Rule2]: .Z files generate .Z1 files. Currently, if a File1.X file was part of the sources of a module, only [Rule1] would be generated in the Makefile. Indeed, there are no rules to apply to .Y files: .Y files are a final target. However, there is still [Rule2] to apply to .Z files. This patch also adds a dependency between the first ouput file of a rule and the other output files. For instance, with the same example as above, File1.Y and File1.Z are generated by the following rule: File1.Y: File1.X and the new dependency is: File1.Z: File1.Y This is necessary to keep a dependency order during the execution of the Makefile. Indeed, .Y and .Z files are generated by the execution of a common set of commands, and without this rule, there is no explicit dependency relation between them. Signed-off-by: Pierre Gondois Suggested-by: Tomas Pilar --- The changes can be seen at https://github.com/PierreARM/edk2/commits/803_Co= mpile_AML_bytecode_array_into_OBJ_file_v4 Notes: Notes: v1: - Generate multiple rules when multiple output files are specified in the build_rule.txt file. [Pierre] v2: - Use the "FileType" variable in the _ApplyBuildRule function as it is in the current state. [Pierre] v3: - Adding Suggested-by [Pierre] v4: - No modification. Re-sending the patch with base64 encoding to conserve the right line endings. [Bob] BaseTools/Source/Python/AutoGen/GenMake.py | 6 ++++ BaseTools/Source/Python/AutoGen/ModuleAutoGen.py | 38 +++++++++++--------- 2 files changed, 27 insertions(+), 17 deletions(-) diff --git a/BaseTools/Source/Python/AutoGen/GenMake.py b/BaseTools/Source/= Python/AutoGen/GenMake.py index bbb3c29446f53fa7f2cb61a216a5b119f72c3fbc..0314d0ea34d99a014379e8d30c4= 6ac0f0a7068ce 100755 --- a/BaseTools/Source/Python/AutoGen/GenMake.py +++ b/BaseTools/Source/Python/AutoGen/GenMake.py @@ -1054,6 +1054,12 @@ cleanlib: TargetDict =3D {"target": self.PlaceMacro(T.Target.Pat= h, self.Macros), "cmd": "\n\t".join(T.Commands),"deps": Deps} self.BuildTargetList.append(self._BUILD_TARGET_TEMPLAT= E.Replace(TargetDict)) =20 + # Add a Makefile rule for targets generating multiple = files. + # The main output is a prerequisite for the other outp= ut files. + for i in T.Outputs[1:]: + AnnexeTargetDict =3D {"target": self.PlaceMacro(i.= Path, self.Macros), "cmd": "", "deps": self.PlaceMacro(T.Target.Path, self.= Macros)} + self.BuildTargetList.append(self._BUILD_TARGET_TEM= PLATE.Replace(AnnexeTargetDict)) + def ParserCCodeFile(self, T, Type, CmdSumDict, CmdTargetDict, CmdCppDi= ct, DependencyDict): if not CmdSumDict: for item in self._AutoGenObject.Targets[Type]: diff --git a/BaseTools/Source/Python/AutoGen/ModuleAutoGen.py b/BaseTools/S= ource/Python/AutoGen/ModuleAutoGen.py index aad591de65f086043d55aeea5661f59c53792e7c..dc8b1fe3d160cac2da22227fc23= 3e3aa0d92cb1e 100755 --- a/BaseTools/Source/Python/AutoGen/ModuleAutoGen.py +++ b/BaseTools/Source/Python/AutoGen/ModuleAutoGen.py @@ -860,7 +860,8 @@ class ModuleAutoGen(AutoGen): SubDirectory =3D os.path.join(self.OutputDir, File.SubDir) if not os.path.exists(SubDirectory): CreateDirectory(SubDirectory) - LastTarget =3D None + TargetList =3D set() + FinalTargetName =3D set() RuleChain =3D set() SourceList =3D [File] Index =3D 0 @@ -870,6 +871,9 @@ class ModuleAutoGen(AutoGen): self.BuildOption =20 while Index < len(SourceList): + # Reset the FileType if not the first iteration. + if Index > 0: + FileType =3D TAB_UNKNOWN_FILE Source =3D SourceList[Index] Index =3D Index + 1 =20 @@ -886,29 +890,25 @@ class ModuleAutoGen(AutoGen): elif Source.Ext in self.BuildRules: RuleObject =3D self.BuildRules[Source.Ext] else: - # stop at no more rules - if LastTarget: - self._FinalBuildTargetList.add(LastTarget) - break + # No more rule to apply: Source is a final target. + FinalTargetName.add(Source) + continue =20 FileType =3D RuleObject.SourceFileType self._FileTypes[FileType].add(Source) =20 # stop at STATIC_LIBRARY for library if self.IsLibrary and FileType =3D=3D TAB_STATIC_LIBRARY: - if LastTarget: - self._FinalBuildTargetList.add(LastTarget) - break + FinalTargetName.add(Source) + continue =20 Target =3D RuleObject.Apply(Source, self.BuildRuleOrder) if not Target: - if LastTarget: - self._FinalBuildTargetList.add(LastTarget) - break - elif not Target.Outputs: - # Only do build for target with outputs - self._FinalBuildTargetList.add(Target) + # No Target: Source is a final target. + FinalTargetName.add(Source) + continue =20 + TargetList.add(Target) self._BuildTargets[FileType].add(Target) =20 if not Source.IsBinary and Source =3D=3D File: @@ -916,12 +916,16 @@ class ModuleAutoGen(AutoGen): =20 # to avoid cyclic rule if FileType in RuleChain: - break + EdkLogger.error("build", ERROR_STATEMENT, "Cyclic dependen= cy detected while generating rule for %s" % str(Source)) =20 RuleChain.add(FileType) SourceList.extend(Target.Outputs) - LastTarget =3D Target - FileType =3D TAB_UNKNOWN_FILE + + # For each final target name, retrieve the corresponding TargetDes= cBlock instance. + for FTargetName in FinalTargetName: + for Target in TargetList: + if FTargetName =3D=3D Target.Target: + self._FinalBuildTargetList.add(Target) =20 @cached_property def Targets(self): --=20 'Guid(CE165669-3EF3-493F-B85D-6190EE5B9759)' From nobody Tue Apr 16 17:08:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+61738+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61738+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1593171623; cv=none; d=zohomail.com; s=zohoarc; b=TtCKovUaLfQ+OFgVaA+aO5ZzKxv6frCZiOIFSsqsetm1jPMBdu9vsP7XTtSpWbual44HMpFU43UZBZqxe+xIMMTMGy5OpemTwfD4Yzkd/i9KBKr93s1lK1uDOgS1FU2RB54tydm63OxGwLp5APltj+1BphL+aQsN0xYC+lV1h4I= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1593171623; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=uw6196z6ObRL0OSGQFbhaZySMOTtr7bZusyvtKoBkbY=; b=gFH2N1U7wi/SYJz38+8MVlBjnQE+YZhIkwYs4JFglBBC+JiSDS36B6ZnW0sg4VU9CEym5yiu7UBhpK3FnnwvALlmTzCyUtJIZV9vd6mO2331BvCLVXyGmWV6QgOUmcM2JvYJAsscTrOzImGeiirXVYCYcU11WaN5BVCvJ7/EXYw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61738+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593171623286723.5889669764476; Fri, 26 Jun 2020 04:40:23 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id g1RQYY1788612xQrmY1FqQAZ; Fri, 26 Jun 2020 04:40:22 -0700 X-Received: from cam-smtp0.cambridge.arm.com (cam-smtp0.cambridge.arm.com [217.140.106.51]) by mx.groups.io with SMTP id smtpd.web12.5994.1593171621558744517 for ; Fri, 26 Jun 2020 04:40:22 -0700 X-Received: from E119881.Arm.com (E119881.Arm.com [10.1.197.28]) by cam-smtp0.cambridge.arm.com (8.13.8/8.13.8) with ESMTP id 05QBeI75004773; Fri, 26 Jun 2020 12:40:19 +0100 From: "PierreGondois" To: devel@edk2.groups.io Cc: Pierre Gondois , sami.mujawar@arm.com, tomas.pilar@arm.com, bob.c.feng@intel.com, liming.gao@intel.com, nd@arm.com Subject: [edk2-devel] [PATCH v4 2/4] BaseTools: Rename AmlToHex script to AmlToC Date: Fri, 26 Jun 2020 12:40:11 +0100 Message-Id: <20200626114013.125524-3-pierre.gondois@arm.com> In-Reply-To: <20200626114013.125524-1-pierre.gondois@arm.com> References: <20200626114013.125524-1-pierre.gondois@arm.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,pierre.gondois@arm.com X-Gm-Message-State: 8MKkarS6p0gkEivxNvNZwP7Bx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593171622; bh=JOLPwYp9+dywvYhFhbGBp39LlcdBk6Ic5VLOiJ++wq8=; h=Cc:Date:From:Reply-To:Subject:To; b=APzcgFSP4my5Qlks01ErnEzNLUV7dn7wqzZKluEEiSedltiUs46PPIcGEC+VjA+VmQK hOarURCdfLqOr8b+aA0EX4eprVsrj2gykkgK1DfEi+Lne52qp/RwuBS42rCvuWjZKxb5r 1YndHt8oe3tGcwdPEgLCYjsoh7X73anGb2A= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: Pierre Gondois The AmlToHex script and Posix/WindowsLike wrappers convert an AML file to a .hex file, containing a C array storing AML bytecode. This ".hex" file can then be included in a C file, allowing to access the AML bytecode from this C file. The EDK2 build system doesn't allow to a depict dependency orders between files of different languages. For instance, in a module containing a ".c" file and a ".asl", the ".c" file may or may not be built prior to the ".asl" file. This prevents any inclusion of a generated ".hex" in a ".c" file since this later ".hex" file may or may not have been created yet. This patch renames the script as AmlToC. It is posted as a separate patch to prevent git from seeing the renaming as a deletion plus addition of a new file. The ending line of the posix-like bin-wrapper script has also been corrected. This is a first step toward generating a C file containing the AML bytecode from an ASL file. This C file will then be handled by the EDK2 build system to generate an object file. Thus, no file inclusion will be required anymore. The C file requiring the AML bytecode as a C array, and the ASL file, will be compiled independently. The C array must be defined as an external symbol. The linker is resolving the reference to the C array symbol. To summarize, the flow goes as: -1. ASL file is compiled to AML; -2. AML file is copied to a ".amli" intermediate file; -3. EDK2 build system applies the rule relevant to ".amli" files. This is, calling the "AmlToC" script, generating a C file from the ".amli" file; -4. EDK2 build system applies the rule relevant to C files. This is creating an object file. -5. EDK2 build system links the object file containing the AML bytecode with the object file requiring it. Signed-off-by: Pierre Gondois Suggested-by: Tomas Pilar --- The changes can be seen at https://github.com/PierreARM/edk2/commits/803_Co= mpile_AML_bytecode_array_into_OBJ_file_v4 Notes: Notes: v1: - Rename AmlToHex scripts to AmlToC, and change line endings of the PosixLike bin-wrapper. [Pierre] v2: - No modification. [Pierre] v3: - Changed "Signed-off-by" to "Suggested-by". [Bob] v4: - No modification. Re-sending the patch with base64 encoding to conserve the right line endings. [Bob] BaseTools/BinWrappers/PosixLike/{AmlToHex =3D> AmlToC} | 28 = ++++++++++---------- BaseTools/BinWrappers/WindowsLike/{AmlToHex.bat =3D> AmlToC.bat} | 0 BaseTools/Source/Python/{AmlToHex/AmlToHex.py =3D> AmlToC/AmlToC.py} | 0 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/BaseTools/BinWrappers/PosixLike/AmlToHex b/BaseTools/BinWrappe= rs/PosixLike/AmlToC similarity index 97% rename from BaseTools/BinWrappers/PosixLike/AmlToHex rename to BaseTools/BinWrappers/PosixLike/AmlToC index 9fb68299e4c67d1f332cd883fd348a896f1bdc50..1dd28e966288f6ea4fc52d42e2d= c7b1f74226c23 100755 --- a/BaseTools/BinWrappers/PosixLike/AmlToHex +++ b/BaseTools/BinWrappers/PosixLike/AmlToC @@ -1,14 +1,14 @@ -#!/usr/bin/env bash -#python `dirname $0`/RunToolFromSource.py `basename $0` $* - -# If a ${PYTHON_COMMAND} command is available, use it in preference to pyt= hon -if command -v ${PYTHON_COMMAND} >/dev/null 2>&1; then - python_exe=3D${PYTHON_COMMAND} -fi - -full_cmd=3D${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028= for a discussion of why $0 is not a good choice here -dir=3D$(dirname "$full_cmd") -exe=3D$(basename "$full_cmd") - -export PYTHONPATH=3D"$dir/../../Source/Python${PYTHONPATH:+:"$PYTHONPATH"}" -exec "${python_exe:-python}" "$dir/../../Source/Python/$exe/$exe.py" "$@" +#!/usr/bin/env bash +#python `dirname $0`/RunToolFromSource.py `basename $0` $* + +# If a ${PYTHON_COMMAND} command is available, use it in preference to pyt= hon +if command -v ${PYTHON_COMMAND} >/dev/null 2>&1; then + python_exe=3D${PYTHON_COMMAND} +fi + +full_cmd=3D${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028= for a discussion of why $0 is not a good choice here +dir=3D$(dirname "$full_cmd") +exe=3D$(basename "$full_cmd") + +export PYTHONPATH=3D"$dir/../../Source/Python${PYTHONPATH:+:"$PYTHONPATH"}" +exec "${python_exe:-python}" "$dir/../../Source/Python/$exe/$exe.py" "$@" diff --git a/BaseTools/BinWrappers/WindowsLike/AmlToHex.bat b/BaseTools/Bin= Wrappers/WindowsLike/AmlToC.bat similarity index 100% rename from BaseTools/BinWrappers/WindowsLike/AmlToHex.bat rename to BaseTools/BinWrappers/WindowsLike/AmlToC.bat diff --git a/BaseTools/Source/Python/AmlToHex/AmlToHex.py b/BaseTools/Sourc= e/Python/AmlToC/AmlToC.py similarity index 100% rename from BaseTools/Source/Python/AmlToHex/AmlToHex.py rename to BaseTools/Source/Python/AmlToC/AmlToC.py --=20 'Guid(CE165669-3EF3-493F-B85D-6190EE5B9759)' =1A=EF=BF=BD.=EF=BF=BD=C8=A8.)=E4=B1=8A.=EF=BF=BD=EF=BF=BD=1E=EF=BF=BD=EF= =BF=BD=EF=BF=BD=EF=BF=BDY=EF=BF=BD=EF=BF=BD=C6=A0z=EF=BF=BD=1E=EF=BF=BD=EF= =BF=BDh=EF=BF=BD=18=EF=BF=BD=EF=BF=BD=EF=BF=BD.=EF=BF=BDX=EF=BF=BD=EF=BF=BD= =EF=BF=BD^=EF=BF=BD\=EF=BF=BD=EF=BF=BDX=EF=BF=BD{=EF=BF=BD{=EF=BF=BD=EF=BF= =BDm=EF=BF=BD=EF=BF=BD?=EF=BF=BD=EF=BF=BDd=EF=BF=BD =E8=BA=9B"=EF=BF=BD=EF=BF=BD?u=EF=BF=BD=DE=97=EF=BF=BD=EF=BF=BD=EF=BF=BD=C6= =A0{=EF=BF=BD=EF=BF=BD=EF=BF=BD=7F=0C=EF=BF=BD=D7=93=EF=BF=BD+=13=EF=BF=BD= =EF=BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BDi=EF=BF=BD=EF=BF=BD=E0=AE=8B=EF=BF=BD= =EF=BF=BD*?=EF=BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BD]=EF=BF=BD=DF=BE=EF=BF=BD=D7= =BF;=DB=BE=C6=AE=EF=BF=BD=EF=BF=BD; =DE=AD=D7=AFz_=EF=BF=BD=EF=BF=BDw=EF=BF= =BDy=EF=BF=BD6=EF=BF=BD=EF=BF=BD.=EF=BF=BD=C8=A8R{.n=EF=BF=BD+=EF=BF=BD=EF= =BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BDl=EF=BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BDh+=EF= =BF=BD=EF=BF=BDl=EF=BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BD=D7=AFz_=EF=BF=BD=CB=9B= =EF=BF=BDjh=EF=BF=BD=D7=AB=EF=BF=BD=EF=BF=BD\=EF=BF=BD=EF=BF=BD(=EF=BF=BD From nobody Tue Apr 16 17:08:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+61742+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61742+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1593171625; cv=none; d=zohomail.com; s=zohoarc; b=fYmKGKc10ZTQzHsIobXmP5zADnfbOBHtMu45D10v+Tku69oCEZMEme5GZOTyggjW2LOcl+IWLgyPEyErqKB8lFc5K1hW+KTITtOwMApRspaI8iaK+ajKLzzMpGddOPBQ2bCqemQgfDBcMu0AffpL0fzTzypptihiJQG6djQDtk4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1593171625; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=XUxmMe7rJTb5vyxI82lQlNhPf8pBiacW/YSL7ePCZSI=; b=nCFNLBxXU+ZBpwttpcAortUvkt4f0qTgeJJGsX8dwZfWnIIYUd8YSP51FIF3Zaf+R5LHVvuz3z/qmHzpgYCdEGlw4z4fTi56xq6AC88yglScjF3zhE5RgWjwV0pw1rjAGEG9/VF2giQDiCfhIcUdnlYZYH+NFEvroK8q/ka6z7Q= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61742+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1593171625679948.7929950852737; Fri, 26 Jun 2020 04:40:25 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id h2X0YY1788612xQwGRH1ZK72; Fri, 26 Jun 2020 04:40:25 -0700 X-Received: from cam-smtp0.cambridge.arm.com (cam-smtp0.cambridge.arm.com [217.140.106.51]) by mx.groups.io with SMTP id smtpd.web11.5756.1593171621988986936 for ; Fri, 26 Jun 2020 04:40:22 -0700 X-Received: from E119881.Arm.com (E119881.Arm.com [10.1.197.28]) by cam-smtp0.cambridge.arm.com (8.13.8/8.13.8) with ESMTP id 05QBeI76004773; Fri, 26 Jun 2020 12:40:19 +0100 From: "PierreGondois" To: devel@edk2.groups.io Cc: Pierre Gondois , sami.mujawar@arm.com, tomas.pilar@arm.com, bob.c.feng@intel.com, liming.gao@intel.com, nd@arm.com Subject: [edk2-devel] [PATCH v4 3/4] BaseTools: Compile AML bytecode arrays into .obj file Date: Fri, 26 Jun 2020 12:40:12 +0100 Message-Id: <20200626114013.125524-4-pierre.gondois@arm.com> In-Reply-To: <20200626114013.125524-1-pierre.gondois@arm.com> References: <20200626114013.125524-1-pierre.gondois@arm.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,pierre.gondois@arm.com X-Gm-Message-State: DA4PtfGeoIPPFAkRGl04kJK8x1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593171625; bh=+2MV32skZsRbV7gOMbkazp8AICUNIdCXYd9K3slI2AE=; h=Cc:Date:From:Reply-To:Subject:To; b=bQ6VHzXgAXV1uejrGQKQ0EkIxWQ3KNvFd5NUllzKj/7KKTz1lfXtG/1SEy4Lbr0whFD ZeMnwRTUbagQ02Rg43WfLktFHTyC2TjeIGpX6HTZ8GsaQvAwNxUOPuXd4SamfKcsX+GZ5 XmB22CNZ/HJ1vm3kMZ1uG//SL9HWt54Xp00= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: Pierre Gondois The AmlToHex script and Posix/WindowsLike wrappers convert an AML file to a .hex file, containing a C array storing AML bytecode. This ".hex" file can then be included in a C file, allowing to access the AML bytecode from this C file. The EDK2 build system doesn't allow to a depict dependency orders between files of different languages. For instance, in a module containing a ".c" file and a ".asl", the ".c" file may or may not be built prior to the ".asl" file. This prevents any inclusion of a generated ".hex" in a ".c" file since this later ".hex" file may or may not have been created yet. This patch modifies the AmlToC script to generate a C file instead of a ".hex" file. It also adds the generation of an intermediate ".amli" file when compiling an ASL file, and adds a rule to convert this ".amli" to a C file. This allows to generate a C file containing the AML bytecode from an ASL file. This C file will then be handled by the EDK2 build system to generate an object file. Thus, no file inclusion will be required anymore. The C file requiring the AML bytecode as a C array, and the ASL file, will be compiled independently. The C array must be defined as an external symbol. The linker is resolving the reference to the C array symbol. To summarize, the flow goes as: -1. ASL file is compiled to AML; -2. AML file is copied to a ".amli" intermediate file; -3. EDK2 build system applies the rule relevant to ".amli" files. This is, calling the "AmlToC" script, generating a C file from the ".amli" file; -4. EDK2 build system applies the rule relevant to C files. This is creating an object file. -5. EDK2 build system links the object file containing the AML bytecode with the object file requiring it. Signed-off-by: Pierre Gondois Suggested-by: Tomas Pilar --- The changes can be seen at https://github.com/PierreARM/edk2/commits/803_Co= mpile_AML_bytecode_array_into_OBJ_file_v4 Notes: Notes: v1: - Add a new rule to the build_rule.template file to generate ".obj" files from .asl files, and modify the AmlToC script accordingly. [Pierre] v2: - Restrict the rule to DXE_DRIVER. This allows to build the OvmfPkg, which was not the case in v1. [Pierre] v3: - Changed "Signed-off-by" to "Suggested-by". [Bob] v4: - No modification. Re-sending the patch with base64 encoding to conserve the right line endings. [Bob] BaseTools/Conf/build_rule.template | 15 +++- BaseTools/Source/Python/AmlToC/AmlToC.py | 82 ++++++++------------ 2 files changed, 47 insertions(+), 50 deletions(-) diff --git a/BaseTools/Conf/build_rule.template b/BaseTools/Conf/build_rule= .template index 0822b681fcd9f61c6508e6f93ffc31fa70fd7059..c034869915914936e28f64a6aad= ba08e0169da44 100755 --- a/BaseTools/Conf/build_rule.template +++ b/BaseTools/Conf/build_rule.template @@ -419,6 +419,7 @@ =20 $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml + $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.amli =20 $(MAKE_FILE) @@ -428,14 +429,24 @@ "$(ASLPP)" $(DEPS_FLAGS) $(ASLPP_FLAGS) $(INC) /I${s_path} $(OUTPU= T_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii Trim --source-code -l -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iiii= $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii=20 "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_di= r}(+)${s_base}.iiii - -AmlToHex $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml + $(CP) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml $(OUTPUT_DIR)(+)${s= _dir}(+)${s_base}.amli =20 Trim --asl-file --asl-deps -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}= .i -i $(INC_LIST) ${src} "$(ASLPP)" $(DEPS_FLAGS) $(ASLPP_FLAGS) $(INC) -I${s_path} $(OUTPU= T_DIR)(+)${s_dir}(+)${s_base}.i > $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii Trim --source-code -l -o $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iiii= $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.iii=20 "$(ASL)" $(ASL_FLAGS) $(ASL_OUTFLAGS)${dst} $(OUTPUT_DIR)(+)${s_di= r}(+)${s_base}.iiii - -AmlToHex $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml + $(CP) $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.aml $(OUTPUT_DIR)(+)${s= _dir}(+)${s_base}.amli + +[Acpi-Machine-Language-File-to-C.DXE_DRIVER] + + ?.amli + + + ${s_path}(+)${s_base}.c + + + -AmlToC ${src} =20 [C-Code-File.AcpiTable] diff --git a/BaseTools/Source/Python/AmlToC/AmlToC.py b/BaseTools/Source/Py= thon/AmlToC/AmlToC.py index 643db2910e37acfdd80ac18d288c921320a79ce1..346de7159de702d860bbd809ddb= e8175f1493cfb 100644 --- a/BaseTools/Source/Python/AmlToC/AmlToC.py +++ b/BaseTools/Source/Python/AmlToC/AmlToC.py @@ -1,9 +1,9 @@ ## @file # -# Convert an AML file to a .hex file containing the AML bytecode stored in= a +# Convert an AML file to a .c file containing the AML bytecode stored in a # C array. -# By default, "Tables\Dsdt.aml" will generate "Tables\Dsdt.hex". -# "Tables\Dsdt.hex" will contain a C array named "dsdt_aml_code" that cont= ains +# By default, "Tables\Dsdt.aml" will generate "Tables\Dsdt.c". +# "Tables\Dsdt.c" will contain a C array named "dsdt_aml_code" that contai= ns # the AML bytecode. # # Copyright (c) 2020, ARM Limited. All rights reserved.
@@ -17,31 +17,26 @@ from Common.BuildToolError import * import sys import os =20 +__description__ =3D """ +Convert an AML file to a .c file containing the AML bytecode stored in a C +array. By default, Tables\Dsdt.aml will generate Tables\Dsdt.c. +Tables\Dsdt.c will contain a C array named "dsdt_aml_code" that contains +the AML bytecode. +""" + ## Parse the command line arguments. # # @retval A argparse.NameSpace instance, containing parsed values. # def ParseArgs(): # Initialize the parser. - Parser =3D argparse.ArgumentParser( - description=3D"Convert an AML file to a .hex file containing the AML= " + \ - "bytecode stored in a C array. By default, " + \ - "\"Tables\\Dsdt.aml\" will generate" + \ - "\"Tables\\Dsdt.hex\". \"Tables\\Dsdt.hex\" will " + \ - "contain a C array named \"dsdt_aml_code\" that " + \ - "contains the AML bytecode." - ) + Parser =3D argparse.ArgumentParser(description=3D__description__) =20 # Define the possible arguments. - Parser.add_argument( - dest=3D"InputFile", - help=3D"Path to an input AML file to generate a .hex file from." - ) - Parser.add_argument( - "-o", "--out-dir", dest=3D"OutDir", - help=3D"Output directory where the .hex file will be generated. " + \ - "Default is the input file's directory." - ) + Parser.add_argument(dest=3D"InputFile", + help=3D"Path to an input AML file to generate a .c= file from.") + Parser.add_argument("-o", "--out-dir", dest=3D"OutDir", + help=3D"Output directory where the .c file will be= generated. Default is the input file's directory.") =20 # Parse the input arguments. Args =3D Parser.parse_args() @@ -55,9 +50,7 @@ def ParseArgs(): with open(Args.InputFile, "rb") as fIn: Signature =3D str(fIn.read(4)) if ("DSDT" not in Signature) and ("SSDT" not in Signature): - EdkLogger.info("Invalid file type. " + \ - "File does not have a valid " + \ - "DSDT or SSDT signature: %s" % Args.InputF= ile) + EdkLogger.info("Invalid file type. File does not have a va= lid DSDT or SSDT signature: {}".format(Args.InputFile)) return None =20 # Get the basename of the input file. @@ -66,42 +59,39 @@ def ParseArgs(): =20 # If no output directory is specified, output to the input directory. if not Args.OutDir: - Args.OutputFile =3D os.path.join( - os.path.dirname(Args.InputFile), - BaseName + ".hex" - ) + Args.OutputFile =3D os.path.join(os.path.dirname(Args.InputFile), + BaseName + ".c") else: if not os.path.exists(Args.OutDir): os.mkdir(Args.OutDir) - Args.OutputFile =3D os.path.join(Args.OutDir, BaseName + ".hex") + Args.OutputFile =3D os.path.join(Args.OutDir, BaseName + ".c") =20 Args.BaseName =3D BaseName =20 return Args =20 -## Convert an AML file to a .hex file containing the AML bytecode stored +## Convert an AML file to a .c file containing the AML bytecode stored # in a C array. # # @param InputFile Path to the input AML file. -# @param OutputFile Path to the output .hex file to generate. +# @param OutputFile Path to the output .c file to generate. # @param BaseName Base name of the input file. -# This is also the name of the generated .hex file. +# This is also the name of the generated .c file. # -def AmlToHex(InputFile, OutputFile, BaseName): +def AmlToC(InputFile, OutputFile, BaseName): =20 - MacroName =3D "__{}_HEX__".format(BaseName.upper()) ArrayName =3D BaseName.lower() + "_aml_code" + FileHeader =3D\ +""" +// This file has been generated from: +// -Python script: {} +// -Input AML file: {} + +""" =20 with open(InputFile, "rb") as fIn, open(OutputFile, "w") as fOut: # Write header. - fOut.write("// This file has been generated from:\n" + \ - "// \tPython script: " + \ - os.path.abspath(__file__) + "\n" + \ - "// \tInput AML file: " + \ - os.path.abspath(InputFile) + "\n\n" + \ - "#ifndef {}\n".format(MacroName) + \ - "#define {}\n\n".format(MacroName) - ) + fOut.write(FileHeader.format(os.path.abspath(InputFile), os.path.a= bspath(__file__))) =20 # Write the array and its content. fOut.write("unsigned char {}[] =3D {{\n ".format(ArrayName)) @@ -115,15 +105,12 @@ def AmlToHex(InputFile, OutputFile, BaseName): byte =3D fIn.read(1) fOut.write("\n};\n") =20 - # Write footer. - fOut.write("#endif // {}\n".format(MacroName)) - ## Main method # # This method: # 1- Initialize an EdkLogger instance. # 2- Parses the input arguments. -# 3- Converts an AML file to a .hex file containing the AML bytecode st= ored +# 3- Converts an AML file to a .c file containing the AML bytecode stor= ed # in a C array. # # @retval 0 Success. @@ -139,10 +126,9 @@ def Main(): if not CommandArguments: return 1 =20 - # Convert an AML file to a .hex file containing the AML bytecode s= tored + # Convert an AML file to a .c file containing the AML bytecode sto= red # in a C array. - AmlToHex(CommandArguments.InputFile, CommandArguments.OutputFile, - CommandArguments.BaseName) + AmlToC(CommandArguments.InputFile, CommandArguments.OutputFile, Co= mmandArguments.BaseName) except Exception as e: print(e) return 1 --=20 'Guid(CE165669-3EF3-493F-B85D-6190EE5B9759)' From nobody Tue Apr 16 17:08:51 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+61741+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61741+1787277+3901457@groups.io ARC-Seal: i=1; a=rsa-sha256; t=1593171625; cv=none; d=zohomail.com; s=zohoarc; b=KyL7Hs5sC7Tr/8Txg+xaIFRCoETF0sY0K8e9alk9xa4fpmpHp8kg1sS0k+dkZNgTB6t1piVap4s9+YTyqpn+mNyoRxRf/W7Ge0GHnq015CSj0KORUJUPNryEMEhN7B8kA5aoTn3j8/2WTbJjOqDC4GvzMkkVJ79k8wEHvALFVIY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1593171625; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=eC35UzYt6H6d6/JZg6fmoQKFV7fAOiQOt3QTFMRnLQ0=; b=PwPgtH9L8ZLdJZMm0jTfOHekm10trupzvIkBZ73GKSHfUrrO/TPL63XIECkplTI66E5zBvITbhwRqSZZmYQXiLW4drCFime5gC4OQBTtCUrUeGGXfYXJDnUZRYywLC0UqnHVTLfMDkH9/4vN6n0HvokhrRJgeFNvPNC50c+RpZ0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+61741+1787277+3901457@groups.io Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 159317162523042.96260210478238; Fri, 26 Jun 2020 04:40:25 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id vhrcYY1788612xU569E8ur9L; Fri, 26 Jun 2020 04:40:24 -0700 X-Received: from cam-smtp0.cambridge.arm.com (cam-smtp0.cambridge.arm.com [217.140.106.51]) by mx.groups.io with SMTP id smtpd.web12.5995.1593171622243940474 for ; Fri, 26 Jun 2020 04:40:22 -0700 X-Received: from E119881.Arm.com (E119881.Arm.com [10.1.197.28]) by cam-smtp0.cambridge.arm.com (8.13.8/8.13.8) with ESMTP id 05QBeI77004773; Fri, 26 Jun 2020 12:40:19 +0100 From: "PierreGondois" To: devel@edk2.groups.io Cc: Pierre Gondois , sami.mujawar@arm.com, tomas.pilar@arm.com, bob.c.feng@intel.com, liming.gao@intel.com, nd@arm.com Subject: [edk2-devel] [PATCH v4 4/4] BaseTools: Fix string concatenation Date: Fri, 26 Jun 2020 12:40:13 +0100 Message-Id: <20200626114013.125524-5-pierre.gondois@arm.com> In-Reply-To: <20200626114013.125524-1-pierre.gondois@arm.com> References: <20200626114013.125524-1-pierre.gondois@arm.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,pierre.gondois@arm.com X-Gm-Message-State: EqrKtbMiGHpnqNlj9M0zbjB9x1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1593171624; bh=W1tTbmxwoM0GIWGknXyHoOvxZcM4+XXjuM9+AvODxSU=; h=Cc:Date:From:Reply-To:Subject:To; b=bpTcISlLOTK/rED8kcqOi7uBROpTS+adi4SYtaixXW+gmU3vjcQrJSvYLuNc/tb5UMD vNsj+NDZdgAm17M9CzERB4KmMOKQAgqnfIC3RMBz22lp1/8vozlJq2Fuwmz8nIlQbOpKn ytbsbSV0ks8jo6CQHKcNuMHDDiGEItuDqLs= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" From: Pierre Gondois Using Python 3.7.2 on win32, when printing a FileBuildRule instance, the following error occurs: File "edk2\BaseTools\Source\Python\AutoGen\BuildEngine.py", line 177, in __str__ DestString =3D ", ".join(self.DestFileList) TypeError: sequence item 0: expected str instance, PathClass found This patch converts each PathClass element of the list to a string instance before concatenating them. Signed-off-by: Pierre Gondois --- The changes can be seen at https://github.com/PierreARM/edk2/commits/803_Co= mpile_AML_bytecode_array_into_OBJ_file_v4 Notes: Notes: v2: - No v1 for this patch. Fix a __str__ method. [Pierre] v3: - No modification. [Pierre] v4: - No modification. Re-sending the patch with base64 encoding to conserve the right line endings. [Bob] BaseTools/Source/Python/AutoGen/BuildEngine.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/BaseTools/Source/Python/AutoGen/BuildEngine.py b/BaseTools/Sou= rce/Python/AutoGen/BuildEngine.py index d602414ca41f37155c9c6d00eec54ea3918840c3..722fead75af6d60aa82365d9998= 37cd5ac3299af 100644 --- a/BaseTools/Source/Python/AutoGen/BuildEngine.py +++ b/BaseTools/Source/Python/AutoGen/BuildEngine.py @@ -172,7 +172,7 @@ class FileBuildRule: def __str__(self): SourceString =3D "" SourceString +=3D " %s %s %s" % (self.SourceFileType, " ".join(sel= f.SourceFileExtList), self.ExtraSourceFileList) - DestString =3D ", ".join(self.DestFileList) + DestString =3D ", ".join([str(i) for i in self.DestFileList]) CommandString =3D "\n\t".join(self.CommandList) return "%s : %s\n\t%s" % (DestString, SourceString, CommandString) =20 --=20 'Guid(CE165669-3EF3-493F-B85D-6190EE5B9759)' =1A=EF=BF=BD.=EF=BF=BD=C8=A8.)=E4=B1=8A.=EF=BF=BD=EF=BF=BD=1E=EF=BF=BD=EF= =BF=BD=EF=BF=BD=EF=BF=BDY=EF=BF=BD=EF=BF=BD=C6=A0z=EF=BF=BD=1E=EF=BF=BD=EF= =BF=BDh=EF=BF=BD=18=EF=BF=BD=EF=BF=BD=EF=BF=BD.=EF=BF=BDX=EF=BF=BD=EF=BF=BD= =EF=BF=BD^=EF=BF=BD\=EF=BF=BD=EF=BF=BDX=EF=BF=BD{=EF=BF=BD{=EF=BF=BDXm=EF= =BF=BD=EF=BF=BD?=EF=BF=BD=EF=BF=BDd=EF=BF=BD =E8=BA=9B"=EF=BF=BD=EF=BF=BD?u=EF=BF=BD=DE=97=EF=BF=BD=EF=BF=BD=EF=BF=BD=C6= =A0{=EF=BF=BD=EF=BF=BD=EF=BF=BDL=EF=BF=BD=D7=93=EF=BF=BD+=13=EF=BF=BD=EF=BF= =BD=EF=BF=BD=EF=BF=BD=EF=BF=BDi=EF=BF=BD=EF=BF=BD=E0=AE=8B=EF=BF=BD=EF=BF= =BD*?=EF=BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BD]=EF=BF=BD=EF=BF=BD=EF=BF=BD?=D7= =BF;=DB=BE=C6=AE=EF=BF=BD=EF=BF=BD; =DE=AD=D7=AFz_=EF=BF=BD=EF=BF=BDw=EF=BF= =BDy=EF=BF=BD6=EF=BF=BD=EF=BF=BD.=EF=BF=BD=C8=A8R{.n=EF=BF=BD+=EF=BF=BD=EF= =BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BDl=EF=BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BDh+=EF= =BF=BD=EF=BF=BDl=EF=BF=BD=EF=BF=BD=EF=BF=BD=EF=BF=BD=D7=AFz_=EF=BF=BD=CB=9B= =EF=BF=BDjh=EF=BF=BD=D7=AB=EF=BF=BD=EF=BF=BD\=EF=BF=BD=EF=BF=BD(=EF=BF=BD