On Thu, Aug 13, 2026 at 01:48:21PM +0100, Daniel P. Berrangé wrote:
> On Thu, Aug 13, 2026 at 08:28:24AM -0400, Peter Xu wrote:
> > On Thu, Aug 13, 2026 at 09:24:22AM +0100, Daniel P. Berrangé wrote:
> > > On Wed, Aug 12, 2026 at 03:16:46PM -0500, Michael Roth wrote:
> > > > From: Peter Xu <[email protected]>
> > > > 
> > > > Host backends supports guest-memfd now by detecting whether it's a
> > > > confidential VM.  There's no way to choose it yet from the memory level 
> > > > to
> > > > use it fully shared.  If we use guest-memfd, it so far always implies we
> > > > need two layers of memory backends, while the guest-memfd only provides 
> > > > the
> > > > private set of pages.
> > > > 
> > > > This patch introduces a way so that QEMU can consume guest memfd as the
> > > > only source of memory to back the object (aka, fully shared).
> > > > 
> > > > To use the fully shared guest-memfd, one can add a memfd object with:
> > > > 
> > > >   -object memory-backend-memfd,guest-memfd=on,share=on
> > > > 
> > > > Note that share=on is required with fully shared guest_memfd.
> > > > 
> > > > PS: there's a trivial touch-up on fd<0 check, because the stub to create
> > > > guest-memfd may return negative but not -1.
> > > > 
> > > > Signed-off-by: Peter Xu <[email protected]>
> > > > Reviewed-by: Xiaoyao Li <[email protected]>
> > > > Reviewed-by: Fabiano Rosas <[email protected]>
> > > > Signed-off-by: Michael Roth <[email protected]>
> > > > ---
> > > >  backends/hostmem-memfd.c | 56 ++++++++++++++++++++++++++++++++++++----
> > > >  qapi/qom.json            |  6 ++++-
> > > >  2 files changed, 56 insertions(+), 6 deletions(-)
> > > > 
> > > > diff --git a/backends/hostmem-memfd.c b/backends/hostmem-memfd.c
> > > > index ea93f034e4..fbe65b00be 100644
> > > > --- a/backends/hostmem-memfd.c
> > > > +++ b/backends/hostmem-memfd.c
> > > > @@ -18,6 +18,8 @@
> > > >  #include "qapi/error.h"
> > > >  #include "qom/object.h"
> > > >  #include "migration/cpr.h"
> > > > +#include "system/kvm.h"
> > > > +#include <linux/kvm.h>
> > > >  
> > > >  OBJECT_DECLARE_SIMPLE_TYPE(HostMemoryBackendMemfd, 
> > > > MEMORY_BACKEND_MEMFD)
> > > >  
> > > > @@ -28,6 +30,13 @@ struct HostMemoryBackendMemfd {
> > > >      bool hugetlb;
> > > >      uint64_t hugetlbsize;
> > > >      bool seal;
> > > > +    /*
> > > > +     * NOTE: this differs from HostMemoryBackend's guest_memfd_private,
> > > > +     * which represents an internally private guest-memfd that only 
> > > > backs
> > > > +     * private pages.  Instead, this flag marks the memory backend will
> > > > +     * 100% use the guest-memfd pages in-place.
> > > > +     */
> > > > +    bool guest_memfd;
> > > >  };
> > > >  
> > > >  static bool
> > > > @@ -47,11 +56,29 @@ memfd_backend_memory_alloc(HostMemoryBackend 
> > > > *backend, Error **errp)
> > > >          goto have_fd;
> > > >      }
> > > >  
> > > > -    fd = qemu_memfd_create(TYPE_MEMORY_BACKEND_MEMFD, backend->size,
> > > > -                           m->hugetlb, m->hugetlbsize, m->seal ?
> > > > -                           F_SEAL_GROW | F_SEAL_SHRINK | F_SEAL_SEAL : 
> > > > 0,
> > > > -                           errp);
> > > > -    if (fd == -1) {
> > > > +    if (m->guest_memfd) {
> > > > +        if (!backend->share) {
> > > > +            error_setg(errp, "guest-memfd=on must be used with 
> > > > share=on");
> > > > +            return false;
> > > > +        } else if (m->seal) {
> > > > +            error_setg(errp, "guest-memfd=on must be used with 
> > > > seal=off");
> > > > +            return false;
> > > > +        } else if (m->hugetlb) {
> > > > +            error_setg(errp, "guest-memfd=on must be used with 
> > > > hugetlb=off");
> > > 
> > > Reporting an error without returning false like the other cases.
> > > 
> > > > +        }
> > > > +
> > > > +        fd = kvm_create_guest_memfd(backend->size,
> > > > +                                    GUEST_MEMFD_FLAG_MMAP |
> > > > +                                    GUEST_MEMFD_FLAG_INIT_SHARED,
> > > > +                                    errp);
> > > > +    } else {
> > > > +        fd = qemu_memfd_create(TYPE_MEMORY_BACKEND_MEMFD, 
> > > > backend->size,
> > > > +                               m->hugetlb, m->hugetlbsize, m->seal ?
> > > > +                               F_SEAL_GROW | F_SEAL_SHRINK | 
> > > > F_SEAL_SEAL : 0,
> > > > +                               errp);
> > > > +    }
> > > > +
> > > > +    if (fd < 0) {
> > > >          return false;
> > > >      }
> > > >      cpr_save_fd(name, 0, fd);
> > > > @@ -65,6 +92,18 @@ have_fd:
> > > >                                            backend->size, ram_flags, 
> > > > fd, 0, errp);
> > > >  }
> > > >  
> > > > +static bool
> > > > +memfd_backend_get_guest_memfd(Object *o, Error **errp)
> > > > +{
> > > > +    return MEMORY_BACKEND_MEMFD(o)->guest_memfd;
> > > > +}
> > > > +
> > > > +static void
> > > > +memfd_backend_set_guest_memfd(Object *o, bool value, Error **errp)
> > > > +{
> > > > +    MEMORY_BACKEND_MEMFD(o)->guest_memfd = value;
> > > > +}
> > > > +
> > > >  static bool
> > > >  memfd_backend_get_hugetlb(Object *o, Error **errp)
> > > >  {
> > > > @@ -152,6 +191,13 @@ memfd_backend_class_init(ObjectClass *oc, const 
> > > > void *data)
> > > >          object_class_property_set_description(oc, "hugetlbsize",
> > > >                                                "Huge pages size (ex: 
> > > > 2M, 1G)");
> > > >      }
> > > > +
> > > > +    object_class_property_add_bool(oc, "guest-memfd",
> > > > +                                   memfd_backend_get_guest_memfd,
> > > > +                                   memfd_backend_set_guest_memfd);
> > > > +    object_class_property_set_description(oc, "guest-memfd",
> > > > +                                          "Use guest memfd");
> > > > +
> > > >      object_class_property_add_bool(oc, "seal",
> > > >                                     memfd_backend_get_seal,
> > > >                                     memfd_backend_set_seal);
> > > > diff --git a/qapi/qom.json b/qapi/qom.json
> > > > index c55776af7d..ee981fc44c 100644
> > > > --- a/qapi/qom.json
> > > > +++ b/qapi/qom.json
> > > > @@ -771,13 +771,17 @@
> > > >  # @seal: if true, create a sealed-file, which will block further
> > > >  #     resizing of the memory (default: true)
> > > >  #
> > > > +# @guest-memfd: if true, use guest-memfd to back the memory region.
> > > > +#     (default: false, since: 11.2)
> > > > +#
> > > >  # Since: 2.12
> > > >  ##
> > > >  { 'struct': 'MemoryBackendMemfdProperties',
> > > >    'base': 'MemoryBackendProperties',
> > > >    'data': { '*hugetlb': 'bool',
> > > >              '*hugetlbsize': 'size',
> > > > -            '*seal': 'bool' },
> > > > +            '*seal': 'bool',
> > > > +            '*guest-memfd': 'bool' },
> > > >    'if': 'CONFIG_LINUX' }
> > > 
> > > We're reusing the 'memory-backend-memfd' class, and then at runtime
> > > refusing allow the user to control any of properties in
> > > MemoryBackendProperties.
> > 
> > gmemfd should be able to use all ultimately.
> > 
> > For seal, IMHO it's already implied, kind of forced seal=on but it doesn't
> > matter, gmemfd was introduced with sealing, at least what QEMU implies with
> > "F_SEAL_GROW | F_SEAL_SHRINK | F_SEAL_SEAL".  So IMHO we could ignore what
> > user selected and assume it's ON.
> 
> Then we should not have a 'seal' property defined for guest memfd
> at all. Defining a property and then ignoring it, or only ever
> allowing 1 value to be set is a design mistake. The property should
> not exist if it can't ever be changed by the user/app.
> 
> > For hugetlb, we will support hugetlb (and allow specify hugetlb size) for
> > gmem in the future I believe.  It's only that this is done one step at a
> > time so we haven't supported it yet, while the kernel support is still in
> > progress.
> 
> The problem with this idea is that it makes it impossible for a mgmt
> app to know if hugetlb is supported or not, as QEMU will always
> report it supported against memory-backend-memfd.
> 
> Having a memory-backend-guest-memfd ensures the public interface
> matches what is actually implemented/permitted for guest memfd.
> 
> > > "memory-backend-memfd,guest-memfd=on|off" is switching between two
> > > separate implementations of the class.
> > > 
> > > This whole thing is just shouting "use a different class".
> > > 
> > > There is no meaningful sharing of code here, and the sharing of the
> > > public interface is offering apps no value as the impl prevents them
> > > from choosing the value of the properties - they have to be set of
> > > certain values which are not introspectable.
> > > 
> > > Please introduce a "memory-backend-guest-memfd" backend instead.
> > 
> > This is indeed what Michael used to suggest, and we were discussing in
> > previous version on which is better,
> > 
> > https://lore.kernel.org/r/rjqfiwh57gip3u3psqg33jhmo7ixaj2qwzupc7zdk7f3d26qnu@tglactz67ogk
> > 
> > The hope is this is also easier for either libvirt or most users, but
> > please correct me if it's not the case, especially for libvirt.  The plan
> > is when CoCo flags are provided, all things will automatically switch to a
> > CoCo-friendly implementation within QEMU.
> > 
> > It also means here the guest-memfd= parameter shouldn't be needed in real
> > CoCo contexts because they'll simply be implied (no cmdline change needed
> > for the same "-object memory-backend-memfd" one used to use without CoCo).
> > It's only needed for only special use of guest-memfd, in this case
> > init-shared is the special case where CoCo doesn't use.
> 
> Reading all this, IMHO reusing memory-backend-memfd for the current
> Coco support was a design mistake, it should have have a
> memory-backend-guest-memfd object from the start.
> 
> Given that we need to be able to control memfd vs guest-memfd for
> the non-Coco case, it is still worth introducing the new object
> class today.
> 
> Even if the two classes shared all their properties (which they
> don't given the comment about 'seal' being always on), then a
> "foo=on|off" that toggles two separate impls is still creating
> a pair of sub-classes by the backdoor. 

The idea of that, at least in my mind.. is an user shouldn't need to worry
about differences of guest-memfd and memfd, QEMU should just do it for the
users, based on the machine configurations.  Memfd is a concept more widely
spread, the hope is anyone using guest-memfd should simply treat it as one
memfd, no matter it is shared, in-place converted, two-layer-backed, or
whatever is happening underneath.

Now we do create guest-memfd via a separate ioctl, what if we can create it
via memfd_create() syscall too?  Then do we need to do the separation from
QEMU layer?

IMHO that is now an ioctl is not required; it really can be part of
memfd_create() syscall, it's just easier to manage, e.g. it's completely
KVM alone, and it also has attached to the KVM instance.  The idea is still
similar, and we can see that from possibly shared properties here on huge
pages and so.  I don't treat seal= a block just to introduce a new object
for that, and I expect as gmemfd evolves it will gradually get most
features memfd supports.. like folio migration and so.. but I could be
wrong.

IMHO one major question to ask is, is it more convenient for libvirt to
have that new object?  Please keep in mind that after we introduce this as
a new object, we may start to introduce even more *-guest-memfd in the
future, we roughly talked about DAX in the previous discussion.  My goal is
to make it most convenient for either user or libvirt to maintain the
cmdlines for QEMU, but if you think that makes libvirt live harder instead,
I've no strong feeling to go back to what Michael initially suggested.

For example, if libvirt wants to detect hugetlb supports for an object, it
can still pass in the parameters and test-boot a QEMU and then IIUC it'll
still correctly capture an error for gmemfd case.  It might be that I
didn't really get what will make libvirt complex by reusing the object, but
I'll definitely follow your judgement on that.

Thanks,

-- 
Peter Xu


Reply via email to