relinker

relinker [--windows] [--windows-diagnostics] [--windows-gui] [--to-intel] [unused-filter=0|1|2] [--registry] [--rpath path] [--autorun] [--skip-sce-module] [--exclude-sce-module file]... [--skip-syscall-check] [--lazy-binding] input.elf output

relinker is the command-line converter from the AnyPS5 project. It rewrites a PlayStation 5 ELF into a native Linux ELF or Windows PE so the title links against AnyPS5's reimplemented system PRX libraries. There is no emulator process: the output runs on the host.The input must be a clean ELF. Place its bundled ELF modules in `scemodule/`, `scemodules/`, or `prx/` beside that file. `prx/` may sit next to either `scemodule/` or `scemodules/`. Having both `scemodule/` and `scemodules/`, or none of the three directories, is an error.There is no --help. Invoking relinker without both positional arguments prints the usage syntax and exits with an error. Unknown options and extra positional arguments are errors. All switches default to off.After conversion, the runtime layout is relative to the output executable: `libs/` holds the built system libraries (`*.prx` from `build/core/libs/libs/`, matching the target OS), and `app0/` holds app resources plus converted guest modules under the same directory name the input used. Relinker prints each converted module path. A custom --rpath moves the system library location.Copy the built PRX libraries into `libs/` before running the output. On Linux:

$ chmod +x [app.elf]

$ ./[app.elf]

$ git submodule update --init --recursive

$ cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++

$ cmake --build build --parallel

$ cmake --build build --target libs --parallel

--windows

Produce a Windows PE executable. The output format is Linux ELF unless this flag is set. A `.exe` suffix does not select Windows.

Include startup dependency diagnostics. Requires --windows.

Select the Windows GUI subsystem instead of the console subsystem. Requires --windows.

Convert supported AMD-only instructions in the executable and bundled modules. Unsupported instructions or unreachable conversion stubs cause an error.

Import filtering, specified at most once and without a leading `--`. 0 (default) keeps all imported NID references. 1 filters unused non-PLT imports using control-flow and GOT access analysis and preserves PLT imports. 2 applies strict unused-import analysis and compacts the PLT; unsupported analysis cases cause an error.

Write `output-stem.registry.json` beside the output executable.

System library search path. Default `$ORIGIN/libs`. Quote `$ORIGIN` so the shell does not expand it. Linux guest modules need an absolute path or a path that begins with `$ORIGIN`. Windows requires a nonempty ASCII path and treats `$ORIGIN` as the executable directory.

Run the output after conversion, print its exit code, and wait for Enter. Adds execute permission on Linux output. Requires the target OS and a prepared runtime layout.

Deprecated. Skip all bundled module processing.

Deprecated. Exclude a bundled module by exact filename, not path. Repeatable. A missing filename is an error. Conflicts with --skip-sce-module.

Deprecated. Disable syscall scanning in the executable and bundled modules.

Deprecated. Enable lazy symbol binding instead of eager binding. Incompatible with bundled ELF modules.

Keyboard and mouse bindings for a converted title live in `anyps5-input.ini` beside the generated executable. Set ANYPS5_INPUT_CONFIG to use another path. SDL-mapped game controllers are enabled automatically and are not changed by this file. With neither the file nor the environment variable, the built-in mapping is used.Each non-empty line is `Action = Type:Value`. Action names are case-insensitive. `#` or `;` starts a comment. The first line for an action replaces its built-in bindings; later lines add alternates. Omitted actions keep the defaults. An invalid line reports the file and line number and stops input initialization.Sources are `KEY:` plus an SDL key name, `MOUSE:Left|Middle|Right|X1|X2`, and `WHEEL:Up|Down`. Actions include `Cross`, `Circle`, `Triangle`, `Square`, `L1`, `R1`, `L2`, `R2`, `L3`, `R3`, `Options`, the D-pad, stick directions, `TouchLeft`, `TouchRight`, `ToggleMouse`, and `ToggleFullscreen`.Games that open console system font sets (`sceFontOpenFontSet`) look in `anyps5-fonts/` beside the output, or in ANYPS5_SYSTEM_FONTS. Console font dumps keep their original names. Without those, openly licensed Noto Sans substitutes are used when present. Without either, opening a system font set fails.Set APS5_PIPELINE_STATS=1 to print driver statistics for each newly created graphics or compute pipeline. That requires `VKKHRpipelineexecutableproperties` and `pipelineExecutableInfo`.

--skip-sce-module, --exclude-sce-module, --skip-syscall-check, and --lazy-binding are deprecated debug flags. Titles converted with them enabled are unstable.The project does not ship copyrighted firmware, keys, or game binaries. Supply your own legally obtained input ELF and modules.Converted titles need a prepared `libs/` and `app0/` layout, Vulkan (SDL), and on Intel hosts often --to-intel. Unsupported or unexpected states throw `std::runtime_error`; `what()` is printed to stderr and the process exits.On Windows, direct memory (`sceKernelAllocateDirectMemory`, up to 13824 MiB per title) is committed in full when allocated. The system commit limit must cover it.x86-64 only. Linux builds use GCC; Windows builds currently require a specific MinGW-w64 GCC 15.2.0 toolchain.

relinker is the CLI of AnyPS5, a C++20 CMake project licensed under GPL-2.0-only. The public repository's first commit is dated August 2026. Tagged releases v0.1.0 and v0.1.1 followed in September 2026.

wine(1), objcopy(1), readelf(1), ld(1), ldd(1)

Documentation · Source code