From nobody Mon Feb 9 05:29:35 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+87014+1787277+3901457@groups.io; helo=mail02.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+87014+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1645785999; cv=none; d=zohomail.com; s=zohoarc; b=RyrnnlY7sRBZj2rbi+Fkqo7GbL907jhZ7mT6+3biFObHG9DyU6TRIR9KV02IwhrGecgpB5L4+VEZzfkIdIWx3pyl/dgTc6YA2PW7LExt0frq4mWiqQi3y1emidjLnxxmSQ3cFvQb1xxlAF0ZN7ZX2BtF2tTMC9ZEKTFiIXTmkMg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1645785999; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=Uc4Izmk7iMz958osAq6UCdiiSHmDmNX+cJzow3It+/Y=; b=bfp0GiYKb4OtRnebeSWimocQTIbQrxks4gKH5ciAd6+bVpIKsPwS5R2Z9HPadAUYDV+9xQAd78T9BfI8cI5WuYgNQO4lmYafVPhblg+7Xsdud/lMtlSi65N33vqOmeKKzGQ90D33uTAA3F6vqvVy1uo7pgqvrigQhpSn/OFD+GU= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+87014+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1645785999886312.85132987546353; Fri, 25 Feb 2022 02:46:39 -0800 (PST) Return-Path: X-Received: by 127.0.0.2 with SMTP id Ou2YYY1788612xYcn8aJGISv; Fri, 25 Feb 2022 02:46:39 -0800 X-Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by mx.groups.io with SMTP id smtpd.web12.5277.1645785999055583762 for ; Fri, 25 Feb 2022 02:46:39 -0800 X-IronPort-AV: E=McAfee;i="6200,9189,10268"; a="232447287" X-IronPort-AV: E=Sophos;i="5.90,136,1643702400"; d="scan'208";a="232447287" X-Received: from orsmga005.jf.intel.com ([10.7.209.41]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 25 Feb 2022 02:46:38 -0800 X-IronPort-AV: E=Sophos;i="5.90,136,1643702400"; d="scan'208";a="707822399" X-Received: from cward2-mobl2.ger.corp.intel.com (HELO sboeuf-mobl.home) ([10.252.25.151]) by orsmga005-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 25 Feb 2022 02:46:36 -0800 From: "Boeuf, Sebastien" To: devel@edk2.groups.io Cc: jiewen.yao@intel.com, jordan.l.justen@intel.com, kraxel@redhat.com, sebastien.boeuf@intel.com Subject: [edk2-devel] [PATCH v4 7/7] OvmfPkg: CloudHv: Add README Date: Fri, 25 Feb 2022 11:45:33 +0100 Message-Id: <0033be0077ab05516aa3af8afada9ab4cef8f117.1645785801.git.sebastien.boeuf@intel.com> In-Reply-To: References: MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,sebastien.boeuf@intel.com X-Gm-Message-State: slqstYDjDiHOth2kaN0tYL5bx1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1645785999; bh=yDOLnD+98bmAWt8kZwQ2eV36ccx8izTALemTYrblv4Q=; h=Cc:Content-Type:Date:From:Reply-To:Subject:To; b=xcCLaTtzWU15f3W15eJ4lDDt5Jxh2pTHdj8WMqmbJ13WeLDlFFjBCJ/9bcDXNHUWUzu uhGLSOYAPLvl2uxocBAq2n8tYwlliANvAEA1p4/8RFwJOYte85pJLJfSSb0ArRGVnxBv8 lKgVnCV6uT9o877mznCU9wt+ffj5PhKVsfw= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1645786000915100002 Content-Type: text/plain; charset="utf-8" From: Sebastien Boeuf Add some documentation to the CloudHv target in order to clarify how to use it and what to expect from it. Signed-off-by: Sebastien Boeuf --- OvmfPkg/CloudHv/README | 67 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 OvmfPkg/CloudHv/README diff --git a/OvmfPkg/CloudHv/README b/OvmfPkg/CloudHv/README new file mode 100644 index 0000000000..63e28860e0 --- /dev/null +++ b/OvmfPkg/CloudHv/README @@ -0,0 +1,67 @@ + +CloudHv is a port of OVMF for the Cloud Hypervisor project. + +The Cloud Hypervisor project +---------------------------- + +Cloud Hypervisor is a Virtual Machine Monitor that runs on top of KVM. The +project focuses on exclusively running modern, cloud workloads, on top of a +limited set of hardware architectures and platforms. Cloud workloads refer= s to +those that are usually run by customers inside a cloud provider. This means +modern operating systems with most I/O handled by paravirtualised devices +(i.e. virtio), no requirement for legacy devices, and 64-bit CPUs. + +https://github.com/cloud-hypervisor/cloud-hypervisor + +Design +------ + +Based on Cloud Hypervisor's motto to reduce the emulation as much as possi= ble, +the project logically decided to support the PVH boot specification as the= only +way of booting virtual machines. That includes both direct kernel boot and= OVMF +firmware which must be generated as PVH ELF binaries. +PVH allows information like location of ACPI tables and location of guest = RAM +ranges to be shared without the need of an extra emulated device like a CM= OS. + +Features +-------- + +* Serial console +* EFI shell +* virtio-pci + +Build +----- + +The way to build the CloudHv target is as follows: + +OvmfPkg/build.sh -p OvmfPkg/CloudHv/CloudHvX64.dsc -a X64 -b DEBUG + +Usage +----- + +Assuming Cloud Hypervisor is already built, one can start a virtual machin= e as +follows: + +./cloud-hypervisor \ + --cpus boot=3D1 \ + --memory size=3D1G \ + --kernel Build/CloudHvX64/DEBUG_GCC5/FV/CLOUDHV.fd \ + --disk path=3D/path/to/disk.raw + +Releases +-------- + +In edk2-stable202202, CloudHv is generated as data-only binary. +Starting with edk2-stable202205, CloudHv is generated as a PVH ELF binary = to +reduce the amount of emulation needed from Cloud Hypervisor. +For TDX, things are handled differently and PVH is not used, which is why = the +firmware is always generated as a data-only binary. + ++-------------------+----------------+ +| | CloudHv | ++-------------------+----------------+ +| edk2-stable202202 | Data binary | ++-------------------+----------------+ +| edk2-stable202205 | PVH ELF binary | ++-------------------+----------------+ --=20 2.32.0 --------------------------------------------------------------------- Intel Corporation SAS (French simplified joint stock company) Registered headquarters: "Les Montalets"- 2, rue de Paris,=20 92196 Meudon Cedex, France Registration Number: 302 456 199 R.C.S. NANTERRE Capital: 4,572,000 Euros This e-mail and any attachments may contain confidential material for the sole use of the intended recipient(s). Any review or distribution by others is strictly prohibited. If you are not the intended recipient, please contact the sender and delete all copies. -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#87014): https://edk2.groups.io/g/devel/message/87014 Mute This Topic: https://groups.io/mt/89385953/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-