Skip to contentSkip to conversation

Fix installation instructions for Debian/Ubuntu

PATCH Superseded Thomas Huth 3 participants 5 messages Jun 29, 2023

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Fix installation instructions for Debian/Ubuntu

There is no package called "qemu" here - thus use the two meta-packages "qemu-system" and "qemu-user" instead.

Resolves: https://gitlab.com/qemu-project/qemu-web/-/issues/8

---
 _download/linux.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
_download/linux.md +1 -1
index 11ed695..bb76425 100644
@@ -2,7 +2,7 @@ QEMU is packaged by most Linux distributions:
 
 * <strong>Arch:</strong> `pacman -S qemu`
 
-* <strong>Debian/Ubuntu:</strong> `apt-get install qemu`
+* <strong>Debian/Ubuntu:</strong> `apt-get install qemu-system qemu-user`
 
 * <strong>Fedora:</strong> `dnf install @virtualization`
 
Signature · 1 line
2.39.3
#1 lore raw
Quoted 2 lines · Thomas Huth

There is no package called "qemu" here - thus use the two meta-packages "qemu-system" and "qemu-user" instead.

There are 2 questions here.

1. Do we really want to suggest users to install the whole thing? qemu-user and qemu-system are two entirely different beasts, used for entirely different purposes. This is exactly the reason why I dropped `qemu' package from debian/ubuntu, - because effectively there are two independent, entirely different packages.

Also 1.a, - again, whole qemu-system usually isn't needed. There are another 2 big different classes here, - native thing (probably with kvm), and foreign thing.

Quoted 1 line

Resolves: https://gitlab.com/qemu-project/qemu-web/-/issues/8

..> -* <strong>Debian/Ubuntu:</strong> apt-get install qemu

Quoted 1 line

+* <strong>Debian/Ubuntu:</strong> apt-get install qemu-system qemu-user

2. There are 2 qemu-user packages on debian/ubuntu: it is qemu-user and qemu-user-static. My guess is that most users actually need the latter, at least this one lets to run foreign chroots without copying anything from host system to a chroot. In rare cases when one wants to install and run foreign binaries directly into the host system, qemu-user is okay. But it is a really rare case, and usually combined with running foreign chroots anyway.

So I'd say this whole thing needs a bit more explanation, like,

when you want to run qemu-system emulation, install qemu-system (meta)package. when you want user-mode emulation, install qemu-user-static package.

Or something like this.

This is actually a question to QEMU upstream, - I think the same reasoning applies there as well.

Thanks,

/mjt

#2 lore raw
Quoted 29 lines · Michael Tokarev
Quoted 2 lines · Thomas Huth

There is no package called "qemu" here - thus use the two meta-packages "qemu-system" and "qemu-user" instead.

There are 2 questions here.

1. Do we really want to suggest users to install the whole thing? qemu-user and qemu-system are two entirely different beasts, used for entirely different purposes.  This is exactly the reason why I dropped `qemu' package from debian/ubuntu, - because effectively there are two independent, entirely different packages.

Also 1.a, - again, whole qemu-system usually isn't needed. There are another 2 big different classes here, - native thing (probably with kvm), and foreign thing.

Quoted 1 line

Resolves: https://gitlab.com/qemu-project/qemu-web/-/issues/8

..> -* <strong>Debian/Ubuntu:</strong> apt-get install qemu

Quoted 2 lines

+* <strong>Debian/Ubuntu:</strong> apt-get install qemu-system qemu-user

2.  There are 2 qemu-user packages on debian/ubuntu: it is qemu-user and qemu-user-static. My guess is that most users actually need the latter, at least this one lets to run foreign chroots without copying anything from host system to a chroot.  In rare cases when one wants to install and run foreign binaries directly into the host system, qemu-user is okay. But it is a really rare case, and usually combined with running foreign chroots anyway.

Quoted 7 lines

So I'd say this whole thing needs a bit more explanation, like,

 when you want to run qemu-system emulation, install qemu-system
(meta)package.
 when you want user-mode emulation, install qemu-user-static package.

Or something like this.

Or link to the Debian wiki where the qemu packages are explained :)

Quoted 8 lines

This is actually a question to QEMU upstream, - I think the same reasoning applies there as well.

Thanks,

/mjt

#3 lore raw
In reply to Michael Tokarev
Quoted 28 lines · Michael Tokarev
Quoted 2 lines · Thomas Huth

There is no package called "qemu" here - thus use the two meta-packages "qemu-system" and "qemu-user" instead.

There are 2 questions here.

1. Do we really want to suggest users to install the whole thing? qemu-user and qemu-system are two entirely different beasts, used for entirely different purposes.  This is exactly the reason why I dropped `qemu' package from debian/ubuntu, - because effectively there are two independent, entirely different packages.

Also 1.a, - again, whole qemu-system usually isn't needed. There are another 2 big different classes here, - native thing (probably with kvm), and foreign thing.

Quoted 1 line

Resolves: https://gitlab.com/qemu-project/qemu-web/-/issues/8

..> -* <strong>Debian/Ubuntu:</strong> apt-get install qemu

Quoted 1 line

+* <strong>Debian/Ubuntu:</strong> apt-get install qemu-system qemu-user

2.  There are 2 qemu-user packages on debian/ubuntu: it is qemu-user and qemu-user-static. My guess is that most users actually need the latter, at least this one lets to run foreign chroots without copying anything from host system to a chroot.  In rare cases when one wants to install and run foreign binaries directly into the host system, qemu-user is okay. But it is a really rare case, and usually combined with running foreign chroots anyway.

Quoted 5 lines

So I'd say this whole thing needs a bit more explanation, like,

 when you want to run qemu-system emulation, install qemu-system
(meta)package.
 when you want user-mode emulation, install qemu-user-static package.

Ok, thanks, makes sense, I sent a v2 where I've split it.

Quoted 2 lines

This is actually a question to QEMU upstream, - I think the same reasoning applies there as well.

Looking at our docs, it seems like we're lacking an introduction to the the "configure" switches like --enable-system and --enable-user completely, indeed :-(

Thomas

#4 lore raw

29.06.2023 12:31, Thomas Huth wrote:
..

Quoted 4 lines
Quoted 2 lines

This is actually a question to QEMU upstream, - I think the same reasoning applies there as well.

Looking at our docs, it seems like we're lacking an introduction to the the "configure" switches like --enable-system and --enable-user completely, indeed :-(

When I come to qemu 10+ years ago, it was somehow very difficult to understand what's qemu-user and what's qemu-system. Now it is obvious, like breathing, but that's after 10+ years.. ;))

/mjt