[Get-fix]

What

PS4 programs load system libraries with sceKernelLoadStartModule and their console path. The OpenOrbis piglet sample loads /<sandbox word>/common/lib/libScePigletv2VSH.sprx and libScePrecompiledShaders.sprx, the sandboxed form of /system/common/lib/ that sceKernelGetFsSandboxRandomWord names. AnyPS5 opened that path as a guest file, so the load failed with ENOENT and the sample stopped with:

Module prefix = /gkbHtXc3Wq/common/lib/
Failed to load the Piglet module, err=0x80020002
Module load failed.

A path in /system/common/lib/ or in the sandboxed /<word>/common/lib/ whose file name ends in .sprx now loads the host libs/<name>.prx, as libSceSysmodule does for module IDs. A name with a directory part is not mapped, so such a path cannot leave libs/. Any other path is opened as before. The new line in docs/dev/debt/libkernel.md records that a host library has no module_start, so res is 0, and that other system directories, such as /system/priv/lib, are not mapped. Part of the PS4 homebrew work tracked in #3093.

Overlap with open pull requests that change Module.cpp or docs/dev/debt/libkernel.md, checked with git merge-file against main 03c4cb5e7:

• fix(libkernel): pass module arguments to loaded modules #4972 adds #include <mutex> on the line where this adds #include <optional>; whichever merges second keeps both includes.
• feat(libkernel): read param.sfo when param.json is absent #5993 (mine) also appends an entry at the end of docs/dev/debt/libkernel.md; whichever merges second keeps both entries.
• fix(libkernel): provide default arguments block for DT_INIT on Linux #6149 merges cleanly with this.

Tested

Windows 11 Pro 26200, WinLibs GCC 15.2.0 r7, Release, BUILD_TESTING=ON, on main 03c4cb5e7:

• guest_dynamic_loader now copies its fixture module into libs/ and loads it through /system/common/lib/<name>.sprx and /gkbHtXc3Wq/common/lib/<name>.sprx (gkbHtXc3Wq is AnyPS5's sandbox word). It calls the module's export and unloads it each time. A missing name and a .prx name return 0x80020002, and so does /gkbHtXc3Wq/common/lib/../<name>.sprx, even though the file exists one directory up.
• Each of these makes the test fail: the mapped path not passed to the loader, the sandboxed prefix not mapped, the /system/common/lib/ prefix not mapped, a name with a directory part mapped.
• The OpenOrbis piglet sample on main 03c4cb5e7 with this, feat(libScePrecompiledShaders): export the texmap shaders the piglet sample uses #6520, feat(libScePigletv2VSH): implement the EGL and GLES 2 calls of the piglet sample #6521, fix(relinker): search libc.prx for libkernel-only Windows executables #5990 to fix(relinker): stop module syscall scans at the PLT and skip the PS4 loader path #5994, feat(libSceFreeType): implement the six FreeType functions OpenOrbis samples use #6376, fix(relinker): accept section-relative guest module relocations #5138 and a change that answers the Linux TIOCGWINSZ with ENOTTY, as fix(libkernel): return ENOTTY for malformed ioctl requests #5569 did: it prints Module prefix = /gkbHtXc3Wq/common/lib/ and Modules loaded OK., and draws its rotating textured square at 59.96 FPS. With Module.cpp from main instead, it stops with the lines above.
• Full ctest of that build: 1304 of 1306 pass; agc_driver_gpu_indirect_arguments_misaligned_writer_ahead does not compile with MinGW on main (test(agc): align the indirect arguments block at run time #6452 fixes it), and prx_thread_local_destructors fails as it did on main 92cdc7b62 on this machine without my changes.
• tools/check_conventions.py passes.

Not tested on Linux or macOS.

Checklist

• Based on current main; no other open PR implements the same functions
• One topic per PR; follow-ups go in a new PR
• No comments in code except technical debt
• Unimplemented paths throw (NotImplemented_nid_no_patch); silent stubs are listed under Silent stubs in their library's technical debt file
• No notes, investigation .md files or images added to the repository (attach them to this PR)
• New third-party code is a submodule built from source
• Generic behaviour, not specific to one title
• Depends on: none for the code; the piglet sample also needs feat(libScePrecompiledShaders): export the texmap shaders the piglet sample uses #6520 and feat(libScePigletv2VSH): implement the EGL and GLES 2 calls of the piglet sample #6521
• Unblocks: OpenOrbis PS4 toolchain sample piglet, Relinker rejects PS4 executables: SCE dynamic tables and data in the code segment (two ready branches) + remaining PS4 work #3093
• GPUs tested: n/a
• AI-assisted: yes (Claude Code)

🤖 Generated with Claude Code

[github-actions]

Other open pull requests touch the same code. Merging one will break the other, or both implement the same thing. If this one builds on them, list them in Depends on.

Pull request	Conflicting files (lines on main)	Same exports	Same new files
PR 7447	docs/dev/debt/libkernel.md L235

Some comparisons could not be completed because a pull request conflicts with the base branch. Review these shared files manually before concluding that there is no overlap.

Pull request	Shared files not compared
PR 4630	docs/dev/debt/libkernel.md
PR 5021	core/libs/prx/libkernel/Module/src/Module.cpp docs/dev/debt/libkernel.md
PR 6044	core/libs/tests/GuestDynamicLoader.cpp
PR 6149	core/libs/prx/libkernel/Module/src/Module.cpp docs/dev/debt/libkernel.md
PR 6469	docs/dev/debt/libkernel.md
PR 6544	core/libs/tests/GuestDynamicLoader.cpp
PR 6740	docs/dev/debt/libkernel.md
PR 6879	core/libs/prx/libkernel/Module/src/Module.cpp docs/dev/debt/libkernel.md
PR 6936	docs/dev/debt/libkernel.md
PR 7049	docs/dev/debt/libkernel.md
PR 7088	docs/dev/debt/libkernel.md
PR 7105	docs/dev/debt/libkernel.md
PR 7121	docs/dev/debt/libkernel.md
PR 7149	docs/dev/debt/libkernel.md
PR 7192	docs/dev/debt/libkernel.md
PR 7201	core/libs/prx/libkernel/Module/src/Module.cpp
PR 7509	docs/dev/debt/libkernel.md
PR 7532	docs/dev/debt/libkernel.md
PR 8520	docs/dev/debt/libkernel.md
PR 8523	docs/dev/debt/libkernel.md
PR 8553	docs/dev/debt/libkernel.md
PR 8658	docs/dev/debt/libkernel.md
PR 8726	docs/dev/debt/libkernel.md

[jotitadev]

Linux run (Ubuntu 26.04, Intel i7-8700, GCC 15.2, full build, non-GPU tests), head 57dbfcadd merged onto main 44df21632.

• Builds; guest_dynamic_loader and guest_dynamic_loader_fixed_base pass.
• With Module.cpp from main and the PR's test, both abort at GuestDynamicLoader.cpp:106 (the /gkbHtXc3Wq/common/lib/<name>.sprx load), so the test protects the change on Linux too.

Non-GPU suite (ctest -E "^agc"): same result as main; only file_writer_binary and file_writer_text fail, and they fail on main too on this machine (Ubuntu 26.04 coreutils).

Written with AI assistance (Claude Code). I ran the builds and tests above on my machine.

[Get-fix]

Thanks for the Linux run, @jotitadev, including the check that the test fails at the sandboxed-path load without the change.

About the overlap the bot lists with #6544: I merged #6544 with git merge-file against main 5d9dcc42d, with and without this change. The only conflict is in core/libs/tests/GuestDynamicLoader.cpp, where each pull request adds an independent block of test code at the same place: this one its console-path loads, #6544 its nested prx/*.guest.prx case. Keeping both blocks resolves it. The production changes, Module.cpp here and General.cpp in #6544, do not overlap.

AI-assisted: yes (Claude Code).

🤖 Generated with Claude Code

[xXPBSXx]

Rebase handoff — this PR conflicts with main only in docs/dev/debt/libkernel.md (two entries appended at the end of the file). I rebased it onto main 892a4f1328: the original commit and its author are unchanged, the only difference is the conflict resolution in the debt file (both entries kept). Nothing in the code or the test was changed.

Windows data (Windows 10 19045, MinGW-w64 GCC 15.2.0, Release): guest_dynamic_loader fails with Module.cpp taken back to main (GuestDynamicLoader.cpp:176, exit code 0xc0000409) and passes with this change, 3 of 3 runs; guest_sysmodule and guest_module_info pass; python tools/check_conventions.py --base upstream/main passes. Not run: Linux, macOS, the piglet sample. The relinker Python tests guest_module_* did not run in my build (relinker binary not built), so they are not covered.

To pick it up:

git fetch https://github.com/xXPBSXx/AnyPS5 fix/system-library-console-paths
git checkout <your branch>
git reset --hard FETCH_HEAD

(fdacba6338 on top of 892a4f1328.) I did not open a second pull request.

AI-assisted (Claude Code).