From nobody Mon Dec 15 03:23:51 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1520529224828917.0235151145708; Thu, 8 Mar 2018 09:13:44 -0800 (PST) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 35BE426AC40; Thu, 8 Mar 2018 17:13:43 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 9388E51DDB; Thu, 8 Mar 2018 17:13:42 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 7DB374CA9F; Thu, 8 Mar 2018 17:13:30 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id w28HDSwh014138 for ; Thu, 8 Mar 2018 12:13:28 -0500 Received: by smtp.corp.redhat.com (Postfix) id D3A808470A; Thu, 8 Mar 2018 17:13:28 +0000 (UTC) Received: from mx1.redhat.com (ext-mx01.extmail.prod.ext.phx2.redhat.com [10.5.110.25]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 18CB984700; Thu, 8 Mar 2018 17:13:22 +0000 (UTC) Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on0043.outbound.protection.outlook.com [104.47.37.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 799847FEA5; Thu, 8 Mar 2018 17:12:37 +0000 (UTC) Received: from wsp141597wss.amd.com (165.204.78.1) by DM2PR12MB0156.namprd12.prod.outlook.com (2a01:111:e400:50ce::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.548.13; Thu, 8 Mar 2018 17:12:33 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amdcloud.onmicrosoft.com; s=selector1-amd-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=LS95IIfpEPP7GTEGqM+NH9jbYNz/KqQyAw7JuWZhp28=; b=dEIqSm75KjQDt0s4r3RtZp3OJv+bAAV9K05G6g1YOLkXsS9+iTcKX9GqiXCFYFiYNSdNtB3PizxLmhEr1eeyomuKcd/3enRstGfJ7v9lfDLajow+qpDRotwk6ZN9kKYOGePLmp6Dx3Z/P4GreZ1lbGhBxHTr74v55KF18AyOU6E= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=brijesh.singh@amd.com; From: Brijesh Singh To: libvir-list@redhat.com Date: Thu, 8 Mar 2018 11:12:02 -0600 Message-Id: <20180308171208.54369-4-brijesh.singh@amd.com> In-Reply-To: <20180308171208.54369-1-brijesh.singh@amd.com> References: <20180308171208.54369-1-brijesh.singh@amd.com> MIME-Version: 1.0 X-Originating-IP: [165.204.78.1] X-ClientProxiedBy: BN6PR11CA0037.namprd11.prod.outlook.com (2603:10b6:404:4b::23) To DM2PR12MB0156.namprd12.prod.outlook.com (2a01:111:e400:50ce::19) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: e5a96bd5-a0dc-44b6-3880-08d58517c912 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4604075)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:DM2PR12MB0156; X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0156; 3:NFFxGUxhC1VJnIXmfaSRGhG3tHUY5Qjg+X/lFYbo/vjoxYTusfq+oyqCxr/Tml3LFN4lVej7fEw6Qt+hTBvReQaoobtssoe7tIp7Z2VNk8r6pGRF5lA56Qxo2jvlkq3gOlHmrWsMxdsW+qOC44sj6CWsPdwgY2AyeEswu4aWTGY5a0l4y8gdXCVwg6F33FlyCKtWqvJ+Nb67EzupV1fR17vfYwDVFv0nBKwNcenz9SkkzoxrOxnFTfTMRdgdL98y; 25:SET7ZegL+dylTa+vjmWNY9DTLQRSGnt37UuBiT5vXrlxWMoYLeL9k5E89HPb2DpmPE8ak0VAfPfGTgA8CfxKq2uirt5Sh8HwmwWsoX/QrCAFdTVJ2eIXB8k5IqMpUMULAtaave9dHWgvq9IUq/GhFgLZpfAaiQ3n+0eUZlMd2gtiP3DeiHh0T/FZ7Ig9cy8QRXz2kGPLCYlZWJUlFBwkJKnum5AKqJlACMPn8s1rdJkfsgHNKC8yA34+5AQI2wQG9Ti3EOWH9QKdqoijALucsBnTGKjBoY27UlyjGHFv8sVn2fsPH79H6NMbtIDT5PYdh7ZjE02ZHZEPg1qFov3Ilg==; 31:KRqjS9fFHdNrvCgwnRnnmxXiJvdUb3vCjnQ90Rj2TMaJez2KS78wPIOIUQ1gSiHk2eP1TXHVGD2Tk0AnChxmmcEFVIj95ZAkjsjHhnkW2J4N/8Ug+dx/pfaTZyXQE1numIsazlhrLc4MDbH7NErMQOTc/7hk/VkSUgk43rsxpNcbfJz+1xCl9m1otNZSAYjDAHVE+odtWsMp7iRmjgb3N3hMAZelTnnBqOPhUaXVlNg= X-MS-TrafficTypeDiagnostic: DM2PR12MB0156: X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0156; 20:dWInuTuZVffmguHP/S0tDJx1n+l3P+4nH5a3HuKQ0ITo1ef/xWoHWpZNT+ehJmG9QSoFlSOO4KUcYF3/Gbvje0nqzmRcwnxzNvPR+aEUzqIZOQsDNo0G5/HD0OgQcpy1Cvk5g748Act+c3MFPdV9ljq6n6SQZFghMHRbGxdv9Rb20/X0upBB9gCY/kn7iwlWwD1MjMF2qfdgvAFBYAqbKimBWjswJ5t8uIXfHwtM5PydOSn778UB+qBuoKmjsEwo51SoEoSA890TY+aV0t8qxWrKJOynteKJBTIkzfI1hi+w8Udz1Sip+e2YKzJIK7E3z+XhK2Ziii6XaUaF9btoA7htJu3+40DDzi0Tf1U9he31LTvYFbKe44WxIEmyHZzba5P/zYwwqjZFMB49Iwbj2s7FpfCgkqnr0OoukJ2uMq/jyiKmilDtdL/P5tuO4QcaZUW8P3HhqRS3EZLYizceCeV3OY6hO8s9BpM8GIafgYcyZ41c70RLTJJHDp/npmDi; 4:WxnSP1/TA98NjgCFG0bsSDYHcCz31IcaS0rUSv68YlVBMu1O61GeA893xYWPB2dNue9Kf+eb7NVNwjdJrU9Q1q6NvfHj8Q9MFuackJhh+yQlr8TYe1a3UEl5F04dQmYm83rxAgsyo/F2biCq8tq3iOoubVdd/q9oPupmC1RB9ZpYS4IqCjw7xBnnRH41X3snMEu8DQKSB8TMQspmiXaTgytn05Tqx5GRNzi6/cTS1rPChO7zJDFL6ji3bx1RjOq2lZi0iK3Vo48T3qm/G5hGH9G3E8W2loO+bNkqGu/k1rzmSINB3Wyk8uoRMYaeUNZ7iP8RbEyUIt4A/sFQD7NdSkQ9JAVkpoMJsIC+qI+AUX0= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192374486261705)(767451399110); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040501)(2401047)(5005006)(8121501046)(10201501046)(93006095)(93001095)(3002001)(3231220)(944501244)(52105095)(6055026)(6041288)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123562045)(20161123558120)(20161123564045)(6072148)(201708071742011); SRVR:DM2PR12MB0156; BCL:0; PCL:0; RULEID:; SRVR:DM2PR12MB0156; X-Forefront-PRVS: 060503E79B X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(366004)(346002)(39860400002)(396003)(376002)(39380400002)(199004)(189003)(5660300001)(16526019)(16586007)(478600001)(3846002)(6116002)(7696005)(52116002)(51416003)(76176011)(6486002)(25786009)(4326008)(316002)(59450400001)(26005)(1076002)(54906003)(86362001)(575784001)(186003)(386003)(6666003)(2361001)(106356001)(2351001)(53416004)(8676002)(81166006)(81156014)(50226002)(6306002)(15650500001)(53936002)(2950100002)(6916009)(2906002)(236005)(97736004)(68736007)(66066001)(606006)(47776003)(305945005)(7736002)(8936002)(36756003)(966005)(50466002)(48376002)(105586002)(19607625011); DIR:OUT; SFP:1101; SCL:1; SRVR:DM2PR12MB0156; H:wsp141597wss.amd.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Received-SPF: None (protection.outlook.com: amd.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DM2PR12MB0156; 23:owwWD2ca4yF+6q+bk0FNcubBrV03xekVv5Twjx2af?= =?us-ascii?Q?tYg9mWgTLvvlXMpRiM+020MeroV7iwlD6fnmLGasLHYDvXNVh+t36SPK+NI+?= =?us-ascii?Q?w5DwA7SnsB5uO2R3+HtSJCjxdF9HnV0L0p27DJ/jmfiGyjABnBn4N3q2/OhE?= =?us-ascii?Q?i16s44ZrZx8woy6bLaE3PSUFGp4rm1i1FbDOtbuwG20sb8WIpn+fjpO3ee15?= =?us-ascii?Q?4ovTdlqk5no/DX1fIkocR22BLYGN27K59hAF+2dgPLAOD0WfzEd1XsoORO0O?= =?us-ascii?Q?HfeYKKGIFuvwY1qn9Ehal5e6E08KnxQYneDZqqB3b5ZO9S9lvlmL79QFXElO?= =?us-ascii?Q?Xs9te4VdM2N6YUpfRRVVfQbDaPPgXvEDnBW0RMmQmOIpBkIX7xFfEya6WDv7?= =?us-ascii?Q?76yXG4LwPRtHIgPsYQS4qGf552Sooc3TU6Xjjgw+PAA4+CZeXiXaWjkMB+q0?= =?us-ascii?Q?ZGgPDpOWTts6EY6Isb311sGGegkUMT8IXdv46s48GIFeUXueIH4UMwAKok7w?= =?us-ascii?Q?pft4NpseWMaXRzIFY4HDbV5faHSLQU6sQSys1B+c0zvoRqj3AaIQNEwu+1Az?= =?us-ascii?Q?cej93WfAmTQKAheiPrwgvgmq0VYZe4yJ/Gl3gxzVjTwNvFHJwzm+WeSYEweX?= =?us-ascii?Q?8ZTWKNMKhV5AYlVRvKrHh8Vr87UqAl07qabe5uYTDA/BEuX81D6Z2hBccWyg?= =?us-ascii?Q?MAtetK53UxmBXiK1wdxlkvHIxx2oIh76jkHWLbOACjF37N5sEz6wEsv79S5U?= =?us-ascii?Q?ZKR91M+FUbD7/h0d4s3NsgIg4ART8O5SIKQdg7sxBvsRgiJb6xgBFLkENGhW?= =?us-ascii?Q?ulFU4NmlnwhVO45NruUl9oNKx3U7NF/nEgBwOAuaAPaiwqI74Qpw8Kw9tIYD?= =?us-ascii?Q?CU8OmZ2h6IF3MyAXSsh9u/jKKqM+wPMAftE8vDhl6bqMmuiFnObqhd/CpSAt?= =?us-ascii?Q?g0NI164Tsqi/Fh+cgn+weUuQuiW6LVoZG7OKObYALavgTDc1QYZeSDJqeAaf?= =?us-ascii?Q?FmguGqWQQA6G6nj87bzq9AOWbIJCd2rJTjf0EScQ2cicfDmMq9v8nslvGqUH?= =?us-ascii?Q?Ym1XKliMFF+p5Zf2sdQIEl1uMYlcu6bRHcK8ko56SleBrwuTHqctl3Qt1t0U?= =?us-ascii?Q?auVmH+3ok0c8ZocC/uvUUU9l4y3q0uLSJrznnYQi1BNuyjdBQ35W1EEdLtvh?= =?us-ascii?Q?lTqRIglDVvuFzVcL6QLJzWwmwH6I9u51bdWkH6p8E+H7T23cHoF064wm/seW?= =?us-ascii?Q?sXwTz2G++ZBmmZpMG98g3VnTG2eYtJRRcgQP7VJWrKRAvJnmTFuyl0CsyDl7?= =?us-ascii?Q?uhEQ2pxn+nd/uvJSI3Anj/fwpFfJVih4rKxQNAcW0Sd/rV+7xh1wsTBUYPK4?= =?us-ascii?Q?EdZ7w=3D=3D?= X-Microsoft-Antispam-Message-Info: 3TeEyzfjHShO9PNulH/rw6WUk7E/HBHgaiHqmL7gtkdKKU/J7TZGIY6KQD25bbdCQZ7gSGdPaJpg/SMV4bhu8K1+o/+PnEIkYF7gvphpYqPy51DJEt9rIzpPYqYxSlTQRG1G2g/e4YsbzoReRQpX4kQi7tquHp1FitOHuRDIuhefnrRq/ax5L6uxotmKrXwf X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0156; 6:b9HtVxgz9yvRDU7QPbmBXsnnI+N8U2QQgcSxySX5pCVAUuY63jn1O0oyz55yOrpcpAdLaQNWtEepPH3hcAT0D6Q4eSL1THEbGjV61HSVIGeg0AlkzYWo8sF1Iq7irjQgX5JJVUwGv8C3GVUffBY/KCWu6FkzVeLwYa+/VO6J2/6JJlOcHuhxdhnS/0bIZvvvCMw1F89QJjIOwk1uO4BXmvBv4L1cz0g60MopX29PMTs7HKvzkENmb1KWWU62fxInBP2hYrdELFc065I35yud8FK2J5L/0A6IiasFXHWidVSRfSf/fmhy04j/vpwEiA2yvW6eDH7Fdk9gW6XYMnmMnVbPeltVJ4pqMYSquUaZIYc=; 5:bqsMj9pe3KORyJUUkcMxY+1jKlCRs98YEif8I3sEGAaAOyYd+9bSdb3DkebZhn/eIKMdsBZyjiwnyyPDdQ9JYu4P2sr0r5fWSs6Q/JaX2LCETivJgeY3EykE/bu8fV4BGA9NJpw9HU0Pyz4pedLs2gG+eQDgtB+mV5++GRpudvo=; 24:Bh7t8/fwLw35ldnNPZx3HBqnGNuPrNshcCvTrOLDZg7yz3ahxL3YIb+kbr538VpsxVtcmgJHSXG688fHGDnJDhxEC9OYHX0D9zmyAyUR1Zs=; 7:Hzr+Rgea1Ge61b71iATIIhxa16IEq8Q89vONHvVeHneDIdv6jUi80lkwgzDj83Ucmrogna8KH80jLkfe+Y1ZtE4MgygDIuFai3OtWXnXpxBSd527FrfUzLP8S6fUfE7hcqOH752lm8zG50N4+PywMTWvZXlDEx/4PYpayJtRAOsLhExxn0JgdBgZiI0rXIOFbNoL5MQLeLwKWemvB/fyOs3Kj67tSUA/7WuJFPdyu6cQTviGkL/B6471yLu9sGJw SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0156; 20:4fsPMKqxSqasGfCocm7JHqiVkZsZQxQlcoBD1pf9SG/x7wyW4iiXMCqqmoO6LOiSVuSByyAJ2hZwsuPtJ2320Ccu6yq0dtbOuEtQ5QQZ7m9eJOzWTMY6t9hiCW6fAn1j64dAa63/RxrvS5gfdXntnDOogxwJ4H/e1ll2VWiUZGEqfgZEqG5ZjK1PZUmNjMFqDiKyJRwl7ol5WTftm1Zbtvh3Qgn1i6iTVigE/Nhnbnd8EunDdbnA/OLfsy+IoMAH X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Mar 2018 17:12:33.8512 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e5a96bd5-a0dc-44b6-3880-08d58517c912 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR12MB0156 X-Greylist: Sender passed SPF test, Sender IP whitelisted by DNSRBL, ACL 207 matched, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.25]); Thu, 08 Mar 2018 17:12:37 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.25]); Thu, 08 Mar 2018 17:12:37 +0000 (UTC) for IP:'104.47.37.43' DOMAIN:'mail-cys01nam02on0043.outbound.protection.outlook.com' HELO:'NAM02-CY1-obe.outbound.protection.outlook.com' FROM:'brijesh.singh@amd.com' RCPT:'' X-RedHat-Spam-Score: -0.011 (DKIM_SIGNED, DKIM_VALID, RCVD_IN_DNSWL_NONE, SPF_HELO_PASS) 104.47.37.43 mail-cys01nam02on0043.outbound.protection.outlook.com 104.47.37.43 mail-cys01nam02on0043.outbound.protection.outlook.com X-Scanned-By: MIMEDefang 2.83 on 10.5.110.25 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com Cc: Tom Lendacky , Peter Krempa , Xiaogang Chen , Jon Grimm , Brijesh Singh , Borislav Petkov Subject: [libvirt] [PATCH v2 3/9] conf: introduce launch-security element in domain X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.29]); Thu, 08 Mar 2018 17:13:43 +0000 (UTC) X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZohoMail: RDKM_2 RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" The launch-security element can be used to define the security model to use when launching a domain. Currently we support 'sev'. When 'sev' is used, the VM will be launched with AMD SEV feature enabled. SEV feature supports running encrypted VM under the control of KVM. Encrypted VMs have their pages (code and data) secured such that only the guest itself has access to the unencrypted version. Each encrypted VM is associated with a unique encryption key; if its data is accessed to a different entity using a different key the encrypted guests data will be incorrectly decrypted, leading to unintelligible data. Signed-off-by: Brijesh Singh Reviewed-by: Daniel P. Berrang=C3=A9 --- docs/formatdomain.html.in | 120 ++++++++++++++++++++++++++++++++++++++= ++++ docs/schemas/domaincommon.rng | 39 ++++++++++++++ src/conf/domain_conf.c | 111 ++++++++++++++++++++++++++++++++++++++ src/conf/domain_conf.h | 27 ++++++++++ 4 files changed, 297 insertions(+) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 6fd2189cd2f4..830d2a3c59be 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -8195,6 +8195,126 @@ qemu-kvm -net nic,model=3D? /dev/null =20

Note: DEA/TDEA is synonymous with DES/TDES.

=20 +

Secure Encrypted Virtualization (SEV)

+ +

+ The contents of the <launch-security type=3D'sev'> element + is used to provide the guest owners input used for creating an encr= ypted + VM using the AMD SEV feature. + + SEV is an extension to the AMD-V architecture which supports running + encrypted virtual machine (VMs) under the control of KVM. Encrypted + VMs have their pages (code and data) secured such that only the gue= st + itself has access to the unencrypted version. Each encrypted VM is + associated with a unique encryption key; if its data is accessed to= a + different entity using a different key the encrypted guests data wi= ll + be incorrectly decrypted, leading to unintelligible data. + + For more information see various input parameters and its format se= e SEV API spec + https://support.amd.com/TechDocs/55766_SEV-KM%20API_Specifi= cation.pdf + Since 4.2.0 +

+ 
+<domain>
+  ...
+  <launch-security type=3D'sev'>
+    <policy> 0 </policy>
+    <cbitpos> 47 </cbitpos>
+    <reduced-phys-bits> 5 </reduced-phys-bits>
+    <session> ... </session>
+    <dh-cert> ... </dh>
+  </sev>
+  ...
+</domain>
+
+ +

+ A least cbitpos and reduced-phys-bits must be + nested within the launch-security element. +

+
+
cbitpos
+
The cbitpos element provides the C-bit (aka encrypt= ion bit) + location in guest page table entry. The value of cbitpos is + hypervisor dependent and can be obtained through the sev element + from domaincapabilities. +
+
reduced-phys-bits
+
The reduced-phys-bits element provides the physical + address bit reducation. Similar to cbitpos the value of= + reduced-phys-bit is hypervisor dependent and can be obtained + through the sev element from domaincapabilities. +
+
policy
+
The optional policy element provides the guest poli= cy + which must be maintained by the SEV firmware. This policy is enforce= d by + the firmware and restricts what configuration and operational comman= ds + can be performed on this guest by the hypervisor. The guest policy + provided during guest launch is bound to the guest and cannot be cha= nged + throughout the lifetime of the guest. The policy is also transmitted + during snapshot and migration flows and enforced on the destination = platform. + + The guest policy is a 4-byte structure with the fields shown in Tabl= e: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Bit(s) Description
0 Debugging of the guest is disallowed when set
1 Sharing keys with other guests is disallowed when set
2 SEV-ES is required when set
3 Sending the guest to another platform is disallowed when se= t
4 The guest must not be transmitted to another platform that = is + not in the domain when set.
5 The guest must not be transmitted to another platform that = is + not SEV capable when set.
15:6 reserved
16:32 The guest must not be transmitted to another platform with a + lower firmware version.
+ Default value is 0x1 + +
+
dh-cert
+
The optional dh-cert element provides the guest own= ers public + Diffie-Hellman (DH) key. The key is used to negotiate a master secret + key between the SEV firmware and guest owner. This master secret key= is + then used to establish a trusted channel between SEV firmware and gu= est + owner. The value must be encoded in base64. +
+
session
+
The optional session element provides the guest own= ers + session blob defined in SEV API spec. The value must be encoded in b= ase64. + + See SEV spec LAUNCH_START section for session blob format. +
+
+

Example configs

=20

diff --git a/docs/schemas/domaincommon.rng b/docs/schemas/domaincommon.rng index 8165e699d67e..e3dcc69067c2 100644 --- a/docs/schemas/domaincommon.rng +++ b/docs/schemas/domaincommon.rng @@ -77,6 +77,9 @@ + + + @@ -436,6 +439,42 @@ =20 + + + + sev + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +