build: Release v23.1 (bug fix release)

Signed-off-by: Rob Bradford <robert.bradford@intel.com>
vmm: Add 'shutdown()' to vCPU seccomp filter
2026-08-05 02:19:16 +00:00 · 2022-05-09 14:54:18 +01:00 · 2022-05-09 14:54:18 +01:00 · 2022-05-09 14:54:18 +01:00 · 2022-05-09 14:54:18 +01:00 · 2022-05-09 14:54:18 +01:00
178 changed files with 11708 additions and 8634 deletions
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -4,7 +4,7 @@ updates:
  directory: "/"
  schedule:
    interval: daily
-  open-pull-requests-limit: 3
+  open-pull-requests-limit: 1
  allow:
  - dependency-type: direct
  - dependency-type: indirect
@@ -12,7 +12,7 @@ updates:
  directory: "/fuzz"
  schedule:
    interval: daily
-  open-pull-requests-limit: 3
+  open-pull-requests-limit: 1
  allow:
  - dependency-type: direct
  - dependency-type: indirect
--- a/.github/workflows/build.yaml
+++ b/.github/workflows/build.yaml
@@ -13,6 +13,7 @@ jobs:
          - stable
          - beta
          - nightly
+          - 1.56
        target:
          - x86_64-unknown-linux-gnu
          - x86_64-unknown-linux-musl
@@ -22,6 +23,9 @@ jobs:
        with:
          fetch-depth: 0

+      - name: Install musl-gcc
+        run: sudo apt install -y musl-tools
+
      - name: Install Rust toolchain (${{ matrix.rust }})
        uses: actions-rs/toolchain@v1
        with:
@@ -31,24 +35,27 @@ jobs:

      - name: Debug Check (default features)
        run: |
-          git rev-list origin/main..$GITHUB_SHA | xargs -t -I % sh -c 'git checkout %; cargo check --all --target=${{ matrix.target }}'
+          git rev-list origin/main..$GITHUB_SHA | xargs -t -I % sh -c 'git checkout %; cargo check --tests --all --target=${{ matrix.target }}'
          git checkout $GITHUB_SHA

-      - name: Build (default + tdx)
+      - name: Build (default features)
+        run: cargo rustc --bin cloud-hypervisor -- -D warnings
+
+      - name: Build (common + kvm)
+        run: cargo rustc --bin cloud-hypervisor --no-default-features --features "common,kvm"  -- -D warnings
+
+      - name: Build (default features + tdx)
        run: cargo rustc --bin cloud-hypervisor --features "tdx" -- -D warnings

-      - name: Build (acpi,kvm)
-        run: cargo rustc --bin cloud-hypervisor --no-default-features --features "acpi,kvm"  -- -D warnings
+      - name: Build (default features + amx)
+        run: cargo rustc --bin cloud-hypervisor --features "amx" -- -D warnings

-      - name: Build (kvm)
-        run: cargo rustc --bin cloud-hypervisor --no-default-features --features "kvm"  -- -D warnings
+      - name: Build (default features + gdb)
+        run: cargo rustc --bin cloud-hypervisor --features "gdb" -- -D warnings

-      - name: Build (acpi,mshv)
-        run: cargo rustc --bin cloud-hypervisor --no-default-features --features "acpi,mshv"  -- -D warnings
+      - name: Build (common + mshv)
+        run: cargo rustc --bin cloud-hypervisor --no-default-features --features "common,mshv"  -- -D warnings

-      - name: Build (mshv)
-        run: cargo rustc --bin cloud-hypervisor --no-default-features --features "mshv"  -- -D warnings
-        
      - name: Release Build (default features)
        run: cargo build --all --release --target=${{ matrix.target }}

--- a/.github/workflows/docker-image.yaml
+++ b/.github/workflows/docker-image.yaml
@@ -27,6 +27,17 @@ jobs:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}

+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v3
+        with:
+          # list of Docker images to use as base name for tags
+          images: cloudhypervisor/dev
+          # generate Docker tags based on the following events/attributes
+          tags: |
+            type=raw,value={{date 'YYYYMMDD'}}-0
+            type=sha
+
      - name: Build and push
        if: ${{ github.event_name == 'push' }}
        uses: docker/build-push-action@v2
@@ -34,7 +45,7 @@ jobs:
          file: ./resources/Dockerfile
          platforms: linux/amd64,linux/arm64
          push: true
-          tags: cloudhypervisor/dev:latest
+          tags: ${{ steps.meta.outputs.tags }}

      - name: Build only
        if: ${{ github.event_name == 'pull_request' }}
@@ -42,7 +53,7 @@ jobs:
        with:
          file: ./resources/Dockerfile
          platforms: linux/amd64,linux/arm64
-          tags: cloudhypervisor/dev:latest
+          tags: ${{ steps.meta.outputs.tags }}

      - name: Image digest
        run: echo ${{ steps.docker_build.outputs.digest }}
--- a/.github/workflows/quality-aarch64.yaml
+++ b/.github/workflows/quality-aarch64.yaml
@@ -32,30 +32,16 @@ jobs:
      - name: Formatting (rustfmt)
        run: cargo fmt -- --check

-      - name: Clippy (kvm)
+      - name: Clippy (common + kvm)
        uses: actions-rs/cargo@v1
        with:
          use-cross: true
          command: clippy
-          args: --target=${{ matrix.target }} --all --no-default-features --features "kvm" -- -D warnings
+          args: --target=${{ matrix.target }} --tests --all --no-default-features --features "common,kvm" -- -D warnings

-      - name: Clippy (kvm,acpi)
+      - name: Clippy (default features)
        uses: actions-rs/cargo@v1
        with:
          use-cross: true
          command: clippy
-          args: --target=${{ matrix.target }} --all --no-default-features --features "kvm,acpi" -- -D warnings
-
-      - name: Clippy (all features,kvm)
-        uses: actions-rs/cargo@v1
-        with:
-          use-cross: true
-          command: clippy
-          args: --target=${{ matrix.target }} --all --no-default-features --features "common,kvm" -- -D warnings
-
-      - name: Clippy (default)
-        uses: actions-rs/cargo@v1
-        with:
-          use-cross: true
-          command: clippy
-          args: --target=${{ matrix.target }} --all -- -D warnings
+          args: --target=${{ matrix.target }} --tests --all -- -D warnings
--- a/.github/workflows/quality.yaml
+++ b/.github/workflows/quality.yaml
@@ -33,29 +33,20 @@ jobs:
      - name: Formatting (rustfmt)
        run: cargo fmt -- --check

-      - name: Clippy (all features,kvm)
+      - name: Clippy (common + kvm)
        run: cargo clippy --all --all-targets --no-default-features --tests --features "common,kvm" -- -D warnings

-      - name: Clippy (all features,mshv)
-        run: cargo clippy --all --all-targets --no-default-features --tests --features "common,mshv" -- -D warnings
-
-      - name: Clippy (acpi,kvm)
-        run: cargo clippy --all --all-targets --no-default-features --tests --features "acpi,kvm" -- -D warnings
-
-      - name: Clippy (acpi,kvm,tdx)
-        run: cargo clippy --all --all-targets --no-default-features --tests --features "acpi,kvm,tdx" -- -D warnings
-
-      - name: Clippy (kvm)
-        run: cargo clippy --all --all-targets --no-default-features --tests --features "kvm" -- -D warnings
-
-      - name: Clippy (acpi,mshv)
-        run: cargo clippy --all --all-targets --no-default-features --tests --features "acpi,mshv" -- -D warnings
-
-      - name: Clippy (mshv)
-        run: cargo clippy --all --all-targets --no-default-features --tests --features "mshv" -- -D warnings
-
-      - name: Clippy (integration tests)
+      - name: Clippy (default features)
        run: cargo clippy --all --all-targets --tests -- -D warnings

+      - name: Clippy (default features + amx)
+        run: cargo clippy --all --all-targets --tests --features "amx" -- -D warnings
+
+      - name: Clippy (default features + gdb)
+        run: cargo clippy --all --all-targets --tests --features "gdb" -- -D warnings
+
+      - name: Clippy (common + mshv)
+        run: cargo clippy --all --all-targets --no-default-features --tests --features "common,mshv" -- -D warnings
+
      - name: Check build did not modify any files
        run: test -z "$(git status --porcelain)"
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -9,28 +9,38 @@ jobs:
    steps:
      - name: Code checkout
        uses: actions/checkout@v2
+      - name: Install musl-gcc
+        run: sudo apt install -y musl-tools      
      - name: Create release directory
        run: rsync -rv --exclude=.git . ../cloud-hypervisor-${{ github.event.ref }}
      - name: Install Rust toolchain (x86_64-unknown-linux-gnu)
        uses: actions-rs/toolchain@v1
        with:
-            toolchain: stable
+            toolchain: 1.58
            target: x86_64-unknown-linux-gnu
      - name: Install Rust toolchain (x86_64-unknown-linux-musl)
        uses: actions-rs/toolchain@v1
        with:
-            toolchain: stable
+            toolchain: 1.58
            target: x86_64-unknown-linux-musl
      - name: Build
-        run: cargo build --all --release --target=x86_64-unknown-linux-gnu
+        uses: actions-rs/cargo@v1
+        with:
+            toolchain: 1.58
+            command: build
+            args: --all --release --target=x86_64-unknown-linux-gnu
      - name: Static Build
-        run: cargo build --all --release --target=x86_64-unknown-linux-musl
+        uses: actions-rs/cargo@v1
+        with:
+            toolchain: 1.58
+            command: build
+            args: --all --release --target=x86_64-unknown-linux-musl
      - name: Strip cloud-hypervisor binaries
        run: strip target/*/release/cloud-hypervisor
      - name: Install Rust toolchain (aarch64-unknown-linux-musl)
        uses: actions-rs/toolchain@v1
        with:
-            toolchain: stable
+            toolchain: 1.58
            target: aarch64-unknown-linux-musl
            override: true
      - name: Static Build (AArch64)
--- a/.rustfmt.toml
+++ b/.rustfmt.toml
@@ -1 +1 @@
-edition = "2018"
+edition = "2021"
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -20,9 +20,9 @@ dependencies = [

 [[package]]
 name = "anyhow"
-version = "1.0.52"
+version = "1.0.56"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "84450d0b4a8bd1ba4144ce8ce718fbc5d071358b1e5384bace6536b3d1f2d5b3"
+checksum = "4361135be9122e0870de935d7c439aef945b9f9ddd4199a553b5270b49c82a27"

 [[package]]
 name = "api_client"
@@ -73,9 +73,9 @@ dependencies = [

 [[package]]
 name = "autocfg"
-version = "1.0.1"
+version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cdb031dd78e28731d87d56cc8ffef4a8f36ca26c38fe2de700543e627f8a464a"
+checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"

 [[package]]
 name = "bincode"
@@ -119,9 +119,9 @@ checksum = "14c189c53d098945499cdfa7ecc63567cf3886b3332b312a5b4585d8d3a6a610"

 [[package]]
 name = "cc"
-version = "1.0.72"
+version = "1.0.73"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "22a9137b95ea06864e018375b72adfb7db6e6f68cfc8df5a04d00288050485ee"
+checksum = "2fff2a6927b3bb87f9595d67196a70493f627687a71d87a0d692242c33f58c11"

 [[package]]
 name = "cfg-if"
@@ -131,9 +131,9 @@ checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"

 [[package]]
 name = "clap"
-version = "3.0.10"
+version = "3.1.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7a30c3bf9ff12dfe5dae53f0a96e0febcd18420d1c0e7fad77796d9d5c4b5375"
+checksum = "71c47df61d9e16dc010b55dba1952a57d8c215dbb533fd13cdd13369aac73b1c"
 dependencies = [
 "atty",
 "bitflags",
@@ -148,12 +148,12 @@ dependencies = [

 [[package]]
 name = "cloud-hypervisor"
-version = "21.0.0"
+version = "23.1.0"
 dependencies = [
 "anyhow",
 "api_client",
 "clap",
- "dirs 4.0.0",
+ "dirs",
 "epoll",
 "event_monitor",
 "hypervisor",
@@ -175,9 +175,9 @@ dependencies = [

 [[package]]
 name = "crc32c"
-version = "0.6.1"
+version = "0.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ee6b9c9389584bcba988bd0836086789b7f87ad91892d6a83d5291dbb24524b5"
+checksum = "3dfea2db42e9927a3845fb268a10a72faed6d416065f77873f05e411457c363e"
 dependencies = [
 "rustc_version",
 ]
@@ -208,15 +208,6 @@ dependencies = [
 "vmm-sys-util",
 ]

-[[package]]
-name = "dirs"
-version = "3.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "30baa043103c9d0c2a57cf537cc2f35623889dc0d405e6c3cccfadbc81c71309"
-dependencies = [
- "dirs-sys",
-]
-
 [[package]]
 name = "dirs"
 version = "4.0.0"
@@ -228,9 +219,9 @@ dependencies = [

 [[package]]
 name = "dirs-sys"
-version = "0.3.6"
+version = "0.3.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "03d86534ed367a67548dc68113a0f5db55432fdfbb6e6f9d77704397d95d5780"
+checksum = "1b1d1d91c932ef41c0f2663aa8b0ca0342d444d842c06914aa0a7e352d0bada6"
 dependencies = [
 "libc",
 "redox_users",
@@ -277,10 +268,34 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b643857cf70949306b81d7e92cb9d47add673868edac9863c4a49c42feaf3f1e"

 [[package]]
-name = "getrandom"
-version = "0.2.4"
+name = "gdbstub"
+version = "0.6.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "418d37c8b1d42553c93648be529cb70f920d3baf8ef469b74b9638df426e0b4c"
+checksum = "9fa2ca5d6b045de372cef3991f873389b421b4cabcfbe52f7787fae8b8b37906"
+dependencies = [
+ "bitflags",
+ "cfg-if",
+ "log",
+ "managed",
+ "num-traits",
+ "paste",
+]
+
+[[package]]
+name = "gdbstub_arch"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "51dc4b5718ac76d21e8605c0966dd32d80273b89b11e6cfef467b04e45934d37"
+dependencies = [
+ "gdbstub",
+ "num-traits",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9be70c98951c83b8d2f8f60d7065fa6d5146873094452a1008da8c2f1e4205ad"
 dependencies = [
 "cfg-if",
 "libc",
@@ -338,9 +353,9 @@ dependencies = [

 [[package]]
 name = "iced-x86"
-version = "1.15.0"
+version = "1.17.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "46e977036f7f5139d580c7f19ad62df9cb8ebd8410bb569e73585226be80a86f"
+checksum = "158f5204401d08f91d19176112146d75e99b3cf745092e268fa7be33e09adcec"
 dependencies = [
 "lazy_static",
 "static_assertions",
@@ -348,9 +363,9 @@ dependencies = [

 [[package]]
 name = "indexmap"
-version = "1.8.0"
+version = "1.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "282a6247722caba404c065016bbfa522806e51714c34f5dfc3e4a3a46fcb4223"
+checksum = "0f647032dfaa1f8b6dc29bd3edb7bbef4861b8b8007ebb118d6db284fd59f6ee"
 dependencies = [
 "autocfg",
 "hashbrown",
@@ -393,7 +408,7 @@ checksum = "1aab8fc367588b89dcee83ab0fd66b72b50b72fa1904d7095045ace2b0c81c35"
 [[package]]
 name = "kvm-bindings"
 version = "0.5.0"
-source = "git+https://github.com/cloud-hypervisor/kvm-bindings?branch=ch-v0.5.0#9c497710ba9968d8efe15dbae03991b16cf82e23"
+source = "git+https://github.com/cloud-hypervisor/kvm-bindings?branch=ch-v0.5.0-tdx#52e56d0e8ef0f6ea32fc0492e6a175b73617a49f"
 dependencies = [
 "serde",
 "serde_derive",
@@ -403,7 +418,7 @@ dependencies = [
 [[package]]
 name = "kvm-ioctls"
 version = "0.11.0"
-source = "git+https://github.com/rust-vmm/kvm-ioctls?branch=main#d22ef1f51852dfb055da38004e1a4fed81246f81"
+source = "git+https://github.com/rust-vmm/kvm-ioctls?branch=main#1e03e29cdfbb0cb108a98de7a78045a5a517f18e"
 dependencies = [
 "kvm-bindings",
 "libc",
@@ -418,9 +433,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"

 [[package]]
 name = "libc"
-version = "0.2.112"
+version = "0.2.123"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b03d17f364a3a042d5e5d46b053bbbf82c92c9430c592dd4c064dc6ee997125"
+checksum = "cb691a747a7ab48abc15c5b42066eaafde10dc427e3b6ee2a1cf43db04c763bd"

 [[package]]
 name = "libssh2-sys"
@@ -438,9 +453,9 @@ dependencies = [

 [[package]]
 name = "libz-sys"
-version = "1.1.3"
+version = "1.1.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "de5435b8549c16d423ed0c03dbaafe57cf6c3344744f1242520d59c9d8ecec66"
+checksum = "6f35facd4a5673cb5a48822be2be1d4236c1c99cb4113cab7061ac720d5bf859"
 dependencies = [
 "cc",
 "libc",
@@ -459,41 +474,39 @@ dependencies = [

 [[package]]
 name = "lock_api"
-version = "0.4.5"
+version = "0.4.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "712a4d093c9976e24e7dbca41db895dabcbac38eb5f4045393d17a95bdfb1109"
+checksum = "327fa5b6a6940e4699ec49a9beae1ea4845c6bab9314e4f84ac68742139d8c53"
 dependencies = [
+ "autocfg",
 "scopeguard",
 ]

 [[package]]
 name = "log"
-version = "0.4.14"
+version = "0.4.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "51b9bbe6c47d51fc3e1a9b945965946b4c44142ab8792c50835a980d362c2710"
+checksum = "6389c490849ff5bc16be905ae24bc913a9c8892e19b2341dbc175e14c341c2b8"
 dependencies = [
 "cfg-if",
 ]

+[[package]]
+name = "managed"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ca88d725a0a943b096803bd34e73a4437208b6077654cc4ecb2947a5f91618d"
+
 [[package]]
 name = "memchr"
 version = "2.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "308cc39be01b73d0d18f82a0e7b2a3df85245f84af96fdddc5d202d27e47b86a"

-[[package]]
-name = "memoffset"
-version = "0.6.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5aa361d4faea93603064a027415f07bd8e1d5c88c9fbf68bf56a285428fd79ce"
-dependencies = [
- "autocfg",
-]
-
 [[package]]
 name = "micro_http"
 version = "0.1.0"
-source = "git+https://github.com/firecracker-microvm/micro-http?branch=main#0a58eb1ece68e326e68365c4297d0a7c08ecd9bc"
+source = "git+https://github.com/firecracker-microvm/micro-http?branch=main#a730d86940081ad044cdfbc1285c1db6d3048392"
 dependencies = [
 "libc",
 "vmm-sys-util",
@@ -502,7 +515,7 @@ dependencies = [
 [[package]]
 name = "mshv-bindings"
 version = "0.1.0"
-source = "git+https://github.com/rust-vmm/mshv?branch=main#b8b69b655337292037219ab765d2c94c565a076e"
+source = "git+https://github.com/rust-vmm/mshv?branch=main#75cf309d566c3d9ba91e81582a7864032ecc5bbb"
 dependencies = [
 "libc",
 "serde",
@@ -514,7 +527,7 @@ dependencies = [
 [[package]]
 name = "mshv-ioctls"
 version = "0.1.0"
-source = "git+https://github.com/rust-vmm/mshv?branch=main#b8b69b655337292037219ab765d2c94c565a076e"
+source = "git+https://github.com/rust-vmm/mshv?branch=main#75cf309d566c3d9ba91e81582a7864032ecc5bbb"
 dependencies = [
 "libc",
 "mshv-bindings",
@@ -551,6 +564,24 @@ dependencies = [
 "vmm-sys-util",
 ]

+[[package]]
+name = "num-traits"
+version = "0.2.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a64b1ec5cda2586e284722486d802acf1f7dbdc623e2bfc57e65ca1cd099290"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "openssl-src"
+version = "111.18.0+1.1.1n"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7897a926e1e8d00219127dc020130eca4292e5ca666dd592480d72c3eca2ff6c"
+dependencies = [
+ "cc",
+]
+
 [[package]]
 name = "openssl-sys"
 version = "0.9.72"
@@ -560,6 +591,7 @@ dependencies = [
 "autocfg",
 "cc",
 "libc",
+ "openssl-src",
 "pkg-config",
 "vcpkg",
 ]
@@ -602,6 +634,12 @@ dependencies = [
 "winapi",
 ]

+[[package]]
+name = "paste"
+version = "1.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c520e05135d6e763148b6426a837e239041653ba7becd2e538c076c738025fc"
+
 [[package]]
 name = "pci"
 version = "0.1.0"
@@ -611,6 +649,8 @@ dependencies = [
 "hypervisor",
 "libc",
 "log",
+ "serde",
+ "serde_derive",
 "thiserror",
 "versionize",
 "versionize_derive",
@@ -624,11 +664,25 @@ dependencies = [
 "vmm-sys-util",
 ]

+[[package]]
+name = "performance-metrics"
+version = "0.1.0"
+dependencies = [
+ "clap",
+ "dirs",
+ "serde",
+ "serde_derive",
+ "serde_json",
+ "test_infra",
+ "thiserror",
+ "wait-timeout",
+]
+
 [[package]]
 name = "pkg-config"
-version = "0.3.24"
+version = "0.3.25"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "58893f751c9b0412871a09abd62ecd2a00298c6c83befa223ef98c52aef40cbe"
+checksum = "1df8c4ec4b0627e53bdf214615ad287367e482558cf84b109250b37464dc03ae"

 [[package]]
 name = "pnet"
@@ -720,9 +774,9 @@ dependencies = [

 [[package]]
 name = "proc-macro2"
-version = "1.0.36"
+version = "1.0.37"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c7342d5883fbccae1cc37a2353b09c87c9b0f3afd73f5fb9bba687a1f733b029"
+checksum = "ec757218438d5fda206afc041538b2f6d889286160d649a86a24d37e1235afd1"
 dependencies = [
 "unicode-xid",
 ]
@@ -740,9 +794,9 @@ dependencies = [

 [[package]]
 name = "quote"
-version = "1.0.14"
+version = "1.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "47aa80447ce4daf1717500037052af176af5d38cc3e571d9ec1c7353fc10c87d"
+checksum = "a1feb54ed693b93a84e14094943b84b7c4eae204c512b7ccb95ab0c66d278ad1"
 dependencies = [
 "proc-macro2",
 ]
@@ -758,28 +812,29 @@ dependencies = [

 [[package]]
 name = "redox_syscall"
-version = "0.2.10"
+version = "0.2.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8383f39639269cde97d255a32bdb68c047337295414940c68bdd30c2e13203ff"
+checksum = "62f25bc4c7e55e0b0b7a1d43fb893f4fa1361d0abe38b9ce4f323c2adfe6ef42"
 dependencies = [
 "bitflags",
 ]

 [[package]]
 name = "redox_users"
-version = "0.4.0"
+version = "0.4.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "528532f3d801c87aec9def2add9ca802fe569e44a544afe633765267840abe64"
+checksum = "b033d837a7cf162d7993aded9304e30a83213c648b6e389db233191f891e5c2b"
 dependencies = [
 "getrandom",
 "redox_syscall",
+ "thiserror",
 ]

 [[package]]
 name = "regex"
-version = "1.5.4"
+version = "1.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d07a8629359eb56f1e2fb1652bb04212c072a87ba68546a04065d525673ac461"
+checksum = "1a11647b6b25ff05a515cb92c365cec08801e83423a235b51e231e1808747286"
 dependencies = [
 "aho-corasick",
 "memchr",
@@ -835,21 +890,21 @@ dependencies = [

 [[package]]
 name = "semver"
-version = "1.0.4"
+version = "1.0.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "568a8e6258aa33c13358f81fd834adb854c6f7c9468520910a9b1e8fac068012"
+checksum = "d65bd28f48be7196d222d95b9243287f48d27aca604e08497513019ff0502cc4"

 [[package]]
 name = "serde"
-version = "1.0.133"
+version = "1.0.136"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97565067517b60e2d1ea8b268e59ce036de907ac523ad83a0475da04e818989a"
+checksum = "ce31e24b01e1e524df96f1c2fdd054405f8d7376249a5110886fb4b658484789"

 [[package]]
 name = "serde_derive"
-version = "1.0.133"
+version = "1.0.136"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed201699328568d8d08208fdd080e3ff594e6c422e438b6705905da01005d537"
+checksum = "08597e7152fcd306f41838ed3e37be9eaeed2b61c42e2117266a554fab4662f9"
 dependencies = [
 "proc-macro2",
 "quote",
@@ -858,9 +913,9 @@ dependencies = [

 [[package]]
 name = "serde_json"
-version = "1.0.75"
+version = "1.0.79"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c059c05b48c5c0067d4b4b2b4f0732dd65feb52daf7e0ea09cd87e7dadc1af79"
+checksum = "8e8d9fa5c3b304765ce1fd9c4c8a3de2c8db365a5b91be52f186efc675681d95"
 dependencies = [
 "itoa",
 "ryu",
@@ -918,9 +973,9 @@ checksum = "73473c0e59e6d5812c5dfe2a064a6444949f089e20eec9a2e5506596494e4623"

 [[package]]
 name = "syn"
-version = "1.0.85"
+version = "1.0.91"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a684ac3dcd8913827e18cd09a68384ee66c1de24157e3c556c9ab16d85695fb7"
+checksum = "b683b2b825c8eef438b77c36a06dc262294da3d5a5813fac20da149241dcd44d"
 dependencies = [
 "proc-macro2",
 "quote",
@@ -941,9 +996,9 @@ dependencies = [

 [[package]]
 name = "termcolor"
-version = "1.1.2"
+version = "1.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2dfed899f0eb03f32ee8c6a0aabdb8a7949659e3466561fc0adf54e26d88c5f4"
+checksum = "bab24d30b911b2376f3a13cc2cd443142f0c81dda04c118693e35b3835757755"
 dependencies = [
 "winapi-util",
 ]
@@ -962,8 +1017,9 @@ dependencies = [
 name = "test_infra"
 version = "0.1.0"
 dependencies = [
- "dirs 3.0.2",
+ "dirs",
 "epoll",
+ "lazy_static",
 "libc",
 "ssh2",
 "vmm-sys-util",
@@ -972,9 +1028,9 @@ dependencies = [

 [[package]]
 name = "textwrap"
-version = "0.14.2"
+version = "0.15.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0066c8d12af8b5acd21e00547c3797fde4e8677254a7ee429176ccebbe93dd80"
+checksum = "b1141d4d61095b28419e22cb0bbf02755f5e54e0526f97f1e3d1d160e60885fb"
 dependencies = [
 "terminal_size",
 ]
@@ -1059,7 +1115,7 @@ dependencies = [
 [[package]]
 name = "vfio-ioctls"
 version = "0.1.0"
-source = "git+https://github.com/rust-vmm/vfio-ioctls?branch=main#19e5b83ddfad430109ce3e8d51f4a24796099127"
+source = "git+https://github.com/rust-vmm/vfio?branch=main#f75a77c1ab6349c105bc1462a65508726b4c2e0f"
 dependencies = [
 "byteorder",
 "kvm-bindings",
@@ -1106,9 +1162,9 @@ dependencies = [

 [[package]]
 name = "vhost"
-version = "0.3.0"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b56bf8f178fc500fe14505fca8b00dec76fc38f2304f461c8d9d7547982311d"
+checksum = "53567fd9ab820e4f3cc156f24146882fee3c365194c3e1dea74723265f27fc88"
 dependencies = [
 "bitflags",
 "libc",
@@ -1117,17 +1173,17 @@ dependencies = [
 ]

 [[package]]
-name = "vhost_user_backend"
-version = "0.1.0"
+name = "vhost-user-backend"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1490f2028d4f119b2292efe218b5f8cfc6471f039b53b6a6eb5d9513e964facc"
 dependencies = [
- "epoll",
 "libc",
 "log",
 "vhost",
 "virtio-bindings",
 "virtio-queue",
 "vm-memory",
- "vm-virtio",
 "vmm-sys-util",
 ]

@@ -1144,7 +1200,7 @@ dependencies = [
 "option_parser",
 "qcow",
 "vhost",
- "vhost_user_backend",
+ "vhost-user-backend",
 "virtio-bindings",
 "vm-memory",
 "vmm-sys-util",
@@ -1162,7 +1218,7 @@ dependencies = [
 "net_util",
 "option_parser",
 "vhost",
- "vhost_user_backend",
+ "vhost-user-backend",
 "virtio-bindings",
 "vm-memory",
 "vmm-sys-util",
@@ -1195,6 +1251,7 @@ dependencies = [
 "serde",
 "serde_derive",
 "serde_json",
+ "thiserror",
 "versionize",
 "versionize_derive",
 "vhost",
@@ -1210,10 +1267,11 @@ dependencies = [

 [[package]]
 name = "virtio-queue"
-version = "0.1.0"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3785325315e6496fa88673842ee6cd198b9658e88e8b0e1ad48a5dc818b221dc"
 dependencies = [
 "log",
- "memoffset",
 "vm-memory",
 "vmm-sys-util",
 ]
@@ -1244,7 +1302,7 @@ dependencies = [
 [[package]]
 name = "vm-fdt"
 version = "0.2.0"
-source = "git+https://github.com/rust-vmm/vm-fdt?branch=main#9cfa0c8d7c3032f79589c7b01c8722a37f4cf44f"
+source = "git+https://github.com/rust-vmm/vm-fdt?branch=main#ca35d96191f8232bd7ab8c3e72ec925bf04bd2e0"

 [[package]]
 name = "vm-memory"
@@ -1295,6 +1353,8 @@ dependencies = [
 "devices",
 "epoll",
 "event_monitor",
+ "gdbstub",
+ "gdbstub_arch",
 "hypervisor",
 "lazy_static",
 "libc",
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,29 +1,32 @@
 [package]
 name = "cloud-hypervisor"
-version = "21.0.0"
+version = "23.1.0"
 authors = ["The Cloud Hypervisor Authors"]
-edition = "2018"
+edition = "2021"
 default-run = "cloud-hypervisor"
 build = "build.rs"
 license = "LICENSE-APACHE & LICENSE-BSD-3-Clause"
 description = "Open source Virtual Machine Monitor (VMM) that runs on top of KVM"
 homepage = "https://github.com/cloud-hypervisor/cloud-hypervisor"
+# Minimum buildable version:
+# Keep in sync with version in .github/workflows/build.yaml
+rust-version = "1.56"

 [profile.release]
 lto = true

 [dependencies]
-anyhow = "1.0.52"
+anyhow = "1.0.56"
 api_client = { path = "api_client" }
-clap = { version = "3.0.10", features = ["wrap_help","cargo"] }
+clap = { version = "3.1.8", features = ["wrap_help","cargo"] }
 epoll = "4.3.1"
 event_monitor = { path = "event_monitor" }
 hypervisor = { path = "hypervisor" }
-libc = "0.2.112"
-log = { version = "0.4.14", features = ["std"] }
+libc = "0.2.123"
+log = { version = "0.4.16", features = ["std"] }
 option_parser = { path = "option_parser" }
 seccompiler = "0.2.0"
-serde_json = "1.0.75"
+serde_json = "1.0.79"
 signal-hook = "0.3.13"
 thiserror = "1.0.30"
 vmm = { path = "vmm" }
@@ -31,11 +34,11 @@ vmm-sys-util = "0.9.0"
 vm-memory = "0.7.0"

 [build-dependencies]
-clap = { version = "3.0.10", features = ["wrap_help"] }
+clap = { version = "3.1.8", features = ["cargo"] }

 # List of patched crates
 [patch.crates-io]
-kvm-bindings = { git = "https://github.com/cloud-hypervisor/kvm-bindings", branch = "ch-v0.5.0", features = ["with-serde", "fam-wrappers"] }
+kvm-bindings = { git = "https://github.com/cloud-hypervisor/kvm-bindings", branch = "ch-v0.5.0-tdx" }
 kvm-ioctls = { git = "https://github.com/rust-vmm/kvm-ioctls", branch = "main" }
 versionize_derive = { git = "https://github.com/cloud-hypervisor/versionize_derive", branch = "ch" }

@@ -43,17 +46,18 @@ versionize_derive = { git = "https://github.com/cloud-hypervisor/versionize_deri
 dirs = "4.0.0"
 lazy_static= "1.4.0"
 net_util = { path = "net_util" }
-serde_json = "1.0.75"
+serde_json = "1.0.79"
 test_infra = { path = "test_infra" }
 wait-timeout = "0.2.0"

 [features]
 default = ["common", "kvm"]
 # Common features for all hypervisors
-common = ["acpi", "cmos", "fwdebug"]
-acpi = ["vmm/acpi"]
+common = ["fwdebug"]
+amx = ["vmm/amx"]
 cmos = ["vmm/cmos"]
 fwdebug = ["vmm/fwdebug"]
+gdb = ["vmm/gdb"]
 kvm = ["vmm/kvm"]
 mshv = ["vmm/mshv"]
 tdx = ["vmm/tdx"]
@@ -71,19 +75,18 @@ members = [
    "net_util",
    "option_parser",
    "pci",
+    "performance-metrics",
    "qcow",
    "rate_limiter",
+    "test_infra",
    "vfio_user",
    "vhdx",
-    "vhost_user_backend",
    "vhost_user_block",
    "vhost_user_net",
    "virtio-devices",
-    "virtio-queue",
    "vmm",
    "vm-allocator",
    "vm-device",
    "vm-migration",
    "vm-virtio"
 ]
-exclude = ["test_infra"]
--- a/137
+++ b/137
@@ -1,9 +1,28 @@
+def runWorkers = true
 pipeline{
 	agent none
 	stages {
 		stage ('Early checks') {
 			agent { node { label 'built-in' } }
 			stages {
+				stage ('Checkout') {
+					steps {
+						checkout scm
+					}
+				}
+				stage ('Check for documentation only changes') {
+					when {
+						expression {
+							return docsFileOnly()
+						}
+					}
+					steps {
+						script {
+							runWorkers = false
+							echo "Documentation only changes, no need to run the CI"
+						}
+					}
+				}
 				stage ('Check for RFC/WIP builds') {
 					when {
  						changeRequest comparator: 'REGEXP', title: '.*(rfc|RFC|wip|WIP).*'
@@ -22,11 +41,14 @@ pipeline{
 			}
 		}
 		stage ('Build') {
-            parallel {
+			parallel {
 				stage ('Worker build') {
-					agent { node { label 'hirsute' } }
-					environment {
-        					AZURE_CONNECTION_STRING = credentials('46b4e7d6-315f-4cc1-8333-b58780863b9b')
+					agent { node { label 'focal' } }
+					when {
+						beforeAgent true
+						expression {
+							return runWorkers
+						}
 					}
 					stages {
 						stage ('Checkout') {
@@ -34,7 +56,11 @@ pipeline{
 								checkout scm
 							}
 						}
-
+						stage ('Prepare environment') {
+							steps {
+								sh "scripts/prepare_vdpa.sh"
+							}
+						}
 						stage ('Run OpenAPI tests') {
 							steps {
 								sh "scripts/run_openapi_tests.sh"
@@ -58,6 +84,12 @@ pipeline{
 				}
 				stage ('AArch64 worker build') {
 					agent { node { label 'bionic-arm64' } }
+					when {
+						beforeAgent true
+						expression {
+							return runWorkers
+						}
+					}
 					stages {
 						stage ('Checkout') {
 							steps {
@@ -66,7 +98,7 @@ pipeline{
 						}
 						stage ('Run unit tests') {
 							steps {
-								sh "scripts/dev_cli.sh tests --unit"
+								sh "scripts/dev_cli.sh tests --unit --libc musl"
 							}
 						}
 						stage ('Run integration tests') {
@@ -75,7 +107,7 @@ pipeline{
 							}
 							steps {
 								sh "sudo modprobe openvswitch"
-								sh "scripts/dev_cli.sh tests --integration"
+								sh "scripts/dev_cli.sh tests --integration --libc musl"
 							}
 						}
 					}
@@ -87,9 +119,12 @@ pipeline{
 					}
 				}
 				stage ('Worker build (musl)') {
-					agent { node { label 'hirsute' } }
-					environment {
-        					AZURE_CONNECTION_STRING = credentials('46b4e7d6-315f-4cc1-8333-b58780863b9b')
+					agent { node { label 'focal' } }
+					when {
+						beforeAgent true
+						expression {
+							return runWorkers
+						}
 					}
 					stages {
 						stage ('Checkout') {
@@ -97,7 +132,11 @@ pipeline{
 								checkout scm
 							}
 						}
-
+						stage ('Prepare environment') {
+							steps {
+								sh "scripts/prepare_vdpa.sh"
+							}
+						}
 						stage ('Run unit tests for musl') {
 							steps {
 								sh "scripts/dev_cli.sh tests --unit --libc musl"
@@ -118,7 +157,12 @@ pipeline{
 					agent { node { label 'bionic-sgx' } }
 					when {
 						beforeAgent true
-						branch 'main'
+						allOf {
+							branch 'main'
+							expression {
+								return runWorkers
+							}
+						}
 					}
 					stages {
 						stage ('Checkout') {
@@ -154,7 +198,12 @@ pipeline{
 					agent { node { label 'bionic-vfio' } }
 					when {
 						beforeAgent true
-						branch 'main'
+						allOf {
+							branch 'main'
+							expression {
+								return runWorkers
+							}
+						}
 					}
 					stages {
 						stage ('Checkout') {
@@ -187,7 +236,13 @@ pipeline{
 					}
 				}
 				stage ('Worker build - Windows guest') {
-					agent { node { label 'hirsute' } }
+					agent { node { label 'focal' } }
+					when {
+						beforeAgent true
+						expression {
+							return runWorkers
+						}
+					}
 					environment {
        					AZURE_CONNECTION_STRING = credentials('46b4e7d6-315f-4cc1-8333-b58780863b9b')
 					}
@@ -227,7 +282,13 @@ pipeline{
 					}
 				}
 				stage ('Worker build - Live Migration') {
-					agent { node { label 'hirsute-small' } }
+					agent { node { label 'focal-small' } }
+					when {
+						beforeAgent true
+						expression {
+							return runWorkers
+						}
+					}
 					stages {
 						stage ('Checkout') {
 							steps {
@@ -254,6 +315,39 @@ pipeline{
 						}
 					}
 				}
+				stage ('Worker build - Metrics') {
+					agent { node { label 'focal-metrics' } }
+					when {
+						branch 'main'
+						beforeAgent true
+						expression {
+							return runWorkers
+						}
+					}
+					environment {
+						METRICS_PUBLISH_KEY = credentials('52e0945f-ce7a-43d1-87af-67d1d87cc40f')
+					}
+					stages {
+						stage ('Checkout') {
+							steps {
+								checkout scm
+							}
+						}
+						stage ('Run metrics tests') {
+							options {
+								timeout(time: 1, unit: 'HOURS')
+							}
+							steps {
+								sh 'scripts/dev_cli.sh tests --metrics -- -- --report-file /root/workloads/metrics.json'
+							}
+						}
+						stage ('Upload metrics report') {
+							steps {
+								sh 'curl -X PUT https://cloud-hypervisor-metrics.azurewebsites.net/api/publishmetrics -H "x-functions-key: $METRICS_PUBLISH_KEY" -T ~/workloads/metrics.json'
+							}
+						}
+					}
+				}
 			}
 		}
 	}
@@ -293,7 +387,18 @@ def cancelPreviousBuilds() {
 def installAzureCli() {
 	sh "sudo apt install -y ca-certificates curl apt-transport-https lsb-release gnupg"
 	sh "curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null"
-	sh "echo \"deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hirsute main\" | sudo tee /etc/apt/sources.list.d/azure-cli.list"
+	sh "echo \"deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ focal main\" | sudo tee /etc/apt/sources.list.d/azure-cli.list"
 	sh "sudo apt update"
 	sh "sudo apt install -y azure-cli"
 }
+
+def boolean docsFileOnly() {
+    if (env.CHANGE_TARGET == null) {
+        return false;
+    }
+
+    return sh(
+        returnStatus: true,
+        script: "git diff --name-only origin/${env.CHANGE_TARGET}... | grep -v '\\.md'"
+    ) != 0
+}
--- a/README.md
+++ b/README.md
@@ -27,12 +27,19 @@

 # 1. What is Cloud Hypervisor?

-Cloud Hypervisor is an open source Virtual Machine Monitor (VMM) that runs on top of [KVM](https://www.kernel.org/doc/Documentation/virtual/kvm/api.txt) and the MSHV hypervisors .
+Cloud Hypervisor is an open source Virtual Machine Monitor (VMM) that runs on
+top of [KVM](https://www.kernel.org/doc/Documentation/virtual/kvm/api.txt)
+hypervisor and Microsoft Hypervisor (MSHV).

-The project focuses on exclusively running modern, cloud workloads, on top of a limited set of hardware architectures and platforms.
-Cloud workloads refers to those that are usually run by customers inside a cloud provider. For our purposes 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.
+The project focuses on exclusively running modern, cloud workloads, on top of
+a limited set of hardware architectures and platforms. Cloud workloads refers
+to those that are usually run by customers inside a cloud provider. For our
+purposes 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.

-Cloud Hypervisor is implemented in [Rust](https://www.rust-lang.org/) and is based on the [rust-vmm](https://github.com/rust-vmm) crates.
+Cloud Hypervisor is implemented in [Rust](https://www.rust-lang.org/) and is
+based on the [rust-vmm](https://github.com/rust-vmm) crates.

 ## Objectives

@@ -51,7 +58,9 @@ Cloud Hypervisor is implemented in [Rust](https://www.rust-lang.org/) and is bas

 ### Architectures

-Cloud Hypervisor supports the `x86-64` and `AArch64` architectures. There are some small differences in functionality between the two architectures (see [#1125](https://github.com/cloud-hypervisor/cloud-hypervisor/issues/1125)).
+Cloud Hypervisor supports the `x86-64` and `AArch64` architectures. There are
+some small differences in functionality between the two architectures
+(see [#1125](https://github.com/cloud-hypervisor/cloud-hypervisor/issues/1125)).

 ### Guest OS

@@ -74,9 +83,9 @@ $ mkdir $CLOUDH

 ## Install prerequisites

-You need to install some prerequisite packages in order to build and test Cloud Hypervisor.
-Here, all the steps are based on Ubuntu, for other Linux distributions please replace the
-package manager and package name.
+You need to install some prerequisite packages in order to build and test Cloud
+Hypervisor. Here, all the steps are based on Ubuntu, for other Linux
+distributions please replace the package manager and package name.

 ```shell
 # Install git
@@ -107,7 +116,8 @@ $ cargo build --release --target=x86_64-unknown-linux-musl --all
 $ popd
 ```

-This will build a `cloud-hypervisor` binary under `$CLOUDH/cloud-hypervisor/target/release/cloud-hypervisor`.
+This will build a `cloud-hypervisor` binary under
+`$CLOUDH/cloud-hypervisor/target/release/cloud-hypervisor`.

 ### Containerized builds and tests

@@ -139,18 +149,20 @@ development script commands and their related options.

 ## Run

-You can run a guest VM by either using an existing cloud image or booting into your own kernel and disk image.
+You can run a guest VM by either using an existing cloud image or booting into
+your own kernel and disk image.

 ### Cloud image

 Cloud Hypervisor supports booting disk images containing all needed
 components to run cloud workloads, a.k.a. cloud images. To do that we rely on
 the [Rust Hypervisor
-Firmware](https://github.com/cloud-hypervisor/rust-hypervisor-firmware) project to provide
-an ELF
-formatted KVM firmware for `cloud-hypervisor` to directly boot into.
+Firmware](https://github.com/cloud-hypervisor/rust-hypervisor-firmware) project
+to provide an ELF formatted KVM firmware for `cloud-hypervisor` to directly
+boot into.

-We need to get the latest `rust-hypervisor-firmware` release and also a working cloud image. Here we will use a Ubuntu image:
+We need to get the latest `rust-hypervisor-firmware` release and also a working
+cloud image. Here we will use a Ubuntu image:

 ```shell
 $ pushd $CLOUDH
@@ -178,7 +190,10 @@ Multiple arguments can be given to the `--disk` parameter.

 #### Building your kernel

-Cloud Hypervisor also supports direct kernel boot into a `vmlinux` ELF kernel. In order to support virtio-iommu we have our own development branch. You are of course able to use your own kernel but these instructions will continue with the version that we develop and test against.
+Cloud Hypervisor also supports direct kernel boot into a `vmlinux` ELF kernel.
+In order to support virtio-watchdog we have our own development branch. You are
+of course able to use your own kernel but these instructions will continue with
+the version that we develop and test against.

 To build the kernel:

@@ -195,11 +210,13 @@ $ KCFLAGS="-Wa,-mx86-used-note=no" make bzImage -j `nproc`
 $ popd
 ```

-The `vmlinux` kernel image will then be located at `linux-cloud-hypervisor/arch/x86/boot/compressed/vmlinux.bin`.
+The `vmlinux` kernel image will then be located at
+`linux-cloud-hypervisor/arch/x86/boot/compressed/vmlinux.bin`.

 #### Disk image

-For the disk image, we will use a Ubuntu cloud image that contains a root partition:
+For the disk image, we will use a Ubuntu cloud image that contains a root
+partition:

 ```shell
 $ pushd $CLOUDH
@@ -210,8 +227,8 @@ $ popd

 #### Booting the guest VM

-Now we can directly boot into our custom kernel and make it use the Ubuntu root partition.
-If we want to have 4 vCPUs and 1024 MBytes of memory:
+Now we can directly boot into our custom kernel and make it use the Ubuntu root
+partition. If we want to have 4 vCPUs and 1024 MBytes of memory:

 ```shell
 $ pushd $CLOUDH
@@ -246,94 +263,112 @@ $ ./cloud-hypervisor/target/release/cloud-hypervisor \

 # 3. Status

-Cloud Hypervisor is under active development. The following stability guarantees are currently made:
+Cloud Hypervisor is under active development. The following stability guarantees
+are currently made:

 * The API (including command line options) will not be removed or changed in a
-  breaking way without a minimum of 2 releases notice. Where possible warnings
-  will be given about the use of deprecated functionality and the deprecations
-  will be documented in the release notes.
+  breaking way without a minimum of 2 major releases notice. Where possible
+  warnings will be given about the use of deprecated functionality and the
+  deprecations will be documented in the release notes.
+
 * Point releases will be made between individual releases where there are
-  substantial bug fixes or security issues that need to be fixed.
+  substantial bug fixes or security issues that need to be fixed. These point
+  releases will only include bug fixes.

 Currently the following items are **not** guaranteed across updates:

 * Snapshot/restore is not supported across different versions
 * Live migration is not supported across different versions
 * The following features are considered experimental and may change
-  substantially between releases: TDX, SGX.
+  substantially between releases: TDX, vfio-user, vDPA.

-
-As of 2021-04-29, the following cloud images are supported:
+As of 2022-04-05, the following cloud images are supported:

 - [Ubuntu Bionic](https://cloud-images.ubuntu.com/bionic/current/) (cloudimg)
 - [Ubuntu Focal](https://cloud-images.ubuntu.com/focal/current/) (cloudimg)
- [Ubuntu Groovy](https://cloud-images.ubuntu.com/groovy/current/) (cloudimg)
- [Ubuntu Hirsute](https://cloud-images.ubuntu.com/hirsute/current/) (cloudimg)
+- [Ubuntu Jammy](https://cloud-images.ubuntu.com/jammy/current/) (cloudimg)

-Direct kernel boot to userspace should work with a rootfs from most distributions.
+Direct kernel boot to userspace should work with a rootfs from most
+distributions.

 ## Hot Plug

-Cloud Hypervisor supports hotplug of CPUs, passthrough devices (VFIO), `virtio-{net,block,pmem,fs,vsock}` and memory resizing. This [document](docs/hotplug.md) details how to add devices to
-a running VM.
+Cloud Hypervisor supports hotplug of CPUs, passthrough devices (VFIO),
+`virtio-{net,block,pmem,fs,vsock}` and memory resizing. This
+[document](docs/hotplug.md) details how to add devices to a running VM.

 ## Device Model

-Details of the device model can be found in this [documentation](docs/device_model.md).
+Details of the device model can be found in this
+[documentation](docs/device_model.md).

 ## TODO

-We are not tracking the Cloud Hypervisor TODO list from a specific git tracked file but through
-[github issues](https://github.com/cloud-hypervisor/cloud-hypervisor/issues/new) instead.
+We are not tracking the Cloud Hypervisor TODO list from a specific git tracked
+file but through
+[github issues](https://github.com/cloud-hypervisor/cloud-hypervisor/issues/new)
+instead.

 # 4. `rust-vmm` project dependency

-In order to satisfy the design goal of having a high-performance, security-focused hypervisor the decision
-was made to use the [Rust](https://www.rust-lang.org/) programming language.
-The language's strong focus on memory and thread safety makes it an ideal candidate for implementing VMMs.
+In order to satisfy the design goal of having a high-performance,
+security-focused hypervisor the decision was made to use the
+[Rust](https://www.rust-lang.org/) programming language. The language's strong
+focus on memory and thread safety makes it an ideal candidate for implementing
+VMMs.

-Instead of implementing the VMM components from scratch, Cloud Hypervisor is importing the [rust-vmm](https://github.com/rust-vmm)
-crates, and sharing code and architecture together with other VMMs like e.g. Amazon's [Firecracker](https://firecracker-microvm.github.io/)
-and Google's [crosvm](https://chromium.googlesource.com/chromiumos/platform/crosvm/).
+Instead of implementing the VMM components from scratch, Cloud Hypervisor is
+importing the [rust-vmm](https://github.com/rust-vmm) crates, and sharing code
+and architecture together with other VMMs like e.g. Amazon's
+[Firecracker](https://firecracker-microvm.github.io/) and Google's
+[crosvm](https://chromium.googlesource.com/chromiumos/platform/crosvm/).

-Cloud Hypervisor embraces the rust-vmm project goals, which is to be able to share and re-use
-as many virtualization crates as possible. As such, the Cloud Hypervisor relationship with the rust-vmm
-project is twofold:
+Cloud Hypervisor embraces the rust-vmm project goals, which is to be able to
+share and re-use as many virtualization crates as possible. As such, the Cloud
+Hypervisor relationship with the rust-vmm project is twofold:

-1. It will use as much of the rust-vmm code as possible. Any new rust-vmm crate that's relevant to the project
-   goals will be integrated as soon as possible.
-2. As it is likely that the rust-vmm project will lack some of the features that Cloud Hypervisor needs (e.g. ACPI,
-   VFIO, vhost-user, etc), we will be using the Cloud Hypervisor VMM to implement and test them, and contribute them
-   back to the rust-vmm project.
+1. It will use as much of the rust-vmm code as possible. Any new rust-vmm crate
+   that's relevant to the project goals will be integrated as soon as possible.
+2. As it is likely that the rust-vmm project will lack some of the features that
+   Cloud Hypervisor needs (e.g. ACPI, VFIO, vhost-user, etc), we will be using
+   the Cloud Hypervisor VMM to implement and test them, and contribute them back
+   to the rust-vmm project.

 ## Firecracker and crosvm

-A large part of the Cloud Hypervisor code is based on either the Firecracker or the crosvm projects implementations.
-Both of these are VMMs written in Rust with a focus on safety and security, like Cloud Hypervisor.
+A large part of the Cloud Hypervisor code is based on either the Firecracker or
+the crosvm projects implementations. Both of these are VMMs written in Rust with
+a focus on safety and security, like Cloud Hypervisor.

-However we want to emphasize that the Cloud Hypervisor project is neither a fork nor a reimplementation of any of those
-projects. The goals and use cases we're trying to meet are different.
-We're aiming at supporting cloud workloads, i.e. those modern, full Linux distribution images currently being run by
-Cloud Service Provider (CSP) tenants.
+However we want to emphasize that the Cloud Hypervisor project is neither a fork
+nor a reimplementation of any of those projects. The goals and use cases we're
+trying to meet are different. We're aiming at supporting cloud workloads, i.e.
+those modern, full Linux distribution images currently being run by Cloud
+Service Provider (CSP) tenants.

-Our primary target is not to support client or serverless use cases, and as such our code base already diverges
-from the crosvm and Firecracker ones. As we add more features to support our use cases, we believe that the divergence
-will increase while at the same time sharing as much of the fundamental virtualization code through the rust-vmm project
-crates as possible.
+Our primary target is not to support client or serverless use cases, and as such
+our code base already diverges from the crosvm and Firecracker ones. As we add
+more features to support our use cases, we believe that the divergence will
+increase while at the same time sharing as much of the fundamental
+virtualization code through the rust-vmm project crates as possible.

 # 5. Community

-The Cloud Hypervisor project follows the governance, and community guidelines described in
-the [Community](https://github.com/cloud-hypervisor/community) repository.
+The Cloud Hypervisor project follows the governance, and community guidelines
+described in the [Community](https://github.com/cloud-hypervisor/community)
+repository.

 ## Contribute

-We are working on building a global, diverse and collaborative community around the Cloud Hypervisor project.
-Anyone who is interested in [contributing](CONTRIBUTING.md) to the project is welcome to participate.
+We are working on building a global, diverse and collaborative community around
+the Cloud Hypervisor project. Anyone who is interested in
+[contributing](CONTRIBUTING.md) to the project is welcome to participate.

-We believe that contributing to a open source project like Cloud Hypervisor covers a lot more than just sending
-code. Testing, documentation, pull request reviews, bug reports, feature requests, project improvement suggestions,
-etc, are all equal and welcome means of contribution. See the [CONTRIBUTING](CONTRIBUTING.md) document for more details.
+We believe that contributing to a open source project like Cloud Hypervisor
+covers a lot more than just sending code. Testing, documentation, pull request
+reviews, bug reports, feature requests, project improvement suggestions, etc,
+are all equal and welcome means of contribution. See the
+[CONTRIBUTING](CONTRIBUTING.md) document for more details.

 ## Join us

@@ -342,4 +377,4 @@ and [join us on Slack](https://cloud-hypervisor.slack.com/).

 ## Security issues

-Please use the GitHub security advisories feature for reporting issues: https://github.com/cloud-hypervisor/cloud-hypervisor/security/advisories/new
+Please contact the maintainers listed in the MAINTAINERS.md file with security issues.
--- a/acpi_tables/Cargo.toml
+++ b/acpi_tables/Cargo.toml
@@ -2,7 +2,7 @@
 name = "acpi_tables"
 version = "0.1.0"
 authors = ["The Cloud Hypervisor Authors"]
-edition = "2018"
+edition = "2021"

 [dependencies]
 vm-memory = "0.7.0"
--- a/api_client/Cargo.toml
+++ b/api_client/Cargo.toml
@@ -2,7 +2,7 @@
 name = "api_client"
 version = "0.1.0"
 authors = ["The Cloud Hypervisor Authors"]
-edition = "2018"
+edition = "2021"

 [dependencies]
 vmm-sys-util = "0.9.0"
--- a/arch/Cargo.toml
+++ b/arch/Cargo.toml
@@ -2,23 +2,22 @@
 name = "arch"
 version = "0.1.0"
 authors = ["The Chromium OS Authors"]
-edition = "2018"
+edition = "2021"

 [features]
 default = []
-acpi = ["acpi_tables"]
 tdx = []

 [dependencies]
-acpi_tables = { path = "../acpi_tables", optional = true }
-anyhow = "1.0.52"
+acpi_tables = { path = "../acpi_tables" }
+anyhow = "1.0.56"
 byteorder = "1.4.3"
 hypervisor = { path = "../hypervisor" }
-libc = "0.2.112"
+libc = "0.2.123"
 linux-loader = { version = "0.4.0", features = ["elf", "bzimage", "pe"] }
-log = "0.4.14"
-serde = { version = "1.0.133", features = ["rc"] }
-serde_derive = "1.0.133"
+log = "0.4.16"
+serde = { version = "1.0.136", features = ["rc"] }
+serde_derive = "1.0.136"
 thiserror = "1.0.30"
 versionize = "0.1.6"
 versionize_derive = "0.1.4"
--- a/arch/src/aarch64/fdt.rs
+++ b/arch/src/aarch64/fdt.rs
@@ -18,14 +18,13 @@ use std::str;
 use super::super::DeviceType;
 use super::super::GuestMemoryMmap;
 use super::super::InitramfsConfig;
-use super::get_fdt_addr;
 use super::gic::GicDevice;
 use super::layout::{
    IRQ_BASE, MEM_32BIT_DEVICES_SIZE, MEM_32BIT_DEVICES_START, MEM_PCI_IO_SIZE, MEM_PCI_IO_START,
    PCI_HIGH_BASE, PCI_MMIO_CONFIG_SIZE_PER_SEGMENT,
 };
 use vm_fdt::{FdtWriter, FdtWriterResult};
-use vm_memory::{Address, Bytes, GuestAddress, GuestMemory, GuestMemoryError, GuestMemoryRegion};
+use vm_memory::{Address, Bytes, GuestMemory, GuestMemoryError, GuestMemoryRegion};

 // This is a value for uniquely identifying the FDT node declaring the interrupt controller.
 const GIC_PHANDLE: u32 = 1;
@@ -51,11 +50,16 @@ const SIZE_CELLS: u32 = 0x2;
 // Look for "The 1st cell..."
 const GIC_FDT_IRQ_TYPE_SPI: u32 = 0;
 const GIC_FDT_IRQ_TYPE_PPI: u32 = 1;
+const GIC_FDT_IRQ_PPI_CPU_SHIFT: u32 = 8;
+const GIC_FDT_IRQ_PPI_CPU_MASK: u32 = 0xff << GIC_FDT_IRQ_PPI_CPU_SHIFT;

 // From https://elixir.bootlin.com/linux/v4.9.62/source/include/dt-bindings/interrupt-controller/irq.h#L17
 const IRQ_TYPE_EDGE_RISING: u32 = 1;
 const IRQ_TYPE_LEVEL_HI: u32 = 4;

+// PMU PPI interrupt number
+pub const AARCH64_PMU_IRQ: u32 = 7;
+
 // Keys and Buttons
 // System Power Down
 const KEY_POWER: u32 = 116;
@@ -91,6 +95,7 @@ pub fn create_fdt<T: DeviceInfoForFdt + Clone + Debug, S: ::std::hash::BuildHash
    pci_space_info: &[PciSpaceInfo],
    numa_nodes: &NumaNodes,
    virtio_iommu_bdf: Option<u32>,
+    pmu_supported: bool,
 ) -> FdtWriterResult<Vec<u8>> {
    // Allocate stuff necessary for the holding the blob.
    let mut fdt = FdtWriter::new().unwrap();
@@ -114,6 +119,9 @@ pub fn create_fdt<T: DeviceInfoForFdt + Clone + Debug, S: ::std::hash::BuildHash
    create_chosen_node(&mut fdt, cmdline, initrd)?;
    create_gic_node(&mut fdt, gic_device)?;
    create_timer_node(&mut fdt)?;
+    if pmu_supported {
+        create_pmu_node(&mut fdt, vcpu_mpidr.len())?;
+    }
    create_clock_node(&mut fdt)?;
    create_psci_node(&mut fdt)?;
    create_devices_node(&mut fdt, device_info)?;
@@ -132,9 +140,8 @@ pub fn create_fdt<T: DeviceInfoForFdt + Clone + Debug, S: ::std::hash::BuildHash

 pub fn write_fdt_to_memory(fdt_final: Vec<u8>, guest_mem: &GuestMemoryMmap) -> Result<()> {
    // Write FDT to memory.
-    let fdt_address = GuestAddress(get_fdt_addr());
    guest_mem
-        .write_slice(fdt_final.as_slice(), fdt_address)
+        .write_slice(fdt_final.as_slice(), super::layout::FDT_START)
        .map_err(Error::WriteFdtToMemory)?;
    Ok(())
 }
@@ -152,9 +159,6 @@ fn create_cpu_nodes(
    fdt.property_u32("#size-cells", 0x0)?;

    let num_cpus = vcpu_mpidr.len();
-    let threads_per_core = vcpu_topology.unwrap_or_default().0 as u8;
-    let cores_per_package = vcpu_topology.unwrap_or_default().1 as u8;
-    let packages = vcpu_topology.unwrap_or_default().2 as u8;

    for (cpu_id, mpidr) in vcpu_mpidr.iter().enumerate().take(num_cpus) {
        let cpu_name = format!("cpu@{:x}", cpu_id);
@@ -183,32 +187,9 @@ fn create_cpu_nodes(
        fdt.end_node(cpu_node)?;
    }

-    // If there is a valid cpu topology config, create the cpu-map node.
-    if (threads_per_core > 0)
-        && (cores_per_package > 0)
-        && (packages > 0)
-        && (num_cpus as u8 == threads_per_core * cores_per_package * packages)
-    {
+    if let Some(topology) = vcpu_topology {
+        let (threads_per_core, cores_per_package, packages) = topology;
        let cpu_map_node = fdt.begin_node("cpu-map")?;
-        // Create mappings between CPU index and cluster,core, and thread.
-        let mut cluster_core_thread_to_cpuidx = HashMap::new();
-        for cpu_idx in 0..num_cpus as u8 {
-            if threads_per_core > 1 {
-                cluster_core_thread_to_cpuidx.insert(
-                    (
-                        cpu_idx / (cores_per_package * threads_per_core),
-                        (cpu_idx / threads_per_core) % cores_per_package,
-                        cpu_idx % threads_per_core,
-                    ),
-                    cpu_idx,
-                );
-            } else {
-                cluster_core_thread_to_cpuidx.insert(
-                    (cpu_idx / cores_per_package, cpu_idx % cores_per_package, 0),
-                    cpu_idx,
-                );
-            }
-        }

        // Create device tree nodes with regard of above mapping.
        for cluster_idx in 0..packages {
@@ -219,24 +200,16 @@ fn create_cpu_nodes(
                let core_name = format!("core{:x}", core_idx);
                let core_node = fdt.begin_node(&core_name)?;

-                if threads_per_core > 1 {
-                    for thread_idx in 0..threads_per_core {
-                        let thread_name = format!("thread{:x}", thread_idx);
-                        let thread_node = fdt.begin_node(&thread_name)?;
-                        let cpu_idx = cluster_core_thread_to_cpuidx
-                            .get(&(cluster_idx, core_idx, thread_idx))
-                            .unwrap();
-
-                        fdt.property_u32("cpu", *cpu_idx as u32 + FIRST_VCPU_PHANDLE)?;
-                        fdt.end_node(thread_node)?;
-                    }
-                } else {
-                    let cpu_idx = cluster_core_thread_to_cpuidx
-                        .get(&(cluster_idx, core_idx, 0))
-                        .unwrap();
-
-                    fdt.property_u32("cpu", *cpu_idx as u32 + FIRST_VCPU_PHANDLE)?;
+                for thread_idx in 0..threads_per_core {
+                    let thread_name = format!("thread{:x}", thread_idx);
+                    let thread_node = fdt.begin_node(&thread_name)?;
+                    let cpu_idx = threads_per_core * cores_per_package * cluster_idx
+                        + threads_per_core * core_idx
+                        + thread_idx;
+                    fdt.property_u32("cpu", cpu_idx as u32 + FIRST_VCPU_PHANDLE)?;
+                    fdt.end_node(thread_node)?;
                }
+
                fdt.end_node(core_node)?;
            }
            fdt.end_node(cluster_node)?;
@@ -256,40 +229,67 @@ fn create_memory_node(
    guest_mem: &GuestMemoryMmap,
    numa_nodes: &NumaNodes,
 ) -> FdtWriterResult<()> {
+    // See https://github.com/torvalds/linux/blob/58ae0b51506802713aa0e9956d1853ba4c722c98/Documentation/devicetree/bindings/numa.txt
+    // for NUMA setting in memory node.
    if numa_nodes.len() > 1 {
        for numa_node_idx in 0..numa_nodes.len() {
            let numa_node = numa_nodes.get(&(numa_node_idx as u32));
+            let mut mem_reg_prop: Vec<u64> = Vec::new();
+            let mut node_memory_addr: u64 = 0;
            // Each memory zone of numa will have its own memory node, but
            // different numa nodes should not share same memory zones.
            for memory_region in numa_node.unwrap().memory_regions.iter() {
                let memory_region_start_addr: u64 = memory_region.start_addr().raw_value();
                let memory_region_size: u64 = memory_region.size() as u64;
-                let mem_reg_prop = [memory_region_start_addr, memory_region_size];
-                // With feature `acpi` enabled, RAM at 0-4M is for edk2 only
-                // and should be hidden to the guest.
-                #[cfg(feature = "acpi")]
-                if memory_region_start_addr == 0 {
-                    continue;
+                mem_reg_prop.push(memory_region_start_addr);
+                mem_reg_prop.push(memory_region_size);
+                // Set the node address the first non-zero regison address
+                if node_memory_addr == 0 {
+                    node_memory_addr = memory_region_start_addr;
                }
-
-                let memory_node_name = format!("memory@{:x}", memory_region_start_addr);
-                let memory_node = fdt.begin_node(&memory_node_name)?;
-                fdt.property_string("device_type", "memory")?;
-                fdt.property_array_u64("reg", &mem_reg_prop)?;
-                fdt.property_u32("numa-node-id", numa_node_idx as u32)?;
-                fdt.end_node(memory_node)?;
            }
+            let memory_node_name = format!("memory@{:x}", node_memory_addr);
+            let memory_node = fdt.begin_node(&memory_node_name)?;
+            fdt.property_string("device_type", "memory")?;
+            fdt.property_array_u64("reg", &mem_reg_prop)?;
+            fdt.property_u32("numa-node-id", numa_node_idx as u32)?;
+            fdt.end_node(memory_node)?;
        }
    } else {
-        let mem_size = guest_mem.last_addr().raw_value() - super::layout::RAM_64BIT_START + 1;
-        // See https://github.com/torvalds/linux/blob/master/Documentation/devicetree/booting-without-of.txt#L960
-        // for an explanation of this.
-        let mem_reg_prop = [super::layout::RAM_64BIT_START as u64, mem_size as u64];
-        let memory_node = fdt.begin_node("memory")?;
+        let last_addr = guest_mem.last_addr().raw_value();
+        if last_addr < super::layout::MEM_32BIT_RESERVED_START.raw_value() {
+            // Case 1: all RAM is under the hole
+            let mem_size = last_addr - super::layout::RAM_START.raw_value() + 1;
+            let mem_reg_prop = [super::layout::RAM_START.raw_value() as u64, mem_size as u64];
+            let memory_node = fdt.begin_node("memory")?;
+            fdt.property_string("device_type", "memory")?;
+            fdt.property_array_u64("reg", &mem_reg_prop)?;
+            fdt.end_node(memory_node)?;
+        } else {
+            // Case 2: RAM is split by the hole
+            // Region 1: RAM before the hole
+            let mem_size = super::layout::MEM_32BIT_RESERVED_START.raw_value()
+                - super::layout::RAM_START.raw_value();
+            let mem_reg_prop = [super::layout::RAM_START.raw_value() as u64, mem_size as u64];
+            let memory_node_name = format!("memory@{:x}", super::layout::RAM_START.raw_value());
+            let memory_node = fdt.begin_node(&memory_node_name)?;
+            fdt.property_string("device_type", "memory")?;
+            fdt.property_array_u64("reg", &mem_reg_prop)?;
+            fdt.end_node(memory_node)?;

-        fdt.property_string("device_type", "memory")?;
-        fdt.property_array_u64("reg", &mem_reg_prop)?;
-        fdt.end_node(memory_node)?;
+            // Region 2: RAM after the hole
+            let mem_size = last_addr - super::layout::RAM_64BIT_START.raw_value() + 1;
+            let mem_reg_prop = [
+                super::layout::RAM_64BIT_START.raw_value() as u64,
+                mem_size as u64,
+            ];
+            let memory_node_name =
+                format!("memory@{:x}", super::layout::RAM_64BIT_START.raw_value());
+            let memory_node = fdt.begin_node(&memory_node_name)?;
+            fdt.property_string("device_type", "memory")?;
+            fdt.property_array_u64("reg", &mem_reg_prop)?;
+            fdt.end_node(memory_node)?;
+        }
    }

    Ok(())
@@ -540,6 +540,24 @@ fn create_devices_node<T: DeviceInfoForFdt + Clone + Debug, S: ::std::hash::Buil
    Ok(())
 }

+fn create_pmu_node(fdt: &mut FdtWriter, cpu_nums: usize) -> FdtWriterResult<()> {
+    let num_cpus = cpu_nums as u64 as u32;
+    let compatible = "arm,armv8-pmuv3";
+    let cpu_mask: u32 =
+        (((1 << num_cpus) - 1) << GIC_FDT_IRQ_PPI_CPU_SHIFT) & GIC_FDT_IRQ_PPI_CPU_MASK;
+    let irq = [
+        GIC_FDT_IRQ_TYPE_PPI,
+        AARCH64_PMU_IRQ,
+        cpu_mask | IRQ_TYPE_LEVEL_HI,
+    ];
+
+    let pmu_node = fdt.begin_node("pmu")?;
+    fdt.property_string("compatible", compatible)?;
+    fdt.property_array_u32("interrupts", &irq)?;
+    fdt.end_node(pmu_node)?;
+    Ok(())
+}
+
 fn create_pci_nodes(
    fdt: &mut FdtWriter,
    pci_device_info: &[PciSpaceInfo],
@@ -555,20 +573,19 @@ fn create_pci_nodes(
        // could fall bellow 4G.
        // Here we cut off PCI device space below 8G in FDT to workaround the EDK2 check.
        // But the address written in ACPI is not impacted.
-        let (pci_device_base_64bit, pci_device_size_64bit) = if cfg!(feature = "acpi")
-            && (pci_device_info_elem.pci_device_space_start < PCI_HIGH_BASE)
-        {
-            (
-                PCI_HIGH_BASE,
-                pci_device_info_elem.pci_device_space_size
-                    - (PCI_HIGH_BASE - pci_device_info_elem.pci_device_space_start),
-            )
-        } else {
-            (
-                pci_device_info_elem.pci_device_space_start,
-                pci_device_info_elem.pci_device_space_size,
-            )
-        };
+        let (pci_device_base_64bit, pci_device_size_64bit) =
+            if pci_device_info_elem.pci_device_space_start < PCI_HIGH_BASE.raw_value() {
+                (
+                    PCI_HIGH_BASE.raw_value(),
+                    pci_device_info_elem.pci_device_space_size
+                        - (PCI_HIGH_BASE.raw_value() - pci_device_info_elem.pci_device_space_start),
+                )
+            } else {
+                (
+                    pci_device_info_elem.pci_device_space_start,
+                    pci_device_info_elem.pci_device_space_size,
+                )
+            };
        // There is no specific requirement of the 32bit MMIO range, and
        // therefore at least we can make these ranges 4K aligned.
        let pci_device_size_32bit: u64 =
--- a/arch/src/aarch64/gic/gicv3.rs
+++ b/arch/src/aarch64/gic/gicv3.rs
@@ -22,6 +22,7 @@ pub mod kvm {
    use std::{boxed::Box, result};
    use versionize::{VersionMap, Versionize, VersionizeResult};
    use versionize_derive::Versionize;
+    use vm_memory::Address;
    use vm_migration::{
        Migratable, MigratableError, Pausable, Snapshot, Snapshottable, Transportable,
        VersionMapped,
@@ -83,7 +84,7 @@ pub mod kvm {

        /// Get the address of the GIC distributor.
        pub fn get_dist_addr() -> u64 {
-            layout::GIC_V3_DIST_START
+            layout::GIC_V3_DIST_START.raw_value()
        }

        /// Get the size of the GIC distributor.
--- a/arch/src/aarch64/layout.rs
+++ b/arch/src/aarch64/layout.rs
@@ -3,7 +3,7 @@
 // SPDX-License-Identifier: Apache-2.0

 //
-// Memory layout of Aarch64 guest:
+// Memory layout of AArch64 guest:
 //
 // Physical  +---------------------------------------------------------------+
 // address   |                                                               |
@@ -20,6 +20,13 @@
 //           |                            DRAM                               |
 //           |                                                               |
 //           |                                                               |
+// 4GB       +---------------------------------------------------------------+
+//           |                      32-bit devices hole                      |
+// 4GB-64M   +---------------------------------------------------------------+
+//           |                                                               |
+//           |                                                               |
+//           |                            DRAM                               |
+//           |                                                               |
 //           |                                                               |
 // 1GB       +---------------------------------------------------------------+
 //           |                                                               |
@@ -35,11 +42,11 @@
 //           |                        Legacy devices space                   |
 //           |                                                               |
 // 144 M     +---------------------------------------------------------------|
+//           |                                                               |
 //           |                    Reserved (now GIC is here)                 |
-// 64  M     +---------------------------------------------------------------+
-//           |                                                               |
-//           |                          UEFI space                           |
 //           |                                                               |
+//  4  M     +---------------------------------------------------------------+
+//           |                          UEFI flash                           |
 // 0GB       +---------------------------------------------------------------+
 //
 //
@@ -48,17 +55,16 @@ use vm_memory::GuestAddress;

 /// 0x0 ~ 0x40_0000 (4 MiB) is reserved to UEFI
 /// UEFI binary size is required less than 3 MiB, reserving 4 MiB is enough.
-pub const UEFI_START: u64 = 0x0;
-pub const MEM_UEFI_START: GuestAddress = GuestAddress(0);
+pub const UEFI_START: GuestAddress = GuestAddress(0);
 pub const UEFI_SIZE: u64 = 0x040_0000;

 /// Below this address will reside the GIC, above this address will reside the MMIO devices.
-pub const MAPPED_IO_START: u64 = 0x0900_0000;
+pub const MAPPED_IO_START: GuestAddress = GuestAddress(0x0900_0000);

 /// See kernel file arch/arm64/include/uapi/asm/kvm.h for the GIC related definitions.
 /// 0x08ff_0000 ~ 0x0900_0000 is reserved for GICv3 Distributor
 pub const GIC_V3_DIST_SIZE: u64 = 0x01_0000;
-pub const GIC_V3_DIST_START: u64 = MAPPED_IO_START - GIC_V3_DIST_SIZE;
+pub const GIC_V3_DIST_START: GuestAddress = GuestAddress(MAPPED_IO_START.0 - GIC_V3_DIST_SIZE);
 /// Below 0x08ff_0000 is reserved for GICv3 Redistributor.
 /// The size defined here is for each vcpu.
 /// The total size is 'number_of_vcpu * GIC_V3_REDIST_SIZE'
@@ -67,9 +73,9 @@ pub const GIC_V3_REDIST_SIZE: u64 = 0x02_0000;
 pub const GIC_V3_ITS_SIZE: u64 = 0x02_0000;

 /// Space 0x0900_0000 ~ 0x0905_0000 is reserved for legacy devices.
-pub const LEGACY_SERIAL_MAPPED_IO_START: u64 = 0x0900_0000;
-pub const LEGACY_RTC_MAPPED_IO_START: u64 = 0x0901_0000;
-pub const LEGACY_GPIO_MAPPED_IO_START: u64 = 0x0902_0000;
+pub const LEGACY_SERIAL_MAPPED_IO_START: GuestAddress = GuestAddress(0x0900_0000);
+pub const LEGACY_RTC_MAPPED_IO_START: GuestAddress = GuestAddress(0x0901_0000);
+pub const LEGACY_GPIO_MAPPED_IO_START: GuestAddress = GuestAddress(0x0902_0000);

 /// Space 0x0905_0000 ~ 0x0906_0000 is reserved for pcie io address
 pub const MEM_PCI_IO_START: GuestAddress = GuestAddress(0x0905_0000);
@@ -85,8 +91,15 @@ pub const PCI_MMCONFIG_SIZE: u64 = 256 << 20;
 // One bus with potentially 256 devices (32 slots x 8 functions).
 pub const PCI_MMIO_CONFIG_SIZE_PER_SEGMENT: u64 = 4096 * 256;

-/// Start of RAM on 64 bit ARM.
-pub const RAM_64BIT_START: u64 = 0x4000_0000;
+/// Start of RAM.
+pub const RAM_START: GuestAddress = GuestAddress(0x4000_0000);
+
+/// 32-bit reserved area: 64MiB before 4GiB
+pub const MEM_32BIT_RESERVED_START: GuestAddress = GuestAddress(0xfc00_0000);
+pub const MEM_32BIT_RESERVED_SIZE: u64 = 0x0400_0000;
+
+/// Start of 64-bit RAM.
+pub const RAM_64BIT_START: GuestAddress = GuestAddress(0x1_0000_0000);

 /// Kernel command line maximum size.
 /// As per `arch/arm64/include/uapi/asm/setup.h`.
@@ -94,19 +107,19 @@ pub const CMDLINE_MAX_SIZE: usize = 2048;

 /// FDT is at the beginning of RAM.
 /// Maximum size of the device tree blob as specified in https://www.kernel.org/doc/Documentation/arm64/booting.txt.
-pub const FDT_START: u64 = RAM_64BIT_START;
-pub const FDT_MAX_SIZE: usize = 0x20_0000;
+pub const FDT_START: GuestAddress = RAM_START;
+pub const FDT_MAX_SIZE: u64 = 0x20_0000;

 /// Put ACPI table above dtb
-pub const ACPI_START: u64 = RAM_64BIT_START + FDT_MAX_SIZE as u64;
-pub const ACPI_MAX_SIZE: usize = 0x20_0000;
-pub const RSDP_POINTER: GuestAddress = GuestAddress(ACPI_START);
+pub const ACPI_START: GuestAddress = GuestAddress(RAM_START.0 + FDT_MAX_SIZE);
+pub const ACPI_MAX_SIZE: u64 = 0x20_0000;
+pub const RSDP_POINTER: GuestAddress = ACPI_START;

 /// Kernel start after FDT and ACPI
-pub const KERNEL_START: u64 = ACPI_START + ACPI_MAX_SIZE as u64;
+pub const KERNEL_START: GuestAddress = GuestAddress(ACPI_START.0 + ACPI_MAX_SIZE);

 /// Pci high memory base
-pub const PCI_HIGH_BASE: u64 = 0x2_0000_0000_u64;
+pub const PCI_HIGH_BASE: GuestAddress = GuestAddress(0x2_0000_0000);

 // As per virt/kvm/arm/vgic/vgic-kvm-device.c we need
 // the number of interrupts our GIC will support to be:
--- a/arch/src/aarch64/mod.rs
+++ b/arch/src/aarch64/mod.rs
@@ -43,6 +43,9 @@ pub enum Error {

    /// Error configuring the MPIDR register
    VcpuRegMpidr(hypervisor::HypervisorCpuError),
+
+    /// Error initializing PMU for vcpu
+    VcpuInitPmu,
 }

 impl From<Error> for super::Error {
@@ -75,31 +78,11 @@ pub fn configure_vcpu(
 }

 pub fn arch_memory_regions(size: GuestUsize) -> Vec<(GuestAddress, usize, RegionType)> {
-    // Normally UEFI should be loaded to a flash area at the beginning of memory.
-    // But now flash memory type is not supported.
-    // As a workaround, we take 4 MiB memory from the main RAM for UEFI.
-    // As a result, the RAM that the guest can see is less than what has been
-    // assigned in command line, when ACPI and UEFI is enabled.
-    let ram_deduction = if cfg!(feature = "acpi") {
-        layout::UEFI_SIZE
-    } else {
-        0
-    };
-
-    vec![
-        // 0 ~ 4 MiB: Reserved for UEFI space
-        #[cfg(feature = "acpi")]
-        (GuestAddress(0), layout::UEFI_SIZE as usize, RegionType::Ram),
-        #[cfg(not(feature = "acpi"))]
+    let mut regions = vec![
+        // 0 MiB ~ 256 MiB: UEFI, GIC and legacy devices
        (
            GuestAddress(0),
-            layout::UEFI_SIZE as usize,
-            RegionType::Reserved,
-        ),
-        // 4 MiB ~ 256 MiB: Gic and legacy devices
-        (
-            GuestAddress(layout::UEFI_SIZE),
-            (layout::MEM_32BIT_DEVICES_START.0 - layout::UEFI_SIZE) as usize,
+            layout::MEM_32BIT_DEVICES_START.0 as usize,
            RegionType::Reserved,
        ),
        // 256 MiB ~ 768 MiB: MMIO space
@@ -114,13 +97,39 @@ pub fn arch_memory_regions(size: GuestUsize) -> Vec<(GuestAddress, usize, Region
            layout::PCI_MMCONFIG_SIZE as usize,
            RegionType::Reserved,
        ),
-        // 1 GiB ~ : Ram
-        (
-            GuestAddress(layout::RAM_64BIT_START),
-            (size - ram_deduction) as usize,
+    ];
+
+    let ram_32bit_space_size =
+        layout::MEM_32BIT_RESERVED_START.unchecked_offset_from(layout::RAM_START);
+
+    // RAM space
+    // Case1: guest memory fits before the gap
+    if size as u64 <= ram_32bit_space_size {
+        regions.push((layout::RAM_START, size as usize, RegionType::Ram));
+    // Case2: guest memory extends beyond the gap
+    } else {
+        // Push memory before the gap
+        regions.push((
+            layout::RAM_START,
+            ram_32bit_space_size as usize,
            RegionType::Ram,
-        ),
-    ]
+        ));
+        // Other memory is placed after 4GiB
+        regions.push((
+            layout::RAM_64BIT_START,
+            (size - ram_32bit_space_size) as usize,
+            RegionType::Ram,
+        ));
+    }
+
+    // Add the 32-bit reserved memory hole as a reserved region
+    regions.push((
+        layout::MEM_32BIT_RESERVED_START,
+        layout::MEM_32BIT_RESERVED_SIZE as usize,
+        RegionType::Reserved,
+    ));
+
+    regions
 }

 /// Configures the system and should be called once per vm before starting vcpu threads.
@@ -136,6 +145,7 @@ pub fn configure_system<T: DeviceInfoForFdt + Clone + Debug, S: ::std::hash::Bui
    virtio_iommu_bdf: Option<u32>,
    gic_device: &dyn GicDevice,
    numa_nodes: &NumaNodes,
+    pmu_supported: bool,
 ) -> super::Result<()> {
    let fdt_final = fdt::create_fdt(
        guest_mem,
@@ -148,6 +158,7 @@ pub fn configure_system<T: DeviceInfoForFdt + Clone + Debug, S: ::std::hash::Bui
        pci_space_info,
        numa_nodes,
        virtio_iommu_bdf,
+        pmu_supported,
    )
    .map_err(|_| Error::SetupFdt)?;

@@ -181,21 +192,6 @@ pub fn initramfs_load_addr(
    }
 }

-/// Returns the memory address where the kernel could be loaded.
-pub fn get_kernel_start() -> u64 {
-    layout::KERNEL_START
-}
-
-///Return guest memory address where the uefi should be loaded.
-pub fn get_uefi_start() -> u64 {
-    layout::UEFI_START
-}
-
-// Auxiliary function to get the address where the device tree blob is loaded.
-fn get_fdt_addr() -> u64 {
-    layout::FDT_START
-}
-
 pub fn get_host_cpu_phys_bits() -> u8 {
    // A dummy hypervisor created only for querying the host IPA size and will
    // be freed after the query.
@@ -215,11 +211,26 @@ mod tests {
    use super::*;

    #[test]
-    fn test_arch_memory_regions_dram() {
-        let regions = arch_memory_regions((1usize << 32) as u64); //4GB
+    fn test_arch_memory_regions_dram_2gb() {
+        let regions = arch_memory_regions((1usize << 31) as u64); //2GB
        assert_eq!(5, regions.len());
-        assert_eq!(GuestAddress(layout::RAM_64BIT_START), regions[4].0);
-        assert_eq!(1usize << 32, regions[4].1);
+        assert_eq!(layout::RAM_START, regions[3].0);
+        assert_eq!((1usize << 31), regions[3].1);
+        assert_eq!(RegionType::Ram, regions[3].2);
+        assert_eq!(RegionType::Reserved, regions[4].2);
+    }
+
+    #[test]
+    fn test_arch_memory_regions_dram_4gb() {
+        let regions = arch_memory_regions((1usize << 32) as u64); //4GB
+        let ram_32bit_space_size =
+            layout::MEM_32BIT_RESERVED_START.unchecked_offset_from(layout::RAM_START) as usize;
+        assert_eq!(6, regions.len());
+        assert_eq!(layout::RAM_START, regions[3].0);
+        assert_eq!(ram_32bit_space_size as usize, regions[3].1);
+        assert_eq!(RegionType::Ram, regions[3].2);
+        assert_eq!(RegionType::Reserved, regions[5].2);
        assert_eq!(RegionType::Ram, regions[4].2);
+        assert_eq!(((1usize << 32) - ram_32bit_space_size), regions[4].1);
    }
 }
--- a/arch/src/aarch64/regs.rs
+++ b/arch/src/aarch64/regs.rs
@@ -5,13 +5,13 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the THIRD-PARTY file.

-use super::get_fdt_addr;
 use hypervisor::kvm::kvm_bindings::{
    kvm_regs, user_pt_regs, KVM_REG_ARM64, KVM_REG_ARM_CORE, KVM_REG_SIZE_U64,
 };
 use hypervisor::{arm64_core_reg_id, offset__of};
 use std::sync::Arc;
 use std::{mem, result};
+use vm_memory::Address;

 /// Errors thrown while setting aarch64 registers.
 #[derive(Debug)]
@@ -67,7 +67,7 @@ pub fn setup_regs(vcpu: &Arc<dyn hypervisor::Vcpu>, cpu_id: u8, boot_ip: u64) ->
        let regs0 = offset__of!(user_pt_regs, regs) + kreg_off;
        vcpu.set_reg(
            arm64_core_reg_id!(KVM_REG_SIZE_U64, regs0),
-            get_fdt_addr() as u64,
+            super::layout::FDT_START.raw_value(),
        )
        .map_err(Error::SetCoreRegister)?;
    }
--- a/arch/src/lib.rs
+++ b/arch/src/lib.rs
@@ -85,8 +85,8 @@ pub mod aarch64;
 #[cfg(target_arch = "aarch64")]
 pub use aarch64::{
    arch_memory_regions, configure_system, configure_vcpu, fdt::DeviceInfoForFdt,
-    get_host_cpu_phys_bits, get_kernel_start, get_uefi_start, initramfs_load_addr, layout,
-    layout::CMDLINE_MAX_SIZE, layout::IRQ_BASE, uefi, EntryPoint,
+    get_host_cpu_phys_bits, initramfs_load_addr, layout, layout::CMDLINE_MAX_SIZE,
+    layout::IRQ_BASE, uefi, EntryPoint,
 };

 #[cfg(target_arch = "x86_64")]
@@ -158,6 +158,7 @@ impl fmt::Display for DeviceType {
 #[cfg(target_arch = "aarch64")]
 pub struct MmioDeviceInfo {
    pub addr: u64,
+    pub len: u64,
    pub irq: u32,
 }

@@ -180,6 +181,6 @@ impl DeviceInfoForFdt for MmioDeviceInfo {
        self.irq
    }
    fn length(&self) -> u64 {
-        4096
+        self.len
    }
 }
--- a/arch/src/x86_64/layout.rs
+++ b/arch/src/x86_64/layout.rs
@@ -24,6 +24,9 @@ pub const LOW_RAM_START: GuestAddress = GuestAddress(0x0);

 // == Fixed addresses within the "Low RAM" range: ==

+// Location of EBDA address
+pub const EBDA_POINTER: GuestAddress = GuestAddress(0x40e);
+
 // Initial GDT/IDT needed to boot kernel
 pub const BOOT_GDT_START: GuestAddress = GuestAddress(0x500);
 pub const BOOT_IDT_START: GuestAddress = GuestAddress(0x520);
--- a/arch/src/x86_64/mod.rs
+++ b/arch/src/x86_64/mod.rs
@@ -186,6 +186,13 @@ pub enum Error {

    /// Error checking CPUID compatibility
    CpuidCheckCompatibility,
+
+    // Error writing EBDA address
+    EbdaSetup(vm_memory::GuestMemoryError),
+
+    /// Error retrieving TDX capabilities through the hypervisor (kvm/mshv) API
+    #[cfg(feature = "tdx")]
+    TdxCapabilities(HypervisorError),
 }

 impl From<Error> for super::Error {
@@ -597,9 +604,39 @@ pub fn generate_common_cpuid(
        update_cpuid_sgx(&mut cpuid, sgx_epc_sections)?;
    }

+    #[cfg(feature = "tdx")]
+    let tdx_capabilities = if tdx_enabled {
+        let caps = hypervisor
+            .tdx_capabilities()
+            .map_err(Error::TdxCapabilities)?;
+        info!("TDX capabilities {:#?}", caps);
+        Some(caps)
+    } else {
+        None
+    };
+
    // Update some existing CPUID
    for entry in cpuid.as_mut_slice().iter_mut() {
        match entry.function {
+            0xd =>
+            {
+                #[cfg(feature = "tdx")]
+                if let Some(caps) = &tdx_capabilities {
+                    let xcr0_mask: u64 = 0x82ff;
+                    let xss_mask: u64 = !xcr0_mask;
+                    if entry.index == 0 {
+                        entry.eax &= (caps.xfam_fixed0 as u32) & (xcr0_mask as u32);
+                        entry.eax |= (caps.xfam_fixed1 as u32) & (xcr0_mask as u32);
+                        entry.edx &= ((caps.xfam_fixed0 & xcr0_mask) >> 32) as u32;
+                        entry.edx |= ((caps.xfam_fixed1 & xcr0_mask) >> 32) as u32;
+                    } else if entry.index == 1 {
+                        entry.ecx &= (caps.xfam_fixed0 as u32) & (xss_mask as u32);
+                        entry.ecx |= (caps.xfam_fixed1 as u32) & (xss_mask as u32);
+                        entry.edx &= ((caps.xfam_fixed0 & xss_mask) >> 32) as u32;
+                        entry.edx |= ((caps.xfam_fixed1 & xss_mask) >> 32) as u32;
+                    }
+                }
+            }
            // Set CPU physical bits
            0x8000_0008 => {
                entry.eax = (entry.eax & 0xffff_ff00) | (phys_bits as u32 & 0xff);
@@ -802,6 +839,11 @@ pub fn configure_system(
    rsdp_addr: Option<GuestAddress>,
    sgx_epc_region: Option<SgxEpcRegion>,
 ) -> super::Result<()> {
+    // Write EBDA address to location where ACPICA expects to find it
+    guest_mem
+        .write_obj((layout::EBDA_START.0 >> 4) as u16, layout::EBDA_POINTER)
+        .map_err(Error::EbdaSetup)?;
+
    let size = smbios::setup_smbios(guest_mem).map_err(Error::SmbiosSetup)?;

    // Place the MP table after the SMIOS table aligned to 16 bytes
--- a/arch/src/x86_64/tdx/mod.rs
+++ b/arch/src/x86_64/tdx/mod.rs
@@ -52,6 +52,9 @@ pub enum TdvfSectionType {
    Cfv,
    TdHob,
    TempMem,
+    PermMem,
+    Payload,
+    PayloadParam,
    Reserved = 0xffffffff,
 }

@@ -61,57 +64,6 @@ impl Default for TdvfSectionType {
    }
 }

-#[repr(C)]
-#[derive(Clone, Copy, Default, Debug)]
-pub struct TdVmmDataRegion {
-    pub start_address: u64,
-    pub length: u64,
-    pub region_type: TdVmmDataRegionType,
-}
-
-#[repr(u16)]
-#[derive(Clone, Copy, Debug)]
-pub enum TdVmmDataRegionType {
-    Signature = 0x0000,
-    InterfaceVersion = 0x0001,
-    SystemUuid = 0x0002,
-    RamSize = 0x0003,
-    GraphicsEnabled = 0x0004,
-    SmpCpuCount = 0x0005,
-    MachineId = 0x0006,
-    KernelAddress = 0x0007,
-    KernelSize = 0x0008,
-    KernelCommandLine = 0x0009,
-    InitrdAddress = 0x000a,
-    InitrdSize = 0x000b,
-    BootDevice = 0x000c,
-    NumaData = 0x000d,
-    BootMenu = 0x000e,
-    MaximumCpuCount = 0x000f,
-    KernelEntry = 0x0010,
-    KernelData = 0x0011,
-    InitrdData = 0x0012,
-    CommandLineAddress = 0x0013,
-    CommandLineSize = 0x0014,
-    CommandLineData = 0x0015,
-    KernelSetupAddress = 0x0016,
-    KernelSetupSize = 0x0017,
-    KernelSetupData = 0x0018,
-    FileDir = 0x0019,
-    AcpiTables = 0x8000,
-    SmbiosTables = 0x8001,
-    Irq0Override = 0x8002,
-    E820Table = 0x8003,
-    HpetData = 0x8004,
-    Reserved = 0xffff,
-}
-
-impl Default for TdVmmDataRegionType {
-    fn default() -> Self {
-        TdVmmDataRegionType::Reserved
-    }
-}
-
 pub fn parse_tdvf_sections(file: &mut File) -> Result<Vec<TdvfSection>, TdvfError> {
    // The 32-bit offset to the TDVF metadata is located 32 bytes from
    // the end of the file.
@@ -231,20 +183,41 @@ struct HobGuidType {
    name: EfiGuid,
 }

+#[repr(u32)]
+#[derive(Clone, Copy, Debug)]
+pub enum PayloadImageType {
+    ExecutablePayload,
+    BzImage,
+    RawVmLinux,
+}
+
+impl Default for PayloadImageType {
+    fn default() -> Self {
+        PayloadImageType::ExecutablePayload
+    }
+}
+
 #[repr(C)]
 #[derive(Copy, Clone, Default, Debug)]
-struct TdVmmData {
+pub struct PayloadInfo {
+    pub image_type: PayloadImageType,
+    pub entry_point: u64,
+}
+
+#[repr(C)]
+#[derive(Copy, Clone, Default, Debug)]
+struct TdPayload {
    guid_type: HobGuidType,
-    region: TdVmmDataRegion,
+    payload_info: PayloadInfo,
 }

 // SAFETY: These data structures only contain a series of integers
-unsafe impl ByteValued for TdVmmDataRegion {}
 unsafe impl ByteValued for HobHeader {}
 unsafe impl ByteValued for HobHandoffInfoTable {}
 unsafe impl ByteValued for HobResourceDescriptor {}
 unsafe impl ByteValued for HobGuidType {}
-unsafe impl ByteValued for TdVmmData {}
+unsafe impl ByteValued for PayloadInfo {}
+unsafe impl ByteValued for TdPayload {}

 pub struct TdHob {
    start_offset: u64,
@@ -351,10 +324,10 @@ impl TdHob {
            },
            /* TODO:
             * QEMU currently fills it in like this:
-             * EFI_RESOURCE_ATTRIBUTE_PRESENT | EFI_RESOURCE_ATTRIBUTE_INITIALIZED | EFI_RESOURCE_ATTRIBUTE_ENCRYPTED | EFI_RESOURCE_ATTRIBUTE_TESTED
+             * EFI_RESOURCE_ATTRIBUTE_PRESENT | EFI_RESOURCE_ATTRIBUTE_INITIALIZED | EFI_RESOURCE_ATTRIBUTE_TESTED
             * which differs from the spec (due to TDVF implementation issue?)
             */
-            0x04000007,
+            0x7,
        )
    }

@@ -376,35 +349,90 @@ impl TdHob {
        )
    }

-    pub fn add_td_vmm_data(
+    pub fn add_acpi_table(
        &mut self,
        mem: &GuestMemoryMmap,
-        region: TdVmmDataRegion,
+        table_content: &[u8],
    ) -> Result<(), TdvfError> {
-        let td_vmm_data = TdVmmData {
+        // We already know the HobGuidType size is 8 bytes multiple, but we
+        // need the total size to be 8 bytes multiple. That is why the ACPI
+        // table size must be 8 bytes multiple as well.
+        let length = std::mem::size_of::<HobGuidType>() as u16
+            + align_hob(table_content.len() as u64) as u16;
+        let hob_guid_type = HobGuidType {
+            header: HobHeader {
+                r#type: HobType::GuidExtension,
+                length,
+                reserved: 0,
+            },
+            // ACPI_TABLE_HOB_GUID
+            // 0x6a0c5870, 0xd4ed, 0x44f4, {0xa1, 0x35, 0xdd, 0x23, 0x8b, 0x6f, 0xc, 0x8d }
+            name: EfiGuid {
+                data1: 0x6a0c_5870,
+                data2: 0xd4ed,
+                data3: 0x44f4,
+                data4: [0xa1, 0x35, 0xdd, 0x23, 0x8b, 0x6f, 0xc, 0x8d],
+            },
+        };
+        info!(
+            "Writing HOB ACPI table {:x} {:x?} {:x?}",
+            self.current_offset, hob_guid_type, table_content
+        );
+        mem.write_obj(hob_guid_type, GuestAddress(self.current_offset))
+            .map_err(TdvfError::GuestMemoryWriteHob)?;
+        let current_offset = self.current_offset + std::mem::size_of::<HobGuidType>() as u64;
+
+        // In case the table is quite large, let's make sure we can handle
+        // retrying until everything has been correctly copied.
+        let mut offset: usize = 0;
+        loop {
+            let bytes_written = mem
+                .write(
+                    &table_content[offset..],
+                    GuestAddress(current_offset + offset as u64),
+                )
+                .map_err(TdvfError::GuestMemoryWriteHob)?;
+            offset += bytes_written;
+            if offset >= table_content.len() {
+                break;
+            }
+        }
+        self.current_offset += length as u64;
+
+        Ok(())
+    }
+
+    pub fn add_payload(
+        &mut self,
+        mem: &GuestMemoryMmap,
+        payload_info: PayloadInfo,
+    ) -> Result<(), TdvfError> {
+        let payload = TdPayload {
            guid_type: HobGuidType {
                header: HobHeader {
                    r#type: HobType::GuidExtension,
-                    length: std::mem::size_of::<TdVmmData>() as u16,
+                    length: std::mem::size_of::<TdPayload>() as u16,
                    reserved: 0,
                },
-                // TD_VMM_DATA_GUID CF2643E4-C0D3-46FF-0000-72EE623DDE38
+                // HOB_PAYLOAD_INFO_GUID
+                // 0xb96fa412, 0x461f, 0x4be3, {0x8c, 0xd, 0xad, 0x80, 0x5a, 0x49, 0x7a, 0xc0
                name: EfiGuid {
-                    data1: 0xcf26_43e4,
-                    data2: 0xc0d3,
-                    data3: 0x46ff,
-                    data4: [0x00, 0x00, 0x72, 0xee, 0x62, 0x3d, 0xde, 0x38],
+                    data1: 0xb96f_a412,
+                    data2: 0x461f,
+                    data3: 0x4be3,
+                    data4: [0x8c, 0xd, 0xad, 0x80, 0x5a, 0x49, 0x7a, 0xc0],
                },
            },
-            region,
+            payload_info,
        };
        info!(
-            "Writing HOB TD_VMM_DATA {:x} {:x?}",
-            self.current_offset, td_vmm_data
+            "Writing HOB TD_PAYLOAD {:x} {:x?}",
+            self.current_offset, payload
        );
-        mem.write_obj(td_vmm_data, GuestAddress(self.current_offset))
+        mem.write_obj(payload, GuestAddress(self.current_offset))
            .map_err(TdvfError::GuestMemoryWriteHob)?;
-        self.update_offset::<TdVmmData>();
+        self.update_offset::<TdPayload>();
+
        Ok(())
    }
 }
--- a/block_util/Cargo.toml
+++ b/block_util/Cargo.toml
@@ -2,22 +2,22 @@
 name = "block_util"
 version = "0.1.0"
 authors = ["The Cloud Hypervisor Authors"]
-edition = "2018"
+edition = "2021"

 [features]
 default = []

 [dependencies]
 io-uring = "0.5.2"
-libc = "0.2.112"
-log = "0.4.14"
+libc = "0.2.123"
+log = "0.4.16"
 qcow = { path = "../qcow" }
 thiserror = "1.0.30"
 versionize = "0.1.6"
 versionize_derive = "0.1.4"
 vhdx = { path = "../vhdx" }
 virtio-bindings = { version = "0.1.0", features = ["virtio-v5_0_0"] }
-virtio-queue = { path = "../virtio-queue" }
+virtio-queue = "0.2.0"
 vm-memory = { version = "0.7.0", features = ["backend-mmap", "backend-atomic", "backend-bitmap"] }
 vm-virtio = { path = "../vm-virtio" }
 vmm-sys-util = "0.9.0"
--- a/block_util/src/lib.rs
+++ b/block_util/src/lib.rs
@@ -30,6 +30,7 @@ use std::io::{self, IoSlice, IoSliceMut, Read, Seek, SeekFrom, Write};
 use std::os::linux::fs::MetadataExt;
 use std::path::Path;
 use std::result;
+use std::sync::Arc;
 use std::sync::MutexGuard;
 use versionize::{VersionMap, Versionize, VersionizeResult};
 use versionize_derive::Versionize;
@@ -39,6 +40,7 @@ use vm_memory::{
    bitmap::AtomicBitmap, bitmap::Bitmap, ByteValued, Bytes, GuestAddress, GuestMemory,
    GuestMemoryError, GuestMemoryLoadGuard,
 };
+use vm_virtio::{AccessPlatform, Translatable};
 use vmm_sys_util::eventfd::EventFd;

 type GuestMemoryMmap = vm_memory::GuestMemoryMmap<AtomicBitmap>;
@@ -190,6 +192,7 @@ pub struct Request {
 impl Request {
    pub fn parse(
        desc_chain: &mut DescriptorChain<GuestMemoryLoadGuard<GuestMemoryMmap>>,
+        access_platform: Option<&Arc<dyn AccessPlatform>>,
    ) -> result::Result<Request, Error> {
        let hdr_desc = desc_chain
            .next()
@@ -204,9 +207,13 @@ impl Request {
            return Err(Error::UnexpectedWriteOnlyDescriptor);
        }

+        let hdr_desc_addr = hdr_desc
+            .addr()
+            .translate_gva(access_platform, hdr_desc.len() as usize);
+
        let mut req = Request {
-            request_type: request_type(desc_chain.memory(), hdr_desc.addr())?,
-            sector: sector(desc_chain.memory(), hdr_desc.addr())?,
+            request_type: request_type(desc_chain.memory(), hdr_desc_addr)?,
+            sector: sector(desc_chain.memory(), hdr_desc_addr)?,
            data_descriptors: Vec::new(),
            status_addr: GuestAddress(0),
            writeback: true,
@@ -240,7 +247,12 @@ impl Request {
                if !desc.is_write_only() && req.request_type == RequestType::GetDeviceId {
                    return Err(Error::UnexpectedReadOnlyDescriptor);
                }
-                req.data_descriptors.push((desc.addr(), desc.len()));
+
+                req.data_descriptors.push((
+                    desc.addr()
+                        .translate_gva(access_platform, desc.len() as usize),
+                    desc.len(),
+                ));
                desc = desc_chain
                    .next()
                    .ok_or(Error::DescriptorChainTooShort)
@@ -261,7 +273,9 @@ impl Request {
            return Err(Error::DescriptorLengthTooSmall);
        }

-        req.status_addr = status_desc.addr();
+        req.status_addr = status_desc
+            .addr()
+            .translate_gva(access_platform, status_desc.len() as usize);

        Ok(req)
    }
--- a/devices/Cargo.toml
+++ b/devices/Cargo.toml
@@ -2,17 +2,17 @@
 name = "devices"
 version = "0.1.0"
 authors = ["The Chromium OS Authors"]
-edition = "2018"
+edition = "2021"

 [dependencies]
-acpi_tables = { path = "../acpi_tables", optional = true }
-anyhow = "1.0.52"
+acpi_tables = { path = "../acpi_tables" }
+anyhow = "1.0.56"
 arch = { path = "../arch" }
 bitflags = "1.3.2"
 byteorder = "1.4.3"
 epoll = "4.3.1"
-libc = "0.2.112"
-log = "0.4.14"
+libc = "0.2.123"
+log = "0.4.16"
 versionize = "0.1.6"
 versionize_derive = "0.1.4"
 vm-device = { path = "../vm-device" }
@@ -22,6 +22,5 @@ vmm-sys-util = "0.9.0"

 [features]
 default = []
-acpi = ["acpi_tables"]
 cmos = []
 fwdebug = []
--- a/devices/src/acpi.rs
+++ b/devices/src/acpi.rs
@@ -102,7 +102,6 @@ impl BusDevice for AcpiGedDevice {
    }
 }

-#[cfg(feature = "acpi")]
 impl Aml for AcpiGedDevice {
    fn append_aml_bytes(&self, bytes: &mut Vec<u8>) {
        aml::Device::new(
--- a/devices/src/gic.rs
+++ b/devices/src/gic.rs
@@ -76,6 +76,7 @@ impl InterruptController for Gic {
                .update(
                    i as InterruptIndex,
                    InterruptSourceConfig::LegacyIrq(config),
+                    false,
                )
                .map_err(Error::EnableInterrupt)?;
        }
--- a/devices/src/ioapic.rs
+++ b/devices/src/ioapic.rs
@@ -367,19 +367,13 @@ impl Ioapic {
        };

        self.interrupt_source_group
-            .update(irq as InterruptIndex, InterruptSourceConfig::MsiIrq(config))
+            .update(
+                irq as InterruptIndex,
+                InterruptSourceConfig::MsiIrq(config),
+                interrupt_mask(entry) == 1,
+            )
            .map_err(Error::UpdateInterrupt)?;

-        if interrupt_mask(entry) == 1 {
-            self.interrupt_source_group
-                .mask(irq as InterruptIndex)
-                .map_err(Error::MaskInterrupt)?;
-        } else {
-            self.interrupt_source_group
-                .unmask(irq as InterruptIndex)
-                .map_err(Error::UnmaskInterrupt)?;
-        }
-
        Ok(())
    }
 }
--- a/devices/src/legacy/cmos.rs
+++ b/devices/src/legacy/cmos.rs
@@ -7,6 +7,7 @@ use std::cmp::min;
 use std::mem;
 use std::sync::{Arc, Barrier};
 use vm_device::BusDevice;
+use vmm_sys_util::eventfd::EventFd;

 // https://github.com/rust-lang/libc/issues/1848
 #[cfg_attr(target_env = "musl", allow(deprecated))]
@@ -21,13 +22,14 @@ const DATA_LEN: usize = 128;
 pub struct Cmos {
    index: u8,
    data: [u8; DATA_LEN],
+    reset_evt: EventFd,
 }

 impl Cmos {
    /// Constructs a CMOS/RTC device with initial data.
    /// `mem_below_4g` is the size of memory in bytes below the 32-bit gap.
    /// `mem_above_4g` is the size of memory in bytes above the 32-bit gap.
-    pub fn new(mem_below_4g: u64, mem_above_4g: u64) -> Cmos {
+    pub fn new(mem_below_4g: u64, mem_above_4g: u64, reset_evt: EventFd) -> Cmos {
        let mut data = [0u8; DATA_LEN];

        // Extended memory from 16 MB to 4 GB in units of 64 KB
@@ -44,7 +46,11 @@ impl Cmos {
        data[0x5c] = (high_mem >> 8) as u8;
        data[0x5d] = (high_mem >> 16) as u8;

-        Cmos { index: 0, data }
+        Cmos {
+            index: 0,
+            data,
+            reset_evt,
+        }
    }
 }

@@ -56,8 +62,15 @@ impl BusDevice for Cmos {
        }

        match offset {
-            INDEX_OFFSET => self.index = data[0] & INDEX_MASK,
-            DATA_OFFSET => self.data[self.index as usize] = data[0],
+            INDEX_OFFSET => self.index = data[0],
+            DATA_OFFSET => {
+                if self.index == 0x8f && data[0] == 0 {
+                    info!("CMOS reset");
+                    self.reset_evt.write(1).unwrap();
+                } else {
+                    self.data[(self.index & INDEX_MASK) as usize] = data[0]
+                }
+            }
            o => warn!("bad write offset on CMOS device: {}", o),
        };
        None
--- a/devices/src/legacy/gpio_pl061.rs
+++ b/devices/src/legacy/gpio_pl061.rs
@@ -356,6 +356,7 @@ mod tests {
            &self,
            _index: InterruptIndex,
            _config: InterruptSourceConfig,
+            _masked: bool,
        ) -> result::Result<(), std::io::Error> {
            Ok(())
        }
--- a/devices/src/legacy/mod.rs
+++ b/devices/src/legacy/mod.rs
@@ -5,7 +5,6 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE-BSD-3-Clause file.

-#[cfg(feature = "cmos")]
 mod cmos;
 #[cfg(feature = "fwdebug")]
 mod fwdebug;
@@ -18,7 +17,6 @@ mod serial;
 #[cfg(target_arch = "aarch64")]
 mod uart_pl011;

-#[cfg(feature = "cmos")]
 pub use self::cmos::Cmos;
 #[cfg(feature = "fwdebug")]
 pub use self::fwdebug::FwDebugDevice;
--- a/devices/src/legacy/rtc_pl031.rs
+++ b/devices/src/legacy/rtc_pl031.rs
@@ -430,6 +430,7 @@ mod tests {
            &self,
            _index: InterruptIndex,
            _config: InterruptSourceConfig,
+            _masked: bool,
        ) -> result::Result<(), std::io::Error> {
            Ok(())
        }
--- a/devices/src/legacy/serial.rs
+++ b/devices/src/legacy/serial.rs
@@ -339,6 +339,7 @@ mod tests {
            &self,
            _index: InterruptIndex,
            _config: InterruptSourceConfig,
+            _masked: bool,
        ) -> result::Result<(), std::io::Error> {
            Ok(())
        }
--- a/devices/src/legacy/uart_pl011.rs
+++ b/devices/src/legacy/uart_pl011.rs
@@ -34,6 +34,7 @@ const UARTRIS: u64 = 15;
 const UARTMIS: u64 = 16;
 const UARTICR: u64 = 17;
 const UARTDMACR: u64 = 18;
+const UARTDEBUG: u64 = 0x3c0;

 const PL011_INT_TX: u32 = 0x20;
 const PL011_INT_RX: u32 = 0x10;
@@ -77,6 +78,7 @@ pub struct Pl011 {
    rsr: u32,
    cr: u32,
    dmacr: u32,
+    debug: u32,
    int_enabled: u32,
    int_level: u32,
    read_fifo: VecDeque<u8>,
@@ -88,6 +90,7 @@ pub struct Pl011 {
    read_trigger: u32,
    irq: Arc<dyn InterruptSourceGroup>,
    out: Option<Box<dyn io::Write + Send>>,
+    timestamp: std::time::Instant,
 }

 #[derive(Versionize)]
@@ -97,6 +100,7 @@ pub struct Pl011State {
    rsr: u32,
    cr: u32,
    dmacr: u32,
+    debug: u32,
    int_enabled: u32,
    int_level: u32,
    read_fifo: Vec<u8>,
@@ -124,6 +128,7 @@ impl Pl011 {
            rsr: 0u32,
            cr: 0x300u32,
            dmacr: 0u32,
+            debug: 0u32,
            int_enabled: 0u32,
            int_level: 0u32,
            read_fifo: VecDeque::new(),
@@ -135,6 +140,7 @@ impl Pl011 {
            read_trigger: 1u32,
            irq,
            out,
+            timestamp: std::time::Instant::now(),
        }
    }

@@ -149,6 +155,7 @@ impl Pl011 {
            rsr: self.rsr,
            cr: self.cr,
            dmacr: self.dmacr,
+            debug: self.debug,
            int_enabled: self.int_enabled,
            int_level: self.int_level,
            read_fifo: self.read_fifo.clone().into(),
@@ -167,6 +174,7 @@ impl Pl011 {
        self.rsr = state.rsr;
        self.cr = state.cr;
        self.dmacr = state.dmacr;
+        self.debug = state.debug;
        self.int_enabled = state.int_enabled;
        self.int_level = state.int_level;
        self.read_fifo = state.read_fifo.clone().into();
@@ -280,13 +288,50 @@ impl Pl011 {
                    return Err(Error::DmaNotImplemented);
                }
            }
+            UARTDEBUG => {
+                self.debug = val;
+                self.handle_debug();
+            }
            off => {
+                debug!("PL011: Bad write offset, offset: {}", off);
                return Err(Error::BadWriteOffset(off));
            }
        }
        Ok(())
    }

+    fn handle_debug(&self) {
+        let elapsed = self.timestamp.elapsed();
+
+        match self.debug {
+            0x00..=0x1f => info!(
+                "[Debug I/O port: Firmware code: 0x{:x}] {}.{:>06} seconds",
+                self.debug,
+                elapsed.as_secs(),
+                elapsed.as_micros()
+            ),
+            0x20..=0x3f => info!(
+                "[Debug I/O port: Bootloader code: 0x{:x}] {}.{:>06} seconds",
+                self.debug,
+                elapsed.as_secs(),
+                elapsed.as_micros()
+            ),
+            0x40..=0x5f => info!(
+                "[Debug I/O port: Kernel code: 0x{:x}] {}.{:>06} seconds",
+                self.debug,
+                elapsed.as_secs(),
+                elapsed.as_micros()
+            ),
+            0x60..=0x7f => info!(
+                "[Debug I/O port: Userspace code: 0x{:x}] {}.{:>06} seconds",
+                self.debug,
+                elapsed.as_secs(),
+                elapsed.as_micros()
+            ),
+            _ => {}
+        }
+    }
+
    fn trigger_interrupt(&mut self) -> result::Result<(), io::Error> {
        self.irq.trigger(0)
    }
@@ -327,6 +372,7 @@ impl BusDevice for Pl011 {
                UARTRIS => self.int_level,
                UARTMIS => (self.int_level & self.int_enabled),
                UARTDMACR => self.dmacr,
+                UARTDEBUG => self.debug,
                _ => {
                    read_ok = false;
                    0
@@ -404,6 +450,7 @@ mod tests {
            &self,
            _index: InterruptIndex,
            _config: InterruptSourceConfig,
+            _masked: bool,
        ) -> result::Result<(), std::io::Error> {
            Ok(())
        }
--- a/devices/src/lib.rs
+++ b/devices/src/lib.rs
@@ -12,7 +12,6 @@ extern crate bitflags;
 #[macro_use]
 extern crate log;

-#[cfg(feature = "acpi")]
 pub mod acpi;
 #[cfg(target_arch = "aarch64")]
 pub mod gic;
@@ -21,7 +20,6 @@ pub mod interrupt_controller;
 pub mod ioapic;
 pub mod legacy;

-#[cfg(feature = "acpi")]
 pub use self::acpi::{AcpiGedDevice, AcpiPmTimerDevice, AcpiShutdownDevice};

 bitflags! {
--- a/docs/COPYING.docs
+++ b/docs/COPYING.docs
@@ -0,0 +1,399 @@
+The documentation in this directory is covered by the following license:
+
+Attribution 4.0 International
+
+=======================================================================
+
+Creative Commons Corporation ("Creative Commons") is not a law firm and
+does not provide legal services or legal advice. Distribution of
+Creative Commons public licenses does not create a lawyer-client or
+other relationship. Creative Commons makes its licenses and related
+information available on an "as-is" basis. Creative Commons gives no
+warranties regarding its licenses, any material licensed under their
+terms and conditions, or any related information. Creative Commons
+disclaims all liability for damages resulting from their use to the
+fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and
+conditions that creators and other rights holders may use to share
+original works of authorship and other material subject to copyright
+and certain other rights specified in the public license below. The
+following considerations are for informational purposes only, are not
+exhaustive, and do not form part of our licenses.
+
+     Considerations for licensors: Our public licenses are
+     intended for use by those authorized to give the public
+     permission to use material in ways otherwise restricted by
+     copyright and certain other rights. Our licenses are
+     irrevocable. Licensors should read and understand the terms
+     and conditions of the license they choose before applying it.
+     Licensors should also secure all rights necessary before
+     applying our licenses so that the public can reuse the
+     material as expected. Licensors should clearly mark any
+     material not subject to the license. This includes other CC-
+     licensed material, or material used under an exception or
+     limitation to copyright. More considerations for licensors:
+    wiki.creativecommons.org/Considerations_for_licensors
+
+     Considerations for the public: By using one of our public
+     licenses, a licensor grants the public permission to use the
+     licensed material under specified terms and conditions. If
+     the licensor's permission is not necessary for any reason--for
+     example, because of any applicable exception or limitation to
+     copyright--then that use is not regulated by the license. Our
+     licenses grant only permissions under copyright and certain
+     other rights that a licensor has authority to grant. Use of
+     the licensed material may still be restricted for other
+     reasons, including because others have copyright or other
+     rights in the material. A licensor may make special requests,
+     such as asking that all changes be marked or described.
+     Although not required by our licenses, you are encouraged to
+     respect those requests where reasonable. More considerations
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
+
+=======================================================================
+
+Creative Commons Attribution 4.0 International Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Creative Commons
+Attribution 4.0 International Public License ("Public License"). To the
+extent this Public License may be interpreted as a contract, You are
+granted the Licensed Rights in consideration of Your acceptance of
+these terms and conditions, and the Licensor grants You such rights in
+consideration of benefits the Licensor receives from making the
+Licensed Material available under these terms and conditions.
+
+
+Section 1 -- Definitions.
+
+  a. Adapted Material means material subject to Copyright and Similar
+     Rights that is derived from or based upon the Licensed Material
+     and in which the Licensed Material is translated, altered,
+     arranged, transformed, or otherwise modified in a manner requiring
+     permission under the Copyright and Similar Rights held by the
+     Licensor. For purposes of this Public License, where the Licensed
+     Material is a musical work, performance, or sound recording,
+     Adapted Material is always produced where the Licensed Material is
+     synched in timed relation with a moving image.
+
+  b. Adapter's License means the license You apply to Your Copyright
+     and Similar Rights in Your contributions to Adapted Material in
+     accordance with the terms and conditions of this Public License.
+
+  c. Copyright and Similar Rights means copyright and/or similar rights
+     closely related to copyright including, without limitation,
+     performance, broadcast, sound recording, and Sui Generis Database
+     Rights, without regard to how the rights are labeled or
+     categorized. For purposes of this Public License, the rights
+     specified in Section 2(b)(1)-(2) are not Copyright and Similar
+     Rights.
+
+  d. Effective Technological Measures means those measures that, in the
+     absence of proper authority, may not be circumvented under laws
+     fulfilling obligations under Article 11 of the WIPO Copyright
+     Treaty adopted on December 20, 1996, and/or similar international
+     agreements.
+
+  e. Exceptions and Limitations means fair use, fair dealing, and/or
+     any other exception or limitation to Copyright and Similar Rights
+     that applies to Your use of the Licensed Material.
+
+  f. Licensed Material means the artistic or literary work, database,
+     or other material to which the Licensor applied this Public
+     License.
+
+  g. Licensed Rights means the rights granted to You subject to the
+     terms and conditions of this Public License, which are limited to
+     all Copyright and Similar Rights that apply to Your use of the
+     Licensed Material and that the Licensor has authority to license.
+
+  h. Licensor means the individual(s) or entity(ies) granting rights
+     under this Public License.
+
+  i. Share means to provide material to the public by any means or
+     process that requires permission under the Licensed Rights, such
+     as reproduction, public display, public performance, distribution,
+     dissemination, communication, or importation, and to make material
+     available to the public including in ways that members of the
+     public may access the material from a place and at a time
+     individually chosen by them.
+
+  j. Sui Generis Database Rights means rights other than copyright
+     resulting from Directive 96/9/EC of the European Parliament and of
+     the Council of 11 March 1996 on the legal protection of databases,
+     as amended and/or succeeded, as well as other essentially
+     equivalent rights anywhere in the world.
+
+  k. You means the individual or entity exercising the Licensed Rights
+     under this Public License. Your has a corresponding meaning.
+
+
+Section 2 -- Scope.
+
+  a. License grant.
+
+       1. Subject to the terms and conditions of this Public License,
+          the Licensor hereby grants You a worldwide, royalty-free,
+          non-sublicensable, non-exclusive, irrevocable license to
+          exercise the Licensed Rights in the Licensed Material to:
+
+            a. reproduce and Share the Licensed Material, in whole or
+               in part; and
+
+            b. produce, reproduce, and Share Adapted Material.
+
+       2. Exceptions and Limitations. For the avoidance of doubt, where
+          Exceptions and Limitations apply to Your use, this Public
+          License does not apply, and You do not need to comply with
+          its terms and conditions.
+
+       3. Term. The term of this Public License is specified in Section
+          6(a).
+
+       4. Media and formats; technical modifications allowed. The
+          Licensor authorizes You to exercise the Licensed Rights in
+          all media and formats whether now known or hereafter created,
+          and to make technical modifications necessary to do so. The
+          Licensor waives and/or agrees not to assert any right or
+          authority to forbid You from making technical modifications
+          necessary to exercise the Licensed Rights, including
+          technical modifications necessary to circumvent Effective
+          Technological Measures. For purposes of this Public License,
+          simply making modifications authorized by this Section 2(a)
+          (4) never produces Adapted Material.
+
+       5. Downstream recipients.
+
+            a. Offer from the Licensor -- Licensed Material. Every
+               recipient of the Licensed Material automatically
+               receives an offer from the Licensor to exercise the
+               Licensed Rights under the terms and conditions of this
+               Public License.
+
+            b. No downstream restrictions. You may not offer or impose
+               any additional or different terms or conditions on, or
+               apply any Effective Technological Measures to, the
+               Licensed Material if doing so restricts exercise of the
+               Licensed Rights by any recipient of the Licensed
+               Material.
+
+       6. No endorsement. Nothing in this Public License constitutes or
+          may be construed as permission to assert or imply that You
+          are, or that Your use of the Licensed Material is, connected
+          with, or sponsored, endorsed, or granted official status by,
+          the Licensor or others designated to receive attribution as
+          provided in Section 3(a)(1)(A)(i).
+
+  b. Other rights.
+
+       1. Moral rights, such as the right of integrity, are not
+          licensed under this Public License, nor are publicity,
+          privacy, and/or other similar personality rights; however, to
+          the extent possible, the Licensor waives and/or agrees not to
+          assert any such rights held by the Licensor to the limited
+          extent necessary to allow You to exercise the Licensed
+          Rights, but not otherwise.
+
+       2. Patent and trademark rights are not licensed under this
+          Public License.
+
+       3. To the extent possible, the Licensor waives any right to
+          collect royalties from You for the exercise of the Licensed
+          Rights, whether directly or through a collecting society
+          under any voluntary or waivable statutory or compulsory
+          licensing scheme. In all other cases the Licensor expressly
+          reserves any right to collect such royalties.
+
+
+Section 3 -- License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the
+following conditions.
+
+  a. Attribution.
+
+       1. If You Share the Licensed Material (including in modified
+          form), You must:
+
+            a. retain the following if it is supplied by the Licensor
+               with the Licensed Material:
+
+                 i. identification of the creator(s) of the Licensed
+                    Material and any others designated to receive
+                    attribution, in any reasonable manner requested by
+                    the Licensor (including by pseudonym if
+                    designated);
+
+                ii. a copyright notice;
+
+               iii. a notice that refers to this Public License;
+
+                iv. a notice that refers to the disclaimer of
+                    warranties;
+
+                 v. a URI or hyperlink to the Licensed Material to the
+                    extent reasonably practicable;
+
+            b. indicate if You modified the Licensed Material and
+               retain an indication of any previous modifications; and
+
+            c. indicate the Licensed Material is licensed under this
+               Public License, and include the text of, or the URI or
+               hyperlink to, this Public License.
+
+       2. You may satisfy the conditions in Section 3(a)(1) in any
+          reasonable manner based on the medium, means, and context in
+          which You Share the Licensed Material. For example, it may be
+          reasonable to satisfy the conditions by providing a URI or
+          hyperlink to a resource that includes the required
+          information.
+
+       3. If requested by the Licensor, You must remove any of the
+          information required by Section 3(a)(1)(A) to the extent
+          reasonably practicable.
+
+       4. If You Share Adapted Material You produce, the Adapter's
+          License You apply must not prevent recipients of the Adapted
+          Material from complying with this Public License.
+
+
+Section 4 -- Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that
+apply to Your use of the Licensed Material:
+
+  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
+     to extract, reuse, reproduce, and Share all or a substantial
+     portion of the contents of the database;
+
+  b. if You include all or a substantial portion of the database
+     contents in a database in which You have Sui Generis Database
+     Rights, then the database in which You have Sui Generis Database
+     Rights (but not its individual contents) is Adapted Material; and
+
+  c. You must comply with the conditions in Section 3(a) if You Share
+     all or a substantial portion of the contents of the database.
+
+For the avoidance of doubt, this Section 4 supplements and does not
+replace Your obligations under this Public License where the Licensed
+Rights include other Copyright and Similar Rights.
+
+
+Section 5 -- Disclaimer of Warranties and Limitation of Liability.
+
+  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+  c. The disclaimer of warranties and limitation of liability provided
+     above shall be interpreted in a manner that, to the extent
+     possible, most closely approximates an absolute disclaimer and
+     waiver of all liability.
+
+
+Section 6 -- Term and Termination.
+
+  a. This Public License applies for the term of the Copyright and
+     Similar Rights licensed here. However, if You fail to comply with
+     this Public License, then Your rights under this Public License
+     terminate automatically.
+
+  b. Where Your right to use the Licensed Material has terminated under
+     Section 6(a), it reinstates:
+
+       1. automatically as of the date the violation is cured, provided
+          it is cured within 30 days of Your discovery of the
+          violation; or
+
+       2. upon express reinstatement by the Licensor.
+
+     For the avoidance of doubt, this Section 6(b) does not affect any
+     right the Licensor may have to seek remedies for Your violations
+     of this Public License.
+
+  c. For the avoidance of doubt, the Licensor may also offer the
+     Licensed Material under separate terms or conditions or stop
+     distributing the Licensed Material at any time; however, doing so
+     will not terminate this Public License.
+
+  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
+     License.
+
+
+Section 7 -- Other Terms and Conditions.
+
+  a. The Licensor shall not be bound by any additional or different
+     terms or conditions communicated by You unless expressly agreed.
+
+  b. Any arrangements, understandings, or agreements regarding the
+     Licensed Material not stated herein are separate from and
+     independent of the terms and conditions of this Public License.
+
+
+Section 8 -- Interpretation.
+
+  a. For the avoidance of doubt, this Public License does not, and
+     shall not be interpreted to, reduce, limit, restrict, or impose
+     conditions on any use of the Licensed Material that could lawfully
+     be made without permission under this Public License.
+
+  b. To the extent possible, if any provision of this Public License is
+     deemed unenforceable, it shall be automatically reformed to the
+     minimum extent necessary to make it enforceable. If the provision
+     cannot be reformed, it shall be severed from this Public License
+     without affecting the enforceability of the remaining terms and
+     conditions.
+
+  c. No term or condition of this Public License will be waived and no
+     failure to comply consented to unless expressly agreed to by the
+     Licensor.
+
+  d. Nothing in this Public License constitutes or may be interpreted
+     as a limitation upon, or waiver of, any privileges and immunities
+     that apply to the Licensor or You, including from the legal
+     processes of any jurisdiction or authority.
+
+
+=======================================================================
+
+Creative Commons is not a party to its public
+licenses. Notwithstanding, Creative Commons may elect to apply one of
+its public licenses to material it publishes and in those instances
+will be considered the “Licensor.” The text of the Creative Commons
+public licenses is dedicated to the public domain under the CC0 Public
+Domain Dedication. Except for the limited purpose of indicating that
+material is shared under a Creative Commons public license or as
+otherwise permitted by the Creative Commons policies published at
+creativecommons.org/policies, Creative Commons does not authorize the
+use of the trademark "Creative Commons" or any other trademark or logo
+of Creative Commons without its prior written consent including,
+without limitation, in connection with any unauthorized modifications
+to any of its public licenses or any other arrangements,
+understandings, or agreements concerning use of licensed material. For
+the avoidance of doubt, this paragraph does not form part of the
+public licenses.
+
+Creative Commons may be contacted at creativecommons.org.
+
+
--- a/docs/api.md
+++ b/docs/api.md
@@ -88,6 +88,8 @@ Reboot the VM                      | `/vm.reboot`         | N/A
 Trigger power button of the VM     | `/vm.power-button`   | N/A                       | N/A                      | The VM is booted
 Pause the VM                       | `/vm.pause`          | N/A                       | N/A                      | The VM is booted
 Resume the VM                      | `/vm.resume`         | N/A                       | N/A                      | The VM is paused
+Task a snapshot of the VM          | `/vm.snapshot`       | `/schemas/VmSnapshotConfig`| N/A                     | The VM is paused
+Restore the VM from a snapshot     | `/vm.restore`        | `/schemas/RestoreConfig`  | N/A                      | The VM is created but not booted
 Add/remove CPUs to/from the VM     | `/vm.resize`         | `/schemas/VmResize`       | N/A                      | The VM is booted
 Add/remove memory from the VM      | `/vm.resize`         | `/schemas/VmResize`       | N/A                      | The VM is booted
 Add/remove memory from a zone      | `/vm.resize-zone`    | `/schemas/VmResizeZone`   | N/A                      | The VM is booted
@@ -98,6 +100,7 @@ Add fs device to the VM            | `/vm.add-fs`         | `/schemas/FsConfig`
 Add pmem device to the VM          | `/vm.add-pmem`       | `/schemas/PmemConfig`     | `/schemas/PciDeviceInfo` | The VM is booted
 Add network device to the VM       | `/vm.add-net`        | `/schemas/NetConfig`      | `/schemas/PciDeviceInfo` | The VM is booted
 Add userspace PCI device to the VM | `/vm.add-user-device`| `/schemas/VmAddUserDevice`| `/schemas/PciDeviceInfo` | The VM is booted
+Add vdpa device to the VM          | `/vm.add-vdpa`       | `/schemas/VdpaConfig`     | `/schemas/PciDeviceInfo` | The VM is booted
 Add vsock device to the VM         | `/vm.add-vsock`      | `/schemas/VsockConfig`    | `/schemas/PciDeviceInfo` | The VM is booted
 Remove device from the VM          | `/vm.remove-device`  | `/schemas/VmRemoveDevice` | N/A                      | The VM is booted
 Dump the VM counters               | `/vm.counters`       | N/A                       | `/schemas/VmCounters`    | The VM is booted
--- a/docs/balloon.md
+++ b/docs/balloon.md
@@ -0,0 +1,76 @@
+# Balloon
+
+Cloud Hypervisor implements a balloon device based on the VIRTIO specification.
+Its main purpose is to provide the host a way to reclaim memory by controlling
+the amount of memory visible to the guest. But it also provides some interesting
+features related to guest memory management.
+
+## Parameters
+
+`BalloonConfig` (known as `--balloon` from the CLI perspective) contains the
+list of parameters available for the balloon device.
+
+```rust
+struct BalloonConfig {
+    pub size: u64,
+    pub deflate_on_oom: bool,
+    pub free_page_reporting: bool,
+}
+```
+
+```
+--balloon <balloon>	Balloon parameters "size=<balloon_size>,deflate_on_oom=on|off,free_page_reporting=on|off"
+```
+
+### `size`
+
+Size of the balloon device. It is subtracted from the VM's total size. For
+instance, if creating a VM with 4GiB of RAM, along with a balloon of 1GiB, the
+guest will be able to use 3GiB of accessible memory. The guest sees all the RAM
+and unless it is balloon enlightened is entitled to all of it.
+
+This parameter is mandatory.
+
+Value is an unsigned integer of 64 bits corresponding to the balloon size in
+bytes.
+
+_Example_
+
+```
+--balloon size=1G
+```
+
+### `deflate_on_oom`
+
+Allow the guest to deflate the balloon if running Out Of Memory (OOM). Assuming
+the balloon size is greater than 0, this means the guest is allowed to reduce
+the balloon size all the way down to 0 if this can help recover from the OOM
+event.
+
+This parameter is optional.
+
+Value is a boolean set to `off` by default.
+
+_Example_
+
+```
+--ballloon size=2G,deflate_on_oom=on
+```
+
+### `free_page_reporting`
+
+Allow the guest to report lists of free pages. This feature doesn't require the
+balloon to be of any specific size as it doesn't impact the balloon size. The
+guest can let the VMM know about pages that are free after they have been used.
+Based on this information, the VMM can advise the host that it doesn't need
+these pages anymore.
+
+This parameter is optional.
+
+Value is a boolean set to `off` by default.
+
+_Example_
+
+```
+--ballloon size=0,free_page_reporting=on
+```
--- a/docs/cpu.md
+++ b/docs/cpu.md
@@ -17,11 +17,12 @@ struct CpusConfig {
    kvm_hyperv: bool,
    max_phys_bits: u8,
    affinity: Option<Vec<CpuAffinity>>,
+    features: CpuFeatures,
 }
 ```

 ```
--cpus boot=<boot_vcpus>,max=<max_vcpus>,topology=<threads_per_core>:<cores_per_die>:<dies_per_package>:<packages>,kvm_hyperv=on|off,max_phys_bits=<maximum_number_of_physical_bits>,affinity=<list_of_vcpus_with_their_associated_cpuset>
+--cpus boot=<boot_vcpus>,max=<max_vcpus>,topology=<threads_per_core>:<cores_per_die>:<dies_per_package>:<packages>,kvm_hyperv=on|off,max_phys_bits=<maximum_number_of_physical_bits>,affinity=<list_of_vcpus_with_their_associated_cpuset>,features=<list_of_features_to_enable>
 ```

 ### `boot`
@@ -187,3 +188,24 @@ _Example_
 In this example, assuming the host has 4 CPUs, vCPU 0 will run exclusively on
 host CPUs 2 and 3, while vCPU 1 will run exclusively on host CPUs 0 and 1.
 Because nothing is defined for vCPU 2, it can run on any of the 4 host CPUs.
+
+### `features`
+
+Set of CPU features to enable.
+
+This option allows the user to enable a set of CPU features that are disabled
+by default otherwise.
+
+The currently available feature set is: `amx`.
+
+The `amx` feature will enable the x86 extension adding hardware units for
+matrix operations (int and float dot products). The goal of the extension is to
+provide performance enhancements for these common operations.
+
+_Example_
+
+```
+--cpus features=amx
+```
+
+In this example the amx CPU feature will be enabled for the VMM.
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -1,23 +1,27 @@
 # How to use virtio-fs

-In the context of virtualization, it is always convenient to be able to share a directory from the host with the guest.
+In the context of virtualization, it is always convenient to be able to share a
+directory from the host with the guest.

-__virtio-fs__, also known as __vhost-user-fs__ is a virtual device defined by the VIRTIO specification which allows any VMM to perform filesystem sharing.
+__virtio-fs__, also known as __vhost-user-fs__ is a virtual device defined by
+the VIRTIO specification which allows any VMM to perform filesystem sharing.

 ## Pre-requisites

 ### The daemon

-This virtual device relies on the _vhost-user_ protocol, which assumes the backend (device emulation) is handled by a dedicated process running on the host. This daemon is called __virtiofsd__ and needs to be present on the host.
+This virtual device relies on the _vhost-user_ protocol, which assumes the
+backend (device emulation) is handled by a dedicated process running on the
+host. This daemon is called __virtiofsd__ and needs to be present on the host.

 _Build virtiofsd_
 ```bash
-git clone --depth 1 "https://gitlab.com/virtio-fs/qemu.git" -b "qemu5.0-virtiofs-dax" $VIRTIOFSD_DIR
-cd $VIRTIOFSD_DIR
-./configure --prefix=$PWD --target-list=x86_64-softmmu
-make virtiofsd -j `nproc`
-sudo setcap cap_sys_admin+epi "virtiofsd"
+git clone https://gitlab.com/virtio-fs/virtiofsd
+pushd virtiofsd
+cargo build --release
+sudo setcap cap_sys_admin+epi target/release/virtiofsd
 ```
+
 _Create shared directory_
 ```bash
 mkdir /tmp/shared_dir
@@ -27,29 +31,39 @@ _Run virtiofsd_
 ./virtiofsd \
    -d \
    --socket-path=/tmp/virtiofs \
-    -o source=/tmp/shared_dir \
-    -o cache=none
+    --shared-dir=/tmp/shared_dir \
+    --cache=never
 ```

-The `cache=none` option should be the default when using `virtiofsd` with the __cloud-hypervisor__ VMM. This prevents from using the guest page cache, which reduces the memory footprint of the guest. When running multiple virtual machines on the same host, this will let the host deal with page cache, which will increase the density of virtual machines which can be launched.
+The `cache=never` option is the default when using `virtiofsd` with
+Cloud Hypervisor. This prevents from using the host page cache, reducing the
+overall footprint on host memory. This increases the maximum density of virtual
+machines that can be launched on a single host.

-The `cache=always` option will allow for the guest page cache to be used, which will increase the memory footprint of the guest. This option should be used only for specific use cases where a single VM is going to be running on a host.
+The `cache=always` option will allow the host page cache to be used, which can
+result in better performance for the guest's workload at the cost of increasing
+the footprint on host memory.

 ### Kernel support

-Modern Linux kernels starting (at least v5.10) have support for virtio-fs. Use
-of older kernels, with additional patches, are not supported.
+Modern Linux kernels (at least v5.10) have support for virtio-fs. Use of older
+kernels, with additional patches, are not supported.

 ## How to share directories with cloud-hypervisor

 ### Start the VM
-Once the daemon is running, the option `--fs` from __cloud-hypervisor__ needs to be used.

-Direct kernel boot is the preferred option, but we can boot from an EFI cloud image if it contains a recent enough kernel.
+Once the daemon is running, the option `--fs` from Cloud Hypervisor needs
+to be used.

-Because _vhost-user_ expects a dedicated process (__virtiofsd__ in this case) to be able to access the guest RAM to communicate through the _virtqueues_ with the driver running in the guest, `--memory` option needs to be slightly modified. It must specify `shared=on` to share the memory pages so that an external process can access them.
+Both direct kernel boot and EFI firmware can be used to boot a VM with
+virtio-fs, given that the cloud image contains a recent enough kernel.

-Assuming you have `focal-server-cloudimg-amd64.raw` and `vmlinux` on your system, here is the __cloud-hypervisor__ command you need to run:
+Correct functioning of `--fs` requires `--memory shared=on` to facilitate
+interprocess memory sharing.
+
+Assuming you have `focal-server-cloudimg-amd64.raw` and `vmlinux` on your
+system, here is the Cloud Hypervisor command you need to run:
 ```bash
 ./cloud-hypervisor \
    --cpus boot=1 \
@@ -60,26 +74,20 @@ Assuming you have `focal-server-cloudimg-amd64.raw` and `vmlinux` on your system
    --fs tag=myfs,socket=/tmp/virtiofs,num_queues=1,queue_size=512
 ```

-By default, DAX is enabled with a cache window of 8GiB. You can specify a custom size (let's say 4GiB for this example) for the cache by explicitly setting DAX and the cache size:
-
-```bash
--fs tag=myfs,socket=/tmp/virtiofs,num_queues=1,queue_size=512,dax=on,cache_size=4G
-
-```
-
-In case you don't want to use a shared window of cache to pass the shared files content, this means you will have to explicitly disable DAX with `dax=off`. Note that in this case, the `cache_size` parameter will be ignored.
-
-```bash
--fs tag=myfs,socket=/tmp/virtiofs,num_queues=1,queue_size=512,dax=off
-
-```
-
 ### Mount the shared directory
-The last step is to mount the shared directory inside the guest, using the `virtiofs` filesystem type.
+
+The last step is to mount the shared directory inside the guest, using the
+`virtiofs` filesystem type.
+
 ```bash
 mkdir mount_dir
-mount -t virtiofs -o dax myfs mount_dir/
+mount -t virtiofs myfs mount_dir/
 ```
-The `tag` needs to be consistent with what has been provided through the __cloud-hypervisor__ command line, which happens to be `myfs` in this example.

-The `-o dax` option must be removed in case the shared cache region is not enabled from the VMM.
+The `tag` needs to be consistent with what has been provided through the
+Cloud Hypervisor command line, which happens to be `myfs` in this example.
+
+## DAX feature
+
+Given the DAX feature is not stable yet from a daemon standpoint, it is not
+available in Cloud Hypervisor.
--- a/docs/gdb.md
+++ b/docs/gdb.md
@@ -0,0 +1,47 @@
+# GDB Support
+
+This feature allows remote guest debugging using GDB. Note that this feature is only supported on x86_64/KVM.
+
+To enable debugging with GDB, build with the `gdb` feature enabled:
+
+```bash
+cargo build --features gdb
+```
+
+To use the `--gdb` option, specify the Unix Domain Socket with `--path` that Cloud Hypervisor will use to communicate with the host's GDB:
+
+```bash
+./cloud-hypervisor \
+    --kernel hypervisor-fw \
+    --disk path=bionic-server-cloudimg-amd64.raw \
+    --cpus boot=1 \
+    --memory size=1024M \
+    --net "tap=,mac=,ip=,mask=" \
+    --console off \
+    --serial tty \
+    --gdb path=/tmp/ch-gdb-sock
+```
+
+Cloud Hypervisor will listen for GDB on the host side before starting the guest.
+On the host side, connect to the GDB remote server as follows:
+
+```bash
+gdb -q
+(gdb) target remote /tmp/ch-gdb-sock
+Remote debugging using /tmp/ch-gdb-sock
+warning: No executable has been specified, and target does not support
+determining executable automatically. Try using the "file" command.
+0x000000000011217e in ?? ()
+```
+
+You can set up to four hardware breakpoints using the x86 debug register:
+
+```bash
+(gdb) hb *0x1121b7
+Hardware assisted breakpoint 1 at 0x1121b7
+(gdb) c
+Continuing.
+
+Breakpoint 1, 0x00000000001121b7 in ?? ()
+(gdb)
+```
--- a/docs/intel_tdx.md
+++ b/docs/intel_tdx.md
@@ -15,14 +15,20 @@ the guest side can be found in the [Guest TDX tree](https://github.com/intel/tdx
 The TDVF firmware can be found in the
 [EDK2 staging project](https://github.com/tianocore/edk2-staging/tree/TDVF).

+The TDShim firmware can be found in the
+[Confidential Containers project](https://github.com/confidential-containers/td-shim).
+
 ## Cloud Hypervisor support

 First, you must be running on a machine with TDX enabled in hardware, and
 with the host OS compiled from the [KVM TDX tree](https://github.com/intel/tdx/tree/kvm).

-Cloud Hypervisor can run TDX VM (Trust Domain) by loading the TDVF firmware,
+Cloud Hypervisor can run TDX VM (Trust Domain) by loading a TD firmware,
 which will then load the guest kernel from the image. The image must be custom
 as it must include a kernel built from the [Guest TDX tree](https://github.com/intel/tdx/tree/guest).
+
+### TDVF
+
 The firmware can be built as follows:

 ```bash
@@ -49,9 +55,9 @@ cargo build --features tdx
 ```

 And run a TDX VM by providing the firmware previously built, along with the
-guest image containing the TDX enlightened kernel. Assuming the guest kernel
-command line contains `console=hvc0` (printing to the `virtio-console` device),
-run Cloud Hypervisor as follows:
+guest image containing the TDX enlightened kernel. The latest image
+`td-guest-rhel8.5.raw` contains `console=hvc0` on the kernel boot parameters,
+meaning it will be printing guest kernel logs to the `virtio-console` device.

 ```bash
 ./cloud-hypervisor \
@@ -61,8 +67,8 @@ run Cloud Hypervisor as follows:
    --disk path=tdx_guest_img
 ```

-And here is the alternative command when looking for debug logs (assuming the
-guest kernel command line contains `console=ttyS0`):
+And here is the alternative command when looking for debug logs from the
+firmware:

 ```bash
 ./cloud-hypervisor \
@@ -70,6 +76,35 @@ guest kernel command line contains `console=ttyS0`):
    --cpus boot=1 \
    --memory size=1G \
    --disk path=tdx_guest_img \
-    --serial tty \
-    --console off
+    --serial file=/tmp/ch_serial \
+    --console tty
 ```
+
+### TDShim
+
+This is a lightweight version of the TDVF, written in Rust and designed for
+direct kernel boot, which is useful for containers use cases.
+
+You can find the instructions for building the firmware directly from the
+project [documentation](https://github.com/confidential-containers/td-shim/tree/staging#how-to-build).
+
+And run a TDX VM by providing the firmware previously built, along with a guest
+kernel built from the [Guest TDX tree](https://github.com/intel/tdx/tree/guest).
+The appropriate kernel boot options must be provided through the `--cmdline`
+option as well.
+
+```bash
+./cloud-hypervisor \
+    --tdx firmware=tdshim \
+    --kernel bzImage \
+    --cmdline "root=/dev/vda3 console=hvc0 rw"
+    --cpus boot=1 \
+    --memory size=1G \
+    --disk path=tdx_guest_img
+```
+
+### Guest kernel disables serial ports
+
+The latest guest kernel that can be found in the latest image
+`td-guest-rhel8.5.raw` disabled the support for serial ports. This means adding
+`console=ttyS0` will have no effect and will not print any log from the guest.
--- a/docs/io_throttling.md
+++ b/docs/io_throttling.md
@@ -24,8 +24,8 @@ bucket is unbounded in speed which allows for bursts bound in size by
 the amount of tokens available. Once the token bucket is empty,
 consumption speed is bound by the "refill-rate". Similarly, Cloud
 Hypervisor provides another three options for limiting I/O operations,
-i.e., `ops_size` (I/O operations), `bw_one_time_burst` (I/O operations),
-and `bw_refill_time` (ms).
+i.e., `ops_size` (I/O operations), `ops_one_time_burst` (I/O operations),
+and `ops_refill_time` (ms).

 One caveat in the I/O throttling is that every-time the bucket gets
 empty, it will stop I/O operations for a fixed amount of time
--- a/docs/iommu.md
+++ b/docs/iommu.md
@@ -231,3 +231,38 @@ Last thing is to start the L2 guest with the huge pages memory backend.
    --cmdline "console=ttyS0 console=hvc0 root=/dev/vda1 rw" \
    --device path=/sys/bus/pci/devices/0000:00:04.0
 ```
+
+### Dedicated IOMMU PCI segments
+
+To facilitate hotplug of devices that require being behind an IOMMU it is
+possible to mark entire PCI segments as behind the IOMMU.
+
+This is accomplished through `--platform
+num_pci_segments=<number_of_segments>,iommu_segments=<range of segments>` or
+via the equivalents in `PlatformConfig` for the API.
+
+e.g.
+
+```bash
+./cloud-hypervisor \
+    --api-socket=/tmp/api \
+    --cpus boot=1 \
+    --memory size=4G,hugepages=on \
+    --disk path=focal-server-cloudimg-amd64.raw \
+    --kernel custom-vmlinux \
+    --cmdline "console=ttyS0 console=hvc0 root=/dev/vda1 rw" \
+    --platform num_pci_segments=2,iommu_segments=1
+```
+
+This adds a second PCI segment to the platform behind the IOMMU. A VFIO device
+requiring the IOMMU then may be hotplugged:
+
+e.g.
+
+```bash
+./ch-remote --api-socket=/tmp/api add-device path=/sys/bus/pci/devices/0000:00:04.0,iommu=on,pci_segment=1
+```
+
+Devices that cannot be placed behind an IOMMU (e.g. lacking an `iommu=` option)
+cannot be placed on the IOMMU segments.
+
--- a/docs/networking.md
+++ b/docs/networking.md
@@ -1,209 +0,0 @@
-# How to use networking
-
-cloud-hypervisor can emulate one or more virtual network interfaces, represented at the hypervisor host by [tap devices](https://www.kernel.org/doc/Documentation/networking/tuntap.txt). This guide briefly describes, in a manual and distribution neutral way, how to setup and use networking with cloud-hypervisor.
-
-## Multiple queue support for net devices
-
-While multiple vcpus defined for guest, to gain the benefit of vcpu scalable to improve performance, it suggests to define multiple queue pairs for net devices, one Tx/Rx queue pair per one vcpu, that means the number of queue pairs at least is equal to the vcpu count. In that case, after virtnet driver set cpu affinity for virtqueues in guest kernel, vcpus could handle interrupt from different virtqueue pairs in parallel.
-
-It will gain better performance for guest that has multiple queues defined for net devices while it has multiple net sessions running in userspace.
-
-To enable multiple queue support in cloud-hypervisor, multiple queue pairs will be defined, while multiple tap fds will be opened for the same tap device, it will also have multiple threads started, each thread will monitor and handle the events from each virtqueue pairs and the associated tap fd.
-
-Note:
-
- Currently, it does not support to use ethtool to change the combined queue numbers in guest.
- Multiple queue is enabled for vhost-user-net backend in cloud-hypervisor, however, multiple thread is not added to handle mq, thus, the performance for vhost-user-net backend is not supposed to be improved. The multiple thread will be added for backend later.
- Performance test for vhost-user-net will be covered once vhost-user-net backend has multiple thread supported.
- Performance test for virtio-net is done by comparing 2 queue pairs with 1 queue pairs, that to run 2 iperf3 sessions in the same test environments, throughput is improved about 37%.
-
-## Start cloud-hypervisor with net devices
-
-Use one `--net` command-line argument from cloud-hypervisor to specify the emulation of one or more virtual NIC's. The example below instructs cloud-hypervisor to emulate for instance 2 virtual NIC's:
-
-```bash
-./cloud-hypervisor \
-    --cpus boot=4 \
-    --memory "size=512M" \
-    --disk path=focal-server-cloudimg-amd64.raw \
-    --kernel my-vmlinux.bin \
-    --cmdline "console=ttyS0 console=hvc0 root=/dev/vda1 rw" \
-    --net tap=ich0,mac=a4:a1:c2:00:00:01,ip=192.168.4.2,mask=255.255.255.0,num_queues=2,queue_size=256 \
-          tap=ich1,mac=a4:a1:c2:00:00:02,ip=10.0.1.2,mask=255.255.255.0,num_queues=2,queue_size=256
-```
-
-The `--net` argument takes 1 or more space-separated strings of key value pairs containing the following 4 keys or fields:
-
-| Name       | Purpose                | Optional |
-| ---------- | ---------------------- | -------- |
-| tap        | tap device name        | Yes      |
-| mac        | vNIC mac address       | Yes      |
-| ip         | tap IP IP address      | yes      |
-| mask       | tap IP netmask         | Yes      |
-| num_queues | the number of queues   | yes      |
-| queue_size | the size of each queue | Yes      |
-
-num_queues is the total number of tx and rx queues, the default value is 2, and it could be increased by multiples of 2. Additionally, num_queues is suggested to be as 2 times of vcpu count. The default value for queue_size is 256.
-
-If the tap device is pre-created on host before guest boot up. To use multiple queue support for net device in guest, the tap device should be opened like this from host.
-
-```bash
-[root@localhost ~]# ip tuntap add name ich0 mode tap multi_queue
-```
-
-And the `--net` device should specify support for multiple queues. `num_queues` must be a multiple of 2 starting at least from 4 since multiple queues really means multiple queue pairs. We need at least 2 pairs for this configuration to be correct:
-
-```bash
--net tap=ich0,mac=a4:a1:c2:00:00:01,ip=192.168.4.2,mask=255.255.255.0,num_queues=4,queue_size=256
-```
-
-## Configure the tap devices
-
-After starting cloud-hypervisor as shown above, 2 tap devices with state down will become available at the host:
-
-```bash
-root@host:~# ip link show ich0
-78: ich0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN mode DEFAULT group default qlen 1000
-    link/ether 72:54:12:ff:ce:6f brd ff:ff:ff:ff:ff:ff
-root@host:~# ip link show ich1
-79: ich1: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN mode DEFAULT group default qlen 1000
-    link/ether 06:7a:fc:1b:9a:67 brd ff:ff:ff:ff:ff:ff
-```
-
-Set the tap devices to up state:
-
-```bash
-root@host:~# ip link set up ich0
-root@host:~# ip link set up ich1
-
-root@host:~# ip link show ich0
-78: ich0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UNKNOWN mode DEFAULT group default qlen 1000
-    link/ether 72:54:12:ff:ce:6f brd ff:ff:ff:ff:ff:ff
-root@host:~# ip link show ich1
-79: ich1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UNKNOWN mode DEFAULT group default qlen 1000
-    link/ether 06:7a:fc:1b:9a:67 brd ff:ff:ff:ff:ff:ff
-```
-
-## Connect tap devices
-
-Different networking models can be used to provide external connectivity. In this example we will
-use 2 linux bridges emulating 2 different networks. The integration bridge (ich-int) in this example will also be used
-for external connectivity.
-
-Create the bridges and connect the cloud-hypervisor tap devices to the bridges:
-
-```bash
-root@host:~# brctl addbr ich-int
-root@host:~# brctl addbr ich-dpl
-root@host:~# ip link set up ich-int
-root@host:~# ip link set up ich-dpl
-root@host:~# brctl addif ich-int ich0
-root@host:~# brctl addif ich-dpl ich1
-root@host:~# brctl show
-bridge name     bridge id               STP enabled     interfaces
-ich-dpl         8000.067afc1b9a67       no              ich1
-ich-int         8000.725412ffce6f       no              ich0
-```
-
-This completes the layer 2 wiring: The cloud-hypervisor is now connected to the hypervisor host via the 2 linux bridges.
-
-## IP (Layer 3) provisioning
-
-### Hypervisor host
-
-On the hypervisor host add the network gateway IP address of each network to the 2 linux bridges:
-
-```bash
-root@host:~# ip addr add 192.168.4.1/24 dev ich-int
-root@host:~# ip addr add 10.0.1.1/24 dev ich-dpl
-```
-
-The routing table of the hypervisor host should now also have corresponding routing entries:
-
-```bash
-root@host:~# route -n
-Kernel IP routing table
-Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
-0.0.0.0         192.168.178.1   0.0.0.0         UG    600    0        0 wlan1
-10.0.1.0        0.0.0.0         255.255.255.0   U     0      0        0 ich-dpl
-192.168.4.0     0.0.0.0         255.255.255.0   U     0      0        0 ich-int
-192.168.178.0   0.0.0.0         255.255.255.0   U     600    0        0 wlan1
-```
-
-### Virtual Machine
-
-Within the virtual machine set the vNIC's to up state and provision the corresponding IP addresses on the 2 vNIC's. The steps outlined below use the ip command as an example. Alternative distribution specific procedures can also apply.
-
-```bash
-root@guest:~# ip link set up enp0s2
-root@guest:~# ip link set up enp0s3
-root@guest:~# ip addr add 192.168.4.2/24 dev enp0s2
-root@guest:~# ip addr add 10.0.1.2/24 dev enp0s3
-```
-
-IP connectivity between the virtual machine and the hypervisor-host can be verified by sending
-ICMP requests to the hypervisor-host for the gateway IP address from within the virtual machine:
-
-```bash
-root@guest:~# ping 192.168.4.1
-PING 192.168.4.1 (192.168.4.1) 56(84) bytes of data.
-64 bytes from 192.168.4.1: icmp_seq=1 ttl=64 time=0.456 ms
-64 bytes from 192.168.4.1: icmp_seq=2 ttl=64 time=0.226 ms
-root@guest:~# ping 10.0.1.1
-PING 10.0.1.1 (10.0.1.1) 56(84) bytes of data.
-64 bytes from 10.0.1.1: icmp_seq=1 ttl=64 time=0.449 ms
-64 bytes from 10.0.1.1: icmp_seq=2 ttl=64 time=0.393 ms
-```
-
-The connection can now be used for instance to log into the virtual machine with
-ssh under the precondition that the machine has an ssh daemon provisioned:
-
-```bash
-root@host:~# ssh root@192.168.4.2
-The authenticity of host '192.168.4.2 (192.168.4.2)' can't be established.
-ECDSA key fingerprint is SHA256:qNAUmTtDMW9pNuZARkpLQhfw+Yc1tqUDBrQp7aZGSjw.
-Are you sure you want to continue connecting (yes/no)? yes
-Warning: Permanently added '192.168.4.2' (ECDSA) to the list of known hosts.
-root@192.168.4.2's password:
-Linux cloud-hypervisor 5.2.0 #2 SMP Thu Jul 11 08:08:16 CEST 2019 x86_64
-
-Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
-permitted by applicable law.
-
-
-Last login: Fri Jul 12 13:27:56 2019 from 192.168.4.1
-root@guest:~#
-```
-
-## Internet connectivity
-
-To enable internet connectivity a default gw and a nameserver has to be set within
-the virtual machine:
-
-```bash
-root@guest:~# ip route add default via 192.168.4.1
-root@guest:~# cat /etc/resolv.conf
-options timeout:2
-domain vallis.nl
-search vallis.nl
-nameserver 192.168.178.1
-```
-
-make sure that the default gateway of the hypervisor host (in this example host 192.168.178.1 which is an adsl router) has an entry in the routing table for the 192.168.4.0/24 network otherwise IP connectivity will not work.
-
-```bash
-root@guest:~# nslookup  ftp.nl.debian.org
-Server:         192.168.178.1
-Address:        192.168.178.1#53
-
-Non-authoritative answer:
-cdn-fastly.deb.debian.org       canonical name = prod.debian.map.fastly.net.
-Name:   prod.debian.map.fastly.net
-Address: 151.101.36.204
-
-root@guest:~# apt-get update
-Ign:1 http://cdn-fastly.deb.debian.org/debian stretch InRelease
-Get:2 http://cdn-fastly.deb.debian.org/debian stretch Release [118 kB]
-Get:3 http://cdn-fastly.deb.debian.org/debian stretch Release.gpg [2434 B]
-Fetched 120 kB in 1s (110 kB/s)
-```
--- a/docs/performance_metrics.md
+++ b/docs/performance_metrics.md
@@ -0,0 +1,29 @@
+# Performance Metrics
+
+Cloud Hypervisor provides a [performance metrics](https://github.com/cloud-hypervisor/cloud-hypervisor/tree/main/performance-metrics)
+binary for users to generate metrics data from their own
+environment. This document describes how to generate metrics data
+quickly by using Cloud Hypervisor's development script,
+e.g. `dev_cli.sh`. The only prerequisite is [Docker installation](https://docs.docker.com/engine/install/).
+Please note that upon its first invocation, this script will pull a
+fairly large container image.
+
+To generate metrics data for all available performance tests (including
+boot time, block I/O throughput, and network throughput & latency) and
+output the result into a json file:
+
+```
+$ ./scripts/dev_cli.sh tests --metrics -- -- --report-file /tmp/metrics.json
+```
+
+To get a list of available performance tests:
+
+```
+$ ./scripts/dev_cli.sh tests --metrics -- -- --list-tests
+```
+
+To generate metrics data for selected performance tests, e.g. boot time only:
+
+```
+$ ./scripts/dev_cli.sh tests --metrics -- -- --report-file /tmp/metrics.json --test-filter boot_time
+```
--- a/docs/snapshot_restore.md
+++ b/docs/snapshot_restore.md
@@ -8,9 +8,6 @@ snapshot and creates the exact same virtual machine, restoring the previously
 saved states. The new virtual machine is restored in a paused state, as it was
 before the snapshot was performed.

-This feature is important for the project as it establishes the first step
-towards the support for live migration.
-
 ## Snapshot a Cloud Hypervisor VM

 First thing, we must run a Cloud Hypervisor VM:
@@ -46,24 +43,22 @@ ll /home/foo/snapshot/
 total 4194536
 drwxrwxr-x  2 foo bar       4096 Jul 22 11:50 ./
 drwxr-xr-x 47 foo bar       4096 Jul 22 11:47 ../
-rw-------  1 foo bar 3221225472 Jul 22 11:19 memory-region-0
-rw-------  1 foo bar 1073741824 Jul 22 11:19 memory-region-1
-rw-------  1 foo bar     217853 Jul 22 11:19 vm.json
+-rw-------  1 foo bar       1084 Jul 22 11:19 config.json
+-rw-------  1 foo bar 4294967296 Jul 22 11:19 memory-ranges
+-rw-------  1 foo bar     217853 Jul 22 11:19 state.json
 ```

-In this particular example, we can observe that 2 memory region files were
-created. That is explained by the size of the guest RAM, which is 4GiB in this
-case. Because it exceeds 3GiB (which is where we can find a ~1GiB memory hole),
-Cloud Hypervisor needs 2 distinct memory regions to be created. Each memory
-region's content is stored through a dedicated file, which explains why we end
-up with 2 different files, the first one containing the guest RAM range 0-3GiB
-and the second one containing the guest RAM range 3-4GiB.
+`config.json` contains the virtual machine configuration. It is used to create
+a similar virtual machine with the correct amount of CPUs, RAM, and other
+expected devices. It is stored in a human readable format so that it could be
+modified between the snapshot and restore phases to achieve some very special
+use cases. But for most cases, manually modifying the configuration should not
+be needed.

-`vm.json` gathers all information related to the virtual machine configuration
-and state. The configuration bits are used to create a similar virtual machine
-with the correct amount of CPUs, RAM, and other expected devices. The state
-bits are used to restore each component in the state it was left before the
-snapshot occurred.
+`memory-ranges` stores the content of the guest RAM.
+
+`state.json` contains the virtual machine state. It is used to restore each
+component in the state it was left before the snapshot occurred.

 ## Restore a Cloud Hypervisor VM

@@ -100,13 +95,4 @@ snapshot earlier.

 ## Limitations

-The support of snapshot/restore feature is still experimental, meaning one
-might still find some bugs associated with it.
-
-Additionally, some devices and features don't support to be snapshot and
-restored yet:
- `vhost-user` devices
- `virtio-mem`
- Intel SGX
-
-VFIO devices are out of scope.
+VFIO devices and Intel SGX are out of scope.
--- a/docs/uefi.md
+++ b/docs/uefi.md
@@ -33,11 +33,7 @@ Any UEFI capable image can be booted using the Cloud Hypervisor specific firmwar

 To make Cloud Hypervisor use UEFI boot, pass the `CLOUDHV.fd` file path as an argument to the `--kernel` option. The firmware file will be opened in read only mode.

-The same firmware can be used with Cloud Hypervisor or with QEMU. This is particularly useful if using QEMU for the preparation phase.
-
 # Links

 - [OVMF wiki](https://github.com/tianocore/tianocore.github.io/wiki/OVMF) 
 - [Cloud Hypervisor specific tree](https://github.com/cloud-hypervisor/edk2/tree/ch)
- [Redhat OVMF Status Report](https://access.redhat.com/sites/default/files/attachments/ovmf-whtepaper-031815.pdf)
- [SeaBIOS Build Overview](https://www.seabios.org/Build_overview#Build_as_a_UEFI_Compatibility_Support_Module_.28CSM.29)
--- a/docs/vdpa.md
+++ b/docs/vdpa.md
@@ -0,0 +1,154 @@
+# Virtio Data Path Acceleration
+
+vDPA aims at achieving bare-metal performance for devices passed into a virtual
+machine. It is an alternative to VFIO, as it provides a simpler solution for
+achieving migration.
+
+It is a kernel framework introduced recently to handle devices complying with
+the VIRTIO specification on their data-path, while the control path is vendor
+specific. In practice, virtqueues are accessed directly through DMA mechanism
+between the hardware and the guest. The control path is accessed through the
+vDPA framework, being exposed through the vhost interface as a vhost-vdpa
+device.
+
+Because DMA accesses between device and guest are going through virtqueues,
+migration can be achieved without requiring device's driver to implement any
+specific migration support. In case of VFIO, each vendor is expected to provide
+an implementation of the VFIO migration framework, complicating things as it
+must be done for each and every device's driver.
+
+The official [website](https://vdpa-dev.gitlab.io/) contains some extensive
+documentation on the topic.
+
+## Usage
+
+`VdpaConfig` (known as `--vdpa` from the CLI perspective) contains the list of
+parameters available for the vDPA device.
+
+```rust
+struct VdpaConfig {
+    path: PathBuf,
+    num_queues: usize,
+    id: Option<String>,
+    pci_segment: u16,
+}
+```
+
+```
+--vdpa <vdpa>	vDPA device "path=<device_path>,num_queues=<number_of_queues>,iommu=on|off,id=<device_id>,pci_segment=<segment_id>"
+```
+
+### `path`
+
+Path of the vDPA device. Usually `/dev/vhost-vdpa-X`.
+
+This parameter is mandatory.
+
+Value is a string.
+
+_Example_
+
+```
+--vdpa path=/dev/vhost-vdpa-0
+```
+
+### `num_queues`
+
+Number of virtqueues supported by the vDPA device.
+
+This parameter is optional.
+
+Value is an unsigned integer set to `1` by default.
+
+_Example_
+
+```
+--vdpa path=/dev/vhost-vdpa-0,num_queues=2
+```
+
+### `id`
+
+Identifier of the vDPA device.
+
+This parameter is optional. If provided, it must be unique across the entire
+virtual machine.
+
+Value is a string.
+
+_Example_
+
+```
+--vdpa path=/dev/vhost-vdpa-0,id=vdpa0
+```
+
+### `pci_segment`
+
+PCI segment number to which the vDPA device should be attached to.
+
+This parameter is optional.
+
+Value is an unsigned integer of 16 bits set to `0` by default.
+
+_Example_
+
+```
+--vdpa path=/dev/vhost-vdpa-0,pci_segment=1
+```
+
+## Example with vDPA block simulator
+
+The vDPA framework provides a simulator with both `virtio-block` and
+`virtio-net` implementations. This is very useful for testing vDPA when we
+don't have access to the specific hardware.
+
+Given the host kernel has the appropriate modules available, let's load them
+all:
+
+```
+sudo modprobe vdpa
+sudo modprobe vhost_vdpa
+sudo modprobe vdpa_sim
+sudo modprobe vdpa_sim_blk
+```
+
+Given you have the `iproute2/vdpa` tool installed, let's now create the
+`virtio-block` vDPA device:
+
+```sh
+sudo vdpa dev add name vdpa-blk1 mgmtdev vdpasim_blk
+sudo chown $USER:$USER /dev/vhost-vdpa-0
+sudo chmod 660 /dev/vhost-vdpa-0
+```
+
+Increase the maximum locked memory to ensure setting up IOMMU mappings will
+succeed:
+
+```sh
+ulimit -l unlimited
+```
+
+Start Cloud Hypervisor:
+
+```sh
+cloud-hypervisor \
+    --cpus boot=1 \
+    --memory size=1G,hugepages=on \
+    --disk path=focal-server-cloudimg-amd64.raw \
+    --kernel vmlinux \
+    --cmdline "root=/dev/vda1 console=hvc0" \
+    --vdpa path=/dev/vhost-vdpa-0,num_queues=1
+```
+
+The `virtio-block` device backed by the vDPA simulator can be found as
+`/dev/vdb` in the guest:
+
+```
+cloud@cloud:~$ lsblk
+NAME    MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
+nullb0  252:0    0  250G  0 disk 
+vda     254:0    0  2.2G  0 disk 
+├─vda1  254:1    0  2.1G  0 part /
+├─vda14 254:14   0    4M  0 part 
+└─vda15 254:15   0  106M  0 part /boot/efi
+vdb     254:16   0  128M  0 disk
+```
--- a/docs/virtiofs-root.md
+++ b/docs/virtiofs-root.md
@@ -65,7 +65,7 @@ iface eth0 inet dhcp

 ```bash
 # starting in the directory above rootfs
-sudo virtiofsd --socket-path=$PWD/virtiofs-rootfs.sock -o source=$PWD/rootfs -o cache=none &
+sudo virtiofsd --socket-path=$PWD/virtiofs-rootfs.sock --shared-dir=$PWD/rootfs --cache=never &
 sudo cloud-hypervisor \
    --cpus boot=1,max=1 \
    --kernel vmlinux \
--- a/docs/windows.md
+++ b/docs/windows.md
@@ -22,7 +22,7 @@ __Prerequisites__
 - QEMU, version >=5.0.0 is recommended.
 - Windows installation ISO. Obtained through MSDN, Visual Studio subscription, evaluation center, etc. 
 - [VirtIO driver ISO](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/)
- Suitable [OVMF](uefi.md) firmware 
+- Suitable firmware for Cloud Hypervisor (`CLOUDHV.fd`) and for QEMU (`OVMF.fd`)
 - With the suggested image size of 30G, there should be enough free disk space to hold the installation ISO and any other necessary files

 This step currently requires QEMU to install Windows onto the guest. QEMU is only used at the preparation stage, the resulting image is then fully functional with Cloud Hypervisor.
--- a/event_monitor/Cargo.toml
+++ b/event_monitor/Cargo.toml
@@ -2,10 +2,10 @@
 name = "event_monitor"
 version = "0.1.0"
 authors = ["The Cloud Hypervisor Authors"]
-edition = "2018"
+edition = "2021"

 [dependencies]
-libc = "0.2.112"
-serde = { version = "1.0.133", features = ["rc"] }
-serde_derive = "1.0.133"
-serde_json = "1.0.75"
+libc = "0.2.123"
+serde = { version = "1.0.136", features = ["rc"] }
+serde_derive = "1.0.136"
+serde_json = "1.0.79"
--- a/fuzz/Cargo.lock
+++ b/fuzz/Cargo.lock
@@ -11,9 +11,9 @@ dependencies = [

 [[package]]
 name = "anyhow"
-version = "1.0.52"
+version = "1.0.56"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "84450d0b4a8bd1ba4144ce8ce718fbc5d071358b1e5384bace6536b3d1f2d5b3"
+checksum = "4361135be9122e0870de935d7c439aef945b9f9ddd4199a553b5270b49c82a27"

 [[package]]
 name = "api_client"
@@ -24,9 +24,9 @@ dependencies = [

 [[package]]
 name = "arbitrary"
-version = "1.0.3"
+version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "510c76ecefdceada737ea728f4f9a84bd2e1ef29f1ba555e560940fe279954de"
+checksum = "c38b6b6b79f671c25e1a3e785b7b82d7562ffc9cd3efdc98627e5668a2472490"

 [[package]]
 name = "arc-swap"
@@ -70,9 +70,9 @@ dependencies = [

 [[package]]
 name = "autocfg"
-version = "1.0.1"
+version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cdb031dd78e28731d87d56cc8ffef4a8f36ca26c38fe2de700543e627f8a464a"
+checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"

 [[package]]
 name = "bincode"
@@ -116,9 +116,9 @@ checksum = "14c189c53d098945499cdfa7ecc63567cf3886b3332b312a5b4585d8d3a6a610"

 [[package]]
 name = "cc"
-version = "1.0.72"
+version = "1.0.73"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "22a9137b95ea06864e018375b72adfb7db6e6f68cfc8df5a04d00288050485ee"
+checksum = "2fff2a6927b3bb87f9595d67196a70493f627687a71d87a0d692242c33f58c11"

 [[package]]
 name = "cfg-if"
@@ -128,9 +128,9 @@ checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"

 [[package]]
 name = "clap"
-version = "3.0.10"
+version = "3.1.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7a30c3bf9ff12dfe5dae53f0a96e0febcd18420d1c0e7fad77796d9d5c4b5375"
+checksum = "71c47df61d9e16dc010b55dba1952a57d8c215dbb533fd13cdd13369aac73b1c"
 dependencies = [
 "atty",
 "bitflags",
@@ -145,7 +145,7 @@ dependencies = [

 [[package]]
 name = "cloud-hypervisor"
-version = "20.0.0"
+version = "22.0.0"
 dependencies = [
 "anyhow",
 "api_client",
@@ -185,9 +185,9 @@ dependencies = [

 [[package]]
 name = "crc32c"
-version = "0.6.1"
+version = "0.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ee6b9c9389584bcba988bd0836086789b7f87ad91892d6a83d5291dbb24524b5"
+checksum = "3dfea2db42e9927a3845fb268a10a72faed6d416065f77873f05e411457c363e"
 dependencies = [
 "rustc_version",
 ]
@@ -245,10 +245,34 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b643857cf70949306b81d7e92cb9d47add673868edac9863c4a49c42feaf3f1e"

 [[package]]
-name = "getrandom"
-version = "0.2.4"
+name = "gdbstub"
+version = "0.6.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "418d37c8b1d42553c93648be529cb70f920d3baf8ef469b74b9638df426e0b4c"
+checksum = "9fa2ca5d6b045de372cef3991f873389b421b4cabcfbe52f7787fae8b8b37906"
+dependencies = [
+ "bitflags",
+ "cfg-if",
+ "log",
+ "managed",
+ "num-traits",
+ "paste",
+]
+
+[[package]]
+name = "gdbstub_arch"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "51dc4b5718ac76d21e8605c0966dd32d80273b89b11e6cfef467b04e45934d37"
+dependencies = [
+ "gdbstub",
+ "num-traits",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9be70c98951c83b8d2f8f60d7065fa6d5146873094452a1008da8c2f1e4205ad"
 dependencies = [
 "cfg-if",
 "libc",
@@ -291,9 +315,9 @@ dependencies = [

 [[package]]
 name = "iced-x86"
-version = "1.15.0"
+version = "1.17.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "46e977036f7f5139d580c7f19ad62df9cb8ebd8410bb569e73585226be80a86f"
+checksum = "158f5204401d08f91d19176112146d75e99b3cf745092e268fa7be33e09adcec"
 dependencies = [
 "lazy_static",
 "static_assertions",
@@ -301,9 +325,9 @@ dependencies = [

 [[package]]
 name = "indexmap"
-version = "1.8.0"
+version = "1.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "282a6247722caba404c065016bbfa522806e51714c34f5dfc3e4a3a46fcb4223"
+checksum = "0f647032dfaa1f8b6dc29bd3edb7bbef4861b8b8007ebb118d6db284fd59f6ee"
 dependencies = [
 "autocfg",
 "hashbrown",
@@ -328,7 +352,7 @@ checksum = "1aab8fc367588b89dcee83ab0fd66b72b50b72fa1904d7095045ace2b0c81c35"
 [[package]]
 name = "kvm-bindings"
 version = "0.5.0"
-source = "git+https://github.com/cloud-hypervisor/kvm-bindings?branch=ch-v0.5.0#9c497710ba9968d8efe15dbae03991b16cf82e23"
+source = "git+https://github.com/cloud-hypervisor/kvm-bindings?branch=ch-v0.5.0-tdx#52e56d0e8ef0f6ea32fc0492e6a175b73617a49f"
 dependencies = [
 "serde",
 "serde_derive",
@@ -338,7 +362,7 @@ dependencies = [
 [[package]]
 name = "kvm-ioctls"
 version = "0.11.0"
-source = "git+https://github.com/rust-vmm/kvm-ioctls?branch=main#d22ef1f51852dfb055da38004e1a4fed81246f81"
+source = "git+https://github.com/rust-vmm/kvm-ioctls?branch=main#1e03e29cdfbb0cb108a98de7a78045a5a517f18e"
 dependencies = [
 "kvm-bindings",
 "libc",
@@ -353,15 +377,15 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"

 [[package]]
 name = "libc"
-version = "0.2.112"
+version = "0.2.123"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b03d17f364a3a042d5e5d46b053bbbf82c92c9430c592dd4c064dc6ee997125"
+checksum = "cb691a747a7ab48abc15c5b42066eaafde10dc427e3b6ee2a1cf43db04c763bd"

 [[package]]
 name = "libfuzzer-sys"
-version = "0.4.2"
+version = "0.4.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "36a9a84a6e8b55dfefb04235e55edb2b9a2a18488fcae777a6bdaa6f06f1deb3"
+checksum = "336244aaeab6a12df46480dc585802aa743a72d66b11937844c61bbca84c991d"
 dependencies = [
 "arbitrary",
 "cc",
@@ -379,13 +403,19 @@ dependencies = [

 [[package]]
 name = "log"
-version = "0.4.14"
+version = "0.4.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "51b9bbe6c47d51fc3e1a9b945965946b4c44142ab8792c50835a980d362c2710"
+checksum = "6389c490849ff5bc16be905ae24bc913a9c8892e19b2341dbc175e14c341c2b8"
 dependencies = [
 "cfg-if",
 ]

+[[package]]
+name = "managed"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ca88d725a0a943b096803bd34e73a4437208b6077654cc4ecb2947a5f91618d"
+
 [[package]]
 name = "memchr"
 version = "2.4.1"
@@ -429,10 +459,19 @@ dependencies = [
 ]

 [[package]]
-name = "once_cell"
-version = "1.9.0"
+name = "num-traits"
+version = "0.2.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "da32515d9f6e6e489d7bc9d84c71b060db7247dc035bbe44eac88cf87486d8d5"
+checksum = "9a64b1ec5cda2586e284722486d802acf1f7dbdc623e2bfc57e65ca1cd099290"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "87f3e037eac156d1775da914196f0f37741a274155e34a0b7e427c35d2a2ecb9"

 [[package]]
 name = "option_parser"
@@ -447,6 +486,12 @@ dependencies = [
 "memchr",
 ]

+[[package]]
+name = "paste"
+version = "1.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c520e05135d6e763148b6426a837e239041653ba7becd2e538c076c738025fc"
+
 [[package]]
 name = "pci"
 version = "0.1.0"
@@ -456,6 +501,8 @@ dependencies = [
 "hypervisor",
 "libc",
 "log",
+ "serde",
+ "serde_derive",
 "thiserror",
 "versionize",
 "versionize_derive",
@@ -471,9 +518,9 @@ dependencies = [

 [[package]]
 name = "proc-macro2"
-version = "1.0.36"
+version = "1.0.37"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c7342d5883fbccae1cc37a2353b09c87c9b0f3afd73f5fb9bba687a1f733b029"
+checksum = "ec757218438d5fda206afc041538b2f6d889286160d649a86a24d37e1235afd1"
 dependencies = [
 "unicode-xid",
 ]
@@ -491,9 +538,9 @@ dependencies = [

 [[package]]
 name = "quote"
-version = "1.0.14"
+version = "1.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "47aa80447ce4daf1717500037052af176af5d38cc3e571d9ec1c7353fc10c87d"
+checksum = "a1feb54ed693b93a84e14094943b84b7c4eae204c512b7ccb95ab0c66d278ad1"
 dependencies = [
 "proc-macro2",
 ]
@@ -544,21 +591,21 @@ dependencies = [

 [[package]]
 name = "semver"
-version = "1.0.4"
+version = "1.0.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "568a8e6258aa33c13358f81fd834adb854c6f7c9468520910a9b1e8fac068012"
+checksum = "d65bd28f48be7196d222d95b9243287f48d27aca604e08497513019ff0502cc4"

 [[package]]
 name = "serde"
-version = "1.0.133"
+version = "1.0.136"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97565067517b60e2d1ea8b268e59ce036de907ac523ad83a0475da04e818989a"
+checksum = "ce31e24b01e1e524df96f1c2fdd054405f8d7376249a5110886fb4b658484789"

 [[package]]
 name = "serde_derive"
-version = "1.0.133"
+version = "1.0.136"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed201699328568d8d08208fdd080e3ff594e6c422e438b6705905da01005d537"
+checksum = "08597e7152fcd306f41838ed3e37be9eaeed2b61c42e2117266a554fab4662f9"
 dependencies = [
 "proc-macro2",
 "quote",
@@ -567,9 +614,9 @@ dependencies = [

 [[package]]
 name = "serde_json"
-version = "1.0.75"
+version = "1.0.79"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c059c05b48c5c0067d4b4b2b4f0732dd65feb52daf7e0ea09cd87e7dadc1af79"
+checksum = "8e8d9fa5c3b304765ce1fd9c4c8a3de2c8db365a5b91be52f186efc675681d95"
 dependencies = [
 "itoa",
 "ryu",
@@ -609,9 +656,9 @@ checksum = "73473c0e59e6d5812c5dfe2a064a6444949f089e20eec9a2e5506596494e4623"

 [[package]]
 name = "syn"
-version = "1.0.85"
+version = "1.0.91"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a684ac3dcd8913827e18cd09a68384ee66c1de24157e3c556c9ab16d85695fb7"
+checksum = "b683b2b825c8eef438b77c36a06dc262294da3d5a5813fac20da149241dcd44d"
 dependencies = [
 "proc-macro2",
 "quote",
@@ -620,9 +667,9 @@ dependencies = [

 [[package]]
 name = "termcolor"
-version = "1.1.2"
+version = "1.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2dfed899f0eb03f32ee8c6a0aabdb8a7949659e3466561fc0adf54e26d88c5f4"
+checksum = "bab24d30b911b2376f3a13cc2cd443142f0c81dda04c118693e35b3835757755"
 dependencies = [
 "winapi-util",
 ]
@@ -639,9 +686,9 @@ dependencies = [

 [[package]]
 name = "textwrap"
-version = "0.14.2"
+version = "0.15.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0066c8d12af8b5acd21e00547c3797fde4e8677254a7ee429176ccebbe93dd80"
+checksum = "b1141d4d61095b28419e22cb0bbf02755f5e54e0526f97f1e3d1d160e60885fb"
 dependencies = [
 "terminal_size",
 ]
@@ -720,12 +767,14 @@ dependencies = [
 [[package]]
 name = "vfio-ioctls"
 version = "0.1.0"
-source = "git+https://github.com/rust-vmm/vfio-ioctls?branch=main#8f7f2210ebe71660938b05b2ed7eec9253478bc5"
+source = "git+https://github.com/rust-vmm/vfio?branch=main#4630612f2ff300e78b6d55be324fb5481aa84661"
 dependencies = [
 "byteorder",
 "kvm-bindings",
 "kvm-ioctls",
+ "libc",
 "log",
+ "thiserror",
 "vfio-bindings",
 "vm-memory",
 "vmm-sys-util",
@@ -763,9 +812,9 @@ dependencies = [

 [[package]]
 name = "vhost"
-version = "0.3.0"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b56bf8f178fc500fe14505fca8b00dec76fc38f2304f461c8d9d7547982311d"
+checksum = "53567fd9ab820e4f3cc156f24146882fee3c365194c3e1dea74723265f27fc88"
 dependencies = [
 "bitflags",
 "libc",
@@ -800,6 +849,7 @@ dependencies = [
 "serde",
 "serde_derive",
 "serde_json",
+ "thiserror",
 "versionize",
 "versionize_derive",
 "vhost",
@@ -815,7 +865,9 @@ dependencies = [

 [[package]]
 name = "virtio-queue"
-version = "0.1.0"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3785325315e6496fa88673842ee6cd198b9658e88e8b0e1ad48a5dc818b221dc"
 dependencies = [
 "log",
 "vm-memory",
@@ -899,6 +951,8 @@ dependencies = [
 "devices",
 "epoll",
 "event_monitor",
+ "gdbstub",
+ "gdbstub_arch",
 "hypervisor",
 "lazy_static",
 "libc",
--- a/fuzz/Cargo.toml
+++ b/fuzz/Cargo.toml
@@ -3,20 +3,20 @@ name = "cloud-hypervisor-fuzz"
 version = "0.0.0"
 authors = ["Automatically generated"]
 publish = false
-edition = "2018"
+edition = "2021"

 [package.metadata]
 cargo-fuzz = true

 [dependencies]
 block_util = { path = "../block_util" }
-libc = "0.2.112"
-libfuzzer-sys = "0.4.2"
+libc = "0.2.123"
+libfuzzer-sys = "0.4.3"
 qcow = { path = "../qcow" }
 seccompiler = "0.2.0"
 vhdx = { path = "../vhdx" }
 virtio-devices = { path = "../virtio-devices" }
-virtio-queue = { path = "../virtio-queue" }
+virtio-queue = "0.2.0"
 vmm-sys-util = "0.9.0"
 vm-virtio = { path = "../vm-virtio" }
 vm-memory = "0.7.0"
@@ -25,7 +25,7 @@ vm-memory = "0.7.0"
 path = ".."

 [patch.crates-io]
-kvm-bindings = { git = "https://github.com/cloud-hypervisor/kvm-bindings", branch = "ch-v0.5.0", features = ["with-serde", "fam-wrappers"] }
+kvm-bindings = { git = "https://github.com/cloud-hypervisor/kvm-bindings", branch = "ch-v0.5.0-tdx" }
 kvm-ioctls = { git = "https://github.com/rust-vmm/kvm-ioctls", branch = "main" }
 versionize_derive = { git = "https://github.com/cloud-hypervisor/versionize_derive", branch = "ch" }

--- a/fuzz/fuzz_targets/block.rs
+++ b/fuzz/fuzz_targets/block.rs
@@ -139,8 +139,7 @@ pub struct NoopVirtioInterrupt {}
 impl VirtioInterrupt for NoopVirtioInterrupt {
    fn trigger(
        &self,
-        _int_type: &VirtioInterruptType,
-        _queue: Option<&Queue<GuestMemoryAtomic<GuestMemoryMmap>>>,
+        _int_type: VirtioInterruptType,
    ) -> std::result::Result<(), std::io::Error> {
        Ok(())
    }
--- a/hypervisor/Cargo.toml
+++ b/hypervisor/Cargo.toml
@@ -2,7 +2,7 @@
 name = "hypervisor"
 version = "0.1.0"
 authors = ["Microsoft Authors"]
-edition = "2018"
+edition = "2021"
 license = "Apache-2.0 OR BSD-3-Clause"

 [features]
@@ -11,23 +11,23 @@ mshv = ["mshv-ioctls", "mshv-bindings"]
 tdx = []

 [dependencies]
-anyhow = "1.0.52"
+anyhow = "1.0.56"
 epoll = "4.3.1"
 thiserror = "1.0.30"
-libc = "0.2.112"
-log = "0.4.14"
+libc = "0.2.123"
+log = "0.4.16"
 kvm-ioctls = { version = "0.11.0", optional = true }
-kvm-bindings = { git = "https://github.com/cloud-hypervisor/kvm-bindings", branch = "ch-v0.5.0", features = ["with-serde", "fam-wrappers"], optional  = true }
+kvm-bindings = { git = "https://github.com/cloud-hypervisor/kvm-bindings", branch = "ch-v0.5.0-tdx", features = ["with-serde", "fam-wrappers"], optional  = true }
 mshv-bindings = {git = "https://github.com/rust-vmm/mshv", branch = "main", features = ["with-serde", "fam-wrappers"], optional  = true }
 mshv-ioctls = { git = "https://github.com/rust-vmm/mshv", branch = "main", optional  = true}
-serde = { version = "1.0.133", features = ["rc"] }
-serde_derive = "1.0.133"
-serde_json = "1.0.75"
+serde = { version = "1.0.136", features = ["rc"] }
+serde_derive = "1.0.136"
+serde_json = "1.0.79"
 vm-memory = { version = "0.7.0", features = ["backend-mmap", "backend-atomic"] }
 vmm-sys-util = { version = "0.9.0", features = ["with-serde"] }

 [target.'cfg(target_arch = "x86_64")'.dependencies.iced-x86]
-version = "1.15.0"
+version = "1.17.0"
 default-features = false
 features = ["std", "decoder", "op_code_info", "instr_info", "fast_fmt"]

--- a/hypervisor/src/cpu.rs
+++ b/hypervisor/src/cpu.rs
@@ -19,15 +19,19 @@ use crate::x86_64::{
    ExtendedControlRegisters, FpuState, MsrEntries, SpecialRegisters, StandardRegisters, VcpuEvents,
 };
 use crate::CpuState;
+#[cfg(target_arch = "aarch64")]
+use crate::DeviceAttr;
 #[cfg(feature = "kvm")]
 use crate::MpState;
 #[cfg(all(feature = "mshv", target_arch = "x86_64"))]
 use crate::SuspendRegisters;
 #[cfg(target_arch = "x86_64")]
 use crate::Xsave;
-#[cfg(feature = "mshv")]
-use mshv_bindings::*;
+#[cfg(feature = "tdx")]
+use crate::{TdxExitDetails, TdxExitStatus};
 use thiserror::Error;
+#[cfg(all(feature = "kvm", target_arch = "x86_64"))]
+use vm_memory::GuestAddress;

 #[derive(Error, Debug)]
 ///
@@ -223,11 +227,27 @@ pub enum HypervisorCpuError {
    #[error("Failed to translate GVA: {0}")]
    TranslateVirtualAddress(#[source] anyhow::Error),
    ///
+    /// Set cpu attribute error
+    ///
+    #[error("Failed to set vcpu attribute: {0}")]
+    SetVcpuAttribute(#[source] anyhow::Error),
+    ///
+    /// Check if cpu has a certain attribute error
+    ///
+    #[error("Failed to check if vcpu has attribute: {0}")]
+    HasVcpuAttribute(#[source] anyhow::Error),
+    ///
    /// Failed to initialize TDX on CPU
    ///
    #[cfg(feature = "tdx")]
    #[error("Failed to initialize TDX: {0}")]
    InitializeTdx(#[source] std::io::Error),
+    ///
+    /// Unknown TDX VM call
+    ///
+    #[cfg(feature = "tdx")]
+    #[error("Unknown TDX VM call")]
+    UnknownTdxVmCall,
 }

 #[derive(Debug)]
@@ -244,6 +264,10 @@ pub enum VmExit<'a> {
    Reset,
    Shutdown,
    Hyperv,
+    #[cfg(feature = "tdx")]
+    Tdx,
+    #[cfg(feature = "kvm")]
+    Debug,
 }

 ///
@@ -259,7 +283,16 @@ pub trait Vcpu: Send + Sync {
    /// Returns the vCPU general purpose registers.
    ///
    fn get_regs(&self) -> Result<StandardRegisters>;
-
+    #[cfg(target_arch = "aarch64")]
+    ///
+    /// Sets vcpu attribute
+    ///
+    fn set_vcpu_attr(&self, attr: &DeviceAttr) -> Result<()>;
+    #[cfg(target_arch = "aarch64")]
+    ///
+    /// Check if vcpu has attribute.
+    ///
+    fn has_vcpu_attr(&self, attr: &DeviceAttr) -> Result<()>;
    #[cfg(target_arch = "x86_64")]
    ///
    /// Sets the vCPU general purpose registers.
@@ -368,6 +401,11 @@ pub trait Vcpu: Send + Sync {
    /// potential soft lockups when being resumed.
    ///
    fn notify_guest_clock_paused(&self) -> Result<()>;
+    #[cfg(all(feature = "kvm", target_arch = "x86_64"))]
+    ///
+    /// Sets debug registers to set hardware breakpoints and/or enable single step.
+    ///
+    fn set_guest_debug(&self, addrs: &[GuestAddress], singlestep: bool) -> Result<()>;
    ///
    /// Sets the type of CPU to be exposed to the guest and optional features.
    ///
@@ -428,11 +466,11 @@ pub trait Vcpu: Send + Sync {
    /// Triggers the running of the current virtual CPU returning an exit reason.
    ///
    fn run(&self) -> std::result::Result<VmExit, HypervisorCpuError>;
-    #[cfg(all(feature = "mshv", target_arch = "x86_64"))]
+    #[cfg(target_arch = "x86_64")]
    ///
    /// Translate guest virtual address to guest physical address
    ///
-    fn translate_gva(&self, gva: u64, flags: u64) -> Result<(u64, hv_translate_gva_result)>;
+    fn translate_gva(&self, gva: u64, flags: u64) -> Result<(u64, u32)>;
    ///
    /// Initialize TDX support on the vCPU
    ///
@@ -443,4 +481,19 @@ pub trait Vcpu: Send + Sync {
    /// Return suspend registers(explicit and intercept suspend registers)
    ///
    fn get_suspend_regs(&self) -> Result<SuspendRegisters>;
+    #[cfg(feature = "kvm")]
+    ///
+    /// Set the "immediate_exit" state
+    ///
+    fn set_immediate_exit(&self, exit: bool);
+    #[cfg(feature = "tdx")]
+    ///
+    /// Returns the details about TDX exit reason
+    ///
+    fn get_tdx_exit_details(&mut self) -> Result<TdxExitDetails>;
+    #[cfg(feature = "tdx")]
+    ///
+    /// Set the status code for TDX exit
+    ///
+    fn set_tdx_status(&mut self, status: TdxExitStatus);
 }
--- a/hypervisor/src/hypervisor.rs
+++ b/hypervisor/src/hypervisor.rs
@@ -12,6 +12,8 @@ use crate::vm::Vm;
 use crate::x86_64::CpuId;
 #[cfg(target_arch = "x86_64")]
 use crate::x86_64::MsrList;
+#[cfg(feature = "tdx")]
+use crate::TdxCapabilities;
 use std::sync::Arc;
 use thiserror::Error;

@@ -59,6 +61,11 @@ pub enum HypervisorError {
    ///
    #[error("Checking extensions:{0}")]
    CheckExtensions(#[source] anyhow::Error),
+    ///
+    /// Failed to retrieve TDX capabilities
+    ///
+    #[error("Failed to retrieve TDX capabilities:{0}")]
+    TdxCapabilities(#[source] anyhow::Error),
 }

 ///
@@ -105,4 +112,9 @@ pub trait Hypervisor: Send + Sync {
    /// Retrieve AArch64 host maximum IPA size supported by KVM.
    ///
    fn get_host_ipa_limit(&self) -> i32;
+    ///
+    /// Retrieve TDX capabilities
+    ///
+    #[cfg(feature = "tdx")]
+    fn tdx_capabilities(&self) -> Result<TdxCapabilities>;
 }
--- a/hypervisor/src/kvm/mod.rs
+++ b/hypervisor/src/kvm/mod.rs
@@ -42,7 +42,8 @@ use crate::arch::x86::NUM_IOAPIC_PINS;
 use aarch64::{RegList, Register, StandardRegisters};
 #[cfg(target_arch = "x86_64")]
 use kvm_bindings::{
-    kvm_enable_cap, kvm_msr_entry, MsrList, KVM_CAP_HYPERV_SYNIC, KVM_CAP_SPLIT_IRQCHIP,
+    kvm_enable_cap, kvm_guest_debug, kvm_msr_entry, MsrList, KVM_CAP_HYPERV_SYNIC,
+    KVM_CAP_SPLIT_IRQCHIP, KVM_GUESTDBG_ENABLE, KVM_GUESTDBG_SINGLESTEP, KVM_GUESTDBG_USE_HW_BP,
 };
 #[cfg(target_arch = "x86_64")]
 use x86_64::{check_required_kvm_extensions, FpuState, SpecialRegisters, StandardRegisters};
@@ -81,7 +82,7 @@ pub use {
    kvm_bindings::kvm_clock_data as ClockData, kvm_bindings::kvm_create_device as CreateDevice,
    kvm_bindings::kvm_device_attr as DeviceAttr,
    kvm_bindings::kvm_irq_routing_entry as IrqRoutingEntry, kvm_bindings::kvm_mp_state as MpState,
-    kvm_bindings::kvm_userspace_memory_region as MemoryRegion,
+    kvm_bindings::kvm_run, kvm_bindings::kvm_userspace_memory_region as MemoryRegion,
    kvm_bindings::kvm_vcpu_events as VcpuEvents, kvm_ioctls::DeviceFd, kvm_ioctls::IoEventAddress,
    kvm_ioctls::VcpuExit,
 };
@@ -89,13 +90,23 @@ pub use {
 #[cfg(target_arch = "x86_64")]
 const KVM_CAP_SGX_ATTRIBUTE: u32 = 196;

+#[cfg(feature = "tdx")]
+const KVM_EXIT_TDX: u32 = 35;
+#[cfg(feature = "tdx")]
+const TDG_VP_VMCALL_GET_QUOTE: u64 = 0x10002;
+#[cfg(feature = "tdx")]
+const TDG_VP_VMCALL_SETUP_EVENT_NOTIFY_INTERRUPT: u64 = 0x10004;
+#[cfg(feature = "tdx")]
+const TDG_VP_VMCALL_SUCCESS: u64 = 0;
+#[cfg(feature = "tdx")]
+const TDG_VP_VMCALL_INVALID_OPERAND: u64 = 0x8000000000000000;
+
 #[cfg(feature = "tdx")]
 ioctl_iowr_nr!(KVM_MEMORY_ENCRYPT_OP, KVMIO, 0xba, std::os::raw::c_ulong);

 #[cfg(feature = "tdx")]
 #[repr(u32)]
 enum TdxCommand {
-    #[allow(dead_code)]
    Capabilities = 0,
    InitVm,
    InitVcpu,
@@ -103,6 +114,46 @@ enum TdxCommand {
    Finalize,
 }

+#[cfg(feature = "tdx")]
+pub enum TdxExitDetails {
+    GetQuote,
+    SetupEventNotifyInterrupt,
+}
+
+#[cfg(feature = "tdx")]
+pub enum TdxExitStatus {
+    Success,
+    InvalidOperand,
+}
+
+#[cfg(feature = "tdx")]
+const TDX_MAX_NR_CPUID_CONFIGS: usize = 6;
+
+#[cfg(feature = "tdx")]
+#[repr(C)]
+#[derive(Debug, Default)]
+pub struct TdxCpuidConfig {
+    pub leaf: u32,
+    pub sub_leaf: u32,
+    pub eax: u32,
+    pub ebx: u32,
+    pub ecx: u32,
+    pub edx: u32,
+}
+
+#[cfg(feature = "tdx")]
+#[repr(C)]
+#[derive(Debug, Default)]
+pub struct TdxCapabilities {
+    pub attrs_fixed0: u64,
+    pub attrs_fixed1: u64,
+    pub xfam_fixed0: u64,
+    pub xfam_fixed1: u64,
+    pub nr_cpuid_configs: u32,
+    pub padding: u32,
+    pub cpuid_configs: [TdxCpuidConfig; TDX_MAX_NR_CPUID_CONFIGS],
+}
+
 #[derive(Clone, Copy, Debug, PartialEq, Deserialize, Serialize)]
 pub struct KvmVmState {}

@@ -501,7 +552,7 @@ impl vm::Vm for KvmVm {
        let data = TdxInitVm {
            max_vcpus,
            tsc_khz: 0,
-            attributes: 1, // TDX1_TD_ATTRIBUTE_DEBUG,
+            attributes: 0,
            cpuid: cpuid.as_fam_struct_ptr() as u64,
            mrconfigid: [0; 6],
            mrowner: [0; 6],
@@ -738,6 +789,27 @@ impl hypervisor::Hypervisor for KvmHypervisor {
    fn get_host_ipa_limit(&self) -> i32 {
        self.kvm.get_host_ipa_limit()
    }
+
+    ///
+    /// Retrieve TDX capabilities
+    ///
+    #[cfg(feature = "tdx")]
+    fn tdx_capabilities(&self) -> hypervisor::Result<TdxCapabilities> {
+        let data = TdxCapabilities {
+            nr_cpuid_configs: TDX_MAX_NR_CPUID_CONFIGS as u32,
+            ..Default::default()
+        };
+
+        tdx_command(
+            &self.kvm.as_raw_fd(),
+            TdxCommand::Capabilities,
+            0,
+            &data as *const _ as u64,
+        )
+        .map_err(|e| hypervisor::HypervisorError::TdxCapabilities(e.into()))?;
+
+        Ok(data)
+    }
 }
 /// Vcpu struct for KVM
 pub struct KvmVcpu {
@@ -777,6 +849,27 @@ impl cpu::Vcpu for KvmVcpu {
            .set_regs(regs)
            .map_err(|e| cpu::HypervisorCpuError::SetStandardRegs(e.into()))
    }
+
+    #[cfg(target_arch = "aarch64")]
+    ///
+    /// Set attribute for vcpu.
+    ///
+    fn set_vcpu_attr(&self, attr: &DeviceAttr) -> cpu::Result<()> {
+        self.fd
+            .set_device_attr(attr)
+            .map_err(|e| cpu::HypervisorCpuError::SetVcpuAttribute(e.into()))
+    }
+
+    #[cfg(target_arch = "aarch64")]
+    ///
+    /// Check if vcpu has a certain attribute.
+    ///
+    fn has_vcpu_attr(&self, attr: &DeviceAttr) -> cpu::Result<()> {
+        self.fd
+            .has_device_attr(attr)
+            .map_err(|e| cpu::HypervisorCpuError::HasVcpuAttribute(e.into()))
+    }
+
    #[cfg(target_arch = "x86_64")]
    ///
    /// Returns the vCPU special registers.
@@ -937,6 +1030,24 @@ impl cpu::Vcpu for KvmVcpu {
            .set_xcrs(xcrs)
            .map_err(|e| cpu::HypervisorCpuError::SetXcsr(e.into()))
    }
+    #[cfg(target_arch = "x86_64")]
+    ///
+    /// Translates guest virtual address to guest physical address using the `KVM_TRANSLATE` ioctl.
+    ///
+    fn translate_gva(&self, gva: u64, _flags: u64) -> cpu::Result<(u64, u32)> {
+        let tr = self
+            .fd
+            .translate_gva(gva)
+            .map_err(|e| cpu::HypervisorCpuError::TranslateVirtualAddress(e.into()))?;
+        // tr.valid is set if the GVA is mapped to valid GPA.
+        match tr.valid {
+            0 => Err(cpu::HypervisorCpuError::TranslateVirtualAddress(anyhow!(
+                "Invalid GVA: {:#x}",
+                gva
+            ))),
+            _ => Ok((tr.physical_address, 0)),
+        }
+    }
    ///
    /// Triggers the running of the current virtual CPU returning an exit reason.
    ///
@@ -1009,6 +1120,9 @@ impl cpu::Vcpu for KvmVcpu {
                    Ok(cpu::VmExit::MmioWrite(addr, data))
                }
                VcpuExit::Hyperv => Ok(cpu::VmExit::Hyperv),
+                #[cfg(feature = "tdx")]
+                VcpuExit::Unsupported(KVM_EXIT_TDX) => Ok(cpu::VmExit::Tdx),
+                VcpuExit::Debug(_) => Ok(cpu::VmExit::Debug),

                r => Err(cpu::HypervisorCpuError::RunVcpu(anyhow!(
                    "Unexpected exit reason on vcpu run: {:?}",
@@ -1062,6 +1176,45 @@ impl cpu::Vcpu for KvmVcpu {

        Ok(())
    }
+    #[cfg(target_arch = "x86_64")]
+    ///
+    /// Sets debug registers to set hardware breakpoints and/or enable single step.
+    ///
+    fn set_guest_debug(
+        &self,
+        addrs: &[vm_memory::GuestAddress],
+        singlestep: bool,
+    ) -> cpu::Result<()> {
+        if addrs.len() > 4 {
+            return Err(cpu::HypervisorCpuError::SetDebugRegs(anyhow!(
+                "Support 4 breakpoints at most but {} addresses are passed",
+                addrs.len()
+            )));
+        }
+
+        let mut dbg = kvm_guest_debug {
+            control: KVM_GUESTDBG_ENABLE | KVM_GUESTDBG_USE_HW_BP,
+            ..Default::default()
+        };
+        if singlestep {
+            dbg.control |= KVM_GUESTDBG_SINGLESTEP;
+        }
+
+        // Set bits 9 and 10.
+        // bit 9: GE (global exact breakpoint enable) flag.
+        // bit 10: always 1.
+        dbg.arch.debugreg[7] = 0x0600;
+
+        for (i, addr) in addrs.iter().enumerate() {
+            dbg.arch.debugreg[i] = addr.0;
+            // Set global breakpoint enable flag
+            dbg.arch.debugreg[7] |= 2 << (i * 2);
+        }
+
+        self.fd
+            .set_guest_debug(&dbg)
+            .map_err(|e| cpu::HypervisorCpuError::SetDebugRegs(e.into()))
+    }
    #[cfg(any(target_arch = "arm", target_arch = "aarch64"))]
    fn vcpu_init(&self, kvi: &VcpuInit) -> cpu::Result<()> {
        self.fd
@@ -1574,6 +1727,50 @@ impl cpu::Vcpu for KvmVcpu {
        tdx_command(&self.fd.as_raw_fd(), TdxCommand::InitVcpu, 0, hob_address)
            .map_err(cpu::HypervisorCpuError::InitializeTdx)
    }
+
+    ///
+    /// Set the "immediate_exit" state
+    ///
+    fn set_immediate_exit(&self, exit: bool) {
+        self.fd.set_kvm_immediate_exit(exit.into());
+    }
+
+    ///
+    /// Returns the details about TDX exit reason
+    ///
+    #[cfg(feature = "tdx")]
+    fn get_tdx_exit_details(&mut self) -> cpu::Result<TdxExitDetails> {
+        let kvm_run = self.fd.get_kvm_run();
+        let tdx_vmcall = unsafe { &mut kvm_run.__bindgen_anon_1.tdx.u.vmcall };
+
+        tdx_vmcall.status_code = TDG_VP_VMCALL_INVALID_OPERAND;
+
+        if tdx_vmcall.type_ != 0 {
+            return Err(cpu::HypervisorCpuError::UnknownTdxVmCall);
+        }
+
+        match tdx_vmcall.subfunction {
+            TDG_VP_VMCALL_GET_QUOTE => Ok(TdxExitDetails::GetQuote),
+            TDG_VP_VMCALL_SETUP_EVENT_NOTIFY_INTERRUPT => {
+                Ok(TdxExitDetails::SetupEventNotifyInterrupt)
+            }
+            _ => Err(cpu::HypervisorCpuError::UnknownTdxVmCall),
+        }
+    }
+
+    ///
+    /// Set the status code for TDX exit
+    ///
+    #[cfg(feature = "tdx")]
+    fn set_tdx_status(&mut self, status: TdxExitStatus) {
+        let kvm_run = self.fd.get_kvm_run();
+        let tdx_vmcall = unsafe { &mut kvm_run.__bindgen_anon_1.tdx.u.vmcall };
+
+        tdx_vmcall.status_code = match status {
+            TdxExitStatus::Success => TDG_VP_VMCALL_SUCCESS,
+            TdxExitStatus::InvalidOperand => TDG_VP_VMCALL_INVALID_OPERAND,
+        };
+    }
 }

 /// Device struct for KVM
--- a/hypervisor/src/kvm/x86_64/mod.rs
+++ b/hypervisor/src/kvm/x86_64/mod.rs
@@ -130,6 +130,9 @@ pub fn check_required_kvm_extensions(kvm: &Kvm) -> KvmResult<()> {
    if !kvm.check_extension(Cap::SetTssAddr) {
        return Err(KvmError::CapabilityMissing(Cap::SetTssAddr));
    }
+    if !kvm.check_extension(Cap::ImmediateExit) {
+        return Err(KvmError::CapabilityMissing(Cap::ImmediateExit));
+    }
    Ok(())
 }
 #[derive(Clone, Serialize, Deserialize)]
--- a/hypervisor/src/lib.rs
+++ b/hypervisor/src/lib.rs
@@ -51,6 +51,8 @@ mod device;
 pub use crate::hypervisor::{Hypervisor, HypervisorError};
 pub use cpu::{HypervisorCpuError, Vcpu, VmExit};
 pub use device::{Device, HypervisorDeviceError};
+#[cfg(feature = "tdx")]
+pub use kvm::TdxCapabilities;
 #[cfg(feature = "kvm")]
 pub use kvm::*;
 #[cfg(all(feature = "mshv", target_arch = "x86_64"))]
--- a/hypervisor/src/mshv/mod.rs
+++ b/hypervisor/src/mshv/mod.rs
@@ -134,7 +134,7 @@ impl hypervisor::Hypervisor for MshvHypervisor {
    }
    #[cfg(target_arch = "x86_64")]
    ///
-    /// Retrieve the list of MSRs supported by KVM.
+    /// Retrieve the list of MSRs supported by MSHV.
    ///
    fn get_msr_list(&self) -> hypervisor::Result<MsrList> {
        self.mshv
@@ -561,13 +561,17 @@ impl cpu::Vcpu for MshvVcpu {
    ///
    /// Translate guest virtual address to guest physical address
    ///
-    fn translate_gva(&self, gva: u64, flags: u64) -> cpu::Result<(u64, hv_translate_gva_result)> {
+    fn translate_gva(&self, gva: u64, flags: u64) -> cpu::Result<(u64, u32)> {
        let r = self
            .fd
            .translate_gva(gva, flags)
            .map_err(|e| cpu::HypervisorCpuError::TranslateVirtualAddress(e.into()))?;

-        Ok(r)
+        let gpa = r.0;
+        // SAFETY: r is valid, otherwise this function will have returned
+        let result_code = unsafe { r.1.__bindgen_anon_1.result_code };
+
+        Ok((gpa, result_code))
    }
    #[cfg(target_arch = "x86_64")]
    ///
@@ -626,15 +630,13 @@ impl<'a> MshvEmulatorContext<'a> {
        // TODO: More fine-grained control for the flags
        let flags = HV_TRANSLATE_GVA_VALIDATE_READ | HV_TRANSLATE_GVA_VALIDATE_WRITE;

-        let r = self
+        let (gpa, result_code) = self
            .vcpu
            .translate_gva(gva, flags.into())
            .map_err(|e| PlatformError::TranslateVirtualAddress(anyhow!(e)))?;

-        // SAFETY: r is valid, otherwise this function will have returned
-        let result_code = unsafe { r.1.__bindgen_anon_1.result_code };
        match result_code {
-            hv_translate_gva_result_code_HV_TRANSLATE_GVA_SUCCESS => Ok(r.0),
+            hv_translate_gva_result_code_HV_TRANSLATE_GVA_SUCCESS => Ok(gpa),
            _ => Err(PlatformError::TranslateVirtualAddress(anyhow!(result_code))),
        }
    }
--- a/net_gen/Cargo.toml
+++ b/net_gen/Cargo.toml
@@ -2,7 +2,7 @@
 name = "net_gen"
 version = "0.1.0"
 authors = ["The Chromium OS Authors"]
-edition = "2018"
+edition = "2021"

 [dependencies]
 vmm-sys-util = "0.9.0"
--- a/net_util/Cargo.toml
+++ b/net_util/Cargo.toml
@@ -2,20 +2,20 @@
 name = "net_util"
 version = "0.1.0"
 authors = ["The Chromium OS Authors"]
-edition = "2018"
+edition = "2021"

 [dependencies]
 epoll = "4.3.1"
 getrandom = "0.2"
-libc = "0.2.112"
-log = "0.4.14"
+libc = "0.2.123"
+log = "0.4.16"
 net_gen = { path = "../net_gen" }
 rate_limiter = { path = "../rate_limiter" }
-serde = "1.0.133"
+serde = "1.0.136"
 versionize = "0.1.6"
 versionize_derive = "0.1.4"
 virtio-bindings = "0.1.0"
-virtio-queue = { path = "../virtio-queue" }
+virtio-queue = "0.2.0"
 vm-memory = { version = "0.7.0", features = ["backend-mmap", "backend-atomic", "backend-bitmap"] }
 vm-virtio = { path = "../vm-virtio" }
 vmm-sys-util = "0.9.0"
@@ -23,4 +23,4 @@ vmm-sys-util = "0.9.0"
 [dev-dependencies]
 lazy_static = "1.4.0"
 pnet = "0.29.0"
-serde_json = "1.0.75"
+serde_json = "1.0.79"
--- a/net_util/src/ctrl_queue.rs
+++ b/net_util/src/ctrl_queue.rs
@@ -5,6 +5,7 @@
 use crate::GuestMemoryMmap;
 use crate::Tap;
 use libc::c_uint;
+use std::sync::Arc;
 use virtio_bindings::bindings::virtio_net::{
    VIRTIO_NET_CTRL_GUEST_OFFLOADS, VIRTIO_NET_CTRL_GUEST_OFFLOADS_SET, VIRTIO_NET_CTRL_MQ,
    VIRTIO_NET_CTRL_MQ_VQ_PAIRS_MAX, VIRTIO_NET_CTRL_MQ_VQ_PAIRS_MIN,
@@ -14,6 +15,7 @@ use virtio_bindings::bindings::virtio_net::{
 };
 use virtio_queue::Queue;
 use vm_memory::{ByteValued, Bytes, GuestMemoryAtomic, GuestMemoryError};
+use vm_virtio::{AccessPlatform, Translatable};

 #[derive(Debug)]
 pub enum Error {
@@ -57,86 +59,104 @@ impl CtrlQueue {
    pub fn process(
        &mut self,
        queue: &mut Queue<GuestMemoryAtomic<GuestMemoryMmap>>,
-    ) -> Result<bool> {
+        access_platform: Option<&Arc<dyn AccessPlatform>>,
+    ) -> Result<()> {
        let mut used_desc_heads = Vec::new();
-        for mut desc_chain in queue.iter().map_err(Error::QueueIterator)? {
-            let ctrl_desc = desc_chain.next().ok_or(Error::NoControlHeaderDescriptor)?;
+        loop {
+            for mut desc_chain in queue.iter().map_err(Error::QueueIterator)? {
+                let ctrl_desc = desc_chain.next().ok_or(Error::NoControlHeaderDescriptor)?;

-            let ctrl_hdr: ControlHeader = desc_chain
-                .memory()
-                .read_obj(ctrl_desc.addr())
-                .map_err(Error::GuestMemory)?;
-            let data_desc = desc_chain.next().ok_or(Error::NoDataDescriptor)?;
-            let status_desc = desc_chain.next().ok_or(Error::NoStatusDescriptor)?;
+                let ctrl_hdr: ControlHeader = desc_chain
+                    .memory()
+                    .read_obj(
+                        ctrl_desc
+                            .addr()
+                            .translate_gva(access_platform, ctrl_desc.len() as usize),
+                    )
+                    .map_err(Error::GuestMemory)?;
+                let data_desc = desc_chain.next().ok_or(Error::NoDataDescriptor)?;

-            let ok = match u32::from(ctrl_hdr.class) {
-                VIRTIO_NET_CTRL_MQ => {
-                    let queue_pairs = desc_chain
-                        .memory()
-                        .read_obj::<u16>(data_desc.addr())
-                        .map_err(Error::GuestMemory)?;
-                    if u32::from(ctrl_hdr.cmd) != VIRTIO_NET_CTRL_MQ_VQ_PAIRS_SET {
-                        warn!("Unsupported command: {}", ctrl_hdr.cmd);
-                        false
-                    } else if (queue_pairs < VIRTIO_NET_CTRL_MQ_VQ_PAIRS_MIN as u16)
-                        || (queue_pairs > VIRTIO_NET_CTRL_MQ_VQ_PAIRS_MAX as u16)
-                    {
-                        warn!("Number of MQ pairs out of range: {}", queue_pairs);
-                        false
-                    } else {
-                        info!("Number of MQ pairs requested: {}", queue_pairs);
-                        true
-                    }
-                }
-                VIRTIO_NET_CTRL_GUEST_OFFLOADS => {
-                    let features = desc_chain
-                        .memory()
-                        .read_obj::<u64>(data_desc.addr())
-                        .map_err(Error::GuestMemory)?;
-                    if u32::from(ctrl_hdr.cmd) != VIRTIO_NET_CTRL_GUEST_OFFLOADS_SET {
-                        warn!("Unsupported command: {}", ctrl_hdr.cmd);
-                        false
-                    } else {
-                        let mut ok = true;
-                        for tap in self.taps.iter_mut() {
-                            info!("Reprogramming tap offload with features: {}", features);
-                            tap.set_offload(virtio_features_to_tap_offload(features))
-                                .map_err(|e| {
-                                    error!("Error programming tap offload: {:?}", e);
-                                    ok = false
-                                })
-                                .ok();
+                let data_desc_addr = data_desc
+                    .addr()
+                    .translate_gva(access_platform, data_desc.len() as usize);
+
+                let status_desc = desc_chain.next().ok_or(Error::NoStatusDescriptor)?;
+
+                let ok = match u32::from(ctrl_hdr.class) {
+                    VIRTIO_NET_CTRL_MQ => {
+                        let queue_pairs = desc_chain
+                            .memory()
+                            .read_obj::<u16>(data_desc_addr)
+                            .map_err(Error::GuestMemory)?;
+                        if u32::from(ctrl_hdr.cmd) != VIRTIO_NET_CTRL_MQ_VQ_PAIRS_SET {
+                            warn!("Unsupported command: {}", ctrl_hdr.cmd);
+                            false
+                        } else if (queue_pairs < VIRTIO_NET_CTRL_MQ_VQ_PAIRS_MIN as u16)
+                            || (queue_pairs > VIRTIO_NET_CTRL_MQ_VQ_PAIRS_MAX as u16)
+                        {
+                            warn!("Number of MQ pairs out of range: {}", queue_pairs);
+                            false
+                        } else {
+                            info!("Number of MQ pairs requested: {}", queue_pairs);
+                            true
                        }
-                        ok
                    }
-                }
-                _ => {
-                    warn!("Unsupported command {:?}", ctrl_hdr);
-                    false
-                }
-            };
+                    VIRTIO_NET_CTRL_GUEST_OFFLOADS => {
+                        let features = desc_chain
+                            .memory()
+                            .read_obj::<u64>(data_desc_addr)
+                            .map_err(Error::GuestMemory)?;
+                        if u32::from(ctrl_hdr.cmd) != VIRTIO_NET_CTRL_GUEST_OFFLOADS_SET {
+                            warn!("Unsupported command: {}", ctrl_hdr.cmd);
+                            false
+                        } else {
+                            let mut ok = true;
+                            for tap in self.taps.iter_mut() {
+                                info!("Reprogramming tap offload with features: {}", features);
+                                tap.set_offload(virtio_features_to_tap_offload(features))
+                                    .map_err(|e| {
+                                        error!("Error programming tap offload: {:?}", e);
+                                        ok = false
+                                    })
+                                    .ok();
+                            }
+                            ok
+                        }
+                    }
+                    _ => {
+                        warn!("Unsupported command {:?}", ctrl_hdr);
+                        false
+                    }
+                };

-            desc_chain
-                .memory()
-                .write_obj(
-                    if ok { VIRTIO_NET_OK } else { VIRTIO_NET_ERR } as u8,
-                    status_desc.addr(),
-                )
-                .map_err(Error::GuestMemory)?;
-            let len = ctrl_desc.len() + data_desc.len() + status_desc.len();
-            used_desc_heads.push((desc_chain.head_index(), len));
-        }
+                desc_chain
+                    .memory()
+                    .write_obj(
+                        if ok { VIRTIO_NET_OK } else { VIRTIO_NET_ERR } as u8,
+                        status_desc
+                            .addr()
+                            .translate_gva(access_platform, status_desc.len() as usize),
+                    )
+                    .map_err(Error::GuestMemory)?;
+                let len = ctrl_desc.len() + data_desc.len() + status_desc.len();
+                used_desc_heads.push((desc_chain.head_index(), len));
+            }

-        for (desc_index, len) in used_desc_heads.iter() {
-            queue
-                .add_used(*desc_index, *len)
-                .map_err(Error::QueueAddUsed)?;
-            queue
+            for (desc_index, len) in used_desc_heads.iter() {
+                queue
+                    .add_used(*desc_index, *len)
+                    .map_err(Error::QueueAddUsed)?;
+            }
+
+            if !queue
                .enable_notification()
-                .map_err(Error::QueueEnableNotification)?;
+                .map_err(Error::QueueEnableNotification)?
+            {
+                break;
+            }
        }

-        Ok(!used_desc_heads.is_empty())
+        Ok(())
    }
 }

--- a/net_util/src/lib.rs
+++ b/net_util/src/lib.rs
@@ -77,7 +77,7 @@ fn create_sockaddr(ip_addr: net::Ipv4Addr) -> net_gen::sockaddr {
    unsafe { mem::transmute(addr_in) }
 }

-fn create_socket() -> Result<net::UdpSocket> {
+fn create_inet_socket() -> Result<net::UdpSocket> {
    // This is safe since we check the return value.
    let sock = unsafe { libc::socket(libc::AF_INET, libc::SOCK_DGRAM, 0) };
    if sock < 0 {
@@ -88,6 +88,17 @@ fn create_socket() -> Result<net::UdpSocket> {
    Ok(unsafe { net::UdpSocket::from_raw_fd(sock) })
 }

+fn create_unix_socket() -> Result<net::UdpSocket> {
+    // This is safe since we check the return value.
+    let sock = unsafe { libc::socket(libc::AF_UNIX, libc::SOCK_DGRAM, 0) };
+    if sock < 0 {
+        return Err(Error::CreateSocket(IoError::last_os_error()));
+    }
+
+    // This is safe; nothing else will use or hold onto the raw sock fd.
+    Ok(unsafe { net::UdpSocket::from_raw_fd(sock) })
+}
+
 fn vnet_hdr_len() -> usize {
    std::mem::size_of::<virtio_net_hdr_v1>()
 }
--- a/net_util/src/queue_pair.rs
+++ b/net_util/src/queue_pair.rs
@@ -12,6 +12,7 @@ use std::sync::atomic::{AtomicU64, Ordering};
 use std::sync::Arc;
 use virtio_queue::Queue;
 use vm_memory::{Bytes, GuestMemory, GuestMemoryAtomic};
+use vm_virtio::{AccessPlatform, Translatable};

 #[derive(Clone)]
 pub struct TxVirtio {
@@ -38,6 +39,7 @@ impl TxVirtio {
        tap: &mut Tap,
        queue: &mut Queue<GuestMemoryAtomic<GuestMemoryMmap>>,
        rate_limiter: &mut Option<RateLimiter>,
+        access_platform: Option<&Arc<dyn AccessPlatform>>,
    ) -> Result<bool, NetQueuePairError> {
        let mut retry_write = false;
        let mut rate_limit_reached = false;
@@ -58,10 +60,13 @@ impl TxVirtio {

                let mut iovecs = Vec::new();
                while let Some(desc) = next_desc {
+                    let desc_addr = desc
+                        .addr()
+                        .translate_gva(access_platform, desc.len() as usize);
                    if !desc.is_write_only() && desc.len() > 0 {
                        let buf = desc_chain
                            .memory()
-                            .get_slice(desc.addr(), desc.len() as usize)
+                            .get_slice(desc_addr, desc.len() as usize)
                            .map_err(NetQueuePairError::GuestMemory)?
                            .as_ptr();
                        let iovec = libc::iovec {
@@ -72,7 +77,7 @@ impl TxVirtio {
                    } else {
                        error!(
                            "Invalid descriptor chain: address = 0x{:x} length = {} write_only = {}",
-                            desc.addr().0,
+                            desc_addr.0,
                            desc.len(),
                            desc.is_write_only()
                        );
@@ -127,9 +132,12 @@ impl TxVirtio {
            queue
                .add_used(used_desc_head.0, used_desc_head.1)
                .map_err(NetQueuePairError::QueueAddUsed)?;
-            queue
+            if !queue
                .enable_notification()
-                .map_err(NetQueuePairError::QueueEnableNotification)?;
+                .map_err(NetQueuePairError::QueueEnableNotification)?
+            {
+                break;
+            }
        }

        Ok(retry_write)
@@ -161,6 +169,7 @@ impl RxVirtio {
        tap: &mut Tap,
        queue: &mut Queue<GuestMemoryAtomic<GuestMemoryMmap>>,
        rate_limiter: &mut Option<RateLimiter>,
+        access_platform: Option<&Arc<dyn AccessPlatform>>,
    ) -> Result<bool, NetQueuePairError> {
        let mut exhausted_descs = true;
        let mut rate_limit_reached = false;
@@ -181,15 +190,26 @@ impl RxVirtio {
                let desc = desc_chain
                    .next()
                    .ok_or(NetQueuePairError::DescriptorChainTooShort)?;
-                let num_buffers_addr = desc_chain.memory().checked_offset(desc.addr(), 10).unwrap();
+
+                let num_buffers_addr = desc_chain
+                    .memory()
+                    .checked_offset(
+                        desc.addr()
+                            .translate_gva(access_platform, desc.len() as usize),
+                        10,
+                    )
+                    .unwrap();
                let mut next_desc = Some(desc);

                let mut iovecs = Vec::new();
                while let Some(desc) = next_desc {
+                    let desc_addr = desc
+                        .addr()
+                        .translate_gva(access_platform, desc.len() as usize);
                    if desc.is_write_only() && desc.len() > 0 {
                        let buf = desc_chain
                            .memory()
-                            .get_slice(desc.addr(), desc.len() as usize)
+                            .get_slice(desc_addr, desc.len() as usize)
                            .map_err(NetQueuePairError::GuestMemory)?
                            .as_ptr();
                        let iovec = libc::iovec {
@@ -200,7 +220,7 @@ impl RxVirtio {
                    } else {
                        error!(
                            "Invalid descriptor chain: address = 0x{:x} length = {} write_only = {}",
-                            desc.addr().0,
+                            desc_addr.0,
                            desc.len(),
                            desc.is_write_only()
                        );
@@ -263,9 +283,12 @@ impl RxVirtio {
            queue
                .add_used(used_desc_head.0, used_desc_head.1)
                .map_err(NetQueuePairError::QueueAddUsed)?;
-            queue
+            if !queue
                .enable_notification()
-                .map_err(NetQueuePairError::QueueEnableNotification)?;
+                .map_err(NetQueuePairError::QueueEnableNotification)?
+            {
+                break;
+            }
        }

        Ok(exhausted_descs)
@@ -326,6 +349,7 @@ pub struct NetQueuePair {
    pub rx_desc_avail: bool,
    pub rx_rate_limiter: Option<RateLimiter>,
    pub tx_rate_limiter: Option<RateLimiter>,
+    pub access_platform: Option<Arc<dyn AccessPlatform>>,
 }

 impl NetQueuePair {
@@ -333,9 +357,12 @@ impl NetQueuePair {
        &mut self,
        queue: &mut Queue<GuestMemoryAtomic<GuestMemoryMmap>>,
    ) -> Result<bool, NetQueuePairError> {
-        let tx_tap_retry =
-            self.tx
-                .process_desc_chain(&mut self.tap, queue, &mut self.tx_rate_limiter)?;
+        let tx_tap_retry = self.tx.process_desc_chain(
+            &mut self.tap,
+            queue,
+            &mut self.tx_rate_limiter,
+            self.access_platform.as_ref(),
+        )?;

        // We got told to try again when writing to the tap. Wait for the TAP to be writable
        if tx_tap_retry && !self.tx_tap_listening {
@@ -378,10 +405,12 @@ impl NetQueuePair {
        &mut self,
        queue: &mut Queue<GuestMemoryAtomic<GuestMemoryMmap>>,
    ) -> Result<bool, NetQueuePairError> {
-        self.rx_desc_avail =
-            !self
-                .rx
-                .process_desc_chain(&mut self.tap, queue, &mut self.rx_rate_limiter)?;
+        self.rx_desc_avail = !self.rx.process_desc_chain(
+            &mut self.tap,
+            queue,
+            &mut self.rx_rate_limiter,
+            self.access_platform.as_ref(),
+        )?;
        let rate_limit_reached = self
            .rx_rate_limiter
            .as_ref()
--- a/net_util/src/tap.rs
+++ b/net_util/src/tap.rs
@@ -5,7 +5,10 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the THIRD-PARTY file.

-use super::{create_sockaddr, create_socket, vnet_hdr_len, Error as NetUtilError, MacAddr};
+use super::{
+    create_inet_socket, create_sockaddr, create_unix_socket, vnet_hdr_len, Error as NetUtilError,
+    MacAddr,
+};
 use crate::mac::MAC_ADDR_LEN;
 use std::fs::File;
 use std::io::{Error as IoError, Read, Result as IoResult, Write};
@@ -196,7 +199,7 @@ impl Tap {

    /// Set the host-side IP address for the tap interface.
    pub fn set_ip_addr(&self, ip_addr: net::Ipv4Addr) -> Result<()> {
-        let sock = create_socket().map_err(Error::NetUtil)?;
+        let sock = create_inet_socket().map_err(Error::NetUtil)?;
        let addr = create_sockaddr(ip_addr);

        let mut ifreq = self.get_ifreq();
@@ -224,7 +227,7 @@ impl Tap {
            return Ok(());
        }

-        let sock = create_socket().map_err(Error::NetUtil)?;
+        let sock = create_unix_socket().map_err(Error::NetUtil)?;

        let mut ifreq = self.get_ifreq();

@@ -254,7 +257,7 @@ impl Tap {

    /// Get mac addr for tap interface.
    pub fn get_mac_addr(&self) -> Result<MacAddr> {
-        let sock = create_socket().map_err(Error::NetUtil)?;
+        let sock = create_unix_socket().map_err(Error::NetUtil)?;

        let ifreq = self.get_ifreq();

@@ -275,7 +278,7 @@ impl Tap {

    /// Set the netmask for the subnet that the tap interface will exist on.
    pub fn set_netmask(&self, netmask: net::Ipv4Addr) -> Result<()> {
-        let sock = create_socket().map_err(Error::NetUtil)?;
+        let sock = create_inet_socket().map_err(Error::NetUtil)?;
        let addr = create_sockaddr(netmask);

        let mut ifreq = self.get_ifreq();
@@ -306,7 +309,7 @@ impl Tap {

    /// Enable the tap interface.
    pub fn enable(&self) -> Result<()> {
-        let sock = create_socket().map_err(Error::NetUtil)?;
+        let sock = create_unix_socket().map_err(Error::NetUtil)?;

        let mut ifreq = self.get_ifreq();

--- a/option_parser/Cargo.toml
+++ b/option_parser/Cargo.toml
@@ -2,4 +2,4 @@
 name = "option_parser"
 version = "0.1.0"
 authors = ["The Cloud Hypervisor Authors"]
-edition = "2018"
+edition = "2021"
--- a/option_parser/src/lib.rs
+++ b/option_parser/src/lib.rs
@@ -313,6 +313,7 @@ impl<S: FromStr, T: TupleValue> FromStr for Tuple<S, T> {
    }
 }

+#[derive(Default)]
 pub struct StringList(pub Vec<String>);

 pub enum StringListParseError {
--- a/pci/Cargo.toml
+++ b/pci/Cargo.toml
@@ -2,7 +2,7 @@
 name = "pci"
 version = "0.1.0"
 authors = ["Samuel Ortiz <sameo@linux.intel.com>"]
-edition = "2018"
+edition = "2021"

 [features]
 default = []
@@ -10,14 +10,16 @@ kvm = ["vfio-ioctls/kvm"]
 mshv = ["vfio-ioctls/mshv"]

 [dependencies]
-anyhow = "1.0.52"
+anyhow = "1.0.56"
 byteorder = "1.4.3"
 hypervisor = { path = "../hypervisor" }
-vfio-ioctls = { git = "https://github.com/rust-vmm/vfio-ioctls", branch = "main", default-features = false }
+vfio-ioctls = { git = "https://github.com/rust-vmm/vfio", branch = "main", default-features = false }
 vfio_user = { path = "../vfio_user" }
 vmm-sys-util = "0.9.0"
-libc = "0.2.112"
-log = "0.4.14"
+libc = "0.2.123"
+log = "0.4.16"
+serde = "1.0.136"
+serde_derive = "1.0.136"
 thiserror = "1.0.30"
 versionize = "0.1.6"
 versionize_derive = "0.1.4"
--- a/pci/src/configuration.rs
+++ b/pci/src/configuration.rs
@@ -21,6 +21,8 @@ const ROM_BAR_REG: usize = 12;
 const BAR_IO_ADDR_MASK: u32 = 0xffff_fffc;
 const BAR_MEM_ADDR_MASK: u32 = 0xffff_fff0;
 const ROM_BAR_ADDR_MASK: u32 = 0xffff_f800;
+const MSI_CAPABILITY_REGISTER_MASK: u32 = 0x0071_0000;
+const MSIX_CAPABILITY_REGISTER_MASK: u32 = 0xc000_0000;
 const NUM_BAR_REGS: usize = 6;
 const CAPABILITY_LIST_HEAD_OFFSET: usize = 0x34;
 const FIRST_CAPABILITY_OFFSET: usize = 0x40;
@@ -714,8 +716,15 @@ impl PciConfiguration {
        }
        self.last_capability = Some((cap_offset, total_len));

-        if cap_data.id() == PciCapabilityId::MsiX {
-            self.msix_cap_reg_idx = Some(cap_offset / 4);
+        match cap_data.id() {
+            PciCapabilityId::MessageSignalledInterrupts => {
+                self.writable_bits[cap_offset / 4] = MSI_CAPABILITY_REGISTER_MASK;
+            }
+            PciCapabilityId::MsiX => {
+                self.msix_cap_reg_idx = Some(cap_offset / 4);
+                self.writable_bits[self.msix_cap_reg_idx.unwrap()] = MSIX_CAPABILITY_REGISTER_MASK;
+            }
+            _ => {}
        }

        Ok(cap_offset)
@@ -740,6 +749,11 @@ impl PciConfiguration {
                        .lock()
                        .unwrap()
                        .set_msg_ctl(LittleEndian::read_u16(data));
+                } else if msix_cap_reg_idx == reg_idx && offset == 0 && data.len() == 4 {
+                    msix_config
+                        .lock()
+                        .unwrap()
+                        .set_msg_ctl((LittleEndian::read_u32(data) >> 16) as u16);
                }
            }
        }
--- a/pci/src/lib.rs
+++ b/pci/src/lib.rs
@@ -27,7 +27,10 @@ pub use self::msi::{msi_num_enabled_vectors, MsiCap, MsiConfig};
 pub use self::msix::{MsixCap, MsixConfig, MsixTableEntry, MSIX_TABLE_ENTRY_SIZE};
 pub use self::vfio::{VfioPciDevice, VfioPciError};
 pub use self::vfio_user::{VfioUserDmaMapping, VfioUserPciDevice, VfioUserPciDeviceError};
-use std::fmt::Display;
+use serde::de::Visitor;
+use std::fmt::{self, Display};
+use std::num::ParseIntError;
+use std::str::FromStr;

 /// PCI has four interrupt pins A->D.
 #[derive(Copy, Clone)]
@@ -52,6 +55,41 @@ pub const PCI_CONFIG_IO_PORT_SIZE: u64 = 0x8;
 #[derive(Clone, Copy, PartialEq, PartialOrd)]
 pub struct PciBdf(u32);

+struct PciBdfVisitor;
+
+impl<'de> Visitor<'de> for PciBdfVisitor {
+    type Value = PciBdf;
+
+    fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
+        formatter.write_str("struct PciBdf")
+    }
+
+    fn visit_str<E>(self, v: &str) -> Result<Self::Value, E>
+    where
+        E: serde::de::Error,
+    {
+        Ok(v.into())
+    }
+}
+
+impl<'de> serde::Deserialize<'de> for PciBdf {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        deserializer.deserialize_str(PciBdfVisitor)
+    }
+}
+
+impl serde::Serialize for PciBdf {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: serde::Serializer,
+    {
+        serializer.collect_str(&self.to_string())
+    }
+}
+
 impl PciBdf {
    pub fn segment(&self) -> u16 {
        ((self.0 >> 16) & 0xffff) as u16
@@ -121,3 +159,25 @@ impl Display for PciBdf {
        )
    }
 }
+
+impl FromStr for PciBdf {
+    type Err = ParseIntError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        let items: Vec<&str> = s.split('.').collect();
+        assert_eq!(items.len(), 2);
+        let function = u8::from_str_radix(items[1], 16)?;
+        let items: Vec<&str> = items[0].split(':').collect();
+        assert_eq!(items.len(), 3);
+        let segment = u16::from_str_radix(items[0], 16)?;
+        let bus = u8::from_str_radix(items[1], 16)?;
+        let device = u8::from_str_radix(items[2], 16)?;
+        Ok(PciBdf::new(segment, bus, device, function))
+    }
+}
+
+impl From<&str> for PciBdf {
+    fn from(bdf: &str) -> Self {
+        Self::from_str(bdf).unwrap()
+    }
+}
--- a/pci/src/msi.rs
+++ b/pci/src/msi.rs
@@ -201,20 +201,13 @@ impl MsiConfig {
                    devid: 0,
                };

-                if let Err(e) = self
-                    .interrupt_source_group
-                    .update(idx as InterruptIndex, InterruptSourceConfig::MsiIrq(config))
-                {
+                if let Err(e) = self.interrupt_source_group.update(
+                    idx as InterruptIndex,
+                    InterruptSourceConfig::MsiIrq(config),
+                    self.cap.vector_masked(idx),
+                ) {
                    error!("Failed updating vector: {:?}", e);
                }
-
-                if self.cap.vector_masked(idx) {
-                    if let Err(e) = self.interrupt_source_group.mask(idx as InterruptIndex) {
-                        error!("Failed masking vector: {:?}", e);
-                    }
-                } else if let Err(e) = self.interrupt_source_group.unmask(idx as InterruptIndex) {
-                    error!("Failed unmasking vector: {:?}", e);
-                }
            }

            if !old_enabled {
--- a/pci/src/msix.rs
+++ b/pci/src/msix.rs
@@ -132,7 +132,11 @@ impl MsixConfig {
                };

                self.interrupt_source_group
-                    .update(idx as InterruptIndex, InterruptSourceConfig::MsiIrq(config))
+                    .update(
+                        idx as InterruptIndex,
+                        InterruptSourceConfig::MsiIrq(config),
+                        self.masked,
+                    )
                    .map_err(Error::UpdateInterruptRoute)?;

                self.interrupt_source_group
@@ -162,6 +166,7 @@ impl MsixConfig {
        // Update interrupt routing
        if old_masked != self.masked || old_enabled != self.enabled {
            if self.enabled && !self.masked {
+                debug!("MSI-X enabled for device 0x{:x}", self.devid);
                for (idx, table_entry) in self.table_entries.iter().enumerate() {
                    let config = MsiIrqSourceConfig {
                        high_addr: table_entry.msg_addr_hi,
@@ -170,23 +175,16 @@ impl MsixConfig {
                        devid: self.devid,
                    };

-                    if let Err(e) = self
-                        .interrupt_source_group
-                        .update(idx as InterruptIndex, InterruptSourceConfig::MsiIrq(config))
-                    {
+                    if let Err(e) = self.interrupt_source_group.update(
+                        idx as InterruptIndex,
+                        InterruptSourceConfig::MsiIrq(config),
+                        table_entry.masked(),
+                    ) {
                        error!("Failed updating vector: {:?}", e);
                    }
-
-                    if table_entry.masked() {
-                        if let Err(e) = self.interrupt_source_group.mask(idx as InterruptIndex) {
-                            error!("Failed masking vector: {:?}", e);
-                        }
-                    } else if let Err(e) = self.interrupt_source_group.unmask(idx as InterruptIndex)
-                    {
-                        error!("Failed unmasking vector: {:?}", e);
-                    }
                }
            } else if old_enabled || !old_masked {
+                debug!("MSI-X disabled for device 0x{:x}", self.devid);
                if let Err(e) = self.interrupt_source_group.disable() {
                    error!("Failed disabling irq_fd: {:?}", e);
                }
@@ -312,17 +310,10 @@ impl MsixConfig {
            if let Err(e) = self.interrupt_source_group.update(
                index as InterruptIndex,
                InterruptSourceConfig::MsiIrq(config),
+                table_entry.masked(),
            ) {
                error!("Failed updating vector: {:?}", e);
            }
-
-            if table_entry.masked() {
-                if let Err(e) = self.interrupt_source_group.mask(index as InterruptIndex) {
-                    error!("Failed masking vector: {:?}", e);
-                }
-            } else if let Err(e) = self.interrupt_source_group.unmask(index as InterruptIndex) {
-                error!("Failed unmasking vector: {:?}", e);
-            }
        }

        // After the MSI-X table entry has been updated, it is necessary to
--- a/pci/src/vfio_user.rs
+++ b/pci/src/vfio_user.rs
@@ -506,6 +506,10 @@ impl Drop for VfioUserPciDevice {
        if self.common.interrupt.intx_in_use() {
            self.common.disable_intx(&self.vfio_wrapper);
        }
+
+        if let Err(e) = self.client.lock().unwrap().shutdown() {
+            error!("Failed shutting down vfio-user client: {}", e);
+        }
    }
 }

--- a/performance-metrics/Cargo.toml
+++ b/performance-metrics/Cargo.toml
@@ -0,0 +1,19 @@
+[package]
+name = "performance-metrics"
+version = "0.1.0"
+authors = ["The Cloud Hypervisor Authors"]
+edition = "2021"
+build = "build.rs"
+
+[dependencies]
+clap = { version = "3.1.8", features = ["wrap_help","cargo"] }
+dirs = "4.0.0"
+serde = { version = "1.0.136", features = ["rc"] }
+serde_derive = "1.0.136"
+serde_json = "1.0.78"
+test_infra = { path = "../test_infra" }
+thiserror = "1.0.30"
+wait-timeout = "0.2.0"
+
+[build-dependencies]
+clap = { version = "3.1.8", features = ["cargo"] }
--- a/performance-metrics/build.rs
+++ b/performance-metrics/build.rs
@@ -0,0 +1,26 @@
+// Copyright © 2020 Intel Corporation
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+
+#[macro_use(crate_version)]
+extern crate clap;
+
+use std::process::Command;
+
+fn main() {
+    let mut git_human_readable = "v".to_owned() + crate_version!();
+    if let Ok(git_out) = Command::new("git").args(&["describe", "--dirty"]).output() {
+        if git_out.status.success() {
+            if let Ok(git_out_str) = String::from_utf8(git_out.stdout) {
+                git_human_readable = git_out_str;
+            }
+        }
+    }
+
+    // This println!() has a special behavior, as it will set the environment
+    // variable GIT_HUMAN_READABLE, so that it can be reused from the binary.
+    // Particularly, this is used from the main.rs to display the exact
+    // version information.
+    println!("cargo:rustc-env=GIT_HUMAN_READABLE={}", git_human_readable);
+}
--- a/performance-metrics/src/main.rs
+++ b/performance-metrics/src/main.rs
@@ -0,0 +1,517 @@
+// Copyright © 2022 Intel Corporation
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+
+// Custom harness to run performance tests
+extern crate test_infra;
+#[macro_use(crate_authors)]
+extern crate clap;
+
+mod performance_tests;
+
+use clap::{Arg, Command as ClapCommand};
+use performance_tests::*;
+use serde_derive::{Deserialize, Serialize};
+use std::{env, fmt, process::Command, sync::mpsc::channel, thread, time::Duration};
+use thiserror::Error;
+
+#[derive(Error, Debug)]
+enum Error {
+    #[error("Error: test timed-out")]
+    TestTimeout,
+    #[error("Error: test failed")]
+    TestFailed,
+}
+
+#[derive(Deserialize, Serialize)]
+pub struct PerformanceTestResult {
+    name: String,
+    mean: f64,
+    std_dev: f64,
+    max: f64,
+    min: f64,
+}
+
+#[derive(Deserialize, Serialize)]
+pub struct MetricsReport {
+    pub git_human_readable: String,
+    pub git_revision: String,
+    pub git_commit_date: String,
+    pub date: String,
+    pub results: Vec<PerformanceTestResult>,
+}
+
+impl Default for MetricsReport {
+    fn default() -> Self {
+        let mut git_human_readable = "".to_string();
+        if let Ok(git_out) = Command::new("git").args(&["describe", "--dirty"]).output() {
+            if git_out.status.success() {
+                if let Ok(git_out_str) = String::from_utf8(git_out.stdout) {
+                    git_human_readable = git_out_str.trim().to_string();
+                }
+            }
+        }
+
+        let mut git_revision = "".to_string();
+        if let Ok(git_out) = Command::new("git").args(&["rev-parse", "HEAD"]).output() {
+            if git_out.status.success() {
+                if let Ok(git_out_str) = String::from_utf8(git_out.stdout) {
+                    git_revision = git_out_str.trim().to_string();
+                }
+            }
+        }
+
+        let mut git_commit_date = "".to_string();
+        if let Ok(git_out) = Command::new("git")
+            .args(&["show", "-s", "--format=%cd"])
+            .output()
+        {
+            if git_out.status.success() {
+                if let Ok(git_out_str) = String::from_utf8(git_out.stdout) {
+                    git_commit_date = git_out_str.trim().to_string();
+                }
+            }
+        }
+
+        MetricsReport {
+            git_human_readable,
+            git_revision,
+            git_commit_date,
+            date: date(),
+            results: Vec::new(),
+        }
+    }
+}
+
+pub struct PerformanceTestControl {
+    test_timeout: u32,
+    test_iterations: u32,
+    num_queues: Option<u32>,
+    queue_size: Option<u32>,
+    net_rx: Option<bool>,
+    fio_ops: Option<FioOps>,
+}
+
+impl fmt::Display for PerformanceTestControl {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        let mut output = format!(
+            "test_timeout = {}s, test_iterations = {}",
+            self.test_timeout, self.test_iterations
+        );
+        if let Some(o) = self.num_queues {
+            output = format!("{}, num_queues = {}", output, o);
+        }
+        if let Some(o) = self.queue_size {
+            output = format!("{}, queue_size = {}", output, o);
+        }
+        if let Some(o) = self.net_rx {
+            output = format!("{}, net_rx = {}", output, o);
+        }
+        if let Some(o) = &self.fio_ops {
+            output = format!("{}, fio_ops = {}", output, o);
+        }
+
+        write!(f, "{}", output)
+    }
+}
+
+impl PerformanceTestControl {
+    const fn default() -> Self {
+        Self {
+            test_timeout: 10,
+            test_iterations: 5,
+            num_queues: None,
+            queue_size: None,
+            net_rx: None,
+            fio_ops: None,
+        }
+    }
+}
+
+/// A performance test should finish within the a certain time-out and
+/// return a performance metrics number (including the average number and
+/// standard deviation)
+struct PerformanceTest {
+    pub name: &'static str,
+    pub func_ptr: fn(&PerformanceTestControl) -> f64,
+    pub control: PerformanceTestControl,
+    unit_adjuster: fn(f64) -> f64,
+}
+
+impl PerformanceTest {
+    pub fn run(&self) -> PerformanceTestResult {
+        let mut metrics = Vec::new();
+        for _ in 0..self.control.test_iterations {
+            metrics.push((self.func_ptr)(&self.control));
+        }
+
+        let mean = (self.unit_adjuster)(mean(&metrics).unwrap());
+        let std_dev = (self.unit_adjuster)(std_deviation(&metrics).unwrap());
+        let max = (self.unit_adjuster)(metrics.clone().into_iter().reduce(f64::max).unwrap());
+        let min = (self.unit_adjuster)(metrics.clone().into_iter().reduce(f64::min).unwrap());
+
+        PerformanceTestResult {
+            name: self.name.to_string(),
+            mean,
+            std_dev,
+            max,
+            min,
+        }
+    }
+
+    // Calculate the timeout for each test
+    // Note: To cover the setup/cleanup time, 20s is added for each iteration of the test
+    pub fn calc_timeout(&self) -> u64 {
+        ((self.control.test_timeout + 20) * self.control.test_iterations) as u64
+    }
+}
+
+fn mean(data: &[f64]) -> Option<f64> {
+    let count = data.len();
+
+    if count > 0 {
+        Some(data.iter().sum::<f64>() / count as f64)
+    } else {
+        None
+    }
+}
+
+fn std_deviation(data: &[f64]) -> Option<f64> {
+    let count = data.len();
+
+    if count > 0 {
+        let mean = mean(data).unwrap();
+        let variance = data
+            .iter()
+            .map(|value| {
+                let diff = mean - *value;
+                diff * diff
+            })
+            .sum::<f64>()
+            / count as f64;
+
+        Some(variance.sqrt())
+    } else {
+        None
+    }
+}
+
+mod adjuster {
+    pub fn identity(v: f64) -> f64 {
+        v
+    }
+
+    pub fn s_to_ms(v: f64) -> f64 {
+        v * 1000.0
+    }
+
+    pub fn bps_to_gbps(v: f64) -> f64 {
+        v / (1_000_000_000_f64)
+    }
+
+    #[allow(non_snake_case)]
+    pub fn Bps_to_MiBps(v: f64) -> f64 {
+        v / (1 << 20) as f64
+    }
+}
+
+const TEST_LIST: [PerformanceTest; 15] = [
+    PerformanceTest {
+        name: "boot_time_ms",
+        func_ptr: performance_boot_time,
+        control: PerformanceTestControl {
+            test_timeout: 2,
+            test_iterations: 10,
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::s_to_ms,
+    },
+    PerformanceTest {
+        name: "boot_time_pmem_ms",
+        func_ptr: performance_boot_time_pmem,
+        control: PerformanceTestControl {
+            test_timeout: 2,
+            test_iterations: 10,
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::s_to_ms,
+    },
+    PerformanceTest {
+        name: "virtio_net_latency_us",
+        func_ptr: performance_net_latency,
+        control: PerformanceTestControl {
+            num_queues: Some(2),
+            queue_size: Some(256),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::identity,
+    },
+    PerformanceTest {
+        name: "virtio_net_throughput_single_queue_rx_gbps",
+        func_ptr: performance_net_throughput,
+        control: PerformanceTestControl {
+            num_queues: Some(2),
+            queue_size: Some(256),
+            net_rx: Some(true),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::bps_to_gbps,
+    },
+    PerformanceTest {
+        name: "virtio_net_throughput_single_queue_tx_gbps",
+        func_ptr: performance_net_throughput,
+        control: PerformanceTestControl {
+            num_queues: Some(2),
+            queue_size: Some(256),
+            net_rx: Some(false),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::bps_to_gbps,
+    },
+    PerformanceTest {
+        name: "virtio_net_throughput_multi_queue_rx_gbps",
+        func_ptr: performance_net_throughput,
+        control: PerformanceTestControl {
+            num_queues: Some(4),
+            queue_size: Some(256),
+            net_rx: Some(true),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::bps_to_gbps,
+    },
+    PerformanceTest {
+        name: "virtio_net_throughput_multi_queue_tx_gbps",
+        func_ptr: performance_net_throughput,
+        control: PerformanceTestControl {
+            num_queues: Some(4),
+            queue_size: Some(256),
+            net_rx: Some(false),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::bps_to_gbps,
+    },
+    PerformanceTest {
+        name: "block_read_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(1),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::Read),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+    PerformanceTest {
+        name: "block_write_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(1),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::Write),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+    PerformanceTest {
+        name: "block_random_read_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(1),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::RandomRead),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+    PerformanceTest {
+        name: "block_random_write_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(1),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::RandomWrite),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+    PerformanceTest {
+        name: "block_multi_queue_read_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(2),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::Read),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+    PerformanceTest {
+        name: "block_multi_queue_write_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(2),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::Write),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+    PerformanceTest {
+        name: "block_multi_queue_random_read_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(2),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::RandomRead),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+    PerformanceTest {
+        name: "block_multi_queue_random_write_MiBps",
+        func_ptr: performance_block_io,
+        control: PerformanceTestControl {
+            num_queues: Some(2),
+            queue_size: Some(128),
+            fio_ops: Some(FioOps::RandomWrite),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::Bps_to_MiBps,
+    },
+];
+
+fn run_test_with_timeout(test: &'static PerformanceTest) -> Result<PerformanceTestResult, Error> {
+    let (sender, receiver) = channel::<Result<PerformanceTestResult, Error>>();
+    thread::spawn(move || {
+        println!("Test '{}' running .. ({})", test.name, test.control);
+
+        let output = match std::panic::catch_unwind(|| test.run()) {
+            Ok(test_result) => {
+                println!(
+                    "Test '{}' .. ok: mean = {}, std_dev = {}",
+                    test_result.name, test_result.mean, test_result.std_dev
+                );
+                Ok(test_result)
+            }
+            Err(_) => Err(Error::TestFailed),
+        };
+
+        let _ = sender.send(output);
+    });
+
+    // Todo: Need to cleanup/kill all hanging child processes
+    let test_timeout = test.calc_timeout();
+    receiver
+        .recv_timeout(Duration::from_secs(test_timeout))
+        .map_err(|_| {
+            eprintln!(
+                "[Error] Test '{}' time-out after {} seconds",
+                test.name, test_timeout
+            );
+            Error::TestTimeout
+        })?
+}
+
+fn date() -> String {
+    let output = test_infra::exec_host_command_output("date");
+    String::from_utf8_lossy(&output.stdout).trim().to_string()
+}
+
+fn main() {
+    let cmd_arguments = ClapCommand::new("performance-metrics")
+        .version(env!("GIT_HUMAN_READABLE"))
+        .author(crate_authors!())
+        .about("Generate the performance metrics data for Cloud Hypervisor")
+        .arg(
+            Arg::new("test-filter")
+                .long("test-filter")
+                .help("Filter metrics tests to run based on provided keywords")
+                .multiple_occurrences(true)
+                .takes_value(true)
+                .required(false),
+        )
+        .arg(
+            Arg::new("list-tests")
+                .long("list-tests")
+                .help("Print the list of availale metrics tests")
+                .multiple_occurrences(true)
+                .takes_value(false)
+                .required(false),
+        )
+        .arg(
+            Arg::new("report-file")
+                .long("report-file")
+                .help("Report file. Standard error is used if not specified")
+                .takes_value(true),
+        )
+        .get_matches();
+
+    // It seems that the tool (ethr) used for testing the virtio-net latency
+    // is not stable on AArch64, and therefore the latency test is currently
+    // skipped on AArch64.
+    let test_list: Vec<&PerformanceTest> = TEST_LIST
+        .iter()
+        .filter(|t| !(cfg!(target_arch = "aarch64") && t.name == "virtio_net_latency_us"))
+        .collect();
+
+    if cmd_arguments.is_present("list-tests") {
+        for test in test_list.iter() {
+            println!("\"{}\" ({})", test.name, test.control);
+        }
+
+        return;
+    }
+
+    let test_filter = match cmd_arguments.values_of("test-filter") {
+        Some(s) => s.collect(),
+        None => Vec::new(),
+    };
+
+    // Run performance tests sequentially and report results (in both readable/json format)
+    let mut metrics_report: MetricsReport = Default::default();
+
+    init_tests();
+
+    for test in test_list.iter() {
+        if test_filter.is_empty() || test_filter.iter().any(|&s| test.name.contains(s)) {
+            match run_test_with_timeout(test) {
+                Ok(r) => {
+                    metrics_report.results.push(r);
+                }
+                Err(e) => {
+                    eprintln!("Aborting test due to error: '{:?}'", e);
+                    std::process::exit(1);
+                }
+            };
+        }
+    }
+
+    cleanup_tests();
+
+    let mut report_file: Box<dyn std::io::Write + Send> =
+        if let Some(file) = cmd_arguments.value_of("report-file") {
+            Box::new(
+                std::fs::File::create(std::path::Path::new(file))
+                    .map_err(|e| {
+                        eprintln!("Error opening report file: {}: {}", file, e);
+                        std::process::exit(1);
+                    })
+                    .unwrap(),
+            )
+        } else {
+            Box::new(std::io::stdout())
+        };
+
+    report_file
+        .write_all(
+            serde_json::to_string_pretty(&metrics_report)
+                .unwrap()
+                .as_bytes(),
+        )
+        .map_err(|e| {
+            eprintln!("Error writing report file: {}", e);
+            std::process::exit(1);
+        })
+        .unwrap();
+}
--- a/performance-metrics/src/performance_tests.rs
+++ b/performance-metrics/src/performance_tests.rs
@@ -0,0 +1,830 @@
+// Copyright © 2022 Intel Corporation
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+
+// Performance tests
+
+use crate::{mean, PerformanceTestControl};
+use serde_json::Value;
+use std::path::{Path, PathBuf};
+use std::process::{Child, Command, Stdio};
+use std::string::String;
+use std::thread;
+use std::time::Duration;
+use std::{fmt, fs};
+use test_infra::Error as InfraError;
+use test_infra::*;
+use wait_timeout::ChildExt;
+
+#[cfg(target_arch = "x86_64")]
+pub const FOCAL_IMAGE_NAME: &str = "focal-server-cloudimg-amd64-custom-20210609-0.raw";
+#[cfg(target_arch = "aarch64")]
+pub const FOCAL_IMAGE_NAME: &str = "focal-server-cloudimg-arm64-custom-20210929-0-update-tool.raw";
+
+#[derive(Debug)]
+enum WaitTimeoutError {
+    Timedout,
+    ExitStatus,
+    General(std::io::Error),
+}
+
+#[derive(Debug)]
+enum Error {
+    BootTimeParse,
+    EthrLogFile(std::io::Error),
+    EthrLogParse,
+    FioOutputParse,
+    Iperf3Parse,
+    Infra(InfraError),
+    Spawn(std::io::Error),
+    Scp(SshCommandError),
+    WaitTimeout(WaitTimeoutError),
+}
+
+impl From<InfraError> for Error {
+    fn from(e: InfraError) -> Self {
+        Self::Infra(e)
+    }
+}
+
+const BLK_IO_TEST_IMG: &str = "/var/tmp/ch-blk-io-test.img";
+
+pub fn init_tests() {
+    // The test image can not be created on tmpfs (e.g. /tmp) filesystem,
+    // as tmpfs does not support O_DIRECT
+    assert!(exec_host_command_output(&format!(
+        "dd if=/dev/zero of={} bs=1M count=4096",
+        BLK_IO_TEST_IMG
+    ))
+    .status
+    .success());
+}
+
+pub fn cleanup_tests() {
+    fs::remove_file(BLK_IO_TEST_IMG)
+        .unwrap_or_else(|_| panic!("Failed to remove file '{}'.", BLK_IO_TEST_IMG));
+}
+
+// Performance tests are expected to be executed sequentially, so we can
+// start VM guests with the same IP while putting them on a different
+// private network. The default constructor "Guest::new()" does not work
+// well, as we can easily create more than 256 VMs from repeating various
+// performance tests dozens times in a single run.
+fn performance_test_new_guest(disk_config: Box<dyn DiskConfig>) -> Guest {
+    Guest::new_from_ip_range(disk_config, "172.19", 0)
+}
+
+const DIRECT_KERNEL_BOOT_CMDLINE: &str =
+    "root=/dev/vda1 console=hvc0 rw systemd.journald.forward_to_console=1";
+
+// Creates the path for direct kernel boot and return the path.
+// For x86_64, this function returns the vmlinux kernel path.
+// For AArch64, this function returns the PE kernel path.
+fn direct_kernel_boot_path() -> PathBuf {
+    let mut workload_path = dirs::home_dir().unwrap();
+    workload_path.push("workloads");
+
+    let mut kernel_path = workload_path;
+    #[cfg(target_arch = "x86_64")]
+    kernel_path.push("vmlinux");
+    #[cfg(target_arch = "aarch64")]
+    kernel_path.push("Image");
+
+    kernel_path
+}
+
+// Wait the child process for a given timeout
+fn child_wait_timeout(child: &mut Child, timeout: u64) -> Result<(), WaitTimeoutError> {
+    match child.wait_timeout(Duration::from_secs(timeout)) {
+        Err(e) => {
+            return Err(WaitTimeoutError::General(e));
+        }
+        Ok(s) => match s {
+            None => {
+                return Err(WaitTimeoutError::Timedout);
+            }
+            Some(s) => {
+                if !s.success() {
+                    return Err(WaitTimeoutError::ExitStatus);
+                }
+            }
+        },
+    }
+
+    Ok(())
+}
+
+fn parse_iperf3_output(output: &[u8], sender: bool) -> Result<f64, Error> {
+    std::panic::catch_unwind(|| {
+        let s = String::from_utf8_lossy(output);
+        let v: Value = serde_json::from_str(&s).expect("'iperf3' parse error: invalid json output");
+
+        let bps: f64 = if sender {
+            v["end"]["sum_sent"]["bits_per_second"]
+                .as_f64()
+                .expect("'iperf3' parse error: missing entry 'end.sum_sent.bits_per_second'")
+        } else {
+            v["end"]["sum_received"]["bits_per_second"]
+                .as_f64()
+                .expect("'iperf3' parse error: missing entry 'end.sum_received.bits_per_second'")
+        };
+
+        bps
+    })
+    .map_err(|_| {
+        eprintln!(
+            "=============== iperf3 output ===============\n\n{}\n\n===========end============\n\n",
+            String::from_utf8_lossy(output)
+        );
+        Error::Iperf3Parse
+    })
+}
+
+fn measure_virtio_net_throughput(
+    test_timeout: u32,
+    queue_pairs: u32,
+    guest: &Guest,
+    receive: bool,
+) -> Result<f64, Error> {
+    let default_port = 5201;
+
+    // 1. start the iperf3 server on the guest
+    for n in 0..queue_pairs {
+        guest
+            .ssh_command(&format!("iperf3 -s -p {} -D", default_port + n))
+            .map_err(InfraError::SshCommand)?;
+    }
+
+    thread::sleep(Duration::new(1, 0));
+
+    // 2. start the iperf3 client on host to measure RX through-put
+    let mut clients = Vec::new();
+    for n in 0..queue_pairs {
+        let mut cmd = Command::new("iperf3");
+        cmd.args(&[
+            "-J", // Output in JSON format
+            "-c",
+            &guest.network.guest_ip,
+            "-p",
+            &format!("{}", default_port + n),
+            "-t",
+            &format!("{}", test_timeout),
+        ]);
+        // For measuring the guest transmit throughput (as a sender),
+        // use reverse mode of the iperf3 client on the host
+        if !receive {
+            cmd.args(&["-R"]);
+        }
+        let client = cmd
+            .stderr(Stdio::piped())
+            .stdout(Stdio::piped())
+            .spawn()
+            .map_err(Error::Spawn)?;
+
+        clients.push(client);
+    }
+
+    let mut err: Option<Error> = None;
+    let mut bps = Vec::new();
+    let mut failed = false;
+    for c in clients {
+        let mut c = c;
+        if let Err(e) = child_wait_timeout(&mut c, test_timeout as u64 + 5) {
+            err = Some(Error::WaitTimeout(e));
+            failed = true;
+        }
+
+        if !failed {
+            // Safe to unwrap as we know the child has terminated succesffully
+            let output = c.wait_with_output().unwrap();
+            bps.push(parse_iperf3_output(&output.stdout, receive)?);
+        } else {
+            let _ = c.kill();
+            let output = c.wait_with_output().unwrap();
+            println!(
+                "=============== Client output [Error] ===============\n\n{}\n\n===========end============\n\n",
+                String::from_utf8_lossy(&output.stdout)
+            );
+        }
+    }
+
+    if let Some(e) = err {
+        Err(e)
+    } else {
+        Ok(bps.iter().sum())
+    }
+}
+
+pub fn performance_net_throughput(control: &PerformanceTestControl) -> f64 {
+    let test_timeout = control.test_timeout;
+    let rx = control.net_rx.unwrap();
+
+    let focal = UbuntuDiskConfig::new(FOCAL_IMAGE_NAME.to_string());
+    let guest = performance_test_new_guest(Box::new(focal));
+
+    let num_queues = control.num_queues.unwrap();
+    let queue_size = control.queue_size.unwrap();
+    let net_params = format!(
+        "tap=,mac={},ip={},mask=255.255.255.0,num_queues={},queue_size={}",
+        guest.network.guest_mac, guest.network.host_ip, num_queues, queue_size,
+    );
+
+    let mut child = GuestCommand::new(&guest)
+        .args(&["--cpus", &format!("boot={}", num_queues)])
+        .args(&["--memory", "size=4G"])
+        .args(&["--kernel", direct_kernel_boot_path().to_str().unwrap()])
+        .args(&["--cmdline", DIRECT_KERNEL_BOOT_CMDLINE])
+        .default_disks()
+        .args(&["--net", net_params.as_str()])
+        .capture_output()
+        .set_print_cmd(false)
+        .spawn()
+        .unwrap();
+
+    let r = std::panic::catch_unwind(|| {
+        guest.wait_vm_boot(None).unwrap();
+        measure_virtio_net_throughput(test_timeout, num_queues / 2, &guest, rx).unwrap()
+    });
+
+    let _ = child.kill();
+    let output = child.wait_with_output().unwrap();
+
+    match r {
+        Ok(r) => r,
+        Err(e) => {
+            handle_child_output(Err(e), &output);
+            panic!("test failed!");
+        }
+    }
+}
+
+fn parse_ethr_latency_output(output: &[u8]) -> Result<Vec<f64>, Error> {
+    std::panic::catch_unwind(|| {
+        let s = String::from_utf8_lossy(output);
+        let mut latency = Vec::new();
+        for l in s.lines() {
+            let v: Value = serde_json::from_str(l).expect("'ethr' parse error: invalid json line");
+            // Skip header/summary lines
+            if let Some(avg) = v["Avg"].as_str() {
+                // Assume the latency unit is always "us"
+                latency.push(
+                    avg.split("us").collect::<Vec<&str>>()[0]
+                        .parse::<f64>()
+                        .expect("'ethr' parse error: invalid 'Avg' entry"),
+                );
+            }
+        }
+
+        assert!(
+            !latency.is_empty(),
+            "'ethr' parse error: no valid latency data found"
+        );
+
+        latency
+    })
+    .map_err(|_| {
+        eprintln!(
+            "=============== ethr output ===============\n\n{}\n\n===========end============\n\n",
+            String::from_utf8_lossy(output)
+        );
+        Error::EthrLogParse
+    })
+}
+
+fn measure_virtio_net_latency(guest: &Guest, test_timeout: u32) -> Result<Vec<f64>, Error> {
+    // copy the 'ethr' tool to the guest image
+    let ethr_path = "/usr/local/bin/ethr";
+    let ethr_remote_path = "/tmp/ethr";
+    scp_to_guest(
+        Path::new(ethr_path),
+        Path::new(ethr_remote_path),
+        &guest.network.guest_ip,
+        //DEFAULT_SSH_RETRIES,
+        1,
+        DEFAULT_SSH_TIMEOUT,
+    )
+    .map_err(Error::Scp)?;
+
+    // Start the ethr server on the guest
+    guest
+        .ssh_command(&format!("{} -s &> /dev/null &", ethr_remote_path))
+        .map_err(InfraError::SshCommand)?;
+
+    thread::sleep(Duration::new(1, 0));
+
+    // Start the ethr client on the host
+    let log_file = guest
+        .tmp_dir
+        .as_path()
+        .join("ethr.client.log")
+        .to_str()
+        .unwrap()
+        .to_string();
+    let mut c = Command::new(ethr_path)
+        .args(&[
+            "-c",
+            &guest.network.guest_ip,
+            "-t",
+            "l",
+            "-o",
+            &log_file, // file output is JSON format
+            "-d",
+            &format!("{}s", test_timeout),
+        ])
+        .stderr(Stdio::piped())
+        .stdout(Stdio::piped())
+        .spawn()
+        .map_err(Error::Spawn)?;
+
+    if let Err(e) = child_wait_timeout(&mut c, test_timeout as u64 + 5).map_err(Error::WaitTimeout)
+    {
+        let _ = c.kill();
+        return Err(e);
+    }
+
+    // Parse the ethr latency test output
+    let content = fs::read(log_file).map_err(Error::EthrLogFile)?;
+    parse_ethr_latency_output(&content)
+}
+
+pub fn performance_net_latency(control: &PerformanceTestControl) -> f64 {
+    let focal = UbuntuDiskConfig::new(FOCAL_IMAGE_NAME.to_string());
+    let guest = performance_test_new_guest(Box::new(focal));
+
+    let num_queues = control.num_queues.unwrap();
+    let queue_size = control.queue_size.unwrap();
+    let net_params = format!(
+        "tap=,mac={},ip={},mask=255.255.255.0,num_queues={},queue_size={}",
+        guest.network.guest_mac, guest.network.host_ip, num_queues, queue_size,
+    );
+
+    let mut child = GuestCommand::new(&guest)
+        .args(&["--cpus", &format!("boot={}", num_queues)])
+        .args(&["--memory", "size=4G"])
+        .args(&["--kernel", direct_kernel_boot_path().to_str().unwrap()])
+        .args(&["--cmdline", DIRECT_KERNEL_BOOT_CMDLINE])
+        .default_disks()
+        .args(&["--net", net_params.as_str()])
+        .capture_output()
+        .set_print_cmd(false)
+        .spawn()
+        .unwrap();
+
+    let r = std::panic::catch_unwind(|| {
+        guest.wait_vm_boot(None).unwrap();
+
+        // 'ethr' tool will measure the latency multiple times with provided test time
+        let latency = measure_virtio_net_latency(&guest, control.test_timeout).unwrap();
+        mean(&latency).unwrap()
+    });
+
+    let _ = child.kill();
+    let output = child.wait_with_output().unwrap();
+
+    match r {
+        Ok(r) => r,
+        Err(e) => {
+            handle_child_output(Err(e), &output);
+            panic!("test failed!");
+        }
+    }
+}
+
+fn parse_boot_time_output(output: &[u8]) -> Result<f64, Error> {
+    std::panic::catch_unwind(|| {
+        let l: Vec<String> = String::from_utf8_lossy(output)
+            .lines()
+            .into_iter()
+            .filter(|l| l.contains("Debug I/O port: Kernel code"))
+            .map(|l| l.to_string())
+            .collect();
+
+        assert_eq!(
+            l.len(),
+            2,
+            "Expecting two matching lines for 'Debug I/O port: Kernel code'"
+        );
+
+        let time_stamp_kernel_start = {
+            let s = l[0].split("--").collect::<Vec<&str>>();
+            assert_eq!(
+                s.len(),
+                2,
+                "Expecting '--' for the matching line of 'Debug I/O port' output"
+            );
+
+            // Sample output: "[Debug I/O port: Kernel code 0x40] 0.096537 seconds"
+            assert!(
+                s[1].contains("0x40"),
+                "Expecting kernel code '0x40' for 'linux_kernel_start' time stamp output"
+            );
+            let t = s[1].split_whitespace().collect::<Vec<&str>>();
+            assert_eq!(
+                t.len(),
+                8,
+                "Expecting exact '8' words from the 'Debug I/O port' output"
+            );
+            assert!(
+                t[7].eq("seconds"),
+                "Expecting 'seconds' as the the last word of the 'Debug I/O port' output"
+            );
+
+            t[6].parse::<f64>().unwrap()
+        };
+
+        let time_stamp_user_start = {
+            let s = l[1].split("--").collect::<Vec<&str>>();
+            assert_eq!(
+                s.len(),
+                2,
+                "Expecting '--' for the matching line of 'Debug I/O port' output"
+            );
+
+            // Sample output: "Debug I/O port: Kernel code 0x41] 0.198980 seconds"
+            assert!(
+                s[1].contains("0x41"),
+                "Expecting kernel code '0x41' for 'linux_kernel_start' time stamp output"
+            );
+            let t = s[1].split_whitespace().collect::<Vec<&str>>();
+            assert_eq!(
+                t.len(),
+                8,
+                "Expecting exact '8' words from the 'Debug I/O port' output"
+            );
+            assert!(
+                t[7].eq("seconds"),
+                "Expecting 'seconds' as the the last word of the 'Debug I/O port' output"
+            );
+
+            t[6].parse::<f64>().unwrap()
+        };
+
+        time_stamp_user_start - time_stamp_kernel_start
+    })
+    .map_err(|_| {
+        eprintln!(
+            "=============== boot-time output ===============\n\n{}\n\n===========end============\n\n",
+            String::from_utf8_lossy(output)
+        );
+        Error::BootTimeParse
+    })
+}
+
+fn measure_boot_time(cmd: &mut GuestCommand, test_timeout: u32) -> Result<f64, Error> {
+    let mut child = cmd.capture_output().set_print_cmd(false).spawn().unwrap();
+
+    thread::sleep(Duration::new(test_timeout as u64, 0));
+    let _ = child.kill();
+    let output = child.wait_with_output().unwrap();
+
+    parse_boot_time_output(&output.stderr).map_err(|e| {
+        eprintln!(
+            "\n\n==== Start child stdout ====\n\n{}\n\n==== End child stdout ====",
+            String::from_utf8_lossy(&output.stdout)
+        );
+        eprintln!(
+            "\n\n==== Start child stderr ====\n\n{}\n\n==== End child stderr ====",
+            String::from_utf8_lossy(&output.stderr)
+        );
+
+        e
+    })
+}
+
+pub fn performance_boot_time(control: &PerformanceTestControl) -> f64 {
+    let r = std::panic::catch_unwind(|| {
+        let focal = UbuntuDiskConfig::new(FOCAL_IMAGE_NAME.to_string());
+        let guest = performance_test_new_guest(Box::new(focal));
+        let mut cmd = GuestCommand::new(&guest);
+
+        let c = cmd
+            .args(&["--memory", "size=1G"])
+            .args(&["--kernel", direct_kernel_boot_path().to_str().unwrap()])
+            .args(&["--cmdline", DIRECT_KERNEL_BOOT_CMDLINE])
+            .args(&["--console", "off"])
+            .default_disks();
+
+        measure_boot_time(c, control.test_timeout).unwrap()
+    });
+
+    match r {
+        Ok(r) => r,
+        Err(_) => {
+            panic!("test failed!");
+        }
+    }
+}
+
+pub fn performance_boot_time_pmem(control: &PerformanceTestControl) -> f64 {
+    let r = std::panic::catch_unwind(|| {
+        let focal = UbuntuDiskConfig::new(FOCAL_IMAGE_NAME.to_string());
+        let guest = performance_test_new_guest(Box::new(focal));
+        let mut cmd = GuestCommand::new(&guest);
+        let c = cmd
+            .args(&["--memory", "size=1G,hugepages=on"])
+            .args(&["--kernel", direct_kernel_boot_path().to_str().unwrap()])
+            .args(&["--cmdline", "root=/dev/pmem0p1 console=ttyS0 quiet rw"])
+            .args(&["--console", "off"])
+            .args(&[
+                "--pmem",
+                format!(
+                    "file={}",
+                    guest.disk_config.disk(DiskType::OperatingSystem).unwrap()
+                )
+                .as_str(),
+            ]);
+
+        measure_boot_time(c, control.test_timeout).unwrap()
+    });
+
+    match r {
+        Ok(r) => r,
+        Err(_) => {
+            panic!("test failed!");
+        }
+    }
+}
+
+pub enum FioOps {
+    Read,
+    RandomRead,
+    Write,
+    RandomWrite,
+}
+
+impl fmt::Display for FioOps {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        match self {
+            FioOps::Read => write!(f, "read"),
+            FioOps::RandomRead => write!(f, "randread"),
+            FioOps::Write => write!(f, "write"),
+            FioOps::RandomWrite => write!(f, "randwrite"),
+        }
+    }
+}
+
+fn parse_fio_output(output: &str, fio_ops: &FioOps, num_jobs: u32) -> Result<f64, Error> {
+    std::panic::catch_unwind(|| {
+        let v: Value =
+            serde_json::from_str(output).expect("'fio' parse error: invalid json output");
+        let jobs = v["jobs"]
+            .as_array()
+            .expect("'fio' parse error: missing entry 'jobs'");
+        assert_eq!(
+            jobs.len(),
+            num_jobs as usize,
+            "'fio' parse error: Unexpected number of 'fio' jobs."
+        );
+
+        let read = match fio_ops {
+            FioOps::Read | FioOps::RandomRead => true,
+            FioOps::Write | FioOps::RandomWrite => false,
+        };
+
+        let mut total_bps = 0_f64;
+        for j in jobs {
+            if read {
+                let bytes = j["read"]["io_bytes"]
+                    .as_u64()
+                    .expect("'fio' parse error: missing entry 'read.io_bytes'");
+                let runtime = j["read"]["runtime"]
+                    .as_u64()
+                    .expect("'fio' parse error: missing entry 'read.runtime'")
+                    as f64
+                    / 1000_f64;
+                total_bps += bytes as f64 / runtime as f64;
+            } else {
+                let bytes = j["write"]["io_bytes"]
+                    .as_u64()
+                    .expect("'fio' parse error: missing entry 'write.io_bytes'");
+                let runtime = j["write"]["runtime"]
+                    .as_u64()
+                    .expect("'fio' parse error: missing entry 'write.runtime'")
+                    as f64
+                    / 1000_f64;
+                total_bps += bytes as f64 / runtime as f64;
+            }
+        }
+
+        total_bps
+    })
+    .map_err(|_| {
+        eprintln!(
+            "=============== Fio output ===============\n\n{}\n\n===========end============\n\n",
+            output
+        );
+        Error::FioOutputParse
+    })
+}
+
+pub fn performance_block_io(control: &PerformanceTestControl) -> f64 {
+    let test_timeout = control.test_timeout;
+    let num_queues = control.num_queues.unwrap();
+    let fio_ops = control.fio_ops.as_ref().unwrap();
+
+    let focal = UbuntuDiskConfig::new(FOCAL_IMAGE_NAME.to_string());
+    let guest = performance_test_new_guest(Box::new(focal));
+    let api_socket = guest
+        .tmp_dir
+        .as_path()
+        .join("cloud-hypervisor.sock")
+        .to_str()
+        .unwrap()
+        .to_string();
+
+    let mut child = GuestCommand::new(&guest)
+        .args(&["--cpus", &format!("boot={}", num_queues)])
+        .args(&["--memory", "size=4G"])
+        .args(&["--kernel", direct_kernel_boot_path().to_str().unwrap()])
+        .args(&["--cmdline", DIRECT_KERNEL_BOOT_CMDLINE])
+        .args(&[
+            "--disk",
+            format!(
+                "path={}",
+                guest.disk_config.disk(DiskType::OperatingSystem).unwrap()
+            )
+            .as_str(),
+            format!(
+                "path={}",
+                guest.disk_config.disk(DiskType::CloudInit).unwrap()
+            )
+            .as_str(),
+            format!("path={}", BLK_IO_TEST_IMG).as_str(),
+        ])
+        .default_net()
+        .args(&["--api-socket", &api_socket])
+        .capture_output()
+        .set_print_cmd(false)
+        .spawn()
+        .unwrap();
+
+    let r = std::panic::catch_unwind(|| {
+        guest.wait_vm_boot(None).unwrap();
+
+        let fio_command = format!(
+            "sudo fio --filename=/dev/vdc --name=test --output-format=json \
+            --direct=1 --bs=4k --ioengine=io_uring --iodepth=64 \
+            --rw={} --runtime={} --numjobs={}",
+            fio_ops, test_timeout, num_queues
+        );
+        let output = guest
+            .ssh_command(&fio_command)
+            .map_err(InfraError::SshCommand)
+            .unwrap();
+
+        // Parse fio output
+        parse_fio_output(&output, fio_ops, num_queues).unwrap()
+    });
+
+    let _ = child.kill();
+    let output = child.wait_with_output().unwrap();
+
+    match r {
+        Ok(r) => r,
+        Err(e) => {
+            handle_child_output(Err(e), &output);
+            panic!("test failed!");
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_parse_iperf3_output() {
+        let output = r#"
+{
+	"end":	{
+		"sum_sent":	{
+			"start":	0,
+			"end":	5.000196,
+			"seconds":	5.000196,
+			"bytes":	14973836248,
+			"bits_per_second":	23957198874.604115,
+			"retransmits":	0,
+			"sender":	false
+		}
+	}
+}
+       "#;
+        assert_eq!(
+            parse_iperf3_output(output.as_bytes(), true).unwrap(),
+            23957198874.604115
+        );
+
+        let output = r#"
+{
+	"end":	{
+		"sum_received":	{
+			"start":	0,
+			"end":	5.000626,
+			"seconds":	5.000626,
+			"bytes":	24703557800,
+			"bits_per_second":	39520744482.79,
+			"sender":	true
+		}
+	}
+}
+              "#;
+        assert_eq!(
+            parse_iperf3_output(output.as_bytes(), false).unwrap(),
+            39520744482.79
+        );
+    }
+
+    #[test]
+    fn test_parse_ethr_latency_output() {
+        let output = r#"{"Time":"2022-02-08T03:52:50Z","Title":"","Type":"INFO","Message":"Using destination: 192.168.249.2, ip: 192.168.249.2, port: 8888"}
+{"Time":"2022-02-08T03:52:51Z","Title":"","Type":"INFO","Message":"Running latency test: 1000, 1"}
+{"Time":"2022-02-08T03:52:51Z","Title":"","Type":"LatencyResult","RemoteAddr":"192.168.249.2","Protocol":"TCP","Avg":"80.712us","Min":"61.677us","P50":"257.014us","P90":"74.418us","P95":"107.283us","P99":"119.309us","P999":"142.100us","P9999":"216.341us","Max":"216.341us"}
+{"Time":"2022-02-08T03:52:52Z","Title":"","Type":"LatencyResult","RemoteAddr":"192.168.249.2","Protocol":"TCP","Avg":"79.826us","Min":"55.129us","P50":"598.996us","P90":"73.849us","P95":"106.552us","P99":"122.152us","P999":"142.459us","P9999":"474.280us","Max":"474.280us"}
+{"Time":"2022-02-08T03:52:53Z","Title":"","Type":"LatencyResult","RemoteAddr":"192.168.249.2","Protocol":"TCP","Avg":"78.239us","Min":"56.999us","P50":"396.820us","P90":"69.469us","P95":"115.421us","P99":"119.404us","P999":"130.158us","P9999":"258.686us","Max":"258.686us"}"#;
+
+        let ret = parse_ethr_latency_output(output.as_bytes()).unwrap();
+        let reference = vec![80.712_f64, 79.826_f64, 78.239_f64];
+        assert_eq!(ret, reference);
+    }
+
+    #[test]
+    fn test_parse_boot_time_output() {
+        let output = r#"
+cloud-hypervisor: 161.167103ms: <vcpu0> INFO:vmm/src/vm.rs:392 -- [Debug I/O port: Kernel code 0x40] 0.132 seconds
+cloud-hypervisor: 613.57361ms: <vcpu0> INFO:vmm/src/vm.rs:392 -- [Debug I/O port: Kernel code 0x41] 0.5845 seconds
+        "#;
+
+        assert_eq!(parse_boot_time_output(output.as_bytes()).unwrap(), 0.4525);
+    }
+
+    #[test]
+    fn test_parse_fio_output() {
+        let output = r#"
+{
+  "jobs" : [
+    {
+      "read" : {
+        "io_bytes" : 1965273088,
+        "io_kbytes" : 1919212,
+        "bw_bytes" : 392976022,
+        "bw" : 383765,
+        "iops" : 95941.411718,
+        "runtime" : 5001,
+        "total_ios" : 479803,
+        "short_ios" : 0,
+        "drop_ios" : 0
+      }
+    }
+  ]
+}
+"#;
+
+        let bps = 1965273088_f64 / (5001_f64 / 1000_f64);
+        assert_eq!(
+            parse_fio_output(output, &FioOps::RandomRead, 1).unwrap(),
+            bps
+        );
+        assert_eq!(parse_fio_output(output, &FioOps::Read, 1).unwrap(), bps);
+
+        let output = r#"
+{
+  "jobs" : [
+    {
+      "write" : {
+        "io_bytes" : 1172783104,
+        "io_kbytes" : 1145296,
+        "bw_bytes" : 234462835,
+        "bw" : 228967,
+        "iops" : 57241.903239,
+        "runtime" : 5002,
+        "total_ios" : 286324,
+        "short_ios" : 0,
+        "drop_ios" : 0
+      }
+    },
+    {
+      "write" : {
+        "io_bytes" : 1172234240,
+        "io_kbytes" : 1144760,
+        "bw_bytes" : 234353106,
+        "bw" : 228860,
+        "iops" : 57215.113954,
+        "runtime" : 5002,
+        "total_ios" : 286190,
+        "short_ios" : 0,
+        "drop_ios" : 0
+      }
+    }
+  ]
+}
+"#;
+
+        let bps = 1172783104_f64 / (5002_f64 / 1000_f64) + 1172234240_f64 / (5002_f64 / 1000_f64);
+        assert_eq!(
+            parse_fio_output(output, &FioOps::RandomWrite, 2).unwrap(),
+            bps
+        );
+        assert_eq!(parse_fio_output(output, &FioOps::Write, 2).unwrap(), bps);
+    }
+}
--- a/qcow/Cargo.toml
+++ b/qcow/Cargo.toml
@@ -2,7 +2,7 @@
 name = "qcow"
 version = "0.1.0"
 authors = ["The Chromium OS Authors"]
-edition = "2018"
+edition = "2021"
 license = "BSD-3-Clause"

 [lib]
@@ -10,7 +10,7 @@ path = "src/qcow.rs"

 [dependencies]
 byteorder = "1.4.3"
-libc = "0.2.112"
-log = "0.4.14"
+libc = "0.2.123"
+log = "0.4.16"
 remain = "0.2.2"
 vmm-sys-util = "0.9.0"
--- a/rate_limiter/Cargo.toml
+++ b/rate_limiter/Cargo.toml
@@ -1,9 +1,9 @@
 [package]
 name = "rate_limiter"
 version = "0.1.0"
-edition = "2018"
+edition = "2021"

 [dependencies]
-libc = "0.2.112"
-log = "0.4.14"
+libc = "0.2.123"
+log = "0.4.16"
 vmm-sys-util = "0.9.0"
--- a/release-notes.md
+++ b/release-notes.md
@@ -1,8 +1,29 @@
+- [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)
+    - [Deprecations](#deprecations)
+    - [Contributors](#contributors)
+- [v22.1](#v221)
+- [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 License](#documentation-under-cc-by-40-license)
+    - [Deprecation of "Classic" `virtiofsd`](#deprecation-of-classic-virtiofsd)
+    - [Notable Bug Fixes](#notable-bug-fixes-1)
+    - [Contributors](#contributors-1)
 - [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)
-    - [Contributors](#contributors)
+    - [Notable Bug fixes](#notable-bug-fixes-2)
+    - [Contributors](#contributors-2)
 - [v20.2](#v202)
 - [v20.1](#v201)
 - [v20.0](#v200)
@@ -11,8 +32,8 @@
    - [Improved VFIO support](#improved-vfio-support)
    - [Safer code](#safer-code)
    - [Extended documentation](#extended-documentation)
-    - [Notable bug fixes](#notable-bug-fixes-1)
-    - [Contributors](#contributors-1)
+    - [Notable bug fixes](#notable-bug-fixes-3)
+    - [Contributors](#contributors-3)
 - [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 +41,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)
-    - [Contributors](#contributors-2)
+    - [Notable bug fixes](#notable-bug-fixes-4)
+    - [Contributors](#contributors-4)
 - [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,31 +52,31 @@
    - [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)
-    - [Contributors](#contributors-3)
+    - [Notable bug fixes](#notable-bug-fixes-5)
+    - [Contributors](#contributors-5)
 - [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)
-    - [Contributors](#contributors-4)
+    - [Notable bug fixes](#notable-bug-fixes-6)
+    - [Contributors](#contributors-6)
 - [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-7)
    - [Removed functionality](#removed-functionality)
-    - [Contributors](#contributors-5)
+    - [Contributors](#contributors-7)
 - [v15.0](#v150)
    - [Version numbering and stability guarantees](#version-numbering-and-stability-guarantees)
    - [Network device rate limiting](#network-device-rate-limiting)
    - [Support for runtime control of `virtio-net` guest offload](#support-for-runtime-control-of-virtio-net-guest-offload)
    - [`--api-socket` supports file descriptor parameter](#--api-socket-supports-file-descriptor-parameter)
    - [Bug fixes](#bug-fixes)
-    - [Deprecations](#deprecations)
-    - [Contributors](#contributors-6)
+    - [Deprecations](#deprecations-1)
+    - [Contributors](#contributors-8)
 - [v0.14.1](#v0141)
 - [v0.14.0](#v0140)
    - [Structured event monitoring](#structured-event-monitoring)
@@ -64,8 +85,8 @@
    - [Updated hotplug documentation](#updated-hotplug-documentation)
    - [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)
+    - [Deprecations](#deprecations-2)
+    - [Contributors](#contributors-9)
 - [v0.13.0](#v0130)
    - [Wider VFIO device support](#wider-vfio-device-support)
    - [Improved huge page support](#improved-huge-page-support)
@@ -73,13 +94,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-10)
 - [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-11)
 - [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 +112,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)
-    - [Contributors](#contributors-10)
+    - [Notable Bug Fixes](#notable-bug-fixes-8)
+    - [Contributors](#contributors-12)
 - [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)
-    - [Contributors](#contributors-11)
+    - [Notable Bug Fixes](#notable-bug-fixes-9)
+    - [Contributors](#contributors-13)
 - [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 +133,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)
-    - [Contributors](#contributors-12)
+    - [Notable Bug Fixes](#notable-bug-fixes-10)
+    - [Contributors](#contributors-14)
 - [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-11)
    - [Command Line and API Changes](#command-line-and-api-changes)
-    - [Contributors](#contributors-13)
+    - [Contributors](#contributors-15)
 - [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 +153,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-16)
 - [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-17)
 - [v0.5.1](#v051)
 - [v0.5.0](#v050)
    - [Virtual Machine Dynamic Resizing](#virtual-machine-dynamic-resizing)
@@ -147,7 +168,7 @@
    - [New Interrupt Management Framework](#new-interrupt-management-framework)
    - [Development Tools](#development-tools)
    - [Kata Containers Integration](#kata-containers-integration)
-    - [Contributors](#contributors-16)
+    - [Contributors](#contributors-18)
 - [v0.4.0](#v040)
    - [Dynamic virtual CPUs addition](#dynamic-virtual-cpus-addition)
    - [Programmatic firmware tables generation](#programmatic-firmware-tables-generation)
@@ -156,7 +177,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-19)
 - [v0.3.0](#v030)
    - [Block device offloading](#block-device-offloading)
    - [Network device backend](#network-device-backend)
@@ -182,6 +203,169 @@
    - [Console over virtio](#console-over-virtio)
    - [Unit testing](#unit-testing)
    - [Integration tests parallelization](#integration-tests-parallelization)
+# v23.1
+
+This is a bug fix release. The following issues have been addressed:
+
+* Add some missing seccomp rules
+* Remove `virtio-fs` filesystem entries from config on removal
+* Do not delete API socket on API server start (#4026)
+* Reject `virtio-mem` resize if the guest doesn't activate the device
+* Fix OpenAPI naming of I/O throttling knobs
+
+# v23.0
+
+This release has been tracked through the [v23.0
+project](https://github.com/cloud-hypervisor/cloud-hypervisor/projects/27).
+
+### vDPA Support
+
+A vDPA device has a datapath that complies with the virtio specification but
+with a vendor specific control path. The addition of `--vdpa` and the REST API
+equivalent allows the use of these devices with Cloud Hypervisor.
+
+### Updated OS Support list
+
+The list of officially supported and tested OS versions has been updated to
+include Ubuntu "jammy" 22.04 and EOLed versions removed.
+
+### `AArch64` Memory Map Improvements
+
+The memory map when running on `AArch64` has been improved for the handling of
+the UEFI region which means that the booted guest OS now has full access to its
+allocated RAM. (#3938)
+
+### `AMX` Support
+
+Under a compile time gate of `amx` it is possible compile in support for the
+`AMX` instruction set extension for guest use. This also requires runtime
+enabling with `--cpu features=amx`.
+
+### Notable Bug Fixes
+
+* Generate error when incorrect HTTP method used for some API endpoints (#3887)
+* CMOS based reset is now available to support rebooting on "jammy" (#3914)
+* ACPI tables are not produced for memory hotplug when running with
+  `virtio-mem` (#3883)
+* `virtio-iommu` backed PCI segments are now comprehensively placed behind the
+  vIOMMU (#3870)
+* Seccomp rules have been extended for `virtio-fs` to support direct access
+  (#3848)
+
+### Deprecations
+
+Deprecated features will be removed in a subsequent release and users should
+plan to use alternatives
+
+* The `mergeable` option from the `virtio-pmem` support has been deprecated
+  (#3968)
+* The `dax` option from the `virtio-fs` support has been deprecated (#3889)
+
+### Contributors
+
+Many thanks to everyone who has contributed to our release:
+
+* Bo Chen <chen.bo@intel.com>
+* Fabiano Fidêncio <fabiano.fidencio@intel.com>
+* Henry Wang <Henry.Wang@arm.com>
+* Jianyong Wu <jianyong.wu@arm.com>
+* LiHui <andrewli@kubesphere.io>
+* Michael Zhao <michael.zhao@arm.com>
+* Rob Bradford <robert.bradford@intel.com>
+* Sebastien Boeuf <sebastien.boeuf@intel.com>
+* Wei Liu <liuwe@microsoft.com>
+* William Douglas <william.douglas@intel.com>
+* Yi Wang <wang.yi59@zte.com.cn>
+
+# v22.1
+
+This is a bug fix release. The following issues have been addressed:
+
+* VFIO ioctl reordering to fix MSI on AMD platforms (#3827)
+* Fix `virtio-net` control queue (#3829)
+
+# v22.0
+
+This release has been tracked through the [v22.0
+project](https://github.com/cloud-hypervisor/cloud-hypervisor/projects/25).
+
+### 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 License
+
+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

@@ -190,11 +374,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

--- a/resources/Dockerfile
+++ b/resources/Dockerfile
@@ -1,7 +1,10 @@
+# When changing this file don't forget to update the tag name in the
+# .github/workflows/docker-image.yaml file if doing multiple per day
+
 FROM ubuntu:20.04 as dev

 ARG TARGETARCH
-ARG RUST_TOOLCHAIN="1.58.0"
+ARG RUST_TOOLCHAIN="1.59.0"
 ARG CLH_SRC_DIR="/cloud-hypervisor"
 ARG CLH_BUILD_DIR="$CLH_SRC_DIR/build"
 ARG CARGO_REGISTRY_DIR="$CLH_BUILD_DIR/cargo_registry"
@@ -17,7 +20,6 @@ RUN apt-get update \
 	&& DEBIAN_FRONTEND=noninteractive apt-get install -yq \
 	build-essential \
 	bc \
-	docker.io \
 	curl \
 	wget \
 	sudo \
@@ -29,7 +31,6 @@ RUN apt-get update \
 	bison \
 	libelf-dev \
 	qemu-utils \
-	qemu-system \
 	libglib2.0-dev \
 	libpixman-1-dev \
 	libseccomp-dev \
@@ -44,6 +45,11 @@ RUN apt-get update \
 	openvswitch-switch-dpdk \
 	python3-distutils \
 	uuid-dev \
+	iperf3 \
+	zip \
+	git-core \
+	dnsmasq \
+	dmsetup \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

@@ -66,7 +72,7 @@ RUN if [ "$TARGETARCH" = "arm64" ]; then \
        && DEBIAN_FRONTEND=noninteractive apt-get install -yq \
        libcap2-bin \
        libguestfs-tools \
-        linux-image-5.8.0-63-generic \
+        linux-image-generic \
        autotools-dev \
        autoconf \
        automake \
@@ -86,12 +92,11 @@ ENV OPENSSL_INCLUDE_DIR=/usr/include/

 # Install the rust toolchain
 RUN export ARCH="$(uname -m)" \
-    && nohup curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain "$RUST_TOOLCHAIN" \
+    && nohup curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal --default-toolchain "$RUST_TOOLCHAIN" \
    && rustup target add $ARCH-unknown-linux-musl --toolchain "$RUST_TOOLCHAIN" \
-    && if [ "$TARGETARCH" = "amd64" ]; then rustup toolchain add $RUST_TOOLCHAIN-x86_64-unknown-linux-musl; fi \
+    && if [ "$TARGETARCH" = "amd64" ]; then rustup toolchain add --profile minimal $RUST_TOOLCHAIN-x86_64-unknown-linux-musl; fi \
    && if [ "$TARGETARCH" = "amd64" ]; then rustup component add rustfmt; fi \
    && if [ "$TARGETARCH" = "amd64" ]; then rustup component add clippy; fi \
-    && cargo install cargo-audit \
    && rm -rf "$CARGO_HOME/registry" \
    && ln -s "$CARGO_REGISTRY_DIR" "$CARGO_HOME/registry" \
    && rm -rf "$CARGO_HOME/git" \
@@ -102,23 +107,16 @@ RUN echo 'source $CARGO_HOME/env' >> $HOME/.bashrc \
    && mkdir $HOME/.cargo \
    && ln -s $CARGO_HOME/env $HOME/.cargo/env

-# install virtiofsd
-RUN git clone --depth 1 https://gitlab.com/virtio-fs/qemu.git -b qemu5.0-virtiofs-dax \
-    && cd qemu \
-    && ./configure --prefix=$PWD --target-list=x86_64-softmmu \
-    && make virtiofsd -j `nproc` \
-    && cp virtiofsd /usr/local/bin \
-    && cd .. && rm -rf qemu
-
 # install SPDK NVMe
 # only for 'x86_64' platform images as 'docker buildx' can't build 'spdk'
 RUN if [ "$TARGETARCH" = "amd64" ]; then \
       git clone https://github.com/spdk/spdk \
       && cd spdk \
-       && git checkout 59f3cdacb13bd2a19c4a86be04792b0ee4491172 \
+       && git checkout 6301f8915de32baed10dba1eebed556a6749211a \
       && git submodule update --init \
       && apt-get update \
       && ./scripts/pkgdep.sh \
+       && apt-get clean \
       && ./configure --with-vfio-user \
       && make -j `nproc` \
       && mkdir /usr/local/bin/spdk-nvme \
@@ -126,3 +124,10 @@ RUN if [ "$TARGETARCH" = "amd64" ]; then \
       && cp ./scripts/rpc.py /usr/local/bin/spdk-nvme \
       && cp -r ./scripts/rpc /usr/local/bin/spdk-nvme \
       && cd .. && rm -rf spdk; fi
+
+# install ethr tool for performance tests
+RUN if [ "$TARGETARCH" = "amd64" ]; then \
+    wget https://github.com/microsoft/ethr/releases/latest/download/ethr_linux.zip \
+    && unzip ethr_linux.zip \
+    && cp ethr /usr/local/bin \
+    && rm ethr_linux.zip; fi
--- a/rpm/cloud-hypervisor.spec
+++ b/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:        23.1
 Release:        0%{?dist}
 License:        ASL 2.0 or BSD-3-clause
 Group:          Applications/System
@@ -112,6 +112,15 @@ rm -rf %{buildroot}


 %changelog
+*   Mon May 09 2022 Rob Bradford <robert.bradford@intel.com> 23.1-0
+-   Update to 23.1
+
+*   Thu Apr 13 2022 Rob Bradford <robert.bradford@intel.com> 23.0-0
+-   Update to 23.0
+
+*   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

--- a/scripts/dev_cli.sh
+++ b/scripts/dev_cli.sh
@@ -7,7 +7,7 @@
 CLI_NAME="Cloud Hypervisor"

 CTR_IMAGE_TAG="cloudhypervisor/dev"
-CTR_IMAGE_VERSION="latest"
+CTR_IMAGE_VERSION="20220405-0"
 CTR_IMAGE="${CTR_IMAGE_TAG}:${CTR_IMAGE_VERSION}"

 DOCKER_RUNTIME="docker"
@@ -48,32 +48,32 @@ CARGO_TARGET_DIR="${CLH_BUILD_DIR}/cargo_target"
 # Send a decorated message to stdout, followed by a new line
 #
 say() {
-    [ -t 1 ] && [ -n "$TERM" ] \
-        && echo "$(tput setaf 2)[$CLI_NAME]$(tput sgr0) $*" \
-        || echo "[$CLI_NAME] $*"
+    [ -t 1 ] && [ -n "$TERM" ] &&
+        echo "$(tput setaf 2)[$CLI_NAME]$(tput sgr0) $*" ||
+        echo "[$CLI_NAME] $*"
 }

 # Send a decorated message to stdout, without a trailing new line
 #
 say_noln() {
-    [ -t 1 ] && [ -n "$TERM" ] \
-        && echo -n "$(tput setaf 2)[$CLI_NAME]$(tput sgr0) $*" \
-        || echo "[$CLI_NAME] $*"
+    [ -t 1 ] && [ -n "$TERM" ] &&
+        echo -n "$(tput setaf 2)[$CLI_NAME]$(tput sgr0) $*" ||
+        echo "[$CLI_NAME] $*"
 }

 # Send a text message to stderr
 #
 say_err() {
-    [ -t 2 ] && [ -n "$TERM" ] \
-        && echo "$(tput setaf 1)[$CLI_NAME] $*$(tput sgr0)" 1>&2 \
-        || echo "[$CLI_NAME] $*" 1>&2
+    [ -t 2 ] && [ -n "$TERM" ] &&
+        echo "$(tput setaf 1)[$CLI_NAME] $*$(tput sgr0)" 1>&2 ||
+        echo "[$CLI_NAME] $*" 1>&2
 }

 # Send a warning-highlighted text to stdout
 say_warn() {
-    [ -t 1 ] && [ -n "$TERM" ] \
-        && echo "$(tput setaf 3)[$CLI_NAME] $*$(tput sgr0)" \
-        || echo "[$CLI_NAME] $*"
+    [ -t 1 ] && [ -n "$TERM" ] &&
+        echo "$(tput setaf 3)[$CLI_NAME] $*$(tput sgr0)" ||
+        echo "[$CLI_NAME] $*"
 }

 # Exit with an error message and (optional) code
@@ -86,7 +86,7 @@ die() {
        shift 2
    }
    say_err "$@"
-    exit $code
+    exit "$code"
 }

 # Exit with an error message if the last exit code is not 0
@@ -101,26 +101,34 @@ ok_or_die() {
 #
 ensure_build_dir() {
    for dir in "$CLH_BUILD_DIR" \
-		   "$CLH_INTEGRATION_WORKLOADS" \
-		   "$CLH_CTR_BUILD_DIR" \
-		   "$CARGO_TARGET_DIR" \
-		   "$CARGO_REGISTRY_DIR" \
-		   "$CARGO_GIT_REGISTRY_DIR"; do
+        "$CLH_INTEGRATION_WORKLOADS" \
+        "$CLH_CTR_BUILD_DIR" \
+        "$CARGO_TARGET_DIR" \
+        "$CARGO_REGISTRY_DIR" \
+        "$CARGO_GIT_REGISTRY_DIR"; do
        mkdir -p "$dir" || die "Error: cannot create dir $dir"
-        [ -x "$dir" ] && [ -w "$dir" ] || \
+        [ -x "$dir" ] && [ -w "$dir" ] ||
            {
                say "Wrong permissions for $dir. Attempting to fix them ..."
                chmod +x+w "$dir"
-            } || \
+            } ||
            die "Error: wrong permissions for $dir. Should be +x+w"
    done
 }

 # Make sure we're using the latest dev container, by just pulling it.
 ensure_latest_ctr() {
-    $DOCKER_RUNTIME pull "$CTR_IMAGE"
+    if [ "$CTR_IMAGE_VERSION" = "local" ]; then
+        build_container
+    else
+        $DOCKER_RUNTIME pull "$CTR_IMAGE"

-    ok_or_die "Error pulling container image. Aborting."
+        if [ $? -ne 0 ]; then
+            build_container
+        fi
+
+        ok_or_die "Error pulling/building container image. Aborting."
+    fi
 }

 # Fix main directory permissions after a container ran as root.
@@ -132,14 +140,14 @@ fix_dir_perms() {
    # Yes, running Docker to get elevated privileges, just to chown some files
    # is a dirty hack.
    $DOCKER_RUNTIME run \
-	--workdir "$CTR_CLH_ROOT_DIR" \
-	   --rm \
-	   --volume /dev:/dev \
-	   --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	   "$CTR_IMAGE" \
-           chown -R "$(id -u):$(id -g)" "$CTR_CLH_ROOT_DIR"
+        --workdir "$CTR_CLH_ROOT_DIR" \
+        --rm \
+        --volume /dev:/dev \
+        --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+        "$CTR_IMAGE" \
+        chown -R "$(id -u):$(id -g)" "$CTR_CLH_ROOT_DIR"

-    return $1
+    return "$1"
 }
 # Process exported volumes argument, separate the volumes and make docker compatible
 # Sample input: --volumes /a:/a#/b:/b
@@ -151,8 +159,7 @@ process_volumes_args() {
    fi
    exported_volumes=""
    arr_vols=(${arg_vols//#/ })
-    for var in "${arr_vols[@]}"
-    do
+    for var in "${arr_vols[@]}"; do
        parts=(${var//:/ })
        if [[ ! -e "${parts[0]}" ]]; then
            echo "The volume ${parts[0]} does not exist."
@@ -163,8 +170,8 @@ process_volumes_args() {
 }
 cmd_help() {
    echo ""
-    echo "Cloud Hypervisor $(basename $0)"
-    echo "Usage: $(basename $0) <command> [<command args>]"
+    echo "Cloud Hypervisor $(basename "$0")"
+    echo "Usage: $(basename "$0") <command> [<command args>]"
    echo ""
    echo "Available commands:"
    echo ""
@@ -176,23 +183,22 @@ cmd_help() {
    echo "        --volumes             Hash separated volumes to be exported. Example --volumes /mnt:/mnt#/myvol:/myvol"
    echo "        --hypervisor          Underlying hypervisor. Options kvm, mshv"
    echo ""
-    echo "    tests [--unit|--cargo|--all] [--libc musl|gnu] [-- [<cargo test args>]]"
+    echo "    tests [<test type (see below)>] [--libc musl|gnu] [-- [<test scripts args>] [-- [<test binary args>]]] "
    echo "        Run the Cloud Hypervisor tests."
    echo "        --unit                       Run the unit tests."
-    echo "        --cargo                      Run the cargo tests."
    echo "        --integration                Run the integration tests."
    echo "        --integration-sgx            Run the SGX integration tests."
    echo "        --integration-vfio           Run the VFIO integration tests."
    echo "        --integration-windows        Run the Windows guest integration tests."
    echo "        --integration-live-migration Run the live-migration integration tests."
    echo "        --libc                       Select the C library Cloud Hypervisor will be built against. Default is gnu"
+    echo "        --metrics                    Generate performance metrics"
    echo "        --volumes                    Hash separated volumes to be exported. Example --volumes /mnt:/mnt#/myvol:/myvol"
    echo "        --hypervisor                 Underlying hypervisor. Options kvm, mshv"
    echo "        --all                        Run all tests."
    echo ""
    echo "    build-container [--type]"
    echo "        Build the Cloud Hypervisor container."
-    echo "        --dev                Build dev container. This is the default."
    echo ""
    echo "    clean [<cargo args>]]"
    echo "        Remove the Cloud Hypervisor artifacts."
@@ -213,37 +219,47 @@ cmd_build() {
    features_build=""
    exported_device="/dev/kvm"
    while [ $# -gt 0 ]; do
-	case "$1" in
-            "-h"|"--help")  { cmd_help; exit 1; } ;;
-            "--debug")      { build="debug"; } ;;
-            "--release")    { build="release"; } ;;
-            "--libc")
-                shift
-                [[ "$1" =~ ^(musl|gnu)$ ]] || \
-                    die "Invalid libc: $1. Valid options are \"musl\" and \"gnu\"."
-                libc="$1"
-                ;;
-            "--volumes")
-                shift
-                arg_vols="$1"
-                ;;
-            "--hypervisor")
-                shift
-                hypervisor="$1"
-                ;;
-            "--")           { shift; break; } ;;
-            *)
-		die "Unknown build argument: $1. Please use --help for help."
-		;;
-	esac
-	shift
+        case "$1" in
+        "-h" | "--help") {
+            cmd_help
+            exit 1
+        } ;;
+        "--debug") { build="debug"; } ;;
+        "--release") { build="release"; } ;;
+        "--libc")
+            shift
+            [[ "$1" =~ ^(musl|gnu)$ ]] ||
+                die "Invalid libc: $1. Valid options are \"musl\" and \"gnu\"."
+            libc="$1"
+            ;;
+        "--volumes")
+            shift
+            arg_vols="$1"
+            ;;
+        "--hypervisor")
+            shift
+            hypervisor="$1"
+            ;;
+        "--features")
+            shift
+            features_build="--features $1"
+            ;;
+        "--") {
+            shift
+            break
+        } ;;
+        *)
+            die "Unknown build argument: $1. Please use --help for help."
+            ;;
+        esac
+        shift
    done

    ensure_build_dir
    ensure_latest_ctr

    process_volumes_args
-    if [[ ! ("$hypervisor" = "kvm" ||  "$hypervisor" = "mshv") ]]; then
+    if [[ ! ("$hypervisor" = "kvm" || "$hypervisor" = "mshv") ]]; then
        die "Hypervisor value must be kvm or mshv"
    fi
    if [[ "$hypervisor" = "mshv" ]]; then
@@ -254,25 +270,26 @@ cmd_build() {
    cargo_args=("$@")
    [ $build = "release" ] && cargo_args+=("--release")
    cargo_args+=(--target "$target")
-    [ $(uname -m) = "aarch64" ] && cargo_args+=("--no-default-features")
-    [ $(uname -m) = "aarch64" ] && cargo_args+=(--features $hypervisor)

    rustflags=""
-    if [ $(uname -m) = "aarch64" ] && [ $libc = "musl" ] ; then
+    target_cc=""
+    if [ "$(uname -m)" = "aarch64" ] && [ "$libc" = "musl" ]; then
        rustflags="-C link-arg=-lgcc -C link_arg=-specs -C link_arg=/usr/lib/aarch64-linux-musl/musl-gcc.specs"
+        target_cc="musl-gcc"
    fi

    $DOCKER_RUNTIME run \
-	   --user "$(id -u):$(id -g)" \
-	   --workdir "$CTR_CLH_ROOT_DIR" \
-	   --rm \
-	   --volume $exported_device \
-	   --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	   --env RUSTFLAGS="$rustflags" \
-	   "$CTR_IMAGE" \
-	   cargo build --all $features_build \
-	         --target-dir "$CTR_CLH_CARGO_TARGET" \
-	         "${cargo_args[@]}" && say "Binaries placed under $CLH_CARGO_TARGET/$target/$build"
+        --user "$(id -u):$(id -g)" \
+        --workdir "$CTR_CLH_ROOT_DIR" \
+        --rm \
+        --volume $exported_device \
+        --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+        --env RUSTFLAGS="$rustflags" \
+        --env TARGET_CC="$target_cc" \
+        "$CTR_IMAGE" \
+        cargo build --all $features_build \
+        --target-dir "$CTR_CLH_CARGO_TARGET" \
+        "${cargo_args[@]}" && say "Binaries placed under $CLH_CARGO_TARGET/$target/$build"
 }

 cmd_clean() {
@@ -282,61 +299,71 @@ cmd_clean() {
    ensure_latest_ctr

    $DOCKER_RUNTIME run \
-	   --user "$(id -u):$(id -g)" \
-	   --workdir "$CTR_CLH_ROOT_DIR" \
-	   --rm \
-	   --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	   "$CTR_IMAGE" \
-	   cargo clean \
-	         --target-dir "$CTR_CLH_CARGO_TARGET" \
-	         "${cargo_args[@]}"
-    }
+        --user "$(id -u):$(id -g)" \
+        --workdir "$CTR_CLH_ROOT_DIR" \
+        --rm \
+        --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+        "$CTR_IMAGE" \
+        cargo clean \
+        --target-dir "$CTR_CLH_CARGO_TARGET" \
+        "${cargo_args[@]}"
+}

 cmd_tests() {
    unit=false
-    cargo=false
    integration=false
    integration_sgx=false
    integration_vfio=false
    integration_windows=false
    integration_live_migration=false
+    metrics=false
    libc="gnu"
    arg_vols=""
    hypervisor="kvm"
    exported_device="/dev/kvm"
    while [ $# -gt 0 ]; do
-	case "$1" in
-            "-h"|"--help")                  { cmd_help; exit 1; } ;;
-            "--unit")                       { unit=true; } ;;
-            "--cargo")                      { cargo=true; } ;;
-            "--integration")                { integration=true; } ;;
-            "--integration-sgx")            { integration_sgx=true; } ;;
-            "--integration-vfio")           { integration_vfio=true; } ;;
-            "--integration-windows")        { integration_windows=true; } ;;
-            "--integration-live-migration") { integration_live_migration=true; } ;;
-            "--libc")
-                shift
-                [[ "$1" =~ ^(musl|gnu)$ ]] || \
-                    die "Invalid libc: $1. Valid options are \"musl\" and \"gnu\"."
-                libc="$1"
-                ;;
-            "--volumes")
-                shift
-                arg_vols="$1"
-                ;;
-            "--hypervisor")
-                shift
-                hypervisor="$1"
-                ;;
-	    "--all")                 { cargo=true; unit=true; integration=true; } ;;
-            "--")                    { shift; break; } ;;
-            *)
-		die "Unknown tests argument: $1. Please use --help for help."
-		;;
-	esac
-	shift
+        case "$1" in
+        "-h" | "--help") {
+            cmd_help
+            exit 1
+        } ;;
+        "--unit") { unit=true; } ;;
+        "--integration") { integration=true; } ;;
+        "--integration-sgx") { integration_sgx=true; } ;;
+        "--integration-vfio") { integration_vfio=true; } ;;
+        "--integration-windows") { integration_windows=true; } ;;
+        "--integration-live-migration") { integration_live_migration=true; } ;;
+        "--metrics") { metrics=true; } ;;
+        "--libc")
+            shift
+            [[ "$1" =~ ^(musl|gnu)$ ]] ||
+                die "Invalid libc: $1. Valid options are \"musl\" and \"gnu\"."
+            libc="$1"
+            ;;
+        "--volumes")
+            shift
+            arg_vols="$1"
+            ;;
+        "--hypervisor")
+            shift
+            hypervisor="$1"
+            ;;
+        "--all") {
+            cargo=true
+            unit=true
+            integration=true
+        } ;;
+        "--") {
+            shift
+            break
+        } ;;
+        *)
+            die "Unknown tests argument: $1. Please use --help for help."
+            ;;
+        esac
+        shift
    done
-    if [[ ! ("$hypervisor" = "kvm" ||  "$hypervisor" = "mshv") ]]; then
+    if [[ ! ("$hypervisor" = "kvm" || "$hypervisor" = "mshv") ]]; then
        die "Hypervisor value must be kvm or mshv"
    fi

@@ -344,190 +371,204 @@ cmd_tests() {
        exported_device="/dev/mshv"
    fi

-    set -- "$@" '--hypervisor' $hypervisor
+    set -- '--hypervisor' "$hypervisor" "$@"

    ensure_build_dir
    ensure_latest_ctr

    process_volumes_args
    target="$(uname -m)-unknown-linux-${libc}"
-    cflags=""
-    target_cc=""
-    if [[ "$target" == "x86_64-unknown-linux-musl" ]]; then
-	target_cc="musl-gcc"
-	cflags="-I /usr/include/x86_64-linux-musl/ -idirafter /usr/include/"
+
+    if [[ "$unit" = true ]]; then
+        say "Running unit tests for $target..."
+        $DOCKER_RUNTIME run \
+            --workdir "$CTR_CLH_ROOT_DIR" \
+            --rm \
+            --device $exported_device \
+            --device /dev/net/tun \
+            --cap-add net_admin \
+            --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+            --env BUILD_TARGET="$target" \
+            "$CTR_IMAGE" \
+            ./scripts/run_unit_tests.sh "$@" || fix_dir_perms $? || exit $?
    fi

-    if [[ "$unit" = true  ]] ;  then
-	say "Running unit tests for $target..."
-	$DOCKER_RUNTIME run \
-	       --workdir "$CTR_CLH_ROOT_DIR" \
-	       --rm \
-	       --device $exported_device \
-	       --device /dev/net/tun \
-	       --cap-add net_admin \
-	       --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	       --env BUILD_TARGET="$target" \
-	       --env CFLAGS="$cflags" \
-	       --env TARGET_CC="$target_cc" \
-	       "$CTR_IMAGE" \
-	       ./scripts/run_unit_tests.sh "$@" || fix_dir_perms $? || exit $?
+    if [ "$integration" = true ]; then
+        say "Running integration tests for $target..."
+        $DOCKER_RUNTIME run \
+            --workdir "$CTR_CLH_ROOT_DIR" \
+            --rm \
+            --privileged \
+            --security-opt seccomp=unconfined \
+            --ipc=host \
+            --net="$CTR_CLH_NET" \
+            --mount type=tmpfs,destination=/tmp \
+            --volume /dev:/dev \
+            --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+            --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
+            --env USER="root" \
+            --env CH_LIBC="${libc}" \
+            "$CTR_IMAGE" \
+            ./scripts/run_integration_tests_"$(uname -m)".sh "$@" || fix_dir_perms $? || exit $?
    fi

-    if [ "$cargo" = true ] ;  then
-	say "Running cargo tests..."
-	$DOCKER_RUNTIME run \
-	       --workdir "$CTR_CLH_ROOT_DIR" \
-	       --rm \
-	       --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	       "$CTR_IMAGE" \
-	       ./scripts/run_cargo_tests.sh "$@"  || fix_dir_perms $? || exit $?
+    if [ "$integration_sgx" = true ]; then
+        say "Running SGX integration tests for $target..."
+        $DOCKER_RUNTIME run \
+            --workdir "$CTR_CLH_ROOT_DIR" \
+            --rm \
+            --privileged \
+            --security-opt seccomp=unconfined \
+            --ipc=host \
+            --net="$CTR_CLH_NET" \
+            --mount type=tmpfs,destination=/tmp \
+            --volume /dev:/dev \
+            --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+            --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
+            --env USER="root" \
+            --env CH_LIBC="${libc}" \
+            "$CTR_IMAGE" \
+            ./scripts/run_integration_tests_sgx.sh "$@" || fix_dir_perms $? || exit $?
    fi

-    if [ "$integration" = true ] ;  then
-	say "Running integration tests for $target..."
-	$DOCKER_RUNTIME run \
-	       --workdir "$CTR_CLH_ROOT_DIR" \
-	       --rm \
-	       --privileged \
-	       --security-opt seccomp=unconfined \
-	       --ipc=host \
-	       --net="$CTR_CLH_NET" \
-	       --mount type=tmpfs,destination=/tmp \
-	       --volume /dev:/dev \
-	       --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	       --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
-	       --env USER="root" \
-	       --env CH_LIBC="${libc}" \
-	       "$CTR_IMAGE" \
-	       ./scripts/run_integration_tests_$(uname -m).sh "$@" || fix_dir_perms $? || exit $?
+    if [ "$integration_vfio" = true ]; then
+        say "Running VFIO integration tests for $target..."
+        $DOCKER_RUNTIME run \
+            --workdir "$CTR_CLH_ROOT_DIR" \
+            --rm \
+            --privileged \
+            --security-opt seccomp=unconfined \
+            --ipc=host \
+            --net="$CTR_CLH_NET" \
+            --mount type=tmpfs,destination=/tmp \
+            --volume /dev:/dev \
+            --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+            --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
+            --env USER="root" \
+            --env CH_LIBC="${libc}" \
+            "$CTR_IMAGE" \
+            ./scripts/run_integration_tests_vfio.sh "$@" || fix_dir_perms $? || exit $?
    fi

-    if [ "$integration_sgx" = true ] ;  then
-	say "Running SGX integration tests for $target..."
-	$DOCKER_RUNTIME run \
-	       --workdir "$CTR_CLH_ROOT_DIR" \
-	       --rm \
-	       --privileged \
-	       --security-opt seccomp=unconfined \
-	       --ipc=host \
-	       --net="$CTR_CLH_NET" \
-	       --mount type=tmpfs,destination=/tmp \
-	       --volume /dev:/dev \
-	       --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	       --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
-	       --env USER="root" \
-	       --env CH_LIBC="${libc}" \
-	       "$CTR_IMAGE" \
-	       ./scripts/run_integration_tests_sgx.sh "$@" || fix_dir_perms $? || exit $?
+    if [ "$integration_windows" = true ]; then
+        say "Running Windows integration tests for $target..."
+        $DOCKER_RUNTIME run \
+            --workdir "$CTR_CLH_ROOT_DIR" \
+            --rm \
+            --privileged \
+            --security-opt seccomp=unconfined \
+            --ipc=host \
+            --net="$CTR_CLH_NET" \
+            --mount type=tmpfs,destination=/tmp \
+            --volume /dev:/dev \
+            --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+            --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
+            --env USER="root" \
+            --env CH_LIBC="${libc}" \
+            "$CTR_IMAGE" \
+            ./scripts/run_integration_tests_windows.sh "$@" || fix_dir_perms $? || exit $?
    fi

-    if [ "$integration_vfio" = true ] ;  then
-	say "Running VFIO integration tests for $target..."
-	$DOCKER_RUNTIME run \
-	       --workdir "$CTR_CLH_ROOT_DIR" \
-	       --rm \
-	       --privileged \
-	       --security-opt seccomp=unconfined \
-	       --ipc=host \
-	       --net="$CTR_CLH_NET" \
-	       --mount type=tmpfs,destination=/tmp \
-	       --volume /dev:/dev \
-	       --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	       --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
-	       --env USER="root" \
-	       --env CH_LIBC="${libc}" \
-	       "$CTR_IMAGE" \
-	       ./scripts/run_integration_tests_vfio.sh "$@" || fix_dir_perms $? || exit $?
+    if [ "$integration_live_migration" = true ]; then
+        say "Running 'live migration' integration tests for $target..."
+        $DOCKER_RUNTIME run \
+            --workdir "$CTR_CLH_ROOT_DIR" \
+            --rm \
+            --privileged \
+            --security-opt seccomp=unconfined \
+            --ipc=host \
+            --net="$CTR_CLH_NET" \
+            --mount type=tmpfs,destination=/tmp \
+            --volume /dev:/dev \
+            --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+            --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
+            --env USER="root" \
+            --env CH_LIBC="${libc}" \
+            "$CTR_IMAGE" \
+            ./scripts/run_integration_tests_live_migration.sh "$@" || fix_dir_perms $? || exit $?
    fi

-    if [ "$integration_windows" = true ] ;  then
-	say "Running Windows integration tests for $target..."
-	$DOCKER_RUNTIME run \
-	       --workdir "$CTR_CLH_ROOT_DIR" \
-	       --rm \
-	       --privileged \
-	       --security-opt seccomp=unconfined \
-	       --ipc=host \
-	       --net="$CTR_CLH_NET" \
-	       --mount type=tmpfs,destination=/tmp \
-	       --volume /dev:/dev \
-	       --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR"  $exported_volumes \
-	       --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
-	       --env USER="root" \
-	       --env CH_LIBC="${libc}" \
-	       "$CTR_IMAGE" \
-	       ./scripts/run_integration_tests_windows.sh "$@" || fix_dir_perms $? || exit $?
+    if [ "$metrics" = true ]; then
+        say "Generating performance metrics for $target..."
+        $DOCKER_RUNTIME run \
+            --workdir "$CTR_CLH_ROOT_DIR" \
+            --rm \
+            --privileged \
+            --security-opt seccomp=unconfined \
+            --ipc=host \
+            --net="$CTR_CLH_NET" \
+            --mount type=tmpfs,destination=/tmp \
+            --volume /dev:/dev \
+            --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+            --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
+            --env USER="root" \
+            --env CH_LIBC="${libc}" \
+            "$CTR_IMAGE" \
+            ./scripts/run_metrics.sh "$@" || fix_dir_perms $? || exit $?
    fi

-    if [ "$integration_live_migration" = true ] ;  then
-	say "Running 'live migration' integration tests for $target..."
-	$DOCKER_RUNTIME run \
-	       --workdir "$CTR_CLH_ROOT_DIR" \
-	       --rm \
-	       --privileged \
-	       --security-opt seccomp=unconfined \
-	       --ipc=host \
-	       --net="$CTR_CLH_NET" \
-	       --mount type=tmpfs,destination=/tmp \
-	       --volume /dev:/dev \
-	       --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR"  $exported_volumes \
-	       --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
-	       --env USER="root" \
-	       --env CH_LIBC="${libc}" \
-	       "$CTR_IMAGE" \
-	       ./scripts/run_integration_tests_live_migration.sh "$@" || fix_dir_perms $? || exit $?
-    fi
    fix_dir_perms $?
 }

-cmd_build-container() {
-    container_type="dev"
-
-    while [ $# -gt 0 ]; do
-	case "$1" in
-            "-h"|"--help")  { cmd_help; exit 1; } ;;
-            "--dev")        { container_type="dev"; } ;;
-            "--")           { shift; break; } ;;
-            *)
-		die "Unknown build-container argument: $1. Please use --help for help."
-		;;
-	esac
-	shift
-    done
-
+build_container() {
    ensure_build_dir
-    ensure_latest_ctr

    BUILD_DIR=/tmp/cloud-hypervisor/container/

    mkdir -p $BUILD_DIR
-    cp $CLH_DOCKERFILE $BUILD_DIR
+    cp "$CLH_DOCKERFILE" $BUILD_DIR

-    [ $(uname -m) = "aarch64" ] && TARGETARCH="arm64"
-    [ $(uname -m) = "x86_64" ] && TARGETARCH="amd64"
+    [ "$(uname -m)" = "aarch64" ] && TARGETARCH="arm64"
+    [ "$(uname -m)" = "x86_64" ] && TARGETARCH="amd64"

    $DOCKER_RUNTIME build \
-	   --target $container_type \
-	   -t $CTR_IMAGE \
-	   -f $BUILD_DIR/Dockerfile \
-	   --build-arg TARGETARCH=$TARGETARCH \
-	   $BUILD_DIR
+        --target dev \
+        -t $CTR_IMAGE \
+        -f $BUILD_DIR/Dockerfile \
+        --build-arg TARGETARCH=$TARGETARCH \
+        $BUILD_DIR
+}
+
+cmd_build-container() {
+    while [ $# -gt 0 ]; do
+        case "$1" in
+        "-h" | "--help") {
+            cmd_help
+            exit 1
+        } ;;
+        "--") {
+            shift
+            break
+        } ;;
+        *)
+            die "Unknown build-container argument: $1. Please use --help for help."
+            ;;
+        esac
+        shift
+    done
+
+    build_container
 }

 cmd_shell() {
    while [ $# -gt 0 ]; do
-	case "$1" in
-            "-h"|"--help")  { cmd_help; exit 1; } ;;
-            "--volumes")
-                shift
-                arg_vols="$1"
-                ;;
-            "--")           { shift; break; } ;;
-            *)
-		;;
-	esac
-	shift
+        case "$1" in
+        "-h" | "--help") {
+            cmd_help
+            exit 1
+        } ;;
+        "--volumes")
+            shift
+            arg_vols="$1"
+            ;;
+        "--") {
+            shift
+            break
+        } ;;
+        *) ;;
+
+        esac
+        shift
    done
    ensure_build_dir
    ensure_latest_ctr
@@ -535,20 +576,20 @@ cmd_shell() {
    say_warn "Starting a privileged shell prompt as root ..."
    say_warn "WARNING: Your $CLH_ROOT_DIR folder will be bind-mounted in the container under $CTR_CLH_ROOT_DIR"
    $DOCKER_RUNTIME run \
-	   -ti \
-	   --workdir "$CTR_CLH_ROOT_DIR" \
-	   --rm \
-	   --privileged \
-	   --security-opt seccomp=unconfined \
-	   --ipc=host \
-	   --net="$CTR_CLH_NET" \
-	   --tmpfs /tmp:exec \
-	   --volume /dev:/dev \
-	   --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
-	   --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
-	   --env USER="root" \
-	   --entrypoint bash \
-	   "$CTR_IMAGE"
+        -ti \
+        --workdir "$CTR_CLH_ROOT_DIR" \
+        --rm \
+        --privileged \
+        --security-opt seccomp=unconfined \
+        --ipc=host \
+        --net="$CTR_CLH_NET" \
+        --tmpfs /tmp:exec \
+        --volume /dev:/dev \
+        --volume "$CLH_ROOT_DIR:$CTR_CLH_ROOT_DIR" $exported_volumes \
+        --volume "$CLH_INTEGRATION_WORKLOADS:$CTR_CLH_INTEGRATION_WORKLOADS" \
+        --env USER="root" \
+        --entrypoint bash \
+        "$CTR_IMAGE"

    fix_dir_perms $?
 }
@@ -557,14 +598,20 @@ cmd_shell() {
 #
 while [ $# -gt 0 ]; do
    case "$1" in
-        -h|--help)              { cmd_help; exit 1; } ;;
-        -y|--unattended)        { OPT_UNATTENDED=true; } ;;
-        -*)
-            die "Unknown arg: $1. Please use \`$0 help\` for help."
-            ;;
-        *)
-            break
-            ;;
+    -h | --help) {
+        cmd_help
+        exit 1
+    } ;;
+    --local) {
+        CTR_IMAGE_VERSION="local"
+        CTR_IMAGE="${CTR_IMAGE_TAG}:${CTR_IMAGE_VERSION}"
+    } ;;
+    -*)
+        die "Unknown arg: $1. Please use \`$0 help\` for help."
+        ;;
+    *)
+        break
+        ;;
    esac
    shift
 done
@@ -572,11 +619,10 @@ done
 # $1 is now a command name. Check if it is a valid command and, if so,
 # run it.
 #
-declare -f "cmd_$1" > /dev/null
+declare -f "cmd_$1" >/dev/null
 ok_or_die "Unknown command: $1. Please use \`$0 help\` for help."

 cmd=cmd_$1
 shift

-
 $cmd "$@"
--- a/scripts/prepare_vdpa.sh
+++ b/scripts/prepare_vdpa.sh
@@ -0,0 +1,42 @@
+#!/bin/bash
+set -x
+
+sudo apt install -y libncurses-dev gawk flex bison openssl libssl-dev dkms libelf-dev libudev-dev libpci-dev libiberty-dev autoconf git make dpkg-dev libmnl-dev pkg-config
+sudo sed -i -- 's/# deb-src/deb-src/g' /etc/apt/sources.list
+sudo apt update
+apt-get source linux-image-unsigned-`uname -r`
+pushd linux-azure*/drivers/vdpa/vdpa_sim/
+cat <<'EOF' > Makefile
+# SPDX-License-Identifier: GPL-2.0
+obj-m += vdpa_sim.o
+obj-m += vdpa_sim_net.o
+obj-m += vdpa_sim_blk.o
+EOF
+make -C /lib/modules/`uname -r`/build M=$PWD
+sudo make -C /lib/modules/`uname -r`/build M=$PWD modules_install
+popd
+sudo depmod -a
+sudo modprobe vdpa
+sudo modprobe vhost_vdpa
+sudo modprobe vdpa_sim
+sudo modprobe vdpa_sim_blk
+sudo modprobe vdpa_sim_net
+# After the Jenkins builder are moved to Ubuntu 22.04, manually building and
+# installing iproute2/vdpa won't be required.
+# Tracked by: https://github.com/cloud-hypervisor/cloud-hypervisor/issues/3862
+git clone https://github.com/shemminger/iproute2.git
+pushd iproute2
+./configure 
+make -j
+sudo make install
+popd
+# Create /dev/vhost-vdpa-0
+sudo vdpa dev add name vdpa-blk1 mgmtdev vdpasim_blk
+# Create /dev/vhost-vdpa-1
+sudo vdpa dev add name vdpa-blk2 mgmtdev vdpasim_blk
+# Create /dev/vhost-vdpa-2
+sudo vdpa dev add name vdpa-net1 mgmtdev vdpasim_net
+sudo chmod 660 /dev/vhost-vdpa-0
+sudo chmod 660 /dev/vhost-vdpa-1
+sudo chmod 660 /dev/vhost-vdpa-2
+vdpa dev show -jp
--- a/scripts/run_cargo_tests.sh
+++ b/scripts/run_cargo_tests.sh
@@ -1,26 +0,0 @@
-#!/bin/bash
-set -e
-set -x
-
-source $HOME/.cargo/env
-source $(dirname "$0")/test-util.sh
-
-process_common_args "$@"
-
-# Install cargo components
-time rustup component add clippy
-time rustup component add rustfmt
-time which cargo-audit || cargo install cargo-audit
-
-# Run cargo builds and checks
-time cargo clippy --all-targets --all-features -- -D warnings
-time cargo rustc --bin cloud-hypervisor -- -D warnings
-time cargo rustc -p vhost_user_net --bin vhost_user_net -- -D warnings
-time cargo test
-time cargo audit
-time cargo clippy --all-targets --no-default-features --features "acpi,$hypervisor" -- -D warnings
-time cargo rustc --bin cloud-hypervisor --no-default-features --features "acpi,$hypervisor"  -- -D warnings
-time cargo clippy --all-targets --no-default-features --features "$hypervisor" -- -D warnings
-time cargo rustc --bin cloud-hypervisor --no-default-features --features "$hypervisor"  -- -D warnings
-time cargo fmt -- --check
-time cargo build --all --release
--- a/scripts/run_integration_tests_aarch64.sh
+++ b/scripts/run_integration_tests_aarch64.sh
@@ -11,63 +11,6 @@ WORKLOADS_LOCK="$WORKLOADS_DIR/integration_test.lock"

 mkdir -p "$WORKLOADS_DIR"

-# Checkout source code of a GIT repo with specified branch and commit
-# Args:
-#   $1: Target directory
-#   $2: GIT URL of the repo
-#   $3: Required branch
-#   $4: Required commit (optional)
-checkout_repo() {
-    SRC_DIR="$1"
-    GIT_URL="$2"
-    GIT_BRANCH="$3"
-    GIT_COMMIT="$4"
-
-    # Check whether the local HEAD commit same as the requested commit or not.
-    # If commit is not specified, compare local HEAD and remote HEAD.
-    # Remove the folder if there is difference.
-    if [ -d "$SRC_DIR" ]; then
-        pushd $SRC_DIR
-        git fetch
-        SRC_LOCAL_COMMIT=$(git rev-parse HEAD)
-        if [ -z "$GIT_COMMIT" ]; then
-            GIT_COMMIT=$(git rev-parse remotes/origin/"$GIT_BRANCH")
-        fi
-        popd
-        if [ "$SRC_LOCAL_COMMIT" != "$GIT_COMMIT" ]; then
-            rm -rf "$SRC_DIR"
-        fi
-    fi
-
-    # Checkout the specified branch and commit (if required)
-    if [ ! -d "$SRC_DIR" ]; then
-        git clone --depth 1 "$GIT_URL" -b "$GIT_BRANCH" "$SRC_DIR"
-        if [ "$GIT_COMMIT" ]; then
-            pushd "$SRC_DIR"
-            git fetch --depth 1 origin "$GIT_COMMIT"
-            git reset --hard FETCH_HEAD
-            popd
-        fi
-    fi
-}
-
-build_custom_linux() {
-    SRCDIR=$PWD
-    LINUX_CUSTOM_DIR="$WORKLOADS_DIR/linux-custom"
-    LINUX_CUSTOM_BRANCH="ch-5.15.12"
-    LINUX_CUSTOM_URL="https://github.com/cloud-hypervisor/linux.git"
-
-    checkout_repo "$LINUX_CUSTOM_DIR" "$LINUX_CUSTOM_URL" "$LINUX_CUSTOM_BRANCH"
-
-    cp $SRCDIR/resources/linux-config-aarch64 $LINUX_CUSTOM_DIR/.config
-
-    pushd $LINUX_CUSTOM_DIR
-    time make -j `nproc`
-    cp arch/arm64/boot/Image "$WORKLOADS_DIR/" || exit 1
-    cp arch/arm64/boot/Image.gz "$WORKLOADS_DIR/" || exit 1
-    popd
-}
-
 build_edk2() {
    EDK2_BUILD_DIR="$WORKLOADS_DIR/edk2_build"
    EDK2_REPO="https://github.com/tianocore/edk2.git"
@@ -92,33 +35,61 @@ build_edk2() {
    checkout_repo "$EDK2_PLAT_DIR" "$EDK2_PLAT_REPO" master "8227e9e9f6a8aefbd772b40138f835121ccb2307"
    checkout_repo "$ACPICA_DIR" "$ACPICA_REPO" master "b9c69f81a05c45611c91ea9cbce8756078d76233"

-    pushd "$EDK2_BUILD_DIR"
-    # Build
-    make -C acpica -j `nproc`
-    source edk2/edksetup.sh
-    make -C edk2/BaseTools -j `nproc`
-    build -a AARCH64 -t GCC5 -p ArmVirtPkg/ArmVirtCloudHv.dsc -b RELEASE -n 0
-    cp Build/ArmVirtCloudHv-AARCH64/RELEASE_GCC5/FV/CLOUDHV_EFI.fd "$WORKLOADS_DIR"
-    popd
+    if [[ ! -f "$EDK2_DIR/.built" || \
+          ! -f "$EDK2_PLAT_DIR/.built" || \
+          ! -f "$ACPICA_DIR/.built" ]]; then
+        pushd "$EDK2_BUILD_DIR"
+        # Build
+        make -C acpica -j `nproc`
+        source edk2/edksetup.sh
+        make -C edk2/BaseTools -j `nproc`
+        build -a AARCH64 -t GCC5 -p ArmVirtPkg/ArmVirtCloudHv.dsc -b RELEASE -n 0
+        cp Build/ArmVirtCloudHv-AARCH64/RELEASE_GCC5/FV/CLOUDHV_EFI.fd "$WORKLOADS_DIR"
+        touch "$EDK2_DIR"/.built
+        touch "$EDK2_PLAT_DIR"/.built
+        touch "$ACPICA_DIR"/.built
+        popd
+    fi
 }

 build_spdk_nvme() {
    SPDK_DIR="$WORKLOADS_DIR/spdk"
    SPDK_REPO="https://github.com/spdk/spdk.git"
-    checkout_repo "$SPDK_DIR" "$SPDK_REPO" master "f9c496b8e21a8f499df268818bf8b5d8e2b19f04"
+    SPDK_DEPLOY_DIR="/usr/local/bin/spdk-nvme"
+    checkout_repo "$SPDK_DIR" "$SPDK_REPO" master "6301f8915de32baed10dba1eebed556a6749211a"

-    pushd $SPDK_DIR
-    git submodule update --init
-    apt-get update
-    ./scripts/pkgdep.sh
-    ./configure --with-vfio-user
-    chmod +x /usr/local/lib/python3.8/dist-packages/ninja/data/bin/ninja
-    make -j `nproc`
-    mkdir /usr/local/bin/spdk-nvme
-    cp ./build/bin/nvmf_tgt /usr/local/bin/spdk-nvme
-    cp ./scripts/rpc.py /usr/local/bin/spdk-nvme
-    cp -r ./scripts/rpc /usr/local/bin/spdk-nvme
-    popd
+    if [ ! -f "$SPDK_DIR/.built" ]; then
+        pushd $SPDK_DIR
+        git submodule update --init
+        apt-get update
+        ./scripts/pkgdep.sh
+        ./configure --with-vfio-user
+        chmod +x /usr/local/lib/python3.8/dist-packages/ninja/data/bin/ninja
+        make -j `nproc` || exit 1
+        touch .built
+        popd
+    fi
+    if [ ! -d "/usr/local/bin/spdk-nvme" ]; then
+        mkdir -p $SPDK_DEPLOY_DIR
+    fi
+    cp "$WORKLOADS_DIR/spdk/build/bin/nvmf_tgt" $SPDK_DEPLOY_DIR/nvmf_tgt
+    cp "$WORKLOADS_DIR/spdk/scripts/rpc.py" $SPDK_DEPLOY_DIR/rpc.py
+    cp -r "$WORKLOADS_DIR/spdk/scripts/rpc" $SPDK_DEPLOY_DIR/rpc
+}
+
+build_virtiofsd() {
+    VIRTIOFSD_DIR="$WORKLOADS_DIR/virtiofsd_build"
+    VIRTIOFSD_REPO="https://gitlab.com/virtio-fs/virtiofsd.git"
+
+    checkout_repo "$VIRTIOFSD_DIR" "$VIRTIOFSD_REPO" v1.1.0 "220405d7a2606c92636d31992b5cb3036a41047b"
+
+    if [ ! -f "$VIRTIOFSD_DIR/.built" ]; then
+        pushd $VIRTIOFSD_DIR
+        time cargo build --release
+        cp target/release/virtiofsd "$WORKLOADS_DIR/" || exit 1
+        touch .built
+        popd
+    fi
 }

 update_workloads() {
@@ -169,6 +140,24 @@ update_workloads() {
        popd
    fi

+    JAMMY_OS_RAW_IMAGE_NAME="jammy-server-cloudimg-arm64-custom-20220329-0.raw"
+    JAMMY_OS_RAW_IMAGE_DOWNLOAD_URL="https://cloud-hypervisor.azureedge.net/$JAMMY_OS_RAW_IMAGE_NAME"
+    JAMMY_OS_RAW_IMAGE="$WORKLOADS_DIR/$JAMMY_OS_RAW_IMAGE_NAME"
+    if [ ! -f "$JAMMY_OS_RAW_IMAGE" ]; then
+        pushd $WORKLOADS_DIR
+        time wget --quiet $JAMMY_OS_RAW_IMAGE_DOWNLOAD_URL || exit 1
+        popd
+    fi
+
+    JAMMY_OS_QCOW2_IMAGE_UNCOMPRESSED_NAME="jammy-server-cloudimg-arm64-custom-20220329-0.qcow2"
+    JAMMY_OS_QCOW2_IMAGE_UNCOMPRESSED_DOWNLOAD_URL="https://cloud-hypervisor.azureedge.net/$JAMMY_OS_QCOW2_IMAGE_UNCOMPRESSED_NAME"
+    JAMMY_OS_QCOW2_UNCOMPRESSED_IMAGE="$WORKLOADS_DIR/$JAMMY_OS_QCOW2_IMAGE_UNCOMPRESSED_NAME"
+    if [ ! -f "$JAMMY_OS_QCOW2_UNCOMPRESSED_IMAGE" ]; then
+        pushd $WORKLOADS_DIR
+        time wget --quiet $JAMMY_OS_QCOW2_IMAGE_UNCOMPRESSED_DOWNLOAD_URL || exit 1
+        popd
+    fi
+
    ALPINE_MINIROOTFS_URL="http://dl-cdn.alpinelinux.org/alpine/v3.11/releases/aarch64/alpine-minirootfs-3.11.3-aarch64.tar.gz"
    ALPINE_MINIROOTFS_TARBALL="$WORKLOADS_DIR/alpine-minirootfs-aarch64.tar.gz"
    if [ ! -f "$ALPINE_MINIROOTFS_TARBALL" ]; then
@@ -217,19 +206,7 @@ update_workloads() {
    guestunmount "$FOCAL_OS_RAW_IMAGE_UPDATE_KERNEL_ROOT_DIR"

    # Build virtiofsd
-    VIRTIOFSD_RS="$WORKLOADS_DIR/virtiofsd-rs"
-    VIRTIOFSD_RS_DIR="virtiofsd_rs_build"
-    if [ ! -f "$VIRTIOFSD_RS" ]; then
-        pushd $WORKLOADS_DIR
-        git clone "https://gitlab.com/virtio-fs/virtiofsd-rs.git" $VIRTIOFSD_RS_DIR
-        pushd $VIRTIOFSD_RS_DIR
-        git checkout 21d20035a582fb0389697b1bd7f8331623a77939
-        time cargo build --release
-        cp target/release/virtiofsd-rs $VIRTIOFSD_RS || exit 1
-        popd
-        rm -rf $VIRTIOFSD_RS_DIR
-        popd
-    fi
+    build_virtiofsd

    BLK_IMAGE="$WORKLOADS_DIR/blk.img"
    MNT_DIR="mount_image"
@@ -252,10 +229,10 @@ update_workloads() {
        echo "bar" > "$SHARED_DIR/file3" || exit 1
    fi

-    # checkout and build SPDK NVMe
+    # Checkout and build SPDK NVMe
    build_spdk_nvme

-    # Check and build EDK2 binary
+    # Checkout and build EDK2
    build_edk2
 }

@@ -285,11 +262,9 @@ if [ $RES -ne 0 ]; then
 fi

 BUILD_TARGET="aarch64-unknown-linux-${CH_LIBC}"
-CFLAGS=""
-TARGET_CC=""
 if [[ "${BUILD_TARGET}" == "aarch64-unknown-linux-musl" ]]; then
-TARGET_CC="musl-gcc"
-CFLAGS="-I /usr/include/aarch64-linux-musl/ -idirafter /usr/include/"
+export TARGET_CC="musl-gcc"
+export RUSTFLAGS="-C link-arg=-lgcc -C link_arg=-specs -C link_arg=/usr/lib/aarch64-linux-musl/musl-gcc.specs"
 fi

 export RUST_BACKTRACE=1
@@ -311,13 +286,13 @@ echo 6144 | sudo tee /proc/sys/vm/nr_hugepages
 sudo chmod a+rwX /dev/hugepages

 # Run all direct kernel boot (Device Tree) test cases in mod `parallel`
-time cargo test $features "parallel::$test_filter"
+time cargo test $features "parallel::$test_filter" --target $BUILD_TARGET -- ${test_binary_args[*]}
 RES=$?

 # Run some tests in sequence since the result could be affected by other tests
 # running in parallel.
 if [ $RES -eq 0 ]; then
-    time cargo test $features "sequential::$test_filter" -- --test-threads=1
+    time cargo test $features "sequential::$test_filter" --target $BUILD_TARGET -- --test-threads=1 ${test_binary_args[*]}
    RES=$?
 else
    exit $RES
@@ -325,7 +300,7 @@ fi

 # Run all ACPI test cases
 if [ $RES -eq 0 ]; then
-    time cargo test $features "aarch64_acpi::$test_filter"
+    time cargo test $features "aarch64_acpi::$test_filter" --target $BUILD_TARGET -- ${test_binary_args[*]}
    RES=$?
 else
    exit $RES
@@ -333,7 +308,7 @@ fi

 # Run all test cases related to live migration
 if [ $RES -eq 0 ]; then
-    time cargo test $features "live_migration::$test_filter" -- --test-threads=1
+    time cargo test $features "live_migration::$test_filter" --target $BUILD_TARGET -- --test-threads=1 ${test_binary_args[*]}
    RES=$?
 else
    exit $RES
--- a/scripts/run_integration_tests_live_migration.sh
+++ b/scripts/run_integration_tests_live_migration.sh
@@ -87,7 +87,7 @@ echo 6144 | sudo tee /proc/sys/vm/nr_hugepages
 sudo chmod a+rwX /dev/hugepages

 export RUST_BACKTRACE=1
-time cargo test $features "live_migration::$test_filter" -- --test-threads=1
+time cargo test $features "live_migration::$test_filter" -- --test-threads=1 ${test_binary_args[*]}
 RES=$?

 exit $RES
--- a/scripts/run_integration_tests_sgx.sh
+++ b/scripts/run_integration_tests_sgx.sh
@@ -27,7 +27,7 @@ strip target/$BUILD_TARGET/release/cloud-hypervisor

 export RUST_BACKTRACE=1

-time cargo test $features "sgx::$test_filter"
+time cargo test $features "sgx::$test_filter" -- ${test_binary_args[*]}
 RES=$?

 exit $RES
--- a/scripts/run_integration_tests_vfio.sh
+++ b/scripts/run_integration_tests_vfio.sh
@@ -21,7 +21,7 @@ strip target/$BUILD_TARGET/release/cloud-hypervisor

 export RUST_BACKTRACE=1

-time cargo test $features "vfio::$test_filter" -- --test-threads=1
+time cargo test $features "vfio::$test_filter" -- --test-threads=1 ${test_binary_args[*]}
 RES=$?

 exit $RES
--- a/scripts/run_integration_tests_windows.sh
+++ b/scripts/run_integration_tests_windows.sh
@@ -51,7 +51,7 @@ export RUST_BACKTRACE=1

 # Only run with 1 thread to avoid tests interfering with one another because
 # Windows has a static IP configured
-time cargo test $features "windows::$test_filter"
+time cargo test $features "windows::$test_filter" -- ${test_binary_args[*]}
 RES=$?

 dmsetup remove_all -f
--- a/scripts/run_integration_tests_x86_64.sh
+++ b/scripts/run_integration_tests_x86_64.sh
@@ -71,6 +71,23 @@ if [ ! -f "$FOCAL_OS_RAW_IMAGE" ]; then
    popd
 fi

+JAMMY_OS_IMAGE_NAME="jammy-server-cloudimg-amd64-custom-20220329-0.qcow2"
+JAMMY_OS_IMAGE_URL="https://cloud-hypervisor.azureedge.net/$JAMMY_OS_IMAGE_NAME"
+JAMMY_OS_IMAGE="$WORKLOADS_DIR/$JAMMY_OS_IMAGE_NAME"
+if [ ! -f "$JAMMY_OS_IMAGE" ]; then
+    pushd $WORKLOADS_DIR
+    time wget --quiet $JAMMY_OS_IMAGE_URL || exit 1
+    popd
+fi
+
+JAMMY_OS_RAW_IMAGE_NAME="jammy-server-cloudimg-amd64-custom-20220329-0.raw"
+JAMMY_OS_RAW_IMAGE="$WORKLOADS_DIR/$JAMMY_OS_RAW_IMAGE_NAME"
+if [ ! -f "$JAMMY_OS_RAW_IMAGE" ]; then
+    pushd $WORKLOADS_DIR
+    time qemu-img convert -p -f qcow2 -O raw $JAMMY_OS_IMAGE_NAME $JAMMY_OS_RAW_IMAGE_NAME || exit 1
+    popd
+fi
+
 ALPINE_MINIROOTFS_URL="http://dl-cdn.alpinelinux.org/alpine/v3.11/releases/x86_64/alpine-minirootfs-3.11.3-x86_64.tar.gz"
 ALPINE_MINIROOTFS_TARBALL="$WORKLOADS_DIR/alpine-minirootfs-x86_64.tar.gz"
 if [ ! -f "$ALPINE_MINIROOTFS_TARBALL" ]; then
@@ -107,39 +124,19 @@ popd

 # Build custom kernel based on virtio-pmem and virtio-fs upstream patches
 VMLINUX_IMAGE="$WORKLOADS_DIR/vmlinux"
+build_custom_linux

-LINUX_CUSTOM_DIR="$WORKLOADS_DIR/linux-custom"
-
-if [ ! -f "$VMLINUX_IMAGE" ]; then
-    SRCDIR=$PWD
+VIRTIOFSD="$WORKLOADS_DIR/virtiofsd"
+VIRTIOFSD_DIR="virtiofsd_build"
+if [ ! -f "$VIRTIOFSD" ]; then
    pushd $WORKLOADS_DIR
-    time git clone --depth 1 "https://github.com/cloud-hypervisor/linux.git" -b "ch-5.15.12" $LINUX_CUSTOM_DIR
-    cp $SRCDIR/resources/linux-config-x86_64 $LINUX_CUSTOM_DIR/.config
-    popd
-fi
-
-if [ ! -f "$VMLINUX_IMAGE" ]; then
-    pushd $LINUX_CUSTOM_DIR
-    time make bzImage -j `nproc`
-    cp vmlinux $VMLINUX_IMAGE || exit 1
-    popd
-fi
-
-if [ -d "$LINUX_CUSTOM_DIR" ]; then
-    rm -rf $LINUX_CUSTOM_DIR
-fi
-
-VIRTIOFSD_RS="$WORKLOADS_DIR/virtiofsd-rs"
-VIRTIOFSD_RS_DIR="virtiofsd_rs_build"
-if [ ! -f "$VIRTIOFSD_RS" ]; then
-    pushd $WORKLOADS_DIR
-    git clone "https://gitlab.com/virtio-fs/virtiofsd-rs.git" $VIRTIOFSD_RS_DIR
-    pushd $VIRTIOFSD_RS_DIR
-    git checkout 21d20035a582fb0389697b1bd7f8331623a77939
+    git clone "https://gitlab.com/virtio-fs/virtiofsd.git" $VIRTIOFSD_DIR
+    pushd $VIRTIOFSD_DIR
+    git checkout v1.1.0
    time cargo build --release
-    cp target/release/virtiofsd-rs $VIRTIOFSD_RS || exit 1
+    cp target/release/virtiofsd $VIRTIOFSD || exit 1
    popd
-    rm -rf $VIRTIOFSD_RS_DIR
+    rm -rf $VIRTIOFSD_DIR
    popd
 fi

@@ -174,12 +171,6 @@ cp $FW $VFIO_DIR
 cp $VMLINUX_IMAGE $VFIO_DIR || exit 1

 BUILD_TARGET="$(uname -m)-unknown-linux-${CH_LIBC}"
-CFLAGS=""
-TARGET_CC=""
-if [[ "${BUILD_TARGET}" == "x86_64-unknown-linux-musl" ]]; then
-TARGET_CC="musl-gcc"
-CFLAGS="-I /usr/include/x86_64-linux-musl/ -idirafter /usr/include/"
-fi

 cargo build --all  --release $features --target $BUILD_TARGET
 strip target/$BUILD_TARGET/release/cloud-hypervisor
@@ -196,19 +187,22 @@ sudo bash -c "echo 1000000 > /sys/kernel/mm/ksm/pages_to_scan"
 sudo bash -c "echo 10 > /sys/kernel/mm/ksm/sleep_millisecs"
 sudo bash -c "echo 1 > /sys/kernel/mm/ksm/run"

-# Both test_vfio and ovs-dpdk rely on hugepages
+# Both test_vfio, ovs-dpdk and vDPA tests rely on hugepages
 echo 6144 | sudo tee /proc/sys/vm/nr_hugepages
 sudo chmod a+rwX /dev/hugepages

+# Update max locked memory to 'unlimited' to avoid issues with vDPA
+ulimit -l unlimited
+
 export RUST_BACKTRACE=1
-time cargo test $features "parallel::$test_filter"
+time cargo test $features "parallel::$test_filter" -- ${test_binary_args[*]}
 RES=$?

 # Run some tests in sequence since the result could be affected by other tests
 # running in parallel.
 if [ $RES -eq 0 ]; then
    export RUST_BACKTRACE=1
-    time cargo test $features "sequential::$test_filter" -- --test-threads=1
+    time cargo test $features "sequential::$test_filter" -- --test-threads=1 ${test_binary_args[*]}
    RES=$?
 fi

--- a/scripts/run_metrics.sh
+++ b/scripts/run_metrics.sh
@@ -0,0 +1,120 @@
+#!/bin/bash
+set -x
+
+source $HOME/.cargo/env
+source $(dirname "$0")/test-util.sh
+
+export TEST_ARCH=$(uname -m)
+export BUILD_TARGET=${BUILD_TARGET-${TEST_ARCH}-unknown-linux-gnu}
+
+
+WORKLOADS_DIR="$HOME/workloads"
+mkdir -p "$WORKLOADS_DIR"
+
+build_fio() {
+    FIO_DIR="$WORKLOADS_DIR/fio_build"
+    FIO_REPO="https://github.com/axboe/fio.git"
+
+    checkout_repo "$FIO_DIR" "$FIO_REPO" master "1953e1adb5a28ed21370e85991d7f5c3cdc699f3"
+    if [ ! -f "$FIO_DIR/.built" ]; then
+        pushd $FIO_DIR
+        ./configure
+        make -j `nproc`
+        cp fio "$WORKLOADS_DIR/fio"
+        touch .built
+        popd
+    fi
+}
+
+process_common_args "$@"
+
+# For now these values are default for kvm
+features=""
+
+if [ "$hypervisor" = "mshv" ]; then
+    features="--no-default-features --features mshv,common"
+fi
+
+cp scripts/sha1sums-${TEST_ARCH} $WORKLOADS_DIR
+
+if [ ${TEST_ARCH} == "aarch64" ]; then
+     FOCAL_OS_IMAGE_NAME="focal-server-cloudimg-arm64-custom-20210929-0.qcow2"
+else
+     FOCAL_OS_IMAGE_NAME="focal-server-cloudimg-amd64-custom-20210609-0.qcow2"
+fi
+
+FOCAL_OS_IMAGE_URL="https://cloud-hypervisor.azureedge.net/$FOCAL_OS_IMAGE_NAME"
+FOCAL_OS_IMAGE="$WORKLOADS_DIR/$FOCAL_OS_IMAGE_NAME"
+if [ ! -f "$FOCAL_OS_IMAGE" ]; then
+    pushd $WORKLOADS_DIR
+    time wget --quiet $FOCAL_OS_IMAGE_URL || exit 1
+    popd
+fi
+
+if [ ${TEST_ARCH} == "aarch64" ]; then
+    FOCAL_OS_RAW_IMAGE_NAME="focal-server-cloudimg-arm64-custom-20210929-0.raw"
+else
+    FOCAL_OS_RAW_IMAGE_NAME="focal-server-cloudimg-amd64-custom-20210609-0.raw"
+fi
+
+FOCAL_OS_RAW_IMAGE="$WORKLOADS_DIR/$FOCAL_OS_RAW_IMAGE_NAME"
+if [ ! -f "$FOCAL_OS_RAW_IMAGE" ]; then
+    pushd $WORKLOADS_DIR
+    time qemu-img convert -p -f qcow2 -O raw $FOCAL_OS_IMAGE_NAME $FOCAL_OS_RAW_IMAGE_NAME || exit 1
+    popd
+fi
+
+pushd $WORKLOADS_DIR
+grep focal sha1sums-${TEST_ARCH} | sha1sum --check
+if [ $? -ne 0 ]; then
+    echo "sha1sum validation of images failed, remove invalid images to fix the issue."
+    exit 1
+fi
+popd
+
+if [ ${TEST_ARCH} == "aarch64" ]; then
+    build_fio
+
+    # Update the fio in the cloud image to use io_uring on AArch64
+    FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_NAME="focal-server-cloudimg-arm64-custom-20210929-0-update-tool.raw"
+    cp "$FOCAL_OS_RAW_IMAGE" "$WORKLOADS_DIR/$FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_NAME"
+    FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_ROOT_DIR="$WORKLOADS_DIR/focal-server-cloudimg-root"
+    if [ ! -d "$FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_ROOT_DIR" ]; then
+        mkdir -p "$FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_ROOT_DIR"
+    fi
+    # Mount the 'raw' image, replace the fio and umount the working folder
+    guestmount -a "$WORKLOADS_DIR/$FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_NAME" -m /dev/sda1 "$FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_ROOT_DIR" || exit 1
+    cp "$WORKLOADS_DIR"/fio "$FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_ROOT_DIR"/usr/bin/fio
+    guestunmount "$FOCAL_OS_RAW_IMAGE_UPDATE_TOOL_ROOT_DIR"
+fi
+
+# Build custom kernel based on virtio-pmem and virtio-fs upstream patches
+build_custom_linux
+
+BUILD_TARGET="${TEST_ARCH}-unknown-linux-${CH_LIBC}"
+CFLAGS=""
+TARGET_CC=""
+if [[ "${BUILD_TARGET}" == "${TEST_ARCH}-unknown-linux-musl" ]]; then
+    TARGET_CC="musl-gcc"
+    CFLAGS="-I /usr/include/${TEST_ARCH}-linux-musl/ -idirafter /usr/include/"
+fi
+
+cargo build --all --release $features --target $BUILD_TARGET
+strip target/$BUILD_TARGET/release/cloud-hypervisor
+strip target/$BUILD_TARGET/release/vhost_user_net
+strip target/$BUILD_TARGET/release/ch-remote
+strip target/$BUILD_TARGET/release/performance-metrics
+
+# setup hugepages
+echo 6144 | sudo tee /proc/sys/vm/nr_hugepages
+sudo chmod a+rwX /dev/hugepages
+
+if [ -n "$test_filter" ]; then
+    test_binary_args+=("--test-filter $test_filter")
+fi
+
+export RUST_BACKTRACE=1
+time target/$BUILD_TARGET/release/performance-metrics ${test_binary_args[*]}
+RES=$?
+
+exit $RES
--- a/scripts/run_unit_tests.sh
+++ b/scripts/run_unit_tests.sh
@@ -1,16 +1,22 @@
 #!/bin/bash

 source $HOME/.cargo/env
-source  $(dirname "$0")/test-util.sh
+source $(dirname "$0")/test-util.sh

 process_common_args "$@"

 BUILD_TARGET=${BUILD_TARGET-x86_64-unknown-linux-gnu}
 cargo_args=("")

-if [[ $(uname -m) = "aarch64" || $hypervisor = "mshv" ]]; then
+if [[ $hypervisor = "mshv" ]]; then
    cargo_args+=("--no-default-features")
-    cargo_args+=("--features $hypervisor")
+    cargo_args+=("--features common,$hypervisor")
 fi
+
+if [[ "${BUILD_TARGET}" == "aarch64-unknown-linux-musl" ]]; then
+    export TARGET_CC="musl-gcc"
+    export RUSTFLAGS="-C link-arg=-lgcc -C link_arg=-specs -C link_arg=/usr/lib/aarch64-linux-musl/musl-gcc.specs"
+fi
+
 export RUST_BACKTRACE=1
-cargo test --lib --bins --target $BUILD_TARGET --workspace ${cargo_args[@]} || exit 1;
+cargo test --lib --bins --target $BUILD_TARGET --workspace ${cargo_args[@]} || exit 1
--- a/scripts/sha1sums-aarch64
+++ b/scripts/sha1sums-aarch64
@@ -4,3 +4,5 @@
 e4addb6e212a298144f9eb0eb6e36019d013f0e7  alpine-minirootfs-aarch64.tar.gz
 25b4f9ac308898d63b73d7db0e0e2d4768853723  focal-server-cloudimg-arm64-custom-20210929-0.qcow2
 9953b31bb1923cdd8d91b1b7cc9ad3a9be1e0a59  focal-server-cloudimg-arm64-custom-20210929-0.raw
+7118f4d4cad18c8357bc2ad9824a50f9a82a860a  jammy-server-cloudimg-arm64-custom-20220329-0.qcow2
+1f2b71be43b8f748f01306c4454e5c921343faa4  jammy-server-cloudimg-arm64-custom-20220329-0.raw
--- a/scripts/sha1sums-x86_64
+++ b/scripts/sha1sums-x86_64
@@ -3,3 +3,5 @@
 d4a44acc6014d5f83dea1c625c43d677a95fa75f alpine-minirootfs-x86_64.tar.gz
 f1eccdc5e1b515dbad294426ab081b47ebfb97c0 focal-server-cloudimg-amd64-custom-20210609-0.qcow2
 7f5a8358243a96adf61f5c20139b29f308f2c0e3 focal-server-cloudimg-amd64-custom-20210609-0.raw
+272102ac243e544bc5c2303f383eeb217bd2e446 jammy-server-cloudimg-amd64-custom-20220329-0.qcow2
+0b5b4816a0976c458f8e8bab061e9d63ebc1b806 jammy-server-cloudimg-amd64-custom-20220329-0.raw
--- a/scripts/test-util.sh
+++ b/scripts/test-util.sh
@@ -2,6 +2,68 @@
 hypervisor="kvm"
 test_filter=""

+# Checkout source code of a GIT repo with specified branch and commit
+# Args:
+#   $1: Target directory
+#   $2: GIT URL of the repo
+#   $3: Required branch
+#   $4: Required commit (optional)
+checkout_repo() {
+    SRC_DIR="$1"
+    GIT_URL="$2"
+    GIT_BRANCH="$3"
+    GIT_COMMIT="$4"
+
+    # Check whether the local HEAD commit same as the requested commit or not.
+    # If commit is not specified, compare local HEAD and remote HEAD.
+    # Remove the folder if there is difference.
+    if [ -d "$SRC_DIR" ]; then
+        pushd $SRC_DIR
+        git fetch
+        SRC_LOCAL_COMMIT=$(git rev-parse HEAD)
+        if [ -z "$GIT_COMMIT" ]; then
+            GIT_COMMIT=$(git rev-parse remotes/origin/"$GIT_BRANCH")
+        fi
+        popd
+        if [ "$SRC_LOCAL_COMMIT" != "$GIT_COMMIT" ]; then
+            rm -rf "$SRC_DIR"
+        fi
+    fi
+
+    # Checkout the specified branch and commit (if required)
+    if [ ! -d "$SRC_DIR" ]; then
+        git clone --depth 1 "$GIT_URL" -b "$GIT_BRANCH" "$SRC_DIR"
+        if [ "$GIT_COMMIT" ]; then
+            pushd "$SRC_DIR"
+            git fetch --depth 1 origin "$GIT_COMMIT"
+            git reset --hard FETCH_HEAD
+            popd
+        fi
+    fi
+}
+
+build_custom_linux() {
+    ARCH=$(uname -m)
+    SRCDIR=$PWD
+    LINUX_CUSTOM_DIR="$WORKLOADS_DIR/linux-custom"
+    LINUX_CUSTOM_BRANCH="ch-5.15.12"
+    LINUX_CUSTOM_URL="https://github.com/cloud-hypervisor/linux.git"
+
+    checkout_repo "$LINUX_CUSTOM_DIR" "$LINUX_CUSTOM_URL" "$LINUX_CUSTOM_BRANCH"
+
+    cp $SRCDIR/resources/linux-config-${ARCH} $LINUX_CUSTOM_DIR/.config
+
+    pushd $LINUX_CUSTOM_DIR
+    make -j `nproc`
+    if [ ${ARCH} == "x86_64" ]; then
+       cp vmlinux "$WORKLOADS_DIR/" || exit 1
+    elif [ ${ARCH} == "aarch64" ]; then
+       cp arch/arm64/boot/Image "$WORKLOADS_DIR/" || exit 1
+       cp arch/arm64/boot/Image.gz "$WORKLOADS_DIR/" || exit 1
+    fi
+    popd
+}
+
 cmd_help() {
    echo ""
    echo "Cloud Hypervisor $(basename $0)"
@@ -28,12 +90,20 @@ process_common_args() {
                shift
                test_filter="$1"
                ;;
+            "--") {
+                shift
+                break
+            } ;;
            *)
-		;;
+                echo "Unknown test scripts argument: $1. Please use '-- --help' for help."
+                exit
+                ;;
 	esac
 	shift
    done
    if [[ ! ("$hypervisor" = "kvm" ||  "$hypervisor" = "mshv") ]]; then
        die "Hypervisor value must be kvm or mshv"
    fi
+
+    test_binary_args=($@)
 }
--- a/Show More
+++ b/Show More