build: Release v22.0

Signed-off-by: Rob Bradford <robert.bradford@intel.com>

Cargo.lock

@@ -148,7 +148,7 @@ dependencies = [
 
 [[package]]
 name = "cloud-hypervisor"
-version = "21.0.0"
+version = "22.0.0"
 dependencies = [
  "anyhow",
  "api_client",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cloud-hypervisor"
-version = "21.0.0"
+version = "22.0.0"
 authors = ["The Cloud Hypervisor Authors"]
 edition = "2018"
 default-run = "cloud-hypervisor"

release-notes.md

@@ -1,8 +1,19 @@
+- [v22.0](#v220)
+    - [GDB Debug Stub Support](#gdb-debug-stub-support)
+    - [`virtio-iommu` Backed Segments](#virtio-iommu-backed-segments)
+    - [Before Boot Configuration Changes](#before-boot-configuration-changes)
+    - [`virtio-balloon` Free Page Reporting](#virtio-balloon-free-page-reporting)
+    - [Support for Direct Kernel Booting with TDX](#support-for-direct-kernel-booting-with-tdx)
+    - [PMU Support for AArch64](#pmu-support-for-aarch64)
+    - [Documentation Under CC-BY-4.0 Licese](#documentation-under-cc-by-40-licese)
+    - [Deprecation of "Classic" `virtiofsd`](#deprecation-of-classic-virtiofsd)
+    - [Notable Bug Fixes](#notable-bug-fixes)
+    - [Contributors](#contributors)
 - [v21.0](#v210)
     - [Efficient Local Live Migration (for Live Upgrade)](#efficient-local-live-migration-for-live-upgrade)
     - [Recommended Kernel is Now 5.15](#recommended-kernel-is-now-515)
-    - [Notable Bug fixes](#notable-bug-fixes)
+    - [Notable Bug fixes](#notable-bug-fixes-1)
-    - [Contributors](#contributors)
+    - [Contributors](#contributors-1)
 - [v20.2](#v202)
 - [v20.1](#v201)
 - [v20.0](#v200)
@@ -11,8 +22,8 @@
     - [Improved VFIO support](#improved-vfio-support)
     - [Safer code](#safer-code)
     - [Extended documentation](#extended-documentation)
-    - [Notable bug fixes](#notable-bug-fixes-1)
+    - [Notable bug fixes](#notable-bug-fixes-2)
-    - [Contributors](#contributors-1)
+    - [Contributors](#contributors-2)
 - [v19.0](#v190)
     - [Improved PTY handling for serial and `virtio-console`](#improved-pty-handling-for-serial-and-virtio-console)
     - [PCI boot time optimisations](#pci-boot-time-optimisations)
@@ -20,8 +31,8 @@
     - [Live migration enhancements](#live-migration-enhancements)
     - [`virtio-mem` support with `vfio-user`](#virtio-mem-support-with-vfio-user)
     - [AArch64 for `virtio-iommu`](#aarch64-for-virtio-iommu)
-    - [Notable bug fixes](#notable-bug-fixes-2)
+    - [Notable bug fixes](#notable-bug-fixes-3)
-    - [Contributors](#contributors-2)
+    - [Contributors](#contributors-3)
 - [v18.0](#v180)
     - [Experimental User Device (`vfio-user`) support](#experimental-user-device-vfio-user-support)
     - [Migration support for `vhost-user` devices](#migration-support-for-vhost-user-devices)
@@ -31,23 +42,23 @@
     - [Live migration on MSHV hypervisor](#live-migration-on-mshv-hypervisor)
     - [AArch64 CPU topology support](#aarch64-cpu-topology-support)
     - [Power button support on AArch64](#power-button-support-on-aarch64)
-    - [Notable bug fixes](#notable-bug-fixes-3)
+    - [Notable bug fixes](#notable-bug-fixes-4)
-    - [Contributors](#contributors-3)
+    - [Contributors](#contributors-4)
 - [v17.0](#v170)
     - [ARM64 NUMA support using ACPI](#arm64-numa-support-using-acpi)
     - [`Seccomp` support for MSHV backend](#seccomp-support-for-mshv-backend)
     - [Hotplug of `macvtap` devices](#hotplug-of-macvtap-devices)
     - [Improved SGX support](#improved-sgx-support)
     - [Inflight tracking for `vhost-user` devices](#inflight-tracking-for-vhost-user-devices)
-    - [Notable bug fixes](#notable-bug-fixes-4)
+    - [Notable bug fixes](#notable-bug-fixes-5)
-    - [Contributors](#contributors-4)
+    - [Contributors](#contributors-5)
 - [v16.0](#v160)
     - [Improved live migration support](#improved-live-migration-support)
     - [Improved `vhost-user` support](#improved-vhost-user-support)
     - [ARM64 ACPI and UEFI support](#arm64-acpi-and-uefi-support)
-    - [Notable bug fixes](#notable-bug-fixes-5)
+    - [Notable bug fixes](#notable-bug-fixes-6)
     - [Removed functionality](#removed-functionality)
-    - [Contributors](#contributors-5)
+    - [Contributors](#contributors-6)
 - [v15.0](#v150)
     - [Version numbering and stability guarantees](#version-numbering-and-stability-guarantees)
     - [Network device rate limiting](#network-device-rate-limiting)
@@ -55,7 +66,7 @@
     - [`--api-socket` supports file descriptor parameter](#--api-socket-supports-file-descriptor-parameter)
     - [Bug fixes](#bug-fixes)
     - [Deprecations](#deprecations)
-    - [Contributors](#contributors-6)
+    - [Contributors](#contributors-7)
 - [v0.14.1](#v0141)
 - [v0.14.0](#v0140)
     - [Structured event monitoring](#structured-event-monitoring)
@@ -65,7 +76,7 @@
     - [PTY control for serial and `virtio-console`](#pty-control-for-serial-and-virtio-console)
     - [Block device rate limiting](#block-device-rate-limiting)
     - [Deprecations](#deprecations-1)
-    - [Contributors](#contributors-7)
+    - [Contributors](#contributors-8)
 - [v0.13.0](#v0130)
     - [Wider VFIO device support](#wider-vfio-device-support)
     - [Improved huge page support](#improved-huge-page-support)
@@ -73,13 +84,13 @@
     - [VHD disk image support](#vhd-disk-image-support)
     - [Improved Virtio device threading](#improved-virtio-device-threading)
     - [Clean shutdown support via synthetic power button](#clean-shutdown-support-via-synthetic-power-button)
-    - [Contributors](#contributors-8)
+    - [Contributors](#contributors-9)
 - [v0.12.0](#v0120)
     - [ARM64 enhancements](#arm64-enhancements)
     - [Removal of `vhost-user-net` and `vhost-user-block` self spawning](#removal-of-vhost-user-net-and-vhost-user-block-self-spawning)
     - [Migration of `vhost-user-fs` backend](#migration-of-vhost-user-fs-backend)
     - [Enhanced "info" API](#enhanced-info-api)
-    - [Contributors](#contributors-9)
+    - [Contributors](#contributors-10)
 - [v0.11.0](#v0110)
     - [`io_uring` support by default for `virtio-block`](#io_uring-support-by-default-for-virtio-block)
     - [Windows Guest Support](#windows-guest-support)
@@ -91,15 +102,15 @@
     - [Default Log Level Changed](#default-log-level-changed)
     - [New `--balloon` Parameter Added](#new---balloon-parameter-added)
     - [Experimental `virtio-watchdog` Support](#experimental-virtio-watchdog-support)
-    - [Notable Bug Fixes](#notable-bug-fixes-6)
+    - [Notable Bug Fixes](#notable-bug-fixes-7)
-    - [Contributors](#contributors-10)
+    - [Contributors](#contributors-11)
 - [v0.10.0](#v0100)
     - [`virtio-block` Support for Multiple Descriptors](#virtio-block-support-for-multiple-descriptors)
     - [Memory Zones](#memory-zones)
     - [`Seccomp` Sandbox Improvements](#seccomp-sandbox-improvements)
     - [Preliminary KVM HyperV Emulation Control](#preliminary-kvm-hyperv-emulation-control)
-    - [Notable Bug Fixes](#notable-bug-fixes-7)
+    - [Notable Bug Fixes](#notable-bug-fixes-8)
-    - [Contributors](#contributors-11)
+    - [Contributors](#contributors-12)
 - [v0.9.0](#v090)
     - [`io_uring` Based Block Device Support](#io_uring-based-block-device-support)
     - [Block and Network Device Statistics](#block-and-network-device-statistics)
@@ -112,17 +123,17 @@
     - [Enhancements to ARM64 Support](#enhancements-to-arm64-support)
     - [Intel SGX Support](#intel-sgx-support)
     - [`Seccomp` Sandbox Improvements](#seccomp-sandbox-improvements-1)
-    - [Notable Bug Fixes](#notable-bug-fixes-8)
+    - [Notable Bug Fixes](#notable-bug-fixes-9)
-    - [Contributors](#contributors-12)
+    - [Contributors](#contributors-13)
 - [v0.8.0](#v080)
     - [Experimental Snapshot and Restore Support](#experimental-snapshot-and-restore-support)
     - [Experimental ARM64 Support](#experimental-arm64-support)
     - [Support for Using 5-level Paging in Guests](#support-for-using-5-level-paging-in-guests)
     - [Virtio Device Interrupt Suppression for Network Devices](#virtio-device-interrupt-suppression-for-network-devices)
     - [`vhost_user_fs` Improvements](#vhost_user_fs-improvements)
-    - [Notable Bug Fixes](#notable-bug-fixes-9)
+    - [Notable Bug Fixes](#notable-bug-fixes-10)
     - [Command Line and API Changes](#command-line-and-api-changes)
-    - [Contributors](#contributors-13)
+    - [Contributors](#contributors-14)
 - [v0.7.0](#v070)
     - [Block, Network, Persistent Memory (PMEM), VirtioFS and Vsock hotplug](#block-network-persistent-memory-pmem-virtiofs-and-vsock-hotplug)
     - [Alternative `libc` Support](#alternative-libc-support)
@@ -132,14 +143,14 @@
     - [`Seccomp` Sandboxing](#seccomp-sandboxing)
     - [Updated Distribution Support](#updated-distribution-support)
     - [Command Line and API Changes](#command-line-and-api-changes-1)
-    - [Contributors](#contributors-14)
+    - [Contributors](#contributors-15)
 - [v0.6.0](#v060)
     - [Directly Assigned Devices Hotplug](#directly-assigned-devices-hotplug)
     - [Shared Filesystem Improvements](#shared-filesystem-improvements)
     - [Block and Networking IO Self Offloading](#block-and-networking-io-self-offloading)
     - [Command Line Interface](#command-line-interface)
     - [PVH Boot](#pvh-boot)
-    - [Contributors](#contributors-15)
+    - [Contributors](#contributors-16)
 - [v0.5.1](#v051)
 - [v0.5.0](#v050)
     - [Virtual Machine Dynamic Resizing](#virtual-machine-dynamic-resizing)
@@ -147,7 +158,7 @@
     - [New Interrupt Management Framework](#new-interrupt-management-framework)
     - [Development Tools](#development-tools)
     - [Kata Containers Integration](#kata-containers-integration)
-    - [Contributors](#contributors-16)
+    - [Contributors](#contributors-17)
 - [v0.4.0](#v040)
     - [Dynamic virtual CPUs addition](#dynamic-virtual-cpus-addition)
     - [Programmatic firmware tables generation](#programmatic-firmware-tables-generation)
@@ -156,7 +167,7 @@
     - [Userspace IOAPIC by default](#userspace-ioapic-by-default)
     - [PCI BAR reprogramming](#pci-bar-reprogramming)
     - [New `cloud-hypervisor` organization](#new-cloud-hypervisor-organization)
-    - [Contributors](#contributors-17)
+    - [Contributors](#contributors-18)
 - [v0.3.0](#v030)
     - [Block device offloading](#block-device-offloading)
     - [Network device backend](#network-device-backend)
@@ -183,6 +194,91 @@
     - [Unit testing](#unit-testing)
     - [Integration tests parallelization](#integration-tests-parallelization)
 
+# v22.0
+
+This release has been tracked through the [v21.0
+project](https://github.com/cloud-hypervisor/cloud-hypervisor/projects/24).
+
+### GDB Debug Stub Support
+
+Cloud Hypervisor can now be used as debug target with GDB. This is controlled
+by the `gdb` compile time feature and details of how to use it can be found in
+the [gdb
+documentation](https://github.com/cloud-hypervisor/cloud-hypervisor/blob/main/docs/gdb.md).
+
+
+### `virtio-iommu` Backed Segments
+
+In order to facilitate hotplug devices that require being behind an IOMMU (e.g.
+QAT) there is a new option `--platform iommu_segments=<list_of_segments>` that
+will place all the specified segments behind the IOMMU.
+
+### Before Boot Configuration Changes
+
+It is now possible to change the VM configuration (e.g. add or remove devices,
+resize) before the VM is booted.
+
+
+### `virtio-balloon` Free Page Reporting
+
+If `--balloon free_page_reporting=on` is used then the guest can report pages
+that is it not using to the VMM. The VMM will then notify the host OS that
+those pages are no longer in use and can be freed. This can result in improved
+memory density.
+
+### Support for Direct Kernel Booting with TDX
+
+Through the use of `TD-Shim` lightweight firmware it is now possible to
+directly boot into the kernel with TDX. The [TDX
+documentation](https://github.com/cloud-hypervisor/cloud-hypervisor/blob/main/docs/intel_tdx.md#tdshim)
+has been updated for this usage.
+
+### PMU Support for AArch64
+
+A PMU is now available on AArch64 for guest performance profiling. This will be
+exposed automatically if available from the host.
+
+### Documentation Under CC-BY-4.0 Licese
+
+The documentation is now licensed under the "Creative Commons Attribution 4.0
+International" license which is aligned with the project charter under the
+Linux Foundation.
+
+### Deprecation of "Classic" `virtiofsd`
+
+The use of the Rust based [virtiofsd](https://gitlab.com/virtio-fs/virtiofsd)
+is now recommended and we are no longer testing against the C based "classic"
+version.
+
+### Notable Bug Fixes
+
+* Can now be used on kernels without `AF_INET` support (#3785)
+* `virtio-balloon` size is now validated against guest RAM size (#3689)
+* Ensure that I/O related KVM VM Exits are correctly handled (#3677)
+* Multiple TAP file descriptors can be used for `virtio-net` device hotplug (#3607)
+* Minor API improvements and fixes (#3756, #3766, #3647, #3578)
+* Fix sporadic seccomp violation from glibc memory freeing (#3610, #3609)
+* Fix Windows 11 on AArch64 due to wider MSI-X register accesses (#3714, #3720)
+* Ensure `vhost-user` features are correct across migration (#3737)
+* Improved vCPU topology on AArch64 (#3735, #3733)
+
+### Contributors
+
+Many thanks to everyone who has contributed to our release:
+
+* Akira Moroo <retrage01@gmail.com>
+* Barret Rhoden <brho@google.com>
+* Bo Chen <chen.bo@intel.com>
+* Fabiano Fidêncio <fabiano.fidencio@intel.com>
+* Feng Ye <yefeng@smartx.com>
+* Henry Wang <Henry.Wang@arm.com>
+* Jianyong Wu <jianyong.wu@arm.com>
+* lizhaoxin1 <Lxiaoyouling@163.com>
+* Michael Zhao <michael.zhao@arm.com>
+* Rob Bradford <robert.bradford@intel.com>
+* Sebastien Boeuf <sebastien.boeuf@intel.com>
+* Wei Liu <liuwe@microsoft.com>
+
 # v21.0
 
 This release has been tracked through the [v21.0
@@ -190,11 +286,16 @@ project](https://github.com/cloud-hypervisor/cloud-hypervisor/projects/24).
 
 ### Efficient Local Live Migration (for Live Upgrade)
 
-In order to support fast live upgrade of the VMM an optimised path has been added in which the memory for the VM is not compared from source to destination. This is activated by passing `--local` to the `ch-remote send-migration` command. This means that the live upgrade can complete in the order of 50ms vs 3s. (#3566)
+In order to support fast live upgrade of the VMM an optimised path has been
+added in which the memory for the VM is not compared from source to
+destination. This is activated by passing `--local` to the `ch-remote
+send-migration` command. This means that the live upgrade can complete in the
+order of 50ms vs 3s. (#3566)
 
 ### Recommended Kernel is Now 5.15
 
-Due to an issue in the `virtio-net` code in 5.14 the recommended Linux kernel is now 5.15. (#3530)
+Due to an issue in the `virtio-net` code in 5.14 the recommended Linux kernel
+is now 5.15. (#3530)
 
 ### Notable Bug fixes
 

rpm/cloud-hypervisor.spec

@@ -9,7 +9,7 @@
 
 Name:           cloud-hypervisor
 Summary:        Cloud Hypervisor is an open source Virtual Machine Monitor (VMM) that runs on top of KVM.
-Version:        21.0
+Version:        22.0
 Release:        0%{?dist}
 License:        ASL 2.0 or BSD-3-clause
 Group:          Applications/System
@@ -112,6 +112,9 @@ rm -rf %{buildroot}
 
 
 %changelog
+*   Thu Mar 03 2022 Rob Bradford <robert.bradford@intel.com> 22.0-0
+-   Update to 22.0
+
 *   Thu Jan 20 2022 Rob Bradford <robert.bradford@intel.com> 21.0-0
 -   Update to 21.0
 

vm-migration/src/lib.rs

@@ -15,7 +15,7 @@ use versionize::{VersionMap, Versionize};
 pub mod protocol;
 
 /// Global VMM version for versioning
-const MAJOR_VERSION: u16 = 21;
+const MAJOR_VERSION: u16 = 22;
 const MINOR_VERSION: u16 = 0;
 const VMM_VERSION: u16 = MAJOR_VERSION << 12 | MINOR_VERSION & 0b1111;