ravynOS Pygmy Marmoset

Developer Preview Release v0.4.0pre4

Welcome to the 0.4.0pre4 Developer Preview of ravynOS as we continue working towards release 0.4! 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 - including application and desktop crashes and kernel panics. You have been warned.

This snapshot release includes the start of a GUI based on Cocoa and Mach. It aims to be Mac compatible. The GUI is very rudimentary so far - please be patient! More is on the way.

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.

Kernel stabilization

A major bug in mach_msg memory allocation was fixed, massively improving the kernel's stability. There may still be occasional freezes or panics, mainly in the drm-kmod (DRM/KMS video) drivers or in the latest Intel wifi (iwlwifi) driver.

More LaunchDaemons

Launchd now starts the Apple syslog (asld) and auditd services which had been previously disabled for stability issues. The command-line aslutil can be used to examine ASL logs.

WindowServer & SystemUIServer

The Tanuki series releases 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 had the very first bits of a new UI built ground-up to be what we need. This release adds some vital plumbing and the first version of SystemUIServer.

WindowServer should start automatically if it detects a supported GPU (Intel HD and Iris, AMD or Radeon - we are still working towards virtual machine support with qxl and vmwgfx drivers). If successful, a black and white "ravynOS" wallpaper should appear on all screens and a login window should appear on one of them. Enter "liveuser" as the user name, leave password blank, and click the Login button. If you get it wrong, there is no feedback: just try again. A better login window is in development but we needed something quickly to make the Live ISO work :)

After login, the display should change to a black screen with a menu bar at the top of one screen. The menu bar has a clock and the Ravyn menu, with typical options like About this computer, Recent items, Sleep and Restart. Most of these work - try Sleep, Restart, and Shut Down in particular and please report if they work for your hardware.

When a Cocoa app (e.g. /Applications/Utilities/Install ravynOS.app) is launched, its menus appear in the global bar and can be used as you would expect. Switching applications will switch the active menus as well. Exiting an application removes its menus from the bar. Remaining work items are tracked here. Also beware of known issues #288 and #280 in particular.

Temporary Secret Terminal

Since the desktop has no way yet to launch apps, you can press <Logo>-<Enter> (Logo being your Windows or Command key or its equivalent) to launch a terminal window. Press <Alt>-<Space> while focused for a window menu, then enable Decorations to allow moving or resizing the window. The shell will be running as nobody, so use su - liveuser to get to your regular account. This is not a Cocoa app and has no menus; it will go away once we have something better.

Other Changes

• Many commits from FreeBSD upstream
• Many bugs fixed
• Many new bugs

Limitations and Known Issues

• The GUI is extremely minimal
• Lots of inconsistencies and incompatibilities
• Very few apps available
• Launchd jobs created from LaunchServices are not removed after exiting
• Many open options (e.g. redirecting I/O, setting env vars, wait for exit) are not yet implemented on the launchd version of LaunchServices
• See open issues

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!

Get It!

Download 0.4.0pre4 from NomadLogic - US West or your closest mirror: US Central | US East | US East 2 | Norway | Denmark

Torrents are also available courtesy of FOSSTorrents

Unstable "nightly" builds are also available for developer testing: Download from US West | US Central | US East | US East 2 | Norway | Denmark

Torrents of the snapshot builds are available too! Thanks to @RangerRick for setting these up.

Acknowledgements

As usual, thank you to our community of sponsors, designers, developers, testers, and users, and mirror hosts for supporting the project.

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.

Rebranding

The project's name, brand, associated images and assets have been changed.

FreeBSD 14-CURRENT

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.

Mach Subsystem

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 /usr/include/mach and /usr/include/sys/mach, libmach, and extensions to libc.

The mig compiler is provided to compile .def files into Mach IPC/RPC code.

launchd and LaunchAgents

Apple's launchd is now the system init process (pid 1). It starts a few essential services (asld - syslog, notifyd, devd and 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. (asld and 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 /System/Library/LaunchDaemons or /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.

A per-user launchd instance is started to manage user LaunchAgents (defined in ~/Library/LaunchAgents) and LaunchDaemons (defined in ~/Library/LaunchDaemons).

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.

XPC

A 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)
Target: x86_64-ravynos-freebsd14.0
Thread model: posix
InstalledDir: /usr/bin

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 -lobjc.

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 __MACH__.

Several essential header files from Darwin and Apple opensource have been added to /usr/include.

LaunchServices

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

Alongside our 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
/System/Library/CoreServices/WindowServer.app/WindowServer

If this works, you'll see a wallpaper and a placeholder menu bar with clock.

Other Changes

• The Live CD was reworked to use tmpfs for writable areas and dropped unionfs
• 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
• Many 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!

Get It!

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

Acknowledgements

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.

OpenJDK 17.0.1+12 (2021-10-30) built for airyxOS and usable as a bootstrap JDK for further builds.

This is a vanilla FreeBSD JDK other than being packaged for airyxOS. It does not have any menu, font, or other system integration yet.