Skip to contentSkip to conversation

docs: Document removal of 64-bit on 32-bit emulation

PATCH In review Richard Henderson 5 participants 6 messages Apr 12, 2025 – Apr 14, 2025

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 docs: Document removal of 64-bit on 32-bit emulation

With acce728cbc6c we disallowed configuring 64-bit guests on 32-bit hosts, but forgot to document that in removed-features.

---
 docs/about/removed-features.rst | 9 +++++++++
 1 file changed, 9 insertions(+)
docs/about/removed-features.rst +9 -0
index 2527a91795..790a5e481c 100644
@@ -858,6 +858,15 @@ QEMU.  Since all recent x86 hardware from the past >10 years is
 capable of the 64-bit x86 extensions, a corresponding 64-bit OS should
 be used instead.
 
+32-bit hosts for 64-bit guests (removed in 10.0)
+''''''''''''''''''''''''''''''''''''''''''''''''
+
+In general, 32-bit hosts cannot support the memory space or atomicity
+requirements of 64-bit guests.  Prior to 10.0, QEMU attempted to
+work around the atomicity issues in system mode by running all vCPUs
+in a single thread context; in user mode atomicity was simply broken.
+From 10.0, QEMU has disabled configuration of 64-bit guests on 32-bit hosts.
+
 Guest Emulator ISAs
 -------------------
 
Signature · 1 line
2.43.0
Reviewed-by on v1 1/1
#1 lore raw
Quoted 17 lines · Richard Henderson

With acce728cbc6c we disallowed configuring 64-bit guests on 32-bit hosts, but forgot to document that in removed-features.

---
 docs/about/removed-features.rst | 9 +++++++++
 1 file changed, 9 insertions(+)
docs/about/removed-features.rst +1 -0
index 2527a91795..790a5e481c 100644
@@ -858,6 +858,15 @@ QEMU.  Since all recent x86 hardware from the past >10 years is
 capable of the 64-bit x86 extensions, a corresponding 64-bit OS should
 be used instead.
 
+32-bit hosts for 64-bit guests (removed in 10.0)

docs/about/removed-features.rst QEMU. Since all recent x86 hardware from the past >10 years is · line 871

Quoted 10 lines
docs/about/removed-features.rst +8 -0
+''''''''''''''''''''''''''''''''''''''''''''''''
+
+In general, 32-bit hosts cannot support the memory space or atomicity
+requirements of 64-bit guests.  Prior to 10.0, QEMU attempted to
+work around the atomicity issues in system mode by running all vCPUs
+in a single thread context; in user mode atomicity was simply broken.
+From 10.0, QEMU has disabled configuration of 64-bit guests on 32-bit hosts.
+
 Guest Emulator ISAs
 -------------------

With regards,
Daniel

Signature · 3 lines
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|
#4 lore raw
In reply to Richard Henderson
Quoted 8 lines · Richard Henderson

With acce728cbc6c we disallowed configuring 64-bit guests on 32-bit hosts, but forgot to document that in removed-features.

---
 docs/about/removed-features.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

Merged for 10.0 via Michael Tokarev's trivial patches pull request.

Stefan

Quoted 24 lines
docs/about/removed-features.rst +9 -1
index 2527a91795..790a5e481c 100644
@@ -858,6 +858,15 @@ QEMU.  Since all recent x86 hardware from the past >10 years is
 capable of the 64-bit x86 extensions, a corresponding 64-bit OS should
 be used instead.
 
+32-bit hosts for 64-bit guests (removed in 10.0)
+''''''''''''''''''''''''''''''''''''''''''''''''
+
+In general, 32-bit hosts cannot support the memory space or atomicity
+requirements of 64-bit guests.  Prior to 10.0, QEMU attempted to
+work around the atomicity issues in system mode by running all vCPUs
+in a single thread context; in user mode atomicity was simply broken.
+From 10.0, QEMU has disabled configuration of 64-bit guests on 32-bit hosts.
+
 Guest Emulator ISAs
 -------------------
 
--

2.43.0

#5 lore raw
Quoted 6 lines · Stefan Hajnoczi
Quoted 4 lines · Richard Henderson

With acce728cbc6c we disallowed configuring 64-bit guests on 32-bit hosts, but forgot to document that in removed-features.

Quoted 6 lines
Quoted 4 lines
---
  docs/about/removed-features.rst | 9 +++++++++
  1 file changed, 9 insertions(+)

Merged for 10.0 via Michael Tokarev's trivial patches pull request.

Thanks, guys.

r~