qemu_l4b.adoc

=== BSD-USER 4 LINUX

Contact: Maksym Sobolyev <[email protected]>

Links:
link:https://github.com/sobomax/qemu-bsd-user-l4b[Project Page] URL: link:https://github.com/sobomax/qemu-bsd-user-l4b[] +
link:https://github.com/sobomax/qemu_l4b[Tooling] URL: link:https://github.com/sobomax/qemu_l4b[]

The `bsd-user-4-linux` project ports BSD user-mode emulation for QEMU to Linux.
The primary goal is to enable unmodified FreeBSD binaries to run on modern Linux systems.
Additionally, the project aims to provide multi-platform container images with a functional FreeBSD environment and ready-to-use GitHub Actions templates.

News:

* Two new pull requests have been received since the initial project announcement:
  ** Diagnostic output cleanup;
  ** kqueue() support using libkqueue library on Linux.
* The latest set of changes has been pulled from the Warner's qemu-bsd-user project bringing Qemu version to 9.2.0 along with some fixes and improvements.

Current Status:

* The initial port successfully runs `make -jN buildworld`.
* Most command-line tools are working as expected (man:sh[1], man:bash[1], man:find[1], man:grep[1], man:git[1], man:clang[1], etc).
* A link:https://github.com/sobomax/qemu-bsd-user-l4b/actions[GitHub Actions pipeline] builds x86_64 emulation images for:
  ** linux/386
  ** linux/amd64
  ** linux/arm/v5
  ** linux/arm64/v8
* A pre-built Docker container with FreeBSD 14.1 binary world is created and pushed to the GitHub Container Registry.
  ** link:https://ghcr.io/sobomax/qemu-bsd-user-l4b:latest-ubuntu-latest-freebsd141[FreeBSD Image @ GHCR]
* Special pre-built "admin" container with Linux user-mode qemu binary for the FreeBSD/amd64 emulation is also published at the GHCR.
  ** link:https://ghcr.io/sobomax/qemu-bsd-user-l4b:latest-ubuntu-latest[FreeBSD binfmt Image @ GHCR]

Next Steps:
* Bump FreeBSD version to 14.3;
* Rebase onto Qemu 10.0.x.

How You Can Help:

* Test with your preferred toolchain, report issues, or contribute fixes.
* Identify and implement missing system calls.
* Support us on link:https://patreon.com/sippylabs[Patreon].

Sponsor: Sippy Software, Inc.