Add freebsd userland platform

.github/workflows/ci.yml

@@ -259,6 +259,9 @@ jobs:
           # - `litebox_platform_linux_userland` is allowed to have `std` access,
           #   since it is a purely-userland implementation.
           #
+          # - `litebox_platform_freebsd_userland` is allowed to have `std` access,
+          #   since it is a purely-userland implementation.
+          #
           # - `litebox_platform_windows_userland` is allowed to have `std` access,
           #   since it is a purely-userland implementation.
           #
@@ -311,6 +314,7 @@ jobs:
           find . -type f -name 'Cargo.toml' \
             -not -path './Cargo.toml' \
             -not -path './litebox_platform_linux_userland/Cargo.toml' \
+            -not -path './litebox_platform_freebsd_userland/Cargo.toml' \
             -not -path './litebox_platform_windows_userland/Cargo.toml' \
             -not -path './litebox_runner_linux_on_windows_userland/Cargo.toml' \
             -not -path './litebox_platform_lvbs/Cargo.toml' \

Cargo.toml

@@ -4,6 +4,7 @@ members = [
     "litebox", 
     "litebox_common_linux",
     "litebox_common_optee",
+    "litebox_platform_freebsd_userland",
     "litebox_platform_linux_kernel",
     "litebox_platform_linux_userland",
     "litebox_platform_windows_userland",
@@ -28,6 +29,7 @@ default-members = [
     "litebox",
     "litebox_common_linux",
     "litebox_common_optee",
+    "litebox_platform_freebsd_userland",
     "litebox_platform_linux_kernel",
     "litebox_platform_linux_userland",
     "litebox_platform_windows_userland",

dev_tests/src/ratchet.rs

@@ -35,6 +35,7 @@ fn ratchet_globals() -> Result<()> {
         &[
             ("dev_bench/", 1),
             ("litebox/", 9),
+            ("litebox_platform_freebsd_userland/", 7),
             ("litebox_platform_linux_kernel/", 6),
             ("litebox_platform_linux_userland/", 5),
             ("litebox_platform_lvbs/", 23),
@@ -71,6 +72,7 @@ fn ratchet_maybe_uninit() -> Result<()> {
         &[
             ("dev_tests/", 1),
             ("litebox/", 1),
+            ("litebox_platform_freebsd_userland/", 2),
             ("litebox_platform_linux_userland/", 3),
             ("litebox_shim_linux/", 5),
         ],

litebox/src/mm/exception_table.rs

@@ -18,7 +18,7 @@
 
 use crate::utils::TruncateExt as _;
 
-#[cfg(any(target_os = "linux", target_os = "none"))]
+#[cfg(any(target_os = "linux", target_os = "freebsd", target_os = "none"))]
 macro_rules! ex_table_section {
     () => {
         // a = allocate, R = retain: don't discard on linking.
@@ -214,7 +214,7 @@ struct ExceptionTableEntry {
 
 /// Returns the exception table, found by linker-defined symbols marking the
 /// start and end of the section.
-#[cfg(any(target_os = "linux", target_os = "none"))]
+#[cfg(any(target_os = "linux", target_os = "freebsd", target_os = "none"))]
 fn exception_table() -> &'static [ExceptionTableEntry] {
     // SAFETY: the linker automatically defines these symbols when the section
     // is non-empty.

litebox_platform_freebsd_userland/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "litebox_platform_freebsd_userland"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+libc = { version = "0.2.169", default-features = false }
+litebox = { path = "../litebox/", version = "0.1.0" }
+litebox_common_linux = { path = "../litebox_common_linux", version = "0.1.0" }
+thiserror = { version = "2.0.6", default-features = false }
+bitflags = "2.6.0"
+getrandom = "0.3.4"
+zerocopy = { version = "0.8", default-features = false, features = ["derive"] }
+
+[lints]
+workspace = true

litebox_platform_freebsd_userland/README.md

@@ -0,0 +1,3 @@
+# LiteBox Platform: FreeBSD Userland
+
+A [LiteBox platform](../litebox/platform/index.html) for running LiteBox on userland FreeBSD.