Skip to content
This repository was archived by the owner on Jul 13, 2026. It is now read-only.

Rename GuestMemory->GuestMemoryBackend, IoMemory->GuestMemory - #362

Merged
bonzini merged 5 commits into
rust-vmm:mainfrom
bonzini:rename-iomemory
Dec 2, 2025
Merged

Rename GuestMemory->GuestMemoryBackend, IoMemory->GuestMemory #362
bonzini merged 5 commits into
rust-vmm:mainfrom
bonzini:rename-iomemory

Conversation

@bonzini

@bonzini bonzini commented Nov 7, 2025

Copy link
Copy Markdown
Member

Summary of the PR

As discussed in #327, make the main interface to vm-memory the one that includes permissions and lets fewer aspects of the implementation through.

Based on #361.

Requirements

Before submitting your PR, please make sure you addressed the following
requirements:

  • All commits in this PR have Signed-Off-By trailers (with
    git commit -s), and the commit message has max 60 characters for the
    summary and max 75 characters for each description line.
  • All added/changed functionality has a corresponding unit/integration
    test.
  • All added/changed public-facing functionality has entries in the "Upcoming
    Release" section of CHANGELOG.md (if no such section exists, please create one).
  • Any newly added unsafe code is properly documented.

@bonzini
bonzini force-pushed the rename-iomemory branch 2 times, most recently from a97d0e1 to 569b637 Compare November 7, 2025 09:58
@bonzini

bonzini commented Nov 7, 2025

Copy link
Copy Markdown
Member Author

I'm not sure if this should be 0.18.0 or 0.19.0.

@XanClic, I think the current main branch causes some breakage for vhost_kern? If so, the "semver trick" release should be 0.18.0 and the one with renamed symbols would be 0.19.0. Then 0.18.0 would be an easy upgrade for everyone except vhost_kern, whereas 0.19.0 could be more tricky.

@bonzini
bonzini marked this pull request as draft November 7, 2025 10:00
@bonzini bonzini changed the title Rename iomemory Rename GuestMemory->GuestMemoryBackend, IoMemory->GuestMemory Nov 7, 2025
@likebreath likebreath mentioned this pull request Nov 7, 2025
4 tasks
Comment thread CHANGELOG.md Outdated
Comment thread src/guest_memory.rs Outdated
Comment thread src/guest_memory.rs Outdated
Comment thread src/guest_memory.rs
@XanClic

XanClic commented Nov 10, 2025

Copy link
Copy Markdown
Collaborator

Thanks! 🙂

@XanClic

XanClic commented Nov 11, 2025

Copy link
Copy Markdown
Collaborator

Do you want to keep IoMemorySliceIterator and GuestMemorySliceIterator as they are or rename them, too?

Rename GuestMemory to GuestMemoryBackend, IoMemory to GuestMemory.
This allows users of vm-memory to be aware of access permissions
for memory, with no change to callers that just use the `Bytes`
interface.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
@bonzini
bonzini marked this pull request as ready for review November 25, 2025 11:50
Also rename IoMemorySliceIterator to GuestMemorySliceIterator, and
GuestMemorySliceIterator to GusetMemoryBackendSliceIterator.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
After the rename, the primary interface to vm-memory is almost
completely absent in DESIGN.md.  Give it more importance and
remove some details of GuestMemoryBackend that are now
obsolete.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
@bonzini
bonzini enabled auto-merge (rebase) November 25, 2025 11:55
@bonzini

bonzini commented Nov 25, 2025

Copy link
Copy Markdown
Member Author

@roypat does it look good? I also prepared #366 for the next 0.17 version.

@bonzini

bonzini commented Dec 1, 2025

Copy link
Copy Markdown
Member Author

Let's merge this, if there are no other remarks, at the end of this week.

@roypat roypat left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry for the late review!

@bonzini
bonzini merged commit b6404d2 into rust-vmm:main Dec 2, 2025
2 checks passed
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants