Group: Software/FSDG distributions/DistroExecutionEnvironments
Contents
Introduction
The Free System Distribution Guidelines (GNU FSDG) have the following:
Complete Distros Our list of distributions is a guide for systems you can install in a computer. Therefore, it only includes distributions that are complete in themselves and ready to use. [...] An exception to this requirement and to the self-hosting requirement above is for small system distributions, which are distros designed for devices with limited resources, like a wireless router for example. Free small system distributions do not need to be self-hosting or complete, because it is impractical to do development on such a system, but it must be developable and buildable on top of a free complete system distribution from our list of distributions, perhaps with the aid of free tools distributed alongside the small system distribution itself.
So sometimes (like with Replicant) building the small distribution rely on being able to install specific FSDG compliant distributions.
So for instance building Replicant has only been tested on specific distributions (typically Trisquel), so if you run another FSDG distribution (like Parabola for instance) you might want to run Trisquel under Parabola somehow.
Other uses cases could be to deploy services that is packaged in a distribution and not another.
For instance Freedombox is in PureOS and in Trisquel but not in Parabola or Guix.
Installing
There are often various possibilities for installing an FSDG distribution in a virtual environment. For instance
- You can cross bootstrap it (see the CrossDistroBootstrap article for more details)
- You can also install in a VM that emulates a complete computer like Qemu with KVM.
Running distributions in a virtual execution environments
Here some known working combinaison of distributions and virtual execution environments:
Distributions | |||||||||
---|---|---|---|---|---|---|---|---|---|
Guix | Hyperbola | Parabola | PureOS | Replicant | Trisquel 8.0 (Flidas) | Trisquel 9.0 (etiona) | Trisquel 10 (nabia) | ||
Runtimes | libvirt's LXC | No[1][2] | Yes | Yes | Yes | No[3] | No[4] | Yes | Yes |
Qemu / Qemu KVM / Bare metal | Yes | Yes | Yes | Yes | No[3] | Yes | Yes | Yes | |
Docker[5] | Yes[6] | No[7] | yes, Not packaged, requires Parabola.[8] | yes, with configuration. Requires debuerreotype with recent debootstrap.[9] | No[3] | ? | yes, with configuration, Requires debuerreotype with recent Trisquel 9 or 10.[10] | yes, with configuration, Requires debuerreotype with recent Trisquel 9 or 10.[10] |
Virtual execution environments availability in FSDG compliant distributions
Distribution | Dragora | Dynebolic | Guix | Hyperbola | Parabola | PureOS 10.0 (byzantium) | Trisquel 10 (nabia) | Ututo S |
---|---|---|---|---|---|---|---|---|
Docker | Yes[11] | No[12] | Yes[13] | Yes[14] | Yes[15] | |||
Libvirt LXC | No[16] | No[17] | Yes[18] | ? | ||||
Libvirt qemu-kvm | Yes | No[17] | Yes | Yes | ||||
Libvirt Xen | No[19] | No[17] | No[20] | ? |
Other execution environment
Host software name | Host software FSDG status | Target FSDG compliant programs exist? |
---|---|---|
DOSBox | OK | Yes[21] |
MAME | Yes
|
Yes[22] |
Retroarch | Yes
|
Yes Has some backends that are OK:
|
Qemu + SeaBIOS | Yes
|
Yes[24] |
Qemu + Tianocore | Yes
|
Yes[26] |
Uzem | OK | Yes[27] |
Wine |
|
Yes[29] |
See also
- https://wiki.parabola.nu/Emulator_licensing_issues
- https://directory.fsf.org/wiki/Collection:Computer_and_video_game_console_emulators
- https://directory.fsf.org/wiki/Collection:Game_ROM_images
References
- ↑ guix system cannot produce a chroot in a directory if it's not backed by a block device.
- ↑ guix system init doesn't have an easy way for the host to know which init binary to run which which arguments.
- ↑ 3.03.13.2 Nobody tried to run Replicant in a vm or container.
- ↑ At the time of writing (May 2021) Trisquel 8 doesn't work anymore in LXC through libvirt in Parabola: Failed to create symlink /sys/fs/cgroup/net_cls: Operation not permitted Freezing execution. This is due to a cgroup API change. However Trisquel 9 works fine in this context and Trisquel 8 is not supported anymore by Trisquel since April 2021.
- ↑ This references if it's possible to create docker images for a given distribution. For (the lack of) FSDG compliant docker registries and possible workarounds, see the ExternalRepositories page.
- ↑ An image can be produced with the 'guix system image -t docker system.scm' command. Guix can also be installed on top of most GNU/Linux and GNU/Hurd distributions.
- ↑ I found no hyperbola docker package, no docker related git repository in git.hyperbola.info, and while parabola-docker has very few parabola specific files, very few it has at least one, so hyperbola support probably need to be added in the parabla-docker program. Though Hyperbola is also switching to a BSD kernel, so docker might not work anymore there. So there might not be enough interest to do that.
- ↑ A project exist to build Parabola docker images but it's not packaged in Parabola
- ↑ PureOS has a package for debuerreotype, the software used to create the semi-official Debian images on docker.com. It uses debootstrap so it can create PureOS images. However the package documentation mention Ubuntu or Debian examples, so someone needs to bugreport and/or fix it. The debuerreotype-init --non-debian rootfs amber https://repo.pureos.net/pureos command can be used to create a PureOS rootfs on PureOS. There is also some documentation on how to do that the PureOS wiki.
- ↑ 10.010.1 Trisquel 9 and Trisquel 10 have a package for debuerreotype, the software used to create the semi-official Debian images on docker.com. It uses debootstrap so it can create Trisquel images. However the package documentation mention Ubuntu or Debian examples, so someone needs to bugreport and/or fix it. The debuerreotype-init --non-debian rootfs nabia http://archive.trisquel.info/trisquel command can be used to create a Trisquel 10 rootfs on Trisquel 10.
- ↑ There is a docker package and service
- ↑ Hyperbola doesn't have any docker package: https://www.hyperbola.info/packages/?sort=&q=docker
- ↑ The Parabola docker package has a docker service that can be activated.
- ↑ PureOS has the docker.io package and it works fine.
- ↑ The Trisquel docker.io package has a docker service that can be activated.
- ↑ Libvirt LXC is available in Guix, but trying to run Parabola in libvirt LXC results in this error: "Unable to complete install: 'internal error: guest failed to start: Failure in libvirt_lxc startup: Unable to create directory /sys/fs/cgroup/unified: No such file or directory'". And Parabola is known to work in libvirt LXC (at least in Parabola).
- ↑ 17.017.117.2 Hyperbola doesn't have any libvirt package: https://www.hyperbola.info/packages/?sort=&q=libvirt
- ↑ Tested with Parabola, Trisquel 9, Trisquel 10 and other distributions.
- ↑ Guix's libvirt seems not to be built with Xen
- ↑ libvirt is not built with Xen support in the libvirt package (which comes from Arch Linux).
- ↑ COMMAND.com is a program shipped by DOSBox and it's being built with it. Since FSDG compliant distributions ship DOSBox, they probably also build it along the way.
-
↑
There is a tutorial on how to launch and/or convert uzebox games to be used with MAME but not all of the game work. DrMario was tested with the same git revision used in the Free software directory and seemed to work. To build it for MAME:
$ git clone https://github.com/Uzebox/uzebox
$ cd uzebox
$ git checkout e05013c91a77dc32a541f692c82d91250035d66f
$ make -C tools/packrom/
$ export PATH=$PATH:$PWD/tools/packrom/
$ cd demos/DrMario/default
$ make
$ objcopy -I ihex DrMario.hex -O binary dr-mario.bin
Then get where the rom directory is located:
$ mame -showconfig | grep '^rompath'
rompath $HOME/mame/roms
Then install the dr-mario.bin in a uzeboz directory in the rom directory:
$ mkdir -p $HOME/mame/roms/uzebox
$ mv dr-mario.bin $HOME/mame/roms/uzebox/
And we finally I run drmario like that, with the Guix MAME under Parabola:
$ mame uzebox drmario
dr-mario.bin WRONG LENGTH (expected: 0000dcaa found: 0000ce5a)
dr-mario.bin WRONG CHECKSUMS:
EXPECTED: CRC(8144b271) SHA1(d4bb13f54b756e2ba9e57075aae473b72397f48f)
FOUND: CRC(c0130ccf) SHA1(8bca126a623c19033eace513ae547a0560e9f558)
WARNING: the machine might not run correctly.
Average speed: 41.13% (3 seconds)
And that showed a game on the screen. Pressing 1 make it does stuff, but I'm not sure what the controls are. - ↑ "Some cores, like 2048, do not require any content in order to work": https://www.retroarch.com/?page=cores
- ↑ Example: The installer image of most FSDG compliant distributions supporting i686 or x86_64
- ↑ For Tianocore in Parabola the package is named edk2-ovmf
- ↑ Example: The installer image of most FSDG compliant distributions supporting x86_64
-
↑
Uzem, packrom and Arkanoid were checked directly with their upstream source code at the same git version that was reviewed on the Free Software Directory, with Parabola x86_64 and avr-gcc and avr-libc installed:
$ git clone https://github.com/Uzebox/uzebox
$ cd uzebox
$ git checkout e05013c91a77dc32a541f692c82d91250035d66f
$ make -C tools/uzem/
$ make -C tools/packrom/
$ export PATH=$PATH:$PWD/tools/packrom/
$ cd demos/Arkanoid/default
$ make
$ make Arkanoid.uze
Then running the emulator on the game we built also works fine:
$ ../../../tools/uzem/uzem Arkanoid.uze
We have the game graphics appearing inside the emulator and so on. - ↑ Reference: https://directory.fsf.org/wiki/Wine
-
↑
GNU Hello can be built with Guix and run in Parabola (with Parabola's wine) with the following command:
$ wine $(guix build --target=x86_64-w64-mingw32 hello)/bin/hello.exe
[...]
Hello, world!
It is also possible build and run more useful programs like xz in the same way, though not many programs are known to cross compile well. People can also contribute to Guix to make more program cross compile and/or to package free software for windows and run that with Wine.