ravynOS Pygmy Marmoset
Developer Preview Release v0.4.0pre3
Welcome to the 0.4.0pre3 Developer Preview of ravynOS (formerly airyxOS)! As usual, this is an unstable pre-release of upcoming stuff intended for people helping build the system. It is not complete. It contains bugs - sometimes serious ones. It might spontaneously panic & reboot, melt your computer, eat your cat, or accelerate the heat death of the universe. You have been warned.
Also please note that the ISO currently does not boot into a GUI. You will see the boot messages and then it will appear to freeze. Switch to tty1 (Alt+F2 usually) for a login prompt. The login is
liveuser with no password.
Detailed release notes below!
TLDR: This release does stuff. More stuff than the previous one, but not by much, and a lot less than we want it to do eventually.
The project's name, brand, associated images and assets have been changed.
The kernel and base system has been rebased onto the CURRENT (14.0) branch of FreeBSD. The extra packages built from ports remain on the 2022Q1 branch for now. We expect the move to CURRENT to improve hardware support, especially in the DRM/KMS video drivers. Please expect some instability as we work out the bugs from this major update.
There is now kernel support for Mach ports, port rights, messages, IPC including OOL descriptors, and system calls. This is provided by a kernel module,
mach.ko, which is (and must be) loaded at boot time by
loader.conf. Never remove this; it will break your system. (Why is it a module then? Due to technical limitations that we need to solve.)
The userspace parts are provided by headers in
libmach, and extensions to
mig compiler is provided to compile
.def files into Mach IPC/RPC code.
launchd and LaunchAgents
launchd is now the system
init process (pid 1). It starts a few essential services (
asld - syslog,
auditd) as LaunchDaemons then passes control to the standard
rc scripts to start the rest of the system. More services can be translated into LaunchDaemons over time. (
auditd are temporarily disabled for stability concerns.)
-+= 00001 root /sbin/launchd
|--= 00025 root /sbin/devd -d
|--= 00026 root /usr/sbin/asld -d
|--= 00027 root /usr/sbin/auditd -l
|--= 00030 root /usr/sbin/notifyd -d
LaunchDaemons are started from their descriptions in
/Library/LaunchDaemons as on macOS, but ours are currently defined in JSON instead of XML. (Because that's how iX Systems did their
launchctl.) Adding XML plist support here is on the task list.
launchd instance is started to manage user LaunchAgents (defined in
~/Library/LaunchAgents) and LaunchDaemons (defined in
Grand Central Dispatch
You can now write (or build) software that needs Grand Central Dispatch, also known as libdispatch or Dispatch. Dispatch provides thread pools and concurrency. It can be used directly, but more importantly, opens the door to adding Dispatch support in Foundation. Note that neither Cocoa or CoreFoundation have been extended yet to support Dispatch.
libxpc has also been added, courtesy of work done by iX Systems. XPC is "a lightweight mechanism for basic interprocess communication" built on top of Mach. XPC is used by
launchd among other things and enables the addition of more compatibility stuff in Foundation. Note that Cocoa and CoreFoundation have not been extended yet to support XPC.
Clang and LLVM
LLVM and Clang have been upgraded to 13.0.0.
ravynOS clang version 13.0.0 ([email protected]:llvm/llvm-project.git llvmorg-13.0.0-0-gd7b669b3a303)
Thread model: posix
Clang now links
libobjc automatically for any input files detected as Objective-C (
*.m) or Objective-C++ (
*.mm). This only works if compilation and linking are one step. If linking is a separate step, you still need to specify
Clang now defines the preprocessor symbol
__MACH__. The symbol
__AIRYX__ is no longer defined by the compiler; instead it defines
__RAVYNOS__. You may notice that software tries to build in its Mac configuration due to the presence of
Several essential header files from Darwin and Apple opensource have been added to
LaunchServices now uses the "canonical" path of
/var/db/launchd/com.apple.launchd.per-user.$UID for its database. If you had an existing database under
$HOME/Library/db, you can move it to the new location to preserve your app associations. It has also been integrated with
launchd and will launch applications via the per-user instance if it is available.
"MachO ELF" Hybrid Linker, or "How I spent my winter vacation"
A proof-of-concept hybrid runtime linker has been added as
/usr/lib/dyld. This is not Apple's
dyld - it's an attempt to resolve symbols from a MachO binary with exports from ELF shared objects. The goal here was to run Mac MachO executables against our ELF-based Frameworks and other libraries so we don't need two sets of them or to convert everything to MachO. Curious people can read these notes captured during its very early development.
So far, a small "hello world" in C using
printf() and one in Objective-C using Foundation's
NSLog() have been compiled on macOS and run under ravynOS's
dyld. GUI apps will not run yet.
You need to create symlinks as well that translate the library & framework names in the executable to those on ravynOS; e.g.
ln -s /lib/libc.so.7 /usr/lib/libSystem.B.dylib.
(Due to the complexity of this translation, we will very likely be moving toward building a Mach-O based system.)
MachO Executable Support
dyld is a very simple MachO image activator (BSD kernel module) that can recognize a MachO executable and transparently start it under
dyld. This lets you run MachO binaries the same way as native ELF ones. Load the
macho.ko module with
kldload to try it.
★ [email protected] ~ᐳ file ~/hello2
/Users/zoe/hello2: Mach-O 64-bit x86_64 executable, flags:<NOUNDEFS|DYLDLINK|TWOLEVEL|PIE>
★ [email protected] ~ᐳ ~/hello2
2022-01-17 23:24:34.531 hello2[50578:80187d000] Hello from MachO Foundation!
A Whole New World .. er GUI
Our previous images used a pretty traditional X11/KDE desktop environment that was shoehorned into looking and behaving like the Mac desktop. However, this can only go so far due to the very different architecture and design of the two systems. 0.4.0pre3 has the very first bits of a new UI built ground-up to be what we need. It's based on the wayland protocol, wlroots, OpenGL ES2, EGL, and kernel mode setting (KMS) drivers using the direct rendering manager (DRM).
WindowServer can be started if you have an Intel, AMD embedded, or Radeon GPU. It will not work in virtual machines until we get KMS drivers for the virtual hardware - work is underway to support Vmware (vmwgfx) and virtio (qemu, bhyve, others). Briefly:
kldload i915kms # for Intel GPUs
If this works, you'll see a wallpaper and a placeholder menu bar with clock.
- The Live CD was reworked to use
tmpfs for writable areas and dropped
- Several new tree-themed wallpapers were added.
posix_spawn() now supports the
POSIX_SPAWN_SETEXEC flag from Darwin.
/private now exists with symlinks to some critical areas
- The installer now supports installing to MMC and VirtIO (VBD) media.
- pthread work queues were added to support libdispatch and friends
- Some icons have been updated (and more are coming)
Limitations and Known Issues
There are still many major limitations and problems making this release unsuitable for daily use.
- There is no GUI
- Lots of inconsistencies and incompatibilities
- Very few apps available
- Mach is not completely stable
- If the system does not shut down cleanly, you may see a kernel panic & reboot on the next start. It should start correctly after this reboot.
- Launchd jobs created from LaunchServices are not removed after exiting
open options (e.g. redirecting I/O, setting env vars, wait for exit) are not yet implemented on the
launchd version of LaunchServices
Please see the wiki for system requirements, install instructions and where to find things.
Ask questions or give feedback in the Discussions area. Please report any bugs to the Issues tracker. Your help in fixing said bugs would be appreciated too! Thanks!
Download 0.4.0pre3 from NomadLogic - US West or your closest mirror:
US Central | US East | US East 2 | Norway | Denmark
Unstable "nightly" builds are also available for developer testing:
Download from US West | US Central | US East | US East 2 | Norway | Denmark
A huge thanks to the NetBSD and NextBSD projects for pioneering Mach support in BSD. Additional huge thanks to Jordan Hubbard, Kip Macy, the entire NextBSD team, and iX Systems for all their work on XPC, launchd, and Dispatch! As usual, thank you to our community of sponsors, designers, developers, testers, and users, and mirror hosts for supporting the project.