Skip to content

OpenVMM/microVM umbrella: snapshot publication, the manifest, block identity, and restore claims #1180

Open
11 of 12 issues completed

Description

Objective. A snapshot is restorable exactly when its publication committed; its manifest's format and admitted command line are those that NVX and upstream OpenVMM agree on; restore refuses a malformed manifest, artifact, or RAM range with an error, not a panic, before it claims a resume snapshot; and sandbox blocks are identified only by their storage generation, as the architecture guide describes.

Children.

Issue Scope Blocked by
#557 Identify snapshot blocks only by storage generation, and stop hashing block artifacts. —
#1144 Unlinking the source's RAM file changes the inode's ctime, which invalidates an already-opened snapshot. —
#1153 A failed cleanup after a failed publication can leave a restorable snapshot while the source resumes. —
#1362 Outside Linux glibc builds, so in NVX's MSHV (musl) and WHP builds, publication's final rename replaces an empty destination directory that another process created. —
#1210 Align the manifest's tags with upstream SaveVM/RestoreVM (microsoft/openvmm#4553): give tag 8 to upstream's snapshot_id, move state_size_bytes, bump the version, and refuse v6 manifests with a recapture diagnostic. —
#995 Admit a closed set of guest kernel tuning parameters, such as mitigations=off, on a platform snapshot's command line at publication and restore, then let an adapter's templates boot with them. —
#1361 Opening a snapshot whose paired scratch has an unknown restore_mode panics instead of refusing it. —
#1364 The memory-expansion range math overflows near the top of the GPA space, so a crafted manifest panics a debug build. —
#1373 The VM worker accepts decoded snapshot or restore RAM ranges that are unaligned or reversed, and load can then panic merging them. —
#1154 A writerless FIFO in place of a snapshot artifact hangs restore before validation. —
#1157 A nonregular paired scratch.img passes opening, so preparation can consume the resume claim before it fails. #1154
#565 Claim a resume snapshot before linking its direct-claimed scratch. #1157

Order. #1154, then #1157, then #565:

No other child blocks another. Outside this umbrella, #760 (the management RPC) is blocked by #557.

Notes.

Activity

  1. changed the title [-]OpenVMM/microVM umbrella: snapshot publication, block identity, and restore claims[/-] [+]OpenVMM/microVM umbrella: snapshot publication, the manifest, block identity, and restore claims[/+] on Nov 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

area: openvmmInitial title-keyword triage suggestionarea: snapshotInitial title-keyword triage suggestion

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions