Development:Setting up Library Forwarding - Revision history

Neobrain at 10:05, 14 July 2025

2025-07-14T10:05:07Z

Neobrain: Neobrain moved page Development:Setting up Thunks to Development:Setting up Library Forwarding

2025-07-14T09:42:46Z

Neobrain moved page Development:Setting up Thunks to Development:Setting up Library Forwarding

Neobrain at 16:57, 16 February 2025

2025-02-16T16:57:14Z

Sonicadvance1 at 18:33, 5 December 2024

2024-12-05T18:33:08Z

Sonicadvance1 at 19:18, 25 September 2024

2024-09-25T19:18:06Z

Sonicadvance1 at 00:41, 16 March 2023

2023-03-16T00:41:20Z

Sonicadvance1 at 00:17, 16 March 2023

2023-03-16T00:17:10Z

Sonicadvance1 at 00:14, 16 March 2023

2023-03-16T00:14:15Z

Sonicadvance1 at 00:13, 16 March 2023

2023-03-16T00:13:36Z

Sonicadvance1 at 00:12, 16 March 2023

2023-03-16T00:12:56Z

@@ Line 1: / Line 1: @@
 = Build instructions =
-== Build dependencies ==
 * g++-x86-64-linux-gnu (For building thunks)
 * pkg-config
@@ Line 25: / Line 33: @@
 * xorg-x11-server-devel
-== Setting CMake to build thunks ==
+=== Generic Nix fallback ===
-Pass in to CMake the option to enable thunk building.
-* -DBUILD_THUNKS=True
+With Nix installed, run <code>../Data/nix/cmake_enable_libfwd.sh</code> from your build folder. This will set up a cross-compiler, install the required dependencies, and enable the required CMake option.
 = Configuration =
 FEXConfig can be used to enable/disable individual libraries.
 = Advanced configuration =
-== FEX thunk options ==
+=== FEX environment variables and command-line arguments ===
 * FEX_THUNKHOSTLIBS, -t <Thunk Host Libs Path>, --thunkhostlibs=<Thunk Host Libs path>, JSON: '''ThunkHostLibs:<Path>'''
 ** Folder to find the host-side thunking libraries.
@@ Line 45: / Line 64: @@
 ** If the filename isn't a path then FEX will search for the file in '''$HOME/.fex-emu/ThunkConfigs/'''
-== How to use Thunks ==
+===Overriding paths for library wrappers ===
 You can can set the three configuration options to custom paths
@@ Line 52: / Line 71: @@
 ** Overriding these to another location is useful for application specific hacks if necessary
-== Thunks Database format ==
+=== ThunksDB.json schema ===
-FEX provides a ThunksDB.json file which allows the user to describe a thunk mapping. '''$prefix/share/fex-emu/ThunksDB.json'''
+FEX provides a ThunksDB.json file which allows the user to describe a thunk mapping. '''$prefix/share/fex-emu/ThunksDB.json'''. Normally this does not need to be modified, but an overlay to the default database can be provided at '''$HOME/.fex-emu/ThunksDB.json'''.
-The user can also provide a '''$HOME/.fex-emu/ThunksDB.json''' which will overlay the system installed path
+Example:
+   {
        "DB": {
@@ Line 73: / Line 88: @@
+       }
+   }
 [[Category:Development]]

@@ Line 30: / Line 30: @@
 = Configuration =
 == FEX thunk options ==
 * FEX_THUNKHOSTLIBS, -t <Thunk Host Libs Path>, --thunkhostlibs=<Thunk Host Libs path>, JSON: '''ThunkHostLibs:<Path>'''
@@ Line 42: / Line 46: @@
 == How to use Thunks ==
-Once Thunks are built and installed then you can can set the three configuration options to the correct paths
+You can can set the three configuration options to custom paths
 * The user can likely set '''ThunkHostLibs''' and '''ThunkGuestLibs''' to the global install path
 ** Unless these are set in the '''ThunkConfig''' file, these will be unused
 ** Overriding these to another location is useful for application specific hacks if necessary
 == Thunks Database format ==
@@ Line 80: / Line 80: @@
 This thunks configuration file can now enable Thunk definitions using the user defined names.
-== ThunkConfig example ==
+== Per-app overrides ==
 * Filename in '''$HOME/.fex-emu/AppConfig/Balatro.exe.json'''
 * Change the filename as necessary for your application
@@ Line 93: / Line 93: @@
 = Further notes =
 == Limitations and problems ==
-* 32-bit thunks aren't available currently
+* For 32-bit applications, libGL is the only library that can use the host variant currently
-** Requires kernel patches for ARM64 support
 [[Category:Development]]

@@ Line 80: / Line 80: @@
 This thunks configuration file can now enable Thunk definitions using the user defined names.
-* ThunkConfig example
+== ThunkConfig example ==
+   {
      "ThunksDB": {

@@ Line 83: / Line 83: @@
+   {
      "ThunksDB": {
-       "GL": 0,
+       "GL": 1,
-      "xcb": 1,
+       "Vulkan": 1
+     }
+   }

@@ Line 23: / Line 23: @@
 * libxshmfence-devel
 * libdrm-devel
 == Setting CMake to build thunks ==

@@ Line 21: / Line 21: @@
 * alsa-lib-devel
 * libxcb-devel
 == Setting CMake to build thunks ==

@@ Line 15: / Line 15: @@
 === Fedora dependencies ===
-** libXext-devel
+* libXext-devel
-** libXfixes-devel
+* libXfixes-devel
-** libXrender-devel
+* libXrender-devel
-** libXrandr-devel
+* libXrandr-devel
-** alsa-lib-devel
+* alsa-lib-devel
 == Setting CMake to build thunks ==