AppImage apps: Electron programs such as Heroic open under FEX

Every Electron AppImage hung without a window or crashed at its first page.
Four causes, each enough on its own:

- The session preload's hooks found the real functions with
  dlsym(RTLD_NEXT). Before glibc 2.34 a thread's first dlsym callocs, and
  Chromium's PartitionAlloc calls syscall() from inside its first malloc:
  the allocator waited for itself. On older glibc (the x86 runtime's 2.31)
  next.c now walks the libraries after the preload with no allocation and
  picks each function's default version, as glibc 2.36 does; the old
  lookup handed realpath() and posix_spawn() their compat versions, and
  realpath(path, NULL) failed. arm64 keeps dlsym.
- libpci's sysfs backend exits when /sys/bus/pci/devices is listable but a
  device's files are not (a RedMagic's PCIe root port), taking every
  Chromium GPU process with it. An empty directory is bound over it on
  devices where that happens.
- FEX_OUTPUTLOG=stderr made FEX log to its own duplicate of descriptor 2.
  Chromium dup2()s its IPC socket onto that low number in each child it
  starts, then lists /proc/self/fd, which FEX logs into the socket. Empty,
  FEX writes to descriptor 2 itself.
- The tracer preload served every /proc/<pid>/status as a memfd, which is
  open for writing. Chromium hands each renderer its status as a read-only
  file and checks that it is one. Only a process's own status (pid, tid,
  self, thread-self) is rewritten now.
This commit is contained in:
maxjivi05 committed 2026-10-11 00:17:55 -04:00
1 parent d1b0ac4df1
commit 8a6877423e
31 files changed
+472 -112

No files matched your search

+1 -1
View File
@@ -61,7 +61,7 @@ class BinfmtPreloadTest(unittest.TestCase):
cls.library = cls.tmp / "libbinfmt.so"
subprocess.run(["gcc", "-shared", "-fPIC", "-O2", "-Wall", "-Wextra", "-Werror", "-DBINFMT_TEST",
'-DBINFMT_HANDLER="%s"' % cls.handler, "-o", str(cls.library),
"-pthread"] + [str(PRELOAD / name) for name in ("binfmt.c", "net.c", "udevmon.c", "pathcache.c")] + ["-ldl"],
"-pthread"] + [str(PRELOAD / name) for name in ("binfmt.c", "net.c", "udevmon.c", "pathcache.c", "next.c")] + ["-ldl"],
check=True)
source = cls.tmp / "program.c"
source.write_text(PROGRAM)
+1 -1
View File
@@ -16,7 +16,7 @@ class CdpGuardTest(unittest.TestCase):
def setUpClass(cls):
cls.build = tempfile.TemporaryDirectory()
cls.library = Path(cls.build.name) / "net.so"
subprocess.run(["cc", "-shared", "-fPIC", "-O2", str(SOURCE), str(SOURCE.parent / "binfmt.c"), "-x", "c", "-", "-ldl",
subprocess.run(["cc", "-shared", "-fPIC", "-O2", str(SOURCE), str(SOURCE.parent / "binfmt.c"), str(SOURCE.parent / "next.c"), "-x", "c", "-", "-ldl",
"-o", str(cls.library)],
input=b"int bl_udevmon_stand_in(int fd) { return 0; }", check=True, capture_output=True)
+1 -1
View File
@@ -348,7 +348,7 @@ class LaunchTest(FexTestCase):
self.assertNotIn("FEX_ROOTFS", guest)
self.assertEqual(guest["FEX_TSOENABLED"], "1")
self.assertTrue(guest["FEX_APP_CONFIG_LOCATION"].endswith("/config/"))
self.assertEqual((guest["FEX_SILENTLOG"], guest["FEX_OUTPUTLOG"]), ("0", "stderr"))
self.assertEqual((guest["FEX_SILENTLOG"], guest["FEX_OUTPUTLOG"]), ("0", ""))
guest = FEX["guest_environment"]({"portable": False}, {"LD_PRELOAD": str(arm), "FEX_PORTABLE": "1", "FEX_OUTPUTLOG": "/tmp/fex.log"})
self.assertEqual(guest["FEX_OUTPUTLOG"], "/tmp/fex.log")
self.assertNotIn("LD_PRELOAD", guest)
+1 -1
View File
@@ -319,7 +319,7 @@ class FsyncPreloadTest(unittest.TestCase):
source = base / "fsync-test.c"
source.write_text(PROGRAM)
subprocess.run(["cc", "-O2", "-Wall", "-fPIC", "-shared", "-pthread", "-o", str(cls.lib),
str(PRELOAD / "fsync.c"), str(PRELOAD / "robust.c"), str(PRELOAD / "noexec.c"), "-ldl"], check=True)
str(PRELOAD / "fsync.c"), str(PRELOAD / "robust.c"), str(PRELOAD / "noexec.c"), str(PRELOAD / "next.c"), "-ldl"], check=True)
subprocess.run(["cc", "-O2", "-Wall", "-pthread", "-o", str(cls.exe), str(source)], check=True)
@classmethod
+129
View File
@@ -0,0 +1,129 @@
from pathlib import Path
import shutil
import subprocess
import sys
import tempfile
import unittest
PRELOAD = Path(__file__).resolve().parents[1] / "linuxfs/preload"
PROBE = r"""
#define _GNU_SOURCE
#include <dlfcn.h>
void *bl_next(const char *name) __attribute__((visibility("hidden")));
void *__real_dlsym(void *handle, const char *name);
/* Lookups the walk left to dlsym. */
static int walking;
static long passed_on;
void *__wrap_dlsym(void *handle, const char *name) {
passed_on += walking;
return __real_dlsym(handle, name);
}
void *probe_walk(const char *name) {
walking = 1;
void *found = bl_next(name);
walking = 0;
return found;
}
void *probe_dlsym(const char *name) { return dlsym(RTLD_NEXT, name); }
long probe_passed_on(void) { return passed_on; }
"""
# Counts the allocations a thread makes, as an allocator that is still starting up would see them.
COUNT = r"""
#include <stddef.h>
extern void *__libc_malloc(size_t);
extern void *__libc_calloc(size_t, size_t);
extern void *__libc_realloc(void *, size_t);
static __thread long made;
void *malloc(size_t size) { made++; return __libc_malloc(size); }
void *calloc(size_t count, size_t size) { made++; return __libc_calloc(count, size); }
void *realloc(void *old, size_t size) { made++; return __libc_realloc(old, size); }
void count_reset(void) { made = 0; }
long count_get(void) { return made; }
"""
PROGRAM = r"""
#include <pthread.h>
#include <stdio.h>
void *probe_walk(const char *name);
void *probe_dlsym(const char *name);
long probe_passed_on(void);
void count_reset(void);
long count_get(void);
static void *first_lookup(void *made) {
long before = probe_passed_on();
count_reset();
void *found = probe_walk("openat");
((long *)made)[0] = found ? count_get() : -1;
((long *)made)[1] = probe_passed_on() - before;
return NULL;
}
int main(int argc, char **argv) {
int differ = 0;
for (int i = 1; i < argc; i++) {
void *walked = probe_walk(argv[i]), *found = probe_dlsym(argv[i]);
if (walked != found) {
printf("%s: %p, dlsym %p\n", argv[i], walked, found);
differ = 1;
}
}
long made[2] = {0, 0};
pthread_t thread;
pthread_create(&thread, NULL, first_lookup, made);
pthread_join(thread, NULL);
printf("allocations %ld, left to dlsym %ld\n", made[0], made[1]);
return differ;
}
"""
NAMES = ["open", "openat", "read", "recvmsg", "syscall", "close_range", "fstatat", "stat", "pthread_create",
"dlopen", "malloc", "calloc", "memcpy", "strlen", "environ", "no_such_symbol"]
@unittest.skipUnless(sys.platform.startswith("linux") and shutil.which("cc"), "needs Linux and a C compiler")
class NextTest(unittest.TestCase):
"""bl_next built as on glibc before 2.34, where the walk replaces dlsym(RTLD_NEXT)."""
@classmethod
def setUpClass(cls):
cls.build = tempfile.TemporaryDirectory()
build = Path(cls.build.name)
(build / "probe.c").write_text(PROBE)
(build / "count.c").write_text(COUNT)
(build / "program.c").write_text(PROGRAM)
cls.count = build / "libcount.so"
cls.program = build / "program"
subprocess.run(["cc", "-shared", "-fPIC", "-O2", "-DNEXT_TEST", "-Wl,--wrap=dlsym", "-o", str(build / "libprobe.so"),
str(build / "probe.c"), str(PRELOAD / "next.c"), "-ldl"], check=True)
subprocess.run(["cc", "-shared", "-fPIC", "-O2", "-o", str(cls.count), str(build / "count.c")], check=True)
subprocess.run(["cc", "-O2", "-pthread", "-o", str(cls.program), str(build / "program.c"),
str(build / "libprobe.so"), str(cls.count), "-Wl,-rpath," + str(build)], check=True)
@classmethod
def tearDownClass(cls):
cls.build.cleanup()
def run_program(self):
return subprocess.run([str(self.program)] + NAMES, capture_output=True, text=True)
def test_finds_what_dlsym_finds(self):
result = self.run_program()
self.assertEqual(0, result.returncode, result.stdout + result.stderr)
def test_a_threads_first_lookup_walks_and_allocates_nothing(self):
self.assertIn("allocations 0, left to dlsym 0\n", self.run_program().stdout)
if __name__ == "__main__":
unittest.main()
+1 -1
View File
@@ -43,7 +43,7 @@ class NoexecPreloadTest(unittest.TestCase):
cls.tmp = Path(tempfile.mkdtemp())
cls.lib = cls.tmp / "libnoexec.so"
subprocess.run(["cc", "-O2", "-Wall", "-Werror", "-fPIC", "-shared", "-pthread", "-DNOEXEC_TEST", "-o", str(cls.lib),
str(PRELOAD / "noexec.c"), str(PRELOAD / "fsync.c"), str(PRELOAD / "robust.c"), "-ldl"], check=True)
str(PRELOAD / "noexec.c"), str(PRELOAD / "fsync.c"), str(PRELOAD / "robust.c"), str(PRELOAD / "next.c"), "-ldl"], check=True)
source = cls.tmp / "program.c"
source.write_text(PROGRAM)
for name in ("FEX", "game"):
+1 -1
View File
@@ -81,7 +81,7 @@ class StoragePreloadTest(unittest.TestCase):
(build / "program.c").write_text(PROGRAM)
cls.storage = build / "storage.so"
cls.fake = build / "fake.so"
subprocess.run(["cc", "-shared", "-fPIC", "-O2", "-o", str(cls.storage), str(PRELOAD / "storage.c"), "-ldl"], check=True)
subprocess.run(["cc", "-shared", "-fPIC", "-O2", "-o", str(cls.storage), str(PRELOAD / "storage.c"), str(PRELOAD / "next.c"), "-ldl"], check=True)
subprocess.run(["cc", "-shared", "-fPIC", "-O2", "-o", str(cls.fake), str(build / "fake.c")], check=True)
cls.steam = cls.dir / "steamrtarm64/steam"
cls.steam.parent.mkdir()
+68
View File
@@ -0,0 +1,68 @@
import json
import os
from pathlib import Path
import shutil
import subprocess
import sys
import tempfile
import unittest
PRELOAD = Path(__file__).resolve().parents[1] / "linuxfs/preload"
# Each path opened read-only through the preload, from a thread other than the main one: how it was
# served, and its TracerPid line.
PROGRAM = r"""
import fcntl, json, os, sys, threading
seen = {}
def open_all():
for path in sys.argv[1:]:
path = path.replace("PID", str(os.getpid())).replace("TID", str(threading.get_native_id()))
fd = os.open(path, os.O_RDONLY)
try:
text = os.read(fd, 65536).decode()
seen[path] = {"read_only": fcntl.fcntl(fd, fcntl.F_GETFL) & os.O_ACCMODE == os.O_RDONLY,
"file": os.readlink("/proc/self/fd/%d" % fd),
"tracer": next(line for line in text.splitlines() if line.startswith("TracerPid:"))}
finally:
os.close(fd)
thread = threading.Thread(target=open_all)
thread.start()
thread.join()
print(json.dumps(seen))
"""
@unittest.skipUnless(sys.platform.startswith("linux") and shutil.which("cc"), "needs Linux and a C compiler")
class TracerTest(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.build = tempfile.TemporaryDirectory()
cls.library = Path(cls.build.name) / "libblsession.so"
subprocess.run(["cc", "-shared", "-fPIC", "-O2", "-pthread", "-o", str(cls.library),
*map(str, sorted(PRELOAD.glob("*.c"))), "-ldl"], check=True)
@classmethod
def tearDownClass(cls):
cls.build.cleanup()
def opened(self, *paths):
result = subprocess.run([sys.executable, "-c", PROGRAM, *paths], env=dict(os.environ, LD_PRELOAD=str(self.library)),
check=True, capture_output=True, text=True)
return json.loads(result.stdout)
def test_a_process_reads_its_own_status_without_the_tracer(self):
for path, seen in self.opened("/proc/self/status", "/proc/thread-self/status", "/proc/PID/status",
"/proc/TID/status", "/proc/PID/task/TID/status").items():
self.assertEqual("TracerPid:\t0", seen["tracer"], path)
self.assertTrue(seen["file"].startswith("/memfd:status"), path)
def test_another_process_status_is_the_real_read_only_file(self):
# Chromium hands a renderer its status as a read-only file and checks that it is one.
path = "/proc/%d/status" % os.getpid()
seen = self.opened(path)[path]
self.assertTrue(seen["read_only"])
self.assertEqual(path, seen["file"])
if __name__ == "__main__":
unittest.main()