From nobody Wed May 14 15:32:40 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 152109952566075.15192171159458; Thu, 15 Mar 2018 00:38:45 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 5AEA67B02E; Thu, 15 Mar 2018 07:38:44 +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 246AD60BF4; Thu, 15 Mar 2018 07:38:44 +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 E2801B34AA; Thu, 15 Mar 2018 07:38:43 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id w2EFkHvE006808 for ; Wed, 14 Mar 2018 11:46:29 -0400 Received: by smtp.corp.redhat.com (Postfix) id AE8505D70B; Wed, 14 Mar 2018 15:46:17 +0000 (UTC) Received: from mx1.redhat.com (ext-mx04.extmail.prod.ext.phx2.redhat.com [10.5.110.28]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 858A35D6B2; Wed, 14 Mar 2018 15:46:15 +0000 (UTC) Received: from NAM02-CY1-obe.outbound.protection.outlook.com (mail-cys01nam02on0050.outbound.protection.outlook.com [104.47.37.50]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id A738C8048D; Wed, 14 Mar 2018 15:46:13 +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.588.14; Wed, 14 Mar 2018 15:46:07 +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=UBodXDT7VHC4IF4lVR6SxDVJ67t2bVEhzXoTEeeVTx0=; b=5eH55l6WiMk05pVwVt0uVoioake+Mg1Nc++oYu3LEmdoAZyCrcCZuoNwDj7CDejncFA1rUVQzQqQBNJqIG59KMXoewAeZ8xnNRHuLWoP+l1bfL87hSV6CTwRDyzNEfibZzzEHXjAp/vkdN2aHROCv0RwuT2hEFXVkZ/0JjwBwWc= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=brijesh.singh@amd.com; From: Brijesh Singh To: libvir-list@redhat.com Date: Wed, 14 Mar 2018 10:44:29 -0500 Message-Id: <20180314154435.17991-4-brijesh.singh@amd.com> In-Reply-To: <20180314154435.17991-1-brijesh.singh@amd.com> References: <20180314154435.17991-1-brijesh.singh@amd.com> MIME-Version: 1.0 X-Originating-IP: [165.204.78.1] X-ClientProxiedBy: MWHPR1701CA0015.namprd17.prod.outlook.com (2603:10b6:301:14::25) 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: 053e3f01-5be5-4411-e99f-08d589c2b43b 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:UkfvvhDk5kNE+k9xYG6MadmBhBFX84xcC7QsedbDqBxY/zA90iiscYq7FFsevrlKVATvWtTbl8NXwLSqbPQzpHxDjf9TT2giP7AP9lDJxnytaIfxqESeSdJ0MBl607S3SWGn35Owlwt8P044hNnaOm3owWx0WXojt0ztFaqoorNqAcFnrPeZTvDjO7JIQ77a8jdPvOJyG+6QaOQBpNvE0kfUBOJMz570tFhqrFOrw/yevfpyeA+TzWyd3/Bz/N1j; 25:z/ZbZ1lTy4jUCt82neTDSJKyCR5IzMeK3YaLhQ1a/RkqfYgai3L8drhVvYRsfT4L09GtJdkwdIl47Bfk6p/ETH+VVz8wFcis0VaJt60YsjB98FL2w+ywjNsPOFVNG/a59WZgBl9UhKnhm5dWSLe6L9dB4RAGzWmDMpRKs5v7pgYOU6kyHMYLslUa1aNy8uy4BQEsd3x196yk/TRaSOQ2zbJcYEhKH05V7RU4fzgj3kguK0bTXTDVmgzEOU5mXkk2T+qWV+KS+mw9I36qOspRU0su4U2i8L1Ot2B3KpFjGU+0ro/fOYU/a+H9A+ye8JeKhmYNuRgYvb2uCtkO4BHjEA==; 31:+jCgn2Vie+PX5cMCwKdDN+n4pyTtYhOXvtLYjZu45AEAzAE94zxc3OGy4JtoulrRvecyZdI+vVcBQPjLJTJkZYh3XwW7JrVJAJI8OHO/odhIPMadmcZtQeWuK3bFHljO7dzj1V4YjiC3o8KPORo/fRvcaBuxd5IGlWBDmCrhvfDDTvf41E++uhIXU9+qzfIvcgiDaAzo6AhVlQ8xda1nc/nFXKbmzqu+kERN1jJhHW0= X-MS-TrafficTypeDiagnostic: DM2PR12MB0156: X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0156; 20:aXqPBmOvQbc7yG3t5PQn1TSvYndv2pCwBEC32pv3P+HGlvNWZ2BlH+PKIqTw5ejE0Jzb8I6L2y5j06y/GwejL4c3MR5RCPobZmQtPnrrEOErtuvqlH64A+eO9M0DEkZ/luYSiE4HKHCvj9+sAhF8Ru1ae2yV//clFuR0vY9ksbI8hGdXZHvL2GEna1EeyoYPAUtSQ0EBKvUZz8rJF+l0Uhd1kEq4/5FkcZ/AqIIdbMDxu9TSd1Cb0bYLvmB7eL5SiNGGHHr972YrYzkVbqpep06z8eLKLDEktjoK7iWtvb+Mp/f7o1qnRzG/owL6qn0ES0fRmmrhhvKFNgRtPeTDJ1+ZGg0YARFSgVEYik2kJoZ8GfRP1juWK5KjMVtTfXEmggIYN0S4u9oQ8KCmGEgPAOmyT1betEj1UMBPpoO3brVCC8xEtAwMebZnQ1SKAiUAsZJADEdUMnG4xX4fmjSY8ZT/qeZpA2choIw/bf1hWTjLkTJY22tgyW9Qcr78wLk6; 4:PFafUbadmXIY5z5KPkgDQm0B3j477hUoDtSEKcp+8dOMiL1RL4T9ZS+cLXyl+pjcgwMs+TvpyOVEuCvoqC1XdmtH9GCF0Jqm/e5S9X+qxO0lqAptIl2MiiSqsPpAcZhDFXrn7UXu3wDsCrc0DR2DW6W+QtuUJ1EKUe29qXRBGo84AXoJLkcIzbRIZvV3rIGhQmApCd09JydS6D5Ms3PdF4R35w1v1ZpMyrIIRaKS/uuQCPWjWqiXTJnRgFpjvHp2oFAVz3jxL6ELp1WdQZCQz6zxt5J7qwvrkSnVPPDNpI+9OGbf4XJXNmahMgw6a62AyZRQD8/wk4iPtrgAEemyItK9y72Y2xRcAhoFQUN+6hU= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192374486261705)(767451399110); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(10201501046)(3002001)(3231221)(944501244)(52105095)(93006095)(93001095)(6055026)(6041310)(20161123562045)(20161123560045)(20161123564045)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(6072148)(201708071742011); SRVR:DM2PR12MB0156; BCL:0; PCL:0; RULEID:; SRVR:DM2PR12MB0156; X-Forefront-PRVS: 0611A21987 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(366004)(39860400002)(376002)(346002)(396003)(39380400002)(199004)(189003)(59450400001)(2950100002)(6916009)(81166006)(2351001)(81156014)(4326008)(6116002)(478600001)(6666003)(52116002)(7736002)(8676002)(6306002)(3846002)(7696005)(305945005)(236005)(106356001)(2361001)(23676004)(50466002)(53936002)(76176011)(47776003)(5660300001)(316002)(6486002)(54906003)(53416004)(68736007)(105586002)(97736004)(966005)(1076002)(66066001)(8936002)(606006)(50226002)(186003)(16526019)(15650500001)(386003)(36756003)(26005)(2906002)(86362001)(25786009)(2870700001)(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: =?utf-8?B?MTtETTJQUjEyTUIwMTU2OzIzOnN1NWxadHZqMDVLNkR3bkV6ZWVCSWh0TkFD?= =?utf-8?B?YW1CMktKb1lkRjJvNkw1N2w0R2NHU09zTWxIQ1IzWGpFUnMyVkZZcEZJS1VO?= =?utf-8?B?SUZGNGUxeGhaV3I2UG15cDNiM1BHaWl3bDROaUZ6eDdQOWRaZ0JVYlRqVHZx?= =?utf-8?B?WDU5aWNsSDJlRVBPZ2xkRGN5dlNMTXR0S1pGNGpxOHFlczBxRVJyN29yNUdO?= =?utf-8?B?WnlUdkZ6U3NpR0diVHkyQXdVMXJXb2x2QjRqUXpkcmZ3TEJLR2ltbHZwSnpO?= =?utf-8?B?ZTBMMWxhL08vcStkNytkVkI1L3piY3ZUK24wTlNud3JhdXJWM1NzZnZBMER4?= =?utf-8?B?ZWFoT2U1R1laK3l3LzVpNXhockFndWp1N1lrQllCOTVkMDFWSktLZW5LUTBQ?= =?utf-8?B?Vjk3WUhHcEQ1aTVsWXlCbHI1eHk3M05IZTJpS1pLbGI0RkNNVk1BNEFPSE5p?= =?utf-8?B?ZDhWTm1RN3lDREs2YVF4dmU5c0Q3alZTdk9rVmljN2FGa0V6aGtvUHZmMGV3?= =?utf-8?B?eThXeW9IcTlLNjd0Tzl0NXdGakwrYWNTVjVRYi9KZ25TOEVDYjE5ekd6bkVq?= =?utf-8?B?Vlhwcjc4OFV0NStOTlY1NjA5ZzhUdkNHanpjRXBOODV5YjM1M2hDUjk0aFMr?= =?utf-8?B?NEpKYkh6M2JSODR2YWRZaWNRYXZhWTZwZW1ldWljOERkaTNDcDI1Z3dCQ1p4?= =?utf-8?B?Z0RBa1JjQ2s0a2tRbnpSSHAxT0VSKzhLUGo4aFhOaTI4bDdwK1dOeXRMcTd1?= =?utf-8?B?dHlCcDdNQWpmZGI5ZG9YaFlpZDZFYU4wc29XL0xGWXd0dFliYnlXTHZ1eEs1?= =?utf-8?B?ZysvL2dRYnNhY21yS1QwdzF2UlNNMlhVOUhpZU5TWXBXOEJ5WW5rQ1FLeVoy?= =?utf-8?B?V3VrRjlRbGZNaXNaNitWUnpVSFdQamFmVzg0S0NMV2p4bHNPcUhwVGdnL0FC?= =?utf-8?B?Uy9hNTc0cy9CVEcwSERua0ROYmZwQ3ZSRDFOY0o4WW5kUnVBMVlodURiVkU1?= =?utf-8?B?VGV0OXFiTFhjT3B6eXl2UW5GTkUvamxFK3UrbXgrRkFCWVJuUG9jT2ozeHZR?= =?utf-8?B?eW9LbVRZYlNEbFF5M0twb3RpWGRyaS9jZXN5enQ5dHlHMHJYVm4xbXBjQnpl?= =?utf-8?B?MVlUTjE3aitHTGZCNldOZDBpckMxaFRWdzRQeWlYSkJUeVUyTTRIWFcwVXJJ?= =?utf-8?B?dGpOazNGRE40Y0ZQeXNaNzNFY2hnSGJJLzNEa1VWMURxMDVDN3R4ckI1dDIy?= =?utf-8?B?b21sVHJLNUNKQTA5RWlJSFBLOEZacjZ1RWRIL09Db3ViTHdmMVpYbDloRmwr?= =?utf-8?B?UEFhaVpId0Z1b0lzL2N1WXFVUzhNejJMR0RLcGdlWGkwRmdlRmZWcEY2YXNH?= =?utf-8?B?eVZ5Y0NLclJOWmV4Nk9velZTY1pPMG5kL1RpWGNkUmhySU0vaFUwVEJXY005?= =?utf-8?B?R0g3ejlHdHNyK3BMNm96QnJIQ3JidjlBN28rd0NxMGFwZVgrbnpGTVdqeDFF?= =?utf-8?B?a2ZvSnFjeU55a3hSZ0JzMHRzMll2a3YxNm1mc3RHWDF5a3JDcHVxWFBldWFw?= =?utf-8?B?dU9NN2JpdnBhT0xvT09SSUhBSzNDYjhHSk9nck5Pc210MmR4djdqcXBnOVVx?= =?utf-8?B?U05UMnRiQ0NBM0tXcmQ0QVExTGZKQmhsS3RWN1Y2TnBWZVZ0Mk1lZERlQjRv?= =?utf-8?B?Sk42N2NkOEVBSnZ0UFBKZlM4azRoNk5YRFhrL1ZrZUFyU1ArVDdHWUtCcE9h?= =?utf-8?Q?VcngPAD1+mySOuCjIz2gkn9F5sLmjKsjHZKtU=3D?= X-Microsoft-Antispam-Message-Info: NkfGL2KLg1F/rh9tgeiCpgLxdIswLjt3gMQMHrqMFM0l9RztdEPhPxT4rdzpRydu4xbVSsPg8kA9QIRkvFpbdFSgyjA+aT7WE8jZvkvRKaRyLclRToeyUsyp9BUtX5VtRr8o02EZ6uTpKiX4C6ok+a7p/S0TbmZi9gBAFP2rcGiH5sh/CpYabx/3o04W0emI X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0156; 6:05+mwRRxT/DXI+JYbtb40fgD8EU65S/UDcsWSOYzwWNw5F7Av0hLevC02BnNixkU34cQqoNakb+ISCs0OU2IaoAvvz4Syge1Vd0Hw5nZnuUvFnwrFOEx9JzzzHmbwhft37Kx8u7yvzxgKb+/tQG2EJldcLahOia2BBTR1XJ4DI1RYgNK4X9oWx+th5NUljScK5qWIIYlVdppR2MXEAV1TfWc/lVeY63VzVgjBF7iSmv6U9baNS10RPBqY1577/GnKaY3FB/ifPBXP97YMa/FX62DvFaLfy+lWEPIXecOVrWCg5MJJ+ta0wEO1n3mxJhlf1uxsPU5zMkxe29nGbrXvQFMKax9ktLtEAvISdnrOig=; 5:VQsB2VVP4OyXEmqDHxyVB4DqnaN/sS0u/9RHjgVfi5qmZVlJd5HfLpKzTPfxOdtIjgh9xIaOnz9sVIjBUbnj6HkLQMDc+HOmJXjsRRtL8vbEu+h/mv15VzYHmIpo0WPam6/36gv8i6COPMRzM4hSn8Uiviqr/8sGHn4AxpHXoc0=; 24:Osge43+lO4Rolmdp7RVDlBPwCcv0V1ObhOQeWeso0iPc+e8q3CKaMIJbQH/ENZKLDXgle1stQTWAmpkYBpey5SyjtvOfDORD3Rp5bhKyNn8=; 7:xOwl3t4uBo1YzPWjXFxtZEBpJDBTJ0rhlO1KjnyINWeNH//vexLBxAW+uHFUEMZCxeWEduubmGPse2o1EE1tjHjANbzDCVZINGcs0TzlXKzK+Z1bzCVh8DQ0VEg5ZoMV6jkb2o4Vpq5SiJRZexXEg9T7Ofn9sBVoWNjubse61m2mnYUm/mzEyahl4Jp5QQJvwq6m0yEtaoMh+b8ObdcMO6yJLkfsiiTNXCbn38Dw4xksaL41LOKb9F+qq7C0/UW/ SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DM2PR12MB0156; 20:YMU7zugVStkJAbyql8+QsDuzcqYwX90VHMft8CELN/zqQYgyR7POz0TiTUOZgylBOSzdlZWP7oVOvury29T1cpL/QUhiCtJYfwP7thMlf9N4JoIexJox78DgFK+r3KH3KWbGHOpnLETZmWykwb0TdGG8uobpqkpkJEQ+q2HyLAZV1oD6xBmky2Uc/r1pXV57oA8Qa/YfuQvFYQGBEzpudH2GHVVRytAfT8lyvER95YKga5UPUyvXsTPTZThGgpkn X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Mar 2018 15:46:07.1560 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 053e3f01-5be5-4411-e99f-08d589c2b43b 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.28]); Wed, 14 Mar 2018 15:46:13 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.28]); Wed, 14 Mar 2018 15:46:13 +0000 (UTC) for IP:'104.47.37.50' DOMAIN:'mail-cys01nam02on0050.outbound.protection.outlook.com' HELO:'NAM02-CY1-obe.outbound.protection.outlook.com' FROM:'brijesh.singh@amd.com' RCPT:'' X-RedHat-Spam-Score: -0.031 (DKIM_SIGNED, DKIM_VALID, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_PASS) 104.47.37.50 mail-cys01nam02on0050.outbound.protection.outlook.com 104.47.37.50 mail-cys01nam02on0050.outbound.protection.outlook.com X-Scanned-By: MIMEDefang 2.78 on 10.5.110.28 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com Cc: Tom Lendacky , Peter Krempa , Xiaogang Chen , Jon Grimm , Brijesh Singh , Borislav Petkov Subject: [libvirt] [PATCH v3 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-Type: text/plain; charset="utf-8" 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.13 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.38]); Thu, 15 Mar 2018 07:38:44 +0000 (UTC) X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZohoMail: RDKM_2 RSF_0 Z_629925259 SPT_0 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. Reviewed-by: "Daniel P. Berrang=C3=A9" Signed-off-by: Brijesh Singh --- docs/formatdomain.html.in | 120 ++++++++++++++++++++++++++++++++++++++= ++++ docs/schemas/domaincommon.rng | 39 ++++++++++++++ src/conf/domain_conf.c | 110 ++++++++++++++++++++++++++++++++++++++ src/conf/domain_conf.h | 26 +++++++++ 4 files changed, 295 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +