From 5e702dcd5e28503d7e556ae84802a10d6acb70d1 Mon Sep 17 00:00:00 2001 From: Bo Chen Date: Wed, 13 Dec 2023 18:00:07 -0800 Subject: [PATCH] build: Release v37.0 Signed-off-by: Bo Chen --- Cargo.lock | 2 +- Cargo.toml | 2 +- release-notes.md | 188 +++++++++++++++++++++++++++------------- vm-migration/src/lib.rs | 2 +- 4 files changed, 132 insertions(+), 62 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index ce8b17f6b..52afc0d15 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -436,7 +436,7 @@ checksum = "702fc72eb24e5a1e48ce58027a675bc24edd52096d5397d4aea7c6dd9eca0bd1" [[package]] name = "cloud-hypervisor" -version = "36.0.0" +version = "37.0.0" dependencies = [ "anyhow", "api_client", diff --git a/Cargo.toml b/Cargo.toml index e0cafcdb5..ceb1fc679 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "cloud-hypervisor" -version = "36.0.0" +version = "37.0.0" authors = ["The Cloud Hypervisor Authors"] edition = "2021" default-run = "cloud-hypervisor" diff --git a/release-notes.md b/release-notes.md index 456b84c39..39a55590d 100644 --- a/release-notes.md +++ b/release-notes.md @@ -1,3 +1,11 @@ +- [v37.0](#v370) + - [Long Term Support (LTS) Release](#long-term-support-lts-release) + - [Improved VFIO Device Passthrough with Multiple PCI Segments](#improved-vfio-device-passthrough-with-multiple-pci-segments) + - [Configurable Named TAP Devices](#configurable-named-tap-devices) + - [TTY Output from Both Serial Device and Virtio Console](#tty-output-from-both-serial-device-and-virtio-console) + - [Faster VM Restoration from Snapshots](#faster-vm-restoration-from-snapshots) + - [Notable Bug Fixes](#notable-bug-fixes) + - [Contributors](#contributors) - [v36.0](#v360) - [Command Line Changes](#command-line-changes) - [Enabled Features Reported via API Endpoint and CLI](#enabled-features-reported-via-api-endpoint-and-cli) @@ -6,31 +14,31 @@ - [Unix Socket Backend for Serial Port](#unix-socket-backend-for-serial-port) - [AIO Backend for Block Devices](#aio-backend-for-block-devices) - [Documentation Improvements](#documentation-improvements) - - [Notable Bug Fixes](#notable-bug-fixes) - - [Contributors](#contributors) + - [Notable Bug Fixes](#notable-bug-fixes-1) + - [Contributors](#contributors-1) - [v35.0](#v350) - [`virtio-vsock` Support for Linux Guest Kernel v6.3+](#virtio-vsock-support-for-linux-guest-kernel-v63) - [User Specified Serial Number for `virtio-block`](#user-specified-serial-number-for-virtio-block) - [vCPU TSC Frequency Included in Migration State](#vcpu-tsc-frequency-included-in-migration-state) - - [Notable Bug Fixes](#notable-bug-fixes-1) - - [Contributors](#contributors-1) + - [Notable Bug Fixes](#notable-bug-fixes-2) + - [Contributors](#contributors-2) - [v34.0](#v340) - [Paravirtualised Panic Device Support](#paravirtualised-panic-device-support) - [Improvements to VM Core Dump](#improvements-to-vm-core-dump) - [QCOW2 Support for Backing Files](#qcow2-support-for-backing-files) - [Minimum Host Kernel Bump](#minimum-host-kernel-bump) - - [Notable Bug Fixes](#notable-bug-fixes-2) - - [Contributors](#contributors-2) + - [Notable Bug Fixes](#notable-bug-fixes-3) + - [Contributors](#contributors-3) - [v33.0](#v330) - [D-Bus based API](#d-bus-based-api) - [Expose Host CPU Cache Details for AArch64](#expose-host-cpu-cache-details-for-aarch64) - - [Notable Bug Fixes](#notable-bug-fixes-3) - - [Contributors](#contributors-3) + - [Notable Bug Fixes](#notable-bug-fixes-4) + - [Contributors](#contributors-4) - [v32.0](#v320) - [Increased PCI Segment Limit](#increased-pci-segment-limit) - [API Changes](#api-changes) - - [Notable Bug Fixes](#notable-bug-fixes-4) - - [Contributors](#contributors-4) + - [Notable Bug Fixes](#notable-bug-fixes-5) + - [Contributors](#contributors-5) - [v31.1](#v311) - [v31.0](#v310) - [Update to Latest `acpi_tables`](#update-to-latest-acpi_tables) @@ -38,15 +46,15 @@ - [Improvements on Console `SIGWINCH` Handler](#improvements-on-console-sigwinch-handler) - [Remove Directory Support from `MemoryZoneConfig::file`](#remove-directory-support-from-memoryzoneconfigfile) - [Documentation Improvements](#documentation-improvements-1) - - [Notable Bug Fixes](#notable-bug-fixes-5) - - [Contributors](#contributors-5) + - [Notable Bug Fixes](#notable-bug-fixes-6) + - [Contributors](#contributors-6) - [v30.0](#v300) - [Command Line Changes for Reduced Binary Size](#command-line-changes-for-reduced-binary-size) - [Basic vfio-user Server Support](#basic-vfio-user-server-support) - [Heap Profiling Support](#heap-profiling-support) - [Documentation Improvements](#documentation-improvements-2) - - [Notable Bug Fixes](#notable-bug-fixes-6) - - [Contributors](#contributors-6) + - [Notable Bug Fixes](#notable-bug-fixes-7) + - [Contributors](#contributors-7) - [v28.2](#v282) - [v29.0](#v290) - [Release Binary Supports Both MSHV and KVM](#release-binary-supports-both-mshv-and-kvm) @@ -56,20 +64,20 @@ - [`AArch64` Documentation Integration](#aarch64-documentation-integration) - [`virtio-block` Counters Enhancement](#virtio-block-counters-enhancement) - [TCP Offload Control](#tcp-offload-control) - - [Notable Bug Fixes](#notable-bug-fixes-7) + - [Notable Bug Fixes](#notable-bug-fixes-8) - [Removals](#removals) - [Deprecations](#deprecations) - - [Contributors](#contributors-7) + - [Contributors](#contributors-8) - [v28.1](#v281) - [v28.0](#v280) - [Community Engagement (Reminder)](#community-engagement-reminder) - - [Long Term Support (LTS) Release](#long-term-support-lts-release) + - [Long Term Support (LTS) Release](#long-term-support-lts-release-1) - [Virtualised TPM Support](#virtualised-tpm-support) - [Transparent Huge Page Support](#transparent-huge-page-support) - [README Quick Start Improved](#readme-quick-start-improved) - - [Notable Bug Fixes](#notable-bug-fixes-8) + - [Notable Bug Fixes](#notable-bug-fixes-9) - [Removals](#removals-1) - - [Contributors](#contributors-8) + - [Contributors](#contributors-9) - [v27.0](#v270) - [Community Engagement](#community-engagement) - [Prebuilt Packages](#prebuilt-packages) @@ -78,41 +86,41 @@ - [Simplified Build Feature Flags](#simplified-build-feature-flags) - [Asynchronous Kernel Loading](#asynchronous-kernel-loading) - [GDB Support for AArch64](#gdb-support-for-aarch64) - - [Notable Bug Fixes](#notable-bug-fixes-9) + - [Notable Bug Fixes](#notable-bug-fixes-10) - [Deprecations](#deprecations-1) - - [Contributors](#contributors-9) + - [Contributors](#contributors-10) - [v26.0](#v260) - [SMBIOS Improvements via `--platform`](#smbios-improvements-via---platform) - [Unified Binary MSHV and KVM Support](#unified-binary-mshv-and-kvm-support) - - [Notable Bug Fixes](#notable-bug-fixes-10) + - [Notable Bug Fixes](#notable-bug-fixes-11) - [Deprecations](#deprecations-2) - [Removals](#removals-2) - - [Contributors](#contributors-10) + - [Contributors](#contributors-11) - [v25.0](#v250) - [`ch-remote` Improvements](#ch-remote-improvements-1) - [VM "Coredump" Support](#vm-coredump-support) - - [Notable Bug Fixes](#notable-bug-fixes-11) + - [Notable Bug Fixes](#notable-bug-fixes-12) - [Removals](#removals-3) - - [Contributors](#contributors-11) + - [Contributors](#contributors-12) - [v24.0](#v240) - [Bypass Mode for `virtio-iommu`](#bypass-mode-for-virtio-iommu) - [Ensure Identifiers Uniqueness](#ensure-identifiers-uniqueness) - [Sparse Mmap support](#sparse-mmap-support) - [Expose Platform Serial Number](#expose-platform-serial-number) - - [Notable Bug Fixes](#notable-bug-fixes-12) + - [Notable Bug Fixes](#notable-bug-fixes-13) - [Notable Improvements](#notable-improvements) - [Deprecations](#deprecations-3) - [New on the Website](#new-on-the-website) - - [Contributors](#contributors-12) + - [Contributors](#contributors-13) - [v23.1](#v231) - [v23.0](#v230) - [vDPA Support](#vdpa-support) - [Updated OS Support list](#updated-os-support-list) - [`AArch64` Memory Map Improvements](#aarch64-memory-map-improvements) - [`AMX` Support](#amx-support) - - [Notable Bug Fixes](#notable-bug-fixes-13) + - [Notable Bug Fixes](#notable-bug-fixes-14) - [Deprecations](#deprecations-4) - - [Contributors](#contributors-13) + - [Contributors](#contributors-14) - [v22.1](#v221) - [v22.0](#v220) - [GDB Debug Stub Support](#gdb-debug-stub-support) @@ -123,13 +131,13 @@ - [PMU Support for AArch64](#pmu-support-for-aarch64) - [Documentation Under CC-BY-4.0 License](#documentation-under-cc-by-40-license) - [Deprecation of "Classic" `virtiofsd`](#deprecation-of-classic-virtiofsd) - - [Notable Bug Fixes](#notable-bug-fixes-14) - - [Contributors](#contributors-14) + - [Notable Bug Fixes](#notable-bug-fixes-15) + - [Contributors](#contributors-15) - [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-15) - - [Contributors](#contributors-15) + - [Notable Bug fixes](#notable-bug-fixes-16) + - [Contributors](#contributors-16) - [v20.2](#v202) - [v20.1](#v201) - [v20.0](#v200) @@ -138,8 +146,8 @@ - [Improved VFIO support](#improved-vfio-support) - [Safer code](#safer-code) - [Extended documentation](#extended-documentation) - - [Notable bug fixes](#notable-bug-fixes-16) - - [Contributors](#contributors-16) + - [Notable bug fixes](#notable-bug-fixes-17) + - [Contributors](#contributors-17) - [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) @@ -147,8 +155,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-17) - - [Contributors](#contributors-17) + - [Notable bug fixes](#notable-bug-fixes-18) + - [Contributors](#contributors-18) - [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) @@ -158,23 +166,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-18) - - [Contributors](#contributors-18) + - [Notable bug fixes](#notable-bug-fixes-19) + - [Contributors](#contributors-19) - [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-19) - - [Contributors](#contributors-19) + - [Notable bug fixes](#notable-bug-fixes-20) + - [Contributors](#contributors-20) - [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-20) + - [Notable bug fixes](#notable-bug-fixes-21) - [Removed functionality](#removed-functionality) - - [Contributors](#contributors-20) + - [Contributors](#contributors-21) - [v15.0](#v150) - [Version numbering and stability guarantees](#version-numbering-and-stability-guarantees) - [Network device rate limiting](#network-device-rate-limiting) @@ -182,7 +190,7 @@ - [`--api-socket` supports file descriptor parameter](#--api-socket-supports-file-descriptor-parameter) - [Bug fixes](#bug-fixes) - [Deprecations](#deprecations-5) - - [Contributors](#contributors-21) + - [Contributors](#contributors-22) - [v0.14.1](#v0141) - [v0.14.0](#v0140) - [Structured event monitoring](#structured-event-monitoring) @@ -192,7 +200,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-6) - - [Contributors](#contributors-22) + - [Contributors](#contributors-23) - [v0.13.0](#v0130) - [Wider VFIO device support](#wider-vfio-device-support) - [Improved huge page support](#improved-huge-page-support) @@ -200,13 +208,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-23) + - [Contributors](#contributors-24) - [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-24) + - [Contributors](#contributors-25) - [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) @@ -218,15 +226,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-21) - - [Contributors](#contributors-25) + - [Notable Bug Fixes](#notable-bug-fixes-22) + - [Contributors](#contributors-26) - [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-22) - - [Contributors](#contributors-26) + - [Notable Bug Fixes](#notable-bug-fixes-23) + - [Contributors](#contributors-27) - [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) @@ -239,17 +247,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-23) - - [Contributors](#contributors-27) + - [Notable Bug Fixes](#notable-bug-fixes-24) + - [Contributors](#contributors-28) - [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-24) + - [Notable Bug Fixes](#notable-bug-fixes-25) - [Command Line and API Changes](#command-line-and-api-changes) - - [Contributors](#contributors-28) + - [Contributors](#contributors-29) - [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) @@ -259,14 +267,14 @@ - [`Seccomp` Sandboxing](#seccomp-sandboxing) - [Updated Distribution Support](#updated-distribution-support) - [Command Line and API Changes](#command-line-and-api-changes-1) - - [Contributors](#contributors-29) + - [Contributors](#contributors-30) - [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-30) + - [Contributors](#contributors-31) - [v0.5.1](#v051) - [v0.5.0](#v050) - [Virtual Machine Dynamic Resizing](#virtual-machine-dynamic-resizing) @@ -274,7 +282,7 @@ - [New Interrupt Management Framework](#new-interrupt-management-framework) - [Development Tools](#development-tools) - [Kata Containers Integration](#kata-containers-integration) - - [Contributors](#contributors-31) + - [Contributors](#contributors-32) - [v0.4.0](#v040) - [Dynamic virtual CPUs addition](#dynamic-virtual-cpus-addition) - [Programmatic firmware tables generation](#programmatic-firmware-tables-generation) @@ -283,7 +291,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-32) + - [Contributors](#contributors-33) - [v0.3.0](#v030) - [Block device offloading](#block-device-offloading) - [Network device backend](#network-device-backend) @@ -310,6 +318,68 @@ - [Unit testing](#unit-testing) - [Integration tests parallelization](#integration-tests-parallelization) +# v37.0 + +This release has been tracked in our [roadmap +project](https://github.com/orgs/cloud-hypervisor/projects/6) as iteration +v37.0. The following user visible changes have been made: + +### Long Term Support (LTS) Release + +This release is a LTS release. Point releases for bug fixes will be made +for the next 18 months; live migration and live upgrade will be +supported between the point releases of the LTS. + +### Multiple PCI segments Support for 32-bit VFIO devices + +Now VFIO devices with 32-bit memory BARs can be attached to non-zero PCI +segments on the guest, allowing users to have more 32-bit devices and +assign such devices to appropriate NUMA nodes for better performance. + +### Configurable Named TAP Devices + +Named TAP devices now accepts IP configuration from users, such as IP +and MAC address, as long as the named TAP device is created by Cloud +Hypervisor (e.g. not existing TAP devices). + +### TTY Output from Both Serial Device and Virtio Console + +Now legacy serial device and virtio console can be set as TTY mode as +the same time. This allows users to capture early boot logs with the +legacy serial device without losing performance benefits of using +virtio-console, when appropriate kernel configuration is used (such as +using kernel command-line `console=hvc0 earlyprintk=ttyS0` on x86). + +### Faster VM Restoration from Snapshots + +The speed of VM restoration from snapshots is improved with a better +implementation of deserializing JSON files. + +### Notable Bug Fixes + +* Fix aio backend behavior for block devices when writeback cache + disabled (#5930) +* Fix PvPanic device PCI BAR alignment (#5956) +* Bug fix to OpenAPI specification file (#5967) +* Error out early for live migration when TDX is enabled (#6025) + +### Contributors + +Many thanks to everyone who has contributed to our release: + +* Bo Chen +* Jinank Jain +* Markus Sütter +* Michael Zhao +* Muminul Islam +* Rob Bradford +* Rui Chang +* Ruslan Mstoi +* Thomas Barrett +* Wei Liu +* Yi Wang +* Yong He + # v36.0 This release has been tracked in our [roadmap diff --git a/vm-migration/src/lib.rs b/vm-migration/src/lib.rs index 85bc3d2eb..fc6398367 100644 --- a/vm-migration/src/lib.rs +++ b/vm-migration/src/lib.rs @@ -12,7 +12,7 @@ use versionize::{VersionMap, Versionize}; pub mod protocol; /// Global VMM version for versioning -const MAJOR_VERSION: u16 = 36; +const MAJOR_VERSION: u16 = 37; const MINOR_VERSION: u16 = 0; const VMM_VERSION: u16 = MAJOR_VERSION << 12 | MINOR_VERSION & 0b1111;