Editing Main Page (section)

==== Where to Start: Leveraging SmartOS/Illumos Source ====
Since both SmartOS (Illumos) and FreeBSD are open source, you can study the LX zone implementation to guide enhancements to the Linuxulator. Here’s a step-by-step approach:

===== 1. Study Illumos LX Zone Source Code =====
* '''Location''': The relevant code is in the Illumos gate repository, specifically under <code>usr/src/uts/common/brand/lx/</code> and related directories. Key files include:
** <code>lx_syscalls.c</code>: Handles Linux system call emulation.
** <code>lx_cgroups.c</code>: Implements cgroups support.
** <code>lx_namespace.c</code>: Manages Linux namespace emulation.
** <code>lx_fanotify.c</code>: Provides fanotify support.
* '''Key Insight''': Illumos has extended its kernel to natively support these features for LX zones, rather than just translating them to existing Solaris/Illumos mechanisms. This suggests FreeBSD may need a hybrid approach—either adding native support or building a more comprehensive translation layer.

===== 2. Map Illumos Features to FreeBSD =====
* '''cgroups''': Start by reviewing <code>lx_cgroups.c</code>. You could either:
** Implement a minimal cgroups shim in the Linuxulator that maps to FreeBSD’s <code>rctl</code> or a new subsystem.
** Port Illumos’s cgroups implementation directly, adapting it to FreeBSD’s kernel architecture.
* '''Namespaces''': Look at <code>lx_namespace.c</code>. FreeBSD jails and VNET provide a foundation, but you’d need to extend the Linuxulator to handle <code>clone()</code> and <code>unshare()</code> with namespace flags, possibly by mapping them to jail-like constructs.
* '''System Calls''': Compare Illumos’s <code>lx_syscalls.c</code> with FreeBSD’s <code>sys/compat/linux/linux_sysent.c</code>. Add missing syscalls (e.g., <code>pidfd_open()</code>, <code>clone3()</code>) by adapting Illumos’s implementations or writing new ones based on Linux kernel source (e.g., from kernel.org).
* '''Fanotify''': Use <code>lx_fanotify.c</code> as a model to build a translation layer from <code>fanotify</code> to <code>kqueue</code>.

===== 3. Modify FreeBSD Linuxulator =====
* '''Source Location''': FreeBSD’s Linuxulator code is in <code>sys/compat/linux/</code> in the FreeBSD source tree (e.g., <code>/usr/src/sys/compat/linux/</code> if you’ve cloned the repo).
* '''Steps''':
# Extend the syscall table (<code>linux_sysent.c</code>) with missing calls, using Illumos as a reference.
# Add new kernel modules or hooks for cgroups and namespaces, potentially under <code>sys/compat/linux/</code>.
# Implement fanotify emulation by integrating with <code>kqueue</code>.
# Test with a minimal systemd binary (e.g., from a lightweight distro like Alpine) in a chroot environment.