deadash / xp-compatiblerust

Introducing a powerful solution that converts any non-XP-compatible 32-bit exe or dll into a Windows XP-friendly binary. Our patch files are exceptionally small and easy to generate, making it incredibly straightforward to extend your software's support to the XP ecosystem.

MakeXPStub: Make Your PE Executables XP-Compatible

Introduction

MakeXPStub is a utility designed to make your PE (Portable Executable) files compatible with Windows XP. This is particularly useful for executables compiled with Rust, which may not natively support Windows XP. The tool operates by modifying the Import Address Table (IAT) of the target executable to forward incompatible API calls to xpstub.dll. This DLL contains implementations that make these APIs compatible with Windows XP. The underlying implementation for these thunks is sourced from YY-Thunks.

Features

• Modify PE Files: Automatically update the IAT to make your executables XP-compatible.
• DLL Forwarding: Forwards incompatible API calls to xpstub.dll.
• Built for Rust: Tailored for executables compiled with Rust but can be used for any PE file.
• Minimal Footprint: Generates minimal patches that can be easily distributed.

Prerequisites

• Rust Toolchain
• Windows SDK
• NMake (For building xpstub.dll)

Compilation

To compile the project, you need to execute two commands:

1. Build the native components with the batch script:

   .\Build.ps1 build

2. Then build the Rust components:

   cargo build --release

Usage

After the compilation steps, you can use the makexpstub.exe command-line utility to convert your executables. Here's the basic syntax:

makexpstub.exe --input a.exe --output a-xp.exe

This will read a.exe, modify its IAT, and produce a-xp.exe which will be compatible with Windows XP.

Contributing

We welcome contributions and bug reporting. Feel free to open an issue or submit a pull request.

Acknowledgements

A big thank you to the YY-Thunks project for providing the essential API implementations that made this project possible.

License

This project is licensed under MIT License.

For more details, please refer to the LICENSE file in the repository.

xp-compatiblerust's Issues

Have you tried compiling tokio before? Can it run in XP

Have you tried compiling tokio before? Can it run in XP？