Home

LAT Wiki

English index

LATX（LoongArch Architecture Translator for x86）即龙芯 x86 架构转译器，是 一个面向 LoongArch 架构的高性能用户级二进制翻译器，用于在龙架构系统上高效地 运行 32/64 位 x86 应用程序。

第一次使用

1. 先阅读主仓库 README，确认主机架构、 指令集扩展和 ABI 满足要求。
2. 按编译、安装和运行完成构建、安装和静态程序验证。
3. 运行动态链接程序或 Wine 前，准备与程序匹配的 x86 guest 运行时。
4. 遇到问题先查常见问题，需要进一步归因时再使用 调试与问题定位指南。

用户文档

• 编译、安装和运行：安装 LATX、验证 binfmt、准备 runtime 和 Wine、升级与卸载。
• 配置与环境变量：配置优先级、常用入口和唯一参考文档。
• 常见问题：缺库、AVX、浮点、TSO、SIGSEGV 等高频问题。
• 调试与问题定位指南：面向需要继续定位问题的用户和 开发者。

开发者文档

• 代码结构：LATX 主要目录、模块职责和常见修改入口。
• Git 提交规范
• 贡献指南
• Commit Convention

相关项目与资料

• LoongArch Documentation
• QEMU
• box64
• LoongArch memory-model-config

获取帮助

• 可复现的缺陷和兼容性问题：提交 Issue。
• 使用讨论、方案交流和经验分享：使用 Discussions。
• 提交问题时请附上 LATX 版本、宿主 ABI 和页大小、guest 文件类型、运行时信息、 完整命令及错误输出；常见问题提供了检查清单。