From nobody Sun Feb 8 22:34:58 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=intel.com Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1633951747198435.96380422254845; Mon, 11 Oct 2021 04:29:07 -0700 (PDT) Received: from localhost ([::1]:60404 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mZtUQ-0003nh-5B for importer@patchew.org; Mon, 11 Oct 2021 07:29:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:56572) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mZtNL-0001Ya-Sy for qemu-devel@nongnu.org; Mon, 11 Oct 2021 07:21:47 -0400 Received: from mga04.intel.com ([192.55.52.120]:28238) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mZtNK-00080y-56 for qemu-devel@nongnu.org; Mon, 11 Oct 2021 07:21:47 -0400 Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 11 Oct 2021 04:21:39 -0700 Received: from icx-2s.bj.intel.com ([10.240.193.41]) by orsmga008.jf.intel.com with ESMTP; 11 Oct 2021 04:21:37 -0700 X-IronPort-AV: E=McAfee;i="6200,9189,10133"; a="225624876" X-IronPort-AV: E=Sophos;i="5.85,364,1624345200"; d="scan'208";a="225624876" X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.85,364,1624345200"; d="scan'208";a="490432244" From: Yang Zhong To: qemu-devel@nongnu.org Subject: [PATCH 6/6] doc: Add the SGX numa description Date: Mon, 11 Oct 2021 19:15:54 +0800 Message-Id: <20211011111554.12403-7-yang.zhong@intel.com> X-Mailer: git-send-email 2.29.2.334.gfaefdd61ec In-Reply-To: <20211011111554.12403-1-yang.zhong@intel.com> References: <20211011111554.12403-1-yang.zhong@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=192.55.52.120; envelope-from=yang.zhong@intel.com; helo=mga04.intel.com X-Spam_score_int: -41 X-Spam_score: -4.2 X-Spam_bar: ---- X-Spam_report: (-4.2 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: yang.zhong@intel.com, pbonzini@redhat.com, eblake@redhat.com, philmd@redhat.com Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZM-MESSAGEID: 1633951747651100001 Content-Type: text/plain; charset="utf-8" Add the SGX numa reference command and how to check if SGX numa is support or not with multiple EPC sections. Signed-off-by: Yang Zhong --- docs/system/i386/sgx.rst | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/docs/system/i386/sgx.rst b/docs/system/i386/sgx.rst index f103ae2a2f..9e4ada761f 100644 --- a/docs/system/i386/sgx.rst +++ b/docs/system/i386/sgx.rst @@ -141,8 +141,7 @@ To launch a SGX guest: |qemu_system_x86| \\ -cpu host,+sgx-provisionkey \\ -object memory-backend-epc,id=3Dmem1,size=3D64M,prealloc=3Don \\ - -object memory-backend-epc,id=3Dmem2,size=3D28M \\ - -M sgx-epc.0.memdev=3Dmem1,sgx-epc.1.memdev=3Dmem2 + -M sgx-epc.0.memdev=3Dmem1,sgx-epc.0.node=3D0 =20 Utilizing SGX in the guest requires a kernel/OS with SGX support. The support can be determined in guest by:: @@ -152,8 +151,32 @@ The support can be determined in guest by:: and SGX epc info by:: =20 $ dmesg | grep sgx - [ 1.242142] sgx: EPC section 0x180000000-0x181bfffff - [ 1.242319] sgx: EPC section 0x181c00000-0x1837fffff + [ 0.182807] sgx: EPC section 0x140000000-0x143ffffff + [ 0.183695] sgx: [Firmware Bug]: Unable to map EPC section to online = node. Fallback to the NUMA node 0. + +To launch a SGX numa guest: + +.. parsed-literal:: + + |qemu_system_x86| \\ + -cpu host,+sgx-provisionkey \\ + -object memory-backend-ram,size=3D2G,host-nodes=3D0,policy=3Dbind,id=3D= node0 \\ + -object memory-backend-epc,id=3Dmem0,size=3D64M,prealloc=3Don,host-node= s=3D0,policy=3Dbind \\ + -numa node,nodeid=3D0,cpus=3D0-1,memdev=3Dnode0 \\ + -object memory-backend-ram,size=3D2G,host-nodes=3D1,policy=3Dbind,id=3D= node1 \\ + -object memory-backend-epc,id=3Dmem1,size=3D28M,prealloc=3Don,host-node= s=3D1,policy=3Dbind \\ + -numa node,nodeid=3D1,cpus=3D2-3,memdev=3Dnode1 \\ + -M sgx-epc.0.memdev=3Dmem0,sgx-epc.0.node=3D0,sgx-epc.1.memdev=3Dmem1,s= gx-epc.1.node=3D1 + +and SGX epc numa info by:: + + $ dmesg | grep sgx + [ 0.369937] sgx: EPC section 0x180000000-0x183ffffff + [ 0.370259] sgx: EPC section 0x184000000-0x185bfffff + + $ dmesg | grep SRAT + [ 0.009981] ACPI: SRAT: Node 0 PXM 0 [mem 0x180000000-0x183ffffff] + [ 0.009982] ACPI: SRAT: Node 1 PXM 1 [mem 0x184000000-0x185bfffff] =20 References ----------