基于 Box64 实现 x86_64 用户态程序在AArch64\riscv系统上的运行支持

# 中文版本

- 项目名称  
基于 Box64 实现 x86_64 用户态程序在 AArch64 和 RISC-V 系统上的运行支持

- 项目描述：  
（1）相关背景  
在国产 CPU 与 openEuler 操作系统推广过程中，工业仿真、医疗生物等行业中仍存在大量基于 x86_64 架构的软件，这些软件缺乏源码且无人维护，兼容性成为亟需解决的问题。Box64 是一款轻量级用户态动态二进制翻译器，可在 AArch64 和 RISC-V 平台上运行 x86_64 Linux 程序，具备对 Wine 等复杂软件的兼容潜力。  
（2）已有的工作  
Box64 项目已经开源，并成功支持多个 AArch64 Linux 系统，能运行多种图形和命令行程序。  
（3）存在的不足  
openEuler 系统对 Box64 支持不完善，缺乏官方封装和适配文档，且在动态链接库加载、系统调用兼容性方面存在问题，导致部分程序运行失败或不稳定。  
（4）希望改进的点  
    - 改进 Box64 在 openEuler 上的运行环境和配置集成  
    - 提供构建脚本和依赖环境准备方案  
    - 修复已知的兼容性问题（如常用库加载、线程模型等）  
    - 编写面向社区的使用手册与调试指南  
（5）最终项目实现的目标  
实现 Box64 在 openEuler AArch64 和 RISC-V 平台上的稳定运行，能够兼容常见 x86_64 用户态程序，并形成标准化的适配文档与测试样例。

- 项目难度  
进阶

- 技术领域标签：  
操作系统、二进制翻译、系统兼容性

- 编程语言标签：  
C/C++、Shell、Python

- 项目产出要求：  
完善 Box64 在 openEuler 上的运行支持  
提供完整构建脚本和工具链配置  
提交修复补丁解决兼容性问题  
补充测试案例与验证说明文档  
撰写社区使用说明与调试文档

- 项目技术要求：  
熟悉 Linux 操作系统与用户态调试  
掌握 C/C++ 编程与动态链接原理  
了解 QEMU/Box64 等二进制兼容机制  
熟练使用 Shell 和 Python 脚本

- 项目成果提交仓库：  
https://gitee.com/src-openeuler/box64

- 预估工时  
8~10 周

- 项目备注  
- Box64 官方仓库：https://github.com/ptitSeb/box64  
- openEuler 社区兼容性 issue：https://gitee.com/src-openeuler/community/issues  
- 参考技术：ELF 格式、系统调用转译、动态链接器、LD_PRELOAD 技巧

- 项目导师名字&导师邮箱：  
高冲（monic77@126.com）

---

# English Version

- Project Title  
x86_64 User-space Compatibility on AArch64 and RISC-V Systems via Box64

- Project Description:  
(1) Background  
In promoting domestic CPUs and the openEuler OS, many x86_64 applications are still widely used in fields such as industrial simulation and biomedical computing. These programs often lack source code and are no longer maintained, making compatibility a critical issue. Box64 is a lightweight user-space dynamic binary translator that allows running x86_64 Linux applications on AArch64 and RISC-V platforms, with compatibility potential for complex software like Wine.  
(2) Existing Work  
Box64 is an open-source project that currently supports several AArch64 Linux distributions and can run various GUI and CLI programs.  
(3) Limitations  
Box64 lacks complete support on openEuler. There is no official packaging or documentation for the community. Some dynamic libraries and syscalls remain incompatible, causing instability in runtime.  
(4) Improvements Desired  
- Improve runtime adaptation and packaging of Box64 on openEuler  
- Provide build scripts and dependency preparation tools  
- Fix compatibility issues such as library loading and threading models  
- Write user-facing documentation and debugging guides  
(5) Final Goal  
Ensure Box64 runs stably on openEuler AArch64 and RISC-V platforms, supports common x86_64 user-space applications, and delivers a standardized adaptation guide with test cases.

- Project Difficulty  
Advanced

- Technical Domain Tags:  
Operating Systems, Binary Translation, Compatibility Layer

- Programming Language Tags:  
C/C++, Shell, Python

- Deliverables:  
Enable Box64 support on openEuler OS  
Provide build scripts and toolchain config  
Submit patches fixing compatibility issues  
Add test cases and validation documentation  
Write usage and debugging guides for the community

- Technical Requirements:  
Familiar with Linux internals and user-space debugging  
Proficient in C/C++ and dynamic linking concepts  
Understanding of QEMU/Box64 binary translation  
Skilled in Shell and Python scripting

- Submission Repository:  
https://gitee.com/src-openeuler/box64

- Estimated Workload  
8–10 weeks

- Project References  
- Box64 GitHub: https://github.com/ptitSeb/box64  
- openEuler compatibility discussions: https://gitee.com/src-openeuler/community/issues  
- Related concepts: ELF format, syscall translation, dynamic linker internals, LD_PRELOAD usage

- Mentor Name & Email:  
Chong Gao (monic77@126.com)

openEuler/open-source-summer

Content Risk Flag

Comments (1)

openEuler/open-source-summer .gitee-modal { width: 500px !important; }

Content Risk Flag