From 3dc6c588c46c59616c50fae3e07e474ddcdb1b82 Mon Sep 17 00:00:00 2001 From: Yessiest Date: Thu, 27 Jan 2022 03:07:23 +0400 Subject: [PATCH] added readme --- include/README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 include/README.md diff --git a/include/README.md b/include/README.md new file mode 100644 index 0000000..4d0687b --- /dev/null +++ b/include/README.md @@ -0,0 +1,21 @@ +# libwaystub - uhhhhhhhhhh + +There was a point in time when attempts at making firefox be compileable with only wayland support brought the issue with a hard runtime dependency on wayland libs even for X users. and that's why this, uh, thing, exists. + +# Idea + +If there are functions that we want to just omit in the C++ code, we can write stubs for these functions. That approach, surprisingly enough, worked. By simply writing functions that return `NULL` with the names of wayland library functions that firefox expects, we force firefox to believe that wayland libraries are either not existent or wayland isn't running (whichever it is). Despite the absurdity, the approach worked. + +# Building + +``` +mkdir build +cd build +cmake .. +make +``` +you should then have libwaystub.so in the build directory. Copy it to wherever you want to apply the stubs, and add the library to `LD_PRELOAD` before launching your application that you want to apply this stub for. + +# License + +This work is licensed under the MIT-0 license.