Go to file
devilismyfriend 01c4e3edf7 feat(relinker): --to-intel lowers SSE4a sites to same-length jumps into an appended stub section
EXTRQ, INSERTQ, MOVNTSS and MOVNTSD are rewritten at relink time: same-length in-place forms
where they exist, otherwise a jmp rel32 into an appended executable section holding a
scratch-free SSE body and a jump back, so no code shifts and no RIP-relative or jump-table
operand needs adjusting. Decoder fixes for POPCNT and 0F BB (BTC), codegen and elfpatcher
tests, README and technical-debt notes. The runtime illegal-instruction trap stays as a
fallback.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0177gthrWEBBfBu5xJDXgBfo
2026-09-26 19:00:39 -07:00
3rdparty feat(repo): add git submodules to 3rdparty 2026-09-11 15:51:24 +03:00
core feat(relinker): --to-intel lowers SSE4a sites to same-length jumps into an appended stub section 2026-09-26 19:00:39 -07:00
docs feat(relinker): --to-intel lowers SSE4a sites to same-length jumps into an appended stub section 2026-09-26 19:00:39 -07:00
.gitignore chore(gitignore): ignore build_tools/ secondary CMake tree 2026-09-25 16:27:49 -07:00
.gitmodules feat(repo): add git submodules to 3rdparty 2026-09-11 15:51:24 +03:00
CMakeLists.txt fix(build): register relinker tests with CTest 2026-09-25 05:27:19 +10:00
LICENSE initial commit 2026-08-03 20:02:52 +03:00
README.md feat(relinker): --to-intel lowers SSE4a sites to same-length jumps into an appended stub section 2026-09-26 19:00:39 -07:00

README.md

About

Tool for automatic executables porting to Linux and Windows.

Includes a relinker that converts executable to the target system's native format and implementations of system prx libraries suitable for dynamic linking. No emulation or separate runtime process.

relinker --to-intel rewrites the Zen 2-only instructions a title may contain (EXTRQ, INSERTQ, MOVNTSS, MOVNTSD) at relink time, in place when an equal-length Intel encoding exists and otherwise through a jump to a generated stub section, so Intel hosts need no runtime emulation.

Releases will be published after the first full successful launch of at least one game.

Status

Execution reaches _start, stack unwinding and exception handling tables are built, reaches main. Unsupported or unexpected states strictly throw std::runtime_error. what() is printed to stderr and the process terminates.

The shader recompiler successfully produces validated via Spirv-Tools SPIR-V.

The real game reaches the logo, main menu, and gameplay with audio.

Technical debt of the project, code style conventions

Build

The relinker uses only the C++20 standard library and should build with any conforming compiler.

libc.prx implementations contain compiler-specific code. Linux builds work with GCC; on Windows, MinGW-w64 GCC 15.2.0 (winlibs-gcc15, x86_64-ucrt-posix-seh) is currently required.

The project targets maximum compiler portability. Support for additional compilers will be addressed after the first successful game launch.

Disclaimer

This project is intended for interoperability, research, preservation, and compatibility purposes. It does not include, distribute, or require copyrighted software, firmware, cryptographic keys, or proprietary libraries. Users are responsible for ensuring that any binaries used with this project are obtained and used in accordance with applicable laws and their respective license terms.

License

This project is licensed under the GNU General Public License version 2 only.