LASX(LoongArch SIMD Extension,256 位向量指令)软件模拟与二进制翻译方案,提供两种工作模式:
- 按需加载内核模块(
lasx2lsx.ko/liblasx2lsx-dkms,推荐):内核态拦截保留指令陷阱并按需注入独立 PIE 运行时,无需设置LD_PRELOAD或/etc/ld.so.preload,对未执行 LASX 的普通进程零开销,原生支持清空环境变量启动器、静态链接(-static)程序、自定义SIGILL信号处理器的运行时及严格W^X代码页。 - 用户态预加载库(
liblasx2lsx.so):无需内核权限,通过LD_PRELOAD+SIGILL信号捕获在纯用户态完成模拟与 JIT 翻译。
某些 LoongArch 平台(如 2K3000、3B6000M 等)只支持 LSX(128 位向量指令),不支持 LASX(256 位向量指令)。在这些平台上运行编译时开启了 LASX 优化的程序会因 SIGILL 崩溃。
本库通过 LD_PRELOAD 机制在运行时捕获 SIGILL,对 LASX 指令执行软件模拟,使程序无需修改即可正常运行。
- 如果目标程序已实现动态适配(运行时检测 LASX 支持并选择合适代码路径),则无需本库
- 本库解决的是:编译时假设 LASX 可用,但实际硬件不支持的场景
应用程序 (编译时生成 LASX 指令)
│
▼
┌─ CPU 执行 ──────────────────────────────────┐
│ LASX 指令 → 硬件不支持 → SIGILL 信号 │
└──────────────────────────────────────────────┘
│
▼
┌─ liblasx2lsx (LD_PRELOAD) ─────────────────┐
│ sigill_handler() │
│ ├─ 通过 ucontext_t 读取指令码 + 寄存器状态 │
│ ├─ JIT 翻译 → LSX 指令序列 (首选) │
│ │ (将 256 位拆为 2 × 128 位执行) │
│ └─ 纯 C 模拟 (兜底) │
│ │ │
│ 后续执行: 用 jiscr1 替换原指令, 直接跳到 │
│ JIT 代码, 不再触发 SIGILL │
└──────────────────────────────────────────────┘
JIT 翻译支持三层优化策略:
| 策略 | 说明 |
|---|---|
| emu | 纯 C 模拟,每条指令独立处理 |
| block | 批量翻译连续 LASX 指令 |
| usedef | use/def 分析优化寄存器分配(默认) |
| loop | 循环检测 + 整体 JIT 翻译(默认) |
gcc -mlsx # 编译本库需要 -mlsx 支持 (LSX 128位指令)如果只需使用(不编译),直接下载预编译的 .so 即可,无需安装任何工具。
make # 编译全部用户态库:liblasx2lsx.so + 调试版 + 性能分析版
make deb # 打包用户态库 liblasx2lsx_1.0.0_loongarch64.deb
make deb-dkms # 打包按需加载内核模块 liblasx2lsx-dkms_1.0.0_all.deb
make kmod # 在目标 LoongArch 机器针对当前内核直接编译 kmod/lasx2lsx.ko
make clean # 清理编译产物
make debug # 仅调试版 (liblasx2lsx_dbg.so)
make profile # 性能分析版 (liblasx2lsx_profile.so)LoongArch 主机使用 gcc 本地编译。
# 1. 编译库
make
# 2. 运行你的程序
LD_PRELOAD=./liblasx2lsx.so ./your_loongarch_binary
# 3. 如果是多线程程序,正常工作(线程安全)
LD_PRELOAD=./liblasx2lsx.so ./your_multithreaded_program通过环境变量 LIBLASX2LSX_INTERPRET_MODE 控制:
# 默认优化组合(推荐)
LD_PRELOAD=./liblasx2lsx.so ./your_binary
# 关闭 JIT,仅纯模拟(调试用)
LIBLASX2LSX_INTERPRET_MODE=emu LD_PRELOAD=./liblasx2lsx.so ./your_binary
# block 模式(无 use/def 优化)
LIBLASX2LSX_INTERPRET_MODE=block LD_PRELOAD=./liblasx2lsx.so ./your_binary模式说明:
| 模式 | 含义 |
|---|---|
usedef |
use/def 批量翻译优化 |
loop |
循环检测与 JIT |
frag |
片段 xvmap 优化 |
block |
传统块翻译(与 usedef 互斥) |
emu / one |
纯模拟,关闭所有优化 |
LIBLASX2LSX_INTERPRET=off LD_PRELOAD=./liblasx2lsx.so ./your_binaryLD_PRELOAD 是 Linux 动态链接器的环境变量。设置后,指定的共享库会在所有其他库之前加载。本库利用此机制:
- 库的构造函数
register_sigill_handler()在进程启动时自动执行 - 注册 SIGILL 信号处理器
- 程序执行中遇到 LASX 指令 → 硬件 SIGILL → 被本库捕获 → 软件模拟
- 首次模拟后,用
jiscr1指令原地替换原 LASX 指令,后续执行直接跳转 JIT 代码,不再触发 SIGILL
整个过程对目标程序完全透明,无需修改代码或重新链接。
对于系统级透明兼容场景(例如桌面应用启动器清理 LD_PRELOAD、脚本包装程序、静态链接二进制、或 Go/JVM/浏览器自定义 SIGILL 处理器),可安装 liblasx2lsx-dkms:
模块从 EENTRY 和 ECFG.VS 计算异常入口,保存入口前 28 字节并跳转到模块自己的现场保存代码,不扫描或匹配原内核指令。寄存器栈偏移来自当前内核的生成头文件。5.17 之前使用旧异常返回路径,仅支持非抢占配置。已在 Loongnix 4.19.0-19-loongson-3 上使用 3A6000 模拟模式验证。麒麟工业版 V10 SP1 的 5.4.18-152-generic 也使用此路径。
名称过滤只控制首次注入。已注入进程的工作线程改名后创建子进程,子进程仍会恢复继承的模拟运行时;执行 exec 换成新程序后重新判断范围。模块要求 CONFIG_KALLSYMS_ALL,以便按符号名查找 kernelsp 和原异常处理函数;5.7 及以后还要求 CONFIG_KPROBES。新版内核调用 irqentry_enter/exit 建立允许等待的处理上下文,并要求 CONFIG_TRACEPOINTS,用于清理因致命信号而不再返回的异常处理。缺少所需符号或使用共享异常入口(ECFG.VS=0)时拒绝加载。已在 AOSC 6.18.27 上使用 3A6000 模拟模式验证。
- 生产平台门禁:模块默认仅在龙芯 3B6000M / 2K3000(支持 LSX + LBT、硬件无 LASX)上初始化并自动生效;在 3A6000 等原生支持 LASX 的处理器上默认拒绝加载(返回
-ENODEV),避免误伤硬件性能。 - 零全局污染:未触发 LASX 指令的进程不注入任何内存映射、不占用额外虚拟地址空间。
- 多线程与
fork()透明兼容:结合 LBTEXCCODE_BTDIS首次使用陷阱按需为任意线程绑定$scr1/$scr2,退出线程的 64KB 上下文槽位自动回收复用。
# 构建并安装 DKMS 包(自动针对当前内核编译并在启动时按需加载)
make deb-dkms
sudo dpkg -i liblasx2lsx-dkms_1.0.0_all.deb
# 此后直接运行包含 LASX 指令的任意程序,无需设置 LD_PRELOAD:
./your_lasx_binary可通过 sysfs 动态调整翻译模式或查看运行统计:
# 查看或切换 JIT 优化模式(默认 usedef,loop,frag;可选 block / one / off)
cat /sys/module/lasx2lsx/parameters/interpret_mode
echo block | sudo tee /sys/module/lasx2lsx/parameters/interpret_mode
# 查看按需注入与陷阱统计
head /sys/module/lasx2lsx/parameters/stat_*3A6000 仅用于开发验证,需显式开启 sim_3a6000=1 并指定 target_comm 进程名前缀过滤(拦截 do_lasx 模拟 3B6000M 保留指令陷阱):
make kmod kmod-tests
sudo insmod kmod/lasx2lsx.ko sim_3a6000=1 target_comm=test_lasx
env -i ./kmod/tests/test_lasx_raw_ri
env -i ./kmod/tests/test_lasx_suite
env -i ./kmod/tests/test_lasx_static
env -i ./kmod/tests/test_lasx_fork
sudo ./kmod/tests/test_lasx_fork --disable-runtime
sudo rmmod lasx2lsxmake test # 默认优化模式(703 条随机测试)
make test-one # 纯模拟模式
make test-single TEST=xvadd.b # 单条指令测试src/
├── include/ # 头文件
├── emu/ # SIGILL 捕获 + 指令模拟 + 线程数据
├── interpret/ # JIT 解释层(批量翻译 + 优化)
└── lagoon.c # LoongArch 汇编器(指令编码发射)
kmod/ # 免 LD_PRELOAD 按需加载内核模块与 DKMS 配置
├── lasx2lsx_kmod.c # 内核模块主体(陷阱拦截、按需映射、LBT 延迟初始化、W^X COW 补丁)
├── rt/ # 无 libc 依赖的独立 PIE 运行时胶水与构建脚本
└── tests/ # 裸机 (-nostdlib)、静态链接 (-static)、多线程与 W^X 专项测试
tools/ # 辅助脚本
tests/ # 单元测试
random_test/ # 随机测试框架(703 条指令)
doc/
├── development.md # 开发者文档:架构、调试、改进方向
└── ... # 其他技术文档
详细的架构说明、调试方法和已知 Bug 模式见:
- doc/development.md — 开发者文档
- 用户态模拟库与 JIT 核心(
src/):MIT - 内核模块(
kmod/):GPL-2.0-only(共享协议与运行时胶水GPL-2.0-only OR MIT双许可)