From nobody Wed May 14 19:16:41 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 152267880659820.75532619349292; Mon, 2 Apr 2018 07:20:06 -0700 (PDT) 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 1FC4A883CE; Mon, 2 Apr 2018 14:20:05 +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 DC92E51DF2; Mon, 2 Apr 2018 14:20:04 +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 7DD1C4CAA5; Mon, 2 Apr 2018 14:20:04 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id w32EJxQN024239 for ; Mon, 2 Apr 2018 10:19:59 -0400 Received: by smtp.corp.redhat.com (Postfix) id C37C960FAB; Mon, 2 Apr 2018 14:19:59 +0000 (UTC) Received: from mx1.redhat.com (ext-mx02.extmail.prod.ext.phx2.redhat.com [10.5.110.26]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 4456760BEB; Mon, 2 Apr 2018 14:19:56 +0000 (UTC) Received: from NAM01-SN1-obe.outbound.protection.outlook.com (mail-sn1nam01on0087.outbound.protection.outlook.com [104.47.32.87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 89DF6883B1; Mon, 2 Apr 2018 14:19:54 +0000 (UTC) Received: from wsp141597wss.amd.com (165.204.78.1) by BY2PR12MB0145.namprd12.prod.outlook.com (2a01:111:e400:585a::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.631.10; Mon, 2 Apr 2018 14:19:47 +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=K/dqgUFJ/3Jh+Fw8KyG38DxLuDUXqq4wWBjT1MiSEz0=; b=UzLaBOa3aT7J2zzbywp8FSVRwxwwDsFac42HVPabcu0SVl6ksd+0sVWn6WnFT7DlLdC2m9BzAyaXMg9Xggthu3TFzd9liGOaoAFT0CR7y/e641FZHaSuGt6sc7K+oMx6jc9bXbBzkhSDsZvv825xBeyOCoKcS4ZctRkhHwd3b74= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=brijesh.singh@amd.com; From: Brijesh Singh To: libvir-list@redhat.com Date: Mon, 2 Apr 2018 09:18:49 -0500 Message-Id: <20180402141856.4596-4-brijesh.singh@amd.com> In-Reply-To: <20180402141856.4596-1-brijesh.singh@amd.com> References: <20180402141856.4596-1-brijesh.singh@amd.com> MIME-Version: 1.0 X-Originating-IP: [165.204.78.1] X-ClientProxiedBy: SN4PR0501CA0001.namprd05.prod.outlook.com (2603:10b6:803:40::14) To BY2PR12MB0145.namprd12.prod.outlook.com (2a01:111:e400:585a::18) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: e97b10e5-5c98-4569-593b-08d598a4caa3 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4604075)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:BY2PR12MB0145; X-Microsoft-Exchange-Diagnostics: 1; BY2PR12MB0145; 3:ouFHPpuD3ZHV6J6fNQOp2q4xxvb/7GBW4Ui+PpUw2pHeenpMEr6FqWXo5br7j8+jL/rq9Jy5MlvqaxODnM6ajCDXr9dZx3H8qipjVbg8l6WSbE4RwAFS1mPlPOMMduXl6huhFN+9UKY5gh+O9hR24vPJeCl1Dympo3AbMQ4yBX7me1VlHHTzZqXXkoiSUxDFjxU7X8QgveeWu8Dm+79YkcBgxYm7Ds/WwnxHUC4eY64IuHkWLJw9qfbsUQvi0qO5; 25:GZbleA4ZrH/fQKoa//wY3Tb1fhYVeG6KEHGQuMUNdGZ1J7WnwAtDilSJKG3GuFwAW9ibAH7LVg23xbadPFewSDQakm5tI3fRaMPyj+/wAmE73oUp2dEZwvyVYoq2v1y1S15GpmFrjPD2PHyzfBtoKF67XfBkdvPJUzjkBoJh0ga0qn7sNDbgsqDZJIJXaJBON+NX7WPd6fboEYk5Wq2bscKhdQj3n/qpGf0Il1eitnxXZIJTrROfEGLHvRh/HIlrwYvN3c3ohH9tAC89hnjmrW0Brw3YLyoaG+1Afe3NCNU0dIXUnDPIIGyqFUmX3g+4nTUjx8TFzxuBeXSbuw+RXw==; 31:PecmmRNocULufC5Gm9LFwFURQZlq28TAEr3jFC1SZlGtlJuarCOUjWu6XHj4GJYs+BGAuDYXFpioMt932ijHEInvFpA9IVYEIInoiBvHbvY1qve7KGAsmnqwpMe/qPqrjTxPkdKpT9ufDBYGEhGdeIZkLmaSph7ENyhL2XODeYGeBVf4H8ImT1VP4V/sBAMKrp0fwIMtjvoWg7Pz6F8o+j6dKstwv3Qgk+BQBXzSLpo= X-MS-TrafficTypeDiagnostic: BY2PR12MB0145: X-Microsoft-Exchange-Diagnostics: 1; BY2PR12MB0145; 20:pgzfabostpvu85/OQnzlTLG0KKTmz43sekmz1+xVgXwlPX4LNhZ0W+5lTy1830ns+eNwRK8pJRQSbpel78uoi+5aplFUSvQ75ZuAsoWH9X7SIipaiXScAD0DEWxhTH44lq0tImiDDqyc/behQkOPQJsbwNGlB4RAMKVMDBfqTCnpl9xJMpK69FJM8ejgbPfvAp/+2hnEqIlnDR2kxGT5myjD8ocV4Oed1SQDRc28RYfz8XX3gcXRGRfKADM1Bqk2ebJrKBXvelE+tcRQbMxVrWF2uxCtsbhGsw7WMALh4a8C/ifHojLTjsiaGLLKKWQdq94FdzrFMbraNKoBfjsGadJbyj4R0OGEj1otdq00kc66oBlpBm/QlomxAZH4wdVB9rRAiO8U2jALkUfHgMqctPoDCZRfNRJ07Le2dg4TKGllkMsMylRKriTMOcFc75anra3rbKbUR+bimE9fFb87nQxJmTwgo0w/h+F7eQJqwdPRxsUu7+p6tlQprdaD773i; 4:uOU5lRWDorZriGulH7BWaucFeqLQ8IQZ9mN85WEo2oEnPgFKUtFHjChbXbBalpPIU/ybEl//dUKB9M8Qo73ZXf8j5lR3wxUjSR2uxBg/NftNjrTFsBx0iertEXIQRR6w5KuMToeSjdm1snjOVYPH5wT/Ol+HfSI8QBYpyZIwDapAHCWy9CIlMRdWuWv8VyoP2o7RiJnMZskcKurSP/6cRdIdLj8yWmoGAzo6RHM16nFnaQVipMTVfME7dfqPRfsfQtNTC7Yrx9zPlT2fknPPU4KmxwNDyN0VoBuH6GxL5WgkwFHqYOsAUv04A/oywQMHGEYJPjmFzUoxpUdKysUX1lIMcZtQqjoW0jHZTF8E5tQ= 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)(93006095)(93001095)(10201501046)(3002001)(3231221)(944501327)(52105095)(6055026)(6041310)(20161123564045)(20161123558120)(20161123560045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(6072148)(201708071742011); SRVR:BY2PR12MB0145; BCL:0; PCL:0; RULEID:; SRVR:BY2PR12MB0145; X-Forefront-PRVS: 0630013541 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(366004)(346002)(376002)(39860400002)(39380400002)(199004)(189003)(25786009)(956004)(486005)(6916009)(36756003)(81166006)(50226002)(186003)(606006)(2870700001)(23676004)(97736004)(54906003)(316002)(478600001)(26005)(1076002)(8676002)(6486002)(2351001)(50466002)(8936002)(16526019)(106356001)(15650500001)(47776003)(66066001)(53936002)(4326008)(81156014)(2616005)(2361001)(486005)(476003)(7736002)(446003)(53416004)(59450400001)(6306002)(966005)(6116002)(11346002)(5660300001)(68736007)(86362001)(76176011)(105586002)(7696005)(2906002)(236005)(575784001)(52116002)(305945005)(3846002)(386003)(19607625011); DIR:OUT; SFP:1101; SCL:1; SRVR:BY2PR12MB0145; H:wsp141597wss.amd.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; 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?MTtCWTJQUjEyTUIwMTQ1OzIzOndhUk1OSk54L25GOVpqVW1zUER4YzVtMy9r?= =?utf-8?B?bWl5K0hjN3JQVXZjekJKVzdkWDVQeFk3NEl0am1UdGVhTWhTY2ZrUnBlMm5B?= =?utf-8?B?UEF2TkE3TlVLNTI0Y3c3akxnVmUxcjJJWkVYa3o3emhLWmNkdFA4SkpHUUlZ?= =?utf-8?B?NWtGTzNOU0pGL094VEFUaTBjamZDbWpTWDYycnBqdVdnMmVGK1g5U0xvN2hm?= =?utf-8?B?U00vci9lOUNCbjR5QW1NY3BrWUxoVlRwVC9JQkd5UDYzdSt3TDNDZGw5aEtP?= =?utf-8?B?b21ZY0FJYnd3Kzh0TEtrTHArZFlJdUtaNTA1MTlpbU5Pd0hlNml1UGErZ3FW?= =?utf-8?B?R1RWbDFHNWZ0SG16REREWUdzUU1QWlVUZlc5MnowRVFjV0RQdmw0bWowK1Nh?= =?utf-8?B?SlRLWm5MNXV6Y05RN3lUWDV6UnoyWDZORzBXWElTL2g0TXIyRUZsQkVmVTlj?= =?utf-8?B?V24xNktOMytJMVVGVEdQZ29yQ2M0TldGUHR0QnVPdmxCNmsxYnhWNE1VMEhx?= =?utf-8?B?Ulh6ZEpOVUloVjlvUmhxSS9Sak9JdVlhQmxQTDJjZGVkS0FpN2plUUpuK1lk?= =?utf-8?B?YkQ3TlFlUE01VUIzeU1LWDJkdytSRDU0dmNqNGlFcGtvWDMvWHVVVzFLVWVv?= =?utf-8?B?WmRqdTN1OE5XYVc2WVo2dGZjL2dMV1FWQ0dLNDN1WEthVERLa2gveFJZam5L?= =?utf-8?B?ZXhiMVlsTm9XdnZUMkc0bmpyeU1vTGdWbFREKzdzVld5dHF1ZVFuak82SlBF?= =?utf-8?B?NXhaTjFEMWF6VjhtWTlZa0phMlBKMEFJNTM5QUlBK3h2VThMaWVENEFnU09t?= =?utf-8?B?V01BVFBpc2dQemlFRWJYQkRmRmtHamtaRGxMSi8zOXQ4cGlUcTFJOTJIUklC?= =?utf-8?B?WWRySmVONlA2dmR3dmhaNWVLdGVCVTZvendCWmdMQVI1T0grTW4wMGhWMFRz?= =?utf-8?B?K242SnBYUEE3eWErT3J2RkQ1RnFDTkN1a2JScnFlNmYyVFFqSFRzUVlnZ3Bl?= =?utf-8?B?TlpSR2pzYVFlTHpqTUxGQmhsUzF5ZlgxVSt6S1lxQkNYeTVTb3hwZmU1cWla?= =?utf-8?B?b2hjUzFXMkxnYkRzMzNqREZtQ2dkWXoyT29wMENUMmQwWkZPc3YyU0VtRmFl?= =?utf-8?B?cUNvbFpFZjk0ZUk4MTJoQUw2SlZPQWN4aEhucVN3RDN5VkhnREVDQ251S2NK?= =?utf-8?B?RlBieEJTSGY1UG1XMXQrc29CWS9pUGxKTHNBUi81REZCeDBOZzEwYUM0bWNh?= =?utf-8?B?U043cDRFWE9QTnFqcE90UWVvRFdVbnVyUDI4UmRKTEZSTkdHeW1Wd2U3N1Jv?= =?utf-8?B?aDZVVnM5TWtIcmw1NzlFSWR1bEtaYjZJeEtVeHhMMnpWM2paanJMajBZcGpt?= =?utf-8?B?MUtVZnNBR3AvNHNoTU82aUc5a1lEc3hQdERPWC9FZjhQeXZQS2krYjcxMTcv?= =?utf-8?B?VGRUOTNTWVc5STNDdHgySitiWllCbWExTjZjVFFYaHRmYWxObGRLZEJVaE56?= =?utf-8?B?NE92bkh4dll0K0Nxd0lQeHBqajZ5R1d0VmtRVm53RlhiY05CSTIzWkpRVkdO?= =?utf-8?B?QUFYQVc0OEliNkZrODBYUnFZZEtadFdFUVpHajEvcVBsU3IvTWY1ODlXVmpS?= =?utf-8?B?VTV6dnlsSEduSnZjNFZWdXZJTlVQUnJUY29iTjAyRmQwUWp4MmdqNytleXZx?= =?utf-8?B?cTUrMGg0T2tOWGd4UXBmcDFkNXhyWlVpTWZGRjJyeE1MbHBuTk1sd3VndzVa?= =?utf-8?B?N0ZWTWlpYTdpcHI2NFZKMUJHVHNhM25pMzNwM0JKdTZURnNWUWZQUFQ5NU1P?= =?utf-8?B?QllYVUZDeGcvSU1VTlE5SmJYa3JIcnlzVENWY0pmT0d2MTluUmxtcDVFcEtt?= =?utf-8?B?UlhtVWF0U2FlWUN6RUtQd2NvUEpoYlFQN1ZMaXFlNVBDaThFWGNVTFFpN2Fw?= =?utf-8?B?bmdtOHJQbVRRPT0=?= X-Microsoft-Antispam-Message-Info: +EJjRrOuT6qZETSoCn2po3k6xRUMgUELHvfJ1yOJzdX5H2iKHvCj3lhN0qNkG9+/Plvq4ktsnC3bDygb9ffHH2bB7vv1+9fsZxxHlwwf9xR55NwS9FfNBxkoNzKFDq94ko2xghjHgMPqIFnhQsKIJU9aU5H4/x4Z9Wy+Rdv8rHbw7lBGLwy/Jt/B7MT4jam8 X-Microsoft-Exchange-Diagnostics: 1; BY2PR12MB0145; 6:BnzyAXaPhWOsiZp9KQaX7hhWCo8jafWfVueFzqrq7xkbDs9p1g+0Y2ehlo5dCPJqzfkWsqcPfYZUjBdYtaJsaT44uI2OQ3BtmC0HB4O8lSIcBoUpRHUOMmMrMzT48ZCJ7fFwTW5vWhccnirNhWtppkKUosdKfFxr+dH/3oMGWKCZ6GyaRFHqsNtZReZMQnoSjaaDGE9phigeuDfc5guIqC4787XQO46YcZxhkSXOYjbplhNi1oBOPVro+UCM0XDh+j1EM0WIgWm7Qqd2q5Fjmlv1/aS56q0SlgxhKFMA1uc1bxfagc0+JzoqKbrgI0Kscy0ojhdcjyA8B0essiVMzr45H20UQVndmBIQ79t+A45pkxZs9uPaG6qyslUplyKRvE7sD8h8w+ld1axp1OUocOi6qq6Zg+wjwrKgIkVKxGnFbmp5yC/doedqGwBxZQ8pO4iOa8fKoyj99Nq4ZiJfAw==; 5:uiQs8qvvrV26Ds1wanmIMVOfi8C0t6HI3tIb137g2YqypywNaMWwxh3wxBZ98lEu8T1lz7Us6GhjnlAbb0tBXFTlv13w9m/nIKj3WluFjhzoDwfTZy/RDdnveQD6Z3M51E89pjVQ4N+qQMqF0tHLV1xW2hoCPeCdjlo7p316sKE=; 24:iwTMeq3V2vdfTcgXTrR4DnbQWK8kJz/34eUPGfGKE5+H1ucneoswO8GEwcKJBzyirncejL8kzo4lJCf/fZfzvWbB84qZGs6jjq+SruuGgtY= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BY2PR12MB0145; 7:w42R0bQHoQ0Ka3OpbViBkGv3Y8ZyXUFvqC6vt1rsv3DaE4h6b0oHcD7Ci/LrRQZ0AXxUWee2RIKlJp5W9tduFsblHIZkb/DEKgspEEWaroUMXqWFj30vkA8USX7hZPy4Oukkfq/XbQw4//yMfRzAXLxiRga90MISKOmUiKzRQBil+hmBzcmY5EVIoTrLRyPOPDQIvP/E7XBjsb0VrFggpya66JE8RlZ2EmcovcR/xB6wih7F7I19ErBqiCKumY+t; 20:uWIdWmaXmhIdgl6GXxo5jPfu4Kg3DLyevt1SXnk4o3le2bvcBgQG9KDAuJ4RvBzCe546ZE+5lL6jEgIwHEh3YSCNWEcru3RgutibUr8j9SnVLI4FhFtjhI5whgzDvfwsHOB3iV9jg84VbxPw4Aq+gakYgWe7eqUMJhRGKUviwistTKDTVZ5fCYnx3km2yWjWHqy6RpmlzvciyCtpYUSLYLx//8xGdebRyd+DdNI0V3QqSrXTOmQRRsokaro4dJcM X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Apr 2018 14:19:47.7679 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e97b10e5-5c98-4569-593b-08d598a4caa3 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY2PR12MB0145 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.26]); Mon, 02 Apr 2018 14:19:54 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.26]); Mon, 02 Apr 2018 14:19:54 +0000 (UTC) for IP:'104.47.32.87' DOMAIN:'mail-sn1nam01on0087.outbound.protection.outlook.com' HELO:'NAM01-SN1-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.32.87 mail-sn1nam01on0087.outbound.protection.outlook.com 104.47.32.87 mail-sn1nam01on0087.outbound.protection.outlook.com X-Scanned-By: MIMEDefang 2.78 on 10.5.110.26 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-loop: libvir-list@redhat.com Cc: Tom Lendacky , Peter Krempa , Jon Grimm , Andrea Bolognani , Brijesh Singh , Borislav Petkov Subject: [libvirt] [PATCH v5 03/10] 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.12 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.26]); Mon, 02 Apr 2018 14:20:05 +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 82e7d7c..2a6bed7 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -8200,6 +8200,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 a72c919..6a0e129 100644 --- a/docs/schemas/domaincommon.rng +++ b/docs/schemas/domaincommon.rng @@ -77,6 +77,9 @@ + + + @@ -436,6 +439,42 @@ =20 + + + + sev + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +