From nobody Wed Dec 4 18:58:18 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=fail header.i=@intel.com; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=fail(p=none dis=none) header.from=intel.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1716532682310597.2046089729304; Thu, 23 May 2024 23:38:02 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 996) id 55B751B2D; Fri, 24 May 2024 02:38:01 -0400 (EDT) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id DED781CDE; Fri, 24 May 2024 02:27:11 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 996) id A09731B10; Fri, 24 May 2024 02:26:54 -0400 (EDT) Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.15]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id A41461BAB for ; Fri, 24 May 2024 02:26:08 -0400 (EDT) Received: from orviesa009.jf.intel.com ([10.64.159.149]) by fmvoesa109.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 May 2024 23:25:06 -0700 Received: from unknown (HELO SPR-S2600BT.bj.intel.com) ([10.240.192.124]) by orviesa009-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 May 2024 23:25:04 -0700 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, SPF_HELO_NONE autolearn=unavailable autolearn_force=no version=3.4.4 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1716531969; x=1748067969; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=oGqqWAYEqaNOkcL9nMRd/6M4tJCZRgoyT5iLH3iv7OE=; b=cq5nYK0ZNv3FRthHD3CR081WlABP8VQmvCaIkdQNq7IisvgjLHfONq0W btTwfq7VWjD3vMw9tAlP/nmOb3+RFKzuG/0G3qn8QYx7q+B/mBEv+AcwY 5UuJEycMgf3YU7tbiKcjYauQuMEWKB+BFEgTFydtbrG+ChLQwEtURQLVG yjBP0XgsH9q9C+hmJNrLFMugdyW1YI0m4mCO1GMjEfurEq+LyfQJOdsOL DYodCuba5uGYM/OmX+bvpMSShQl4FcsCiByv51uz6F5CjIU7mnSgLYPU/ adD4MIp9TVDy8z+zyzsNQz/woGrXyMjmiHOozZhVC3bNkKkLow4Pz2t3k w==; X-CSE-ConnectionGUID: S1ZkHv3/QiiHEO8jbuF51g== X-CSE-MsgGUID: UJX4AD96RqWiEIn19+uLHg== X-IronPort-AV: E=McAfee;i="6600,9927,11081"; a="13081300" X-IronPort-AV: E=Sophos;i="6.08,184,1712646000"; d="scan'208";a="13081300" X-CSE-ConnectionGUID: rF6H4ctzR0Su29MOV2nwsQ== X-CSE-MsgGUID: AijWMTGGTpa0qPankRYwLQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.08,184,1712646000"; d="scan'208";a="34034125" From: Zhenzhong Duan To: devel@lists.libvirt.org Subject: [PATCH rfcv4 13/13] docs: domain: Add documentation for Intel TDX guest Date: Fri, 24 May 2024 14:21:28 +0800 Message-Id: <20240524062128.523820-14-zhenzhong.duan@intel.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240524062128.523820-1-zhenzhong.duan@intel.com> References: <20240524062128.523820-1-zhenzhong.duan@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Message-ID-Hash: EMRQINIHAWYOASYJBSPHPLOT7VY3DPYP X-Message-ID-Hash: EMRQINIHAWYOASYJBSPHPLOT7VY3DPYP X-MailFrom: zhenzhong.duan@intel.com X-Mailman-Rule-Hits: nonmember-moderation X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0 CC: phrdina@redhat.com, pkrempa@redhat.com, jjongsma@redhat.com, jsuchane@redhat.com, chenyi.qiang@intel.com, isaku.yamahata@intel.com, xiaoyao.li@intel.com, chao.p.peng@intel.com, Zhenzhong Duan X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1716532683609100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Zhenzhong Duan --- docs/formatdomain.rst | 68 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 83c1405c17..5ee9f3a426 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -8851,6 +8851,74 @@ spec `__ session blob defined in the SEV API spec. See SEV spec LAUNCH_START sec= tion for the session blob format. =20 + +The contents of the ```` element is used to p= rovide +the guest owners input used for creating an encrypted VM using the Intel T= DX +(Trusted Domain eXtensions). Intel TDX refers to an Intel technology that +extends Virtual Machine Extensions (VMX) and Multi-Key Total Memory Encryp= tion +(MKTME) with a new kind of virtual machine guest called a Trust Domain (TD= ). +A TD runs in a CPU mode that is designed to protect the confidentiality of= its +memory contents and its CPU state from any other software, including the h= osting +Virtual Machine Monitor (VMM), unless explicitly shared by the TD itself. + +:: + + + ... + + 0x10000001 + xxx + xxx + xxx + + + + ... + + +``policy`` + The required ``policy`` element provides the guest TD attributes which = is + passed by the host VMM as a guest TD initialization parameter as part of + TD_PARAMS, it exactly matches the definition of TD_PARAMS.ATTRIBUTES in + (Intel TDX Module Spec Table 22.2: ATTRIBUTES Definition). It is report= ed + to the guest TD by TDG.VP.INFO and as part of TDREPORT_STRUCT returned = by + TDG.MR.REPORT. The guest policy is a 8 unsigned byte with the fields sh= own + in Table: + + =3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + Bit(s) Description + =3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + 0 Guest TD runs in off-TD debug mode when set + 1:27 reserved + 28 Disable EPT violation conversion to #VE on guest TD access of PE= NDING pages when set + 29:63 reserved + =3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +``mrConfigId`` + The optional ``mrConfigId`` element provides ID for non-owner-defined + configuration of the guest TD, e.g., run-time or OS configuration + (base64 encoded SHA384 digest). + +``@mrowner`` + The optional ``@mrowner`` element provides ID for the guest TD=E2=80=99= s owner + (base64 encoded SHA384 digest). + +``mrownerconfig`` + The optional ``mrownerconfig`` element provides ID for owner-defined + configuration of the guest TD, e.g., specific to the workload rather th= an + the run-time or OS (base64 encoded SHA384 digest). + +``quoteGenerationService`` + The optional ``quoteGenerationService`` subelement provides Quote + Generation Service(QGS) related configuration. QGS is a daemon running + on the host. User in TD guest cannot get TD quoting for attestation if + QGS is not provided. Currently only one subelement ``SocketAddress``. + + ``SocketAddress`` + The required ``SocketAddress`` element provides socket address for Q= GS. + Different properties of ``SocketAddress`` are supported depending on + value of ``type`` property which can be "inet", "unix", "vsock" and = "fd". + Example configs =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 --=20 2.34.1