Skip to content

About

No description, website, or topics provided.

Resources

Stars

18 stars

Watchers

1 watching

Forks

Latest commit

 

History

14 Commits

Folders and files

Repository files navigation

English

liblasx2lsx

LASX(LoongArch SIMD Extension,256 位向量指令)软件模拟与二进制翻译方案,提供两种工作模式:

  1. 按需加载内核模块(lasx2lsx.ko / liblasx2lsx-dkms,推荐):内核态拦截保留指令陷阱并按需注入独立 PIE 运行时,无需设置 LD_PRELOAD 或 /etc/ld.so.preload,对未执行 LASX 的普通进程零开销,原生支持清空环境变量启动器、静态链接(-static)程序、自定义 SIGILL 信号处理器的运行时及严格 W^X 代码页。
  2. 用户态预加载库(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 本地编译。

使用

在真实 LoongArch 设备上

# 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_binary

LD_PRELOAD 机制说明

LD_PRELOAD 是 Linux 动态链接器的环境变量。设置后,指定的共享库会在所有其他库之前加载。本库利用此机制:

  1. 库的构造函数 register_sigill_handler() 在进程启动时自动执行
  2. 注册 SIGILL 信号处理器
  3. 程序执行中遇到 LASX 指令 → 硬件 SIGILL → 被本库捕获 → 软件模拟
  4. 首次模拟后,用 jiscr1 指令原地替换原 LASX 指令,后续执行直接跳转 JIT 代码,不再触发 SIGILL

整个过程对目标程序完全透明,无需修改代码或重新链接。

按需加载内核模块(免 LD_PRELOAD,DKMS)

对于系统级透明兼容场景(例如桌面应用启动器清理 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() 透明兼容:结合 LBT EXCCODE_BTDIS 首次使用陷阱按需为任意线程绑定 $scr1/$scr2,退出线程的 64KB 上下文槽位自动回收复用。

安装与启用(3B6000M / 2K3000)

# 构建并安装 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 上模拟验证

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 lasx2lsx

测试

make 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 模式见:

许可

  • 用户态模拟库与 JIT 核心(src/):MIT
  • 内核模块(kmod/):GPL-2.0-only(共享协议与运行时胶水 GPL-2.0-only OR MIT 双许可)

About

No description, website, or topics provided.

Resources

Stars

18 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages