嵌入式开发实战：在 Ubuntu 22.04 上交叉编译 Valgrind Massif 并部署到 ARM64...

在嵌入式 Linux 开发中，内存泄漏和堆分析是调试性能瓶颈的关键环节。本文将带你从零开始，在 Ubuntu 22.04 x86_64 主机上使用 Rockchip aarch64 交叉编译工具链，编译 Valgrind 3.22.0（含 Massif 堆分析工具），并完整部署到 ARM64 开发板上。无论你使用 C++、Python 还是其他语言编写的程序，这套方法都能帮助你精准定位内存问题。

⚙️ 环境准备与依赖安装

在开始交叉编译之前，确保主机环境满足以下条件：主机为 Ubuntu 22.04 x86_64，内核版本 6.8.0；交叉编译器使用 aarch64-rockchip-linux-gnu-gcc 9.3.0（来自 Buildroot 工具链）。目标 ARM 板为 Rockchip RK3568 M3568，运行 Linux 4.19.193 aarch64 系统，glibc 版本 2.29，这是一个无 gcc 和 valgrind 的最小化嵌入式系统。

技术背景：交叉编译的核心在于让主机（x86_64）生成目标板（aarch64）可执行的二进制文件。与 Java 或 TypeScript 的跨平台特性不同，C/C++ 程序需要手动配置工具链和链接库。

首先，安装 autotools 等构建工具：

sudo apt-get update
sudo apt-get install -y automake autoconf libtool make wget

⚠️ 注意：如果主机上已有 Python 或 Perl 环境，请确保它们与交叉编译过程不冲突。嵌入式开发中，依赖管理是关键，建议使用 Buildroot 或 Yocto 这类工具来统一管理。

下载与配置 Valgrind 源码

Valgrind 3.22.0 是目前最新的稳定版本，支持 Massif、Memcheck 等多个分析工具。下载源码后，需要配置交叉编译环境：

cd /tmp
wget https://sourceware.org/pub/valgrind/valgrind-3.22.0.tar.bz2
tar xjf valgrind-3.22.0.tar.bz2

关键配置点：交叉编译器需要设置 --host=aarch64-linux 以及正确的 CC 和 LD 环境变量。同时，必须设置 CFLAGS 和 LDFLAGS 指向交叉编译工具链的库路径，否则 configure 会报错。

# 设置交叉编译器环境变量
export CROSS_COMPILE=/opt/zlg/m3568-sdk-v1.0.0-ga/gcc-buildroot-9.3.0-2020.03-x86_64_aarch64-rockchip-linux-gnu/bin/aarch64-rockchip-linux-gnu-
# 关键: 设置 LD_LIBRARY_PATH，否则 cc1 会报 libisl.so.15 找不到
export LD_LIBRARY_PATH=/opt/zlg/m3568-sdk-v1.0.0-ga/gcc-buildroot-9.3.0-2020.03-x86_64_aarch64-rockchip-linux-gnu/lib:$LD_LIBRARY_PATH

验证编译器是否可用：

echo 'int main(){return 0;}' > /tmp/test.c
${CROSS_COMPILE}gcc /tmp/test.c -o /tmp/test
file /tmp/test
# 应输出: ELF 64-bit LSB executable, ARM aarch64

最佳实践：在配置过程中，建议先运行 ./configure --help 查看所有选项。与 JavaScript 或 Python 的即时运行不同，C/C++ 交叉编译需要精确控制编译参数，否则生成的可执行文件可能在 ARM 板上无法运行。

配置 Valgrind 时，使用以下命令：

cd /tmp/valgrind-3.22.0
./configure \
--host=aarch64-rockchip-linux-gnu \
--prefix=/opt/massif \
CC="${CROSS_COMPILE}gcc" \
CXX="${CROSS_COMPILE}g++" \
AR="${CROSS_COMPILE}ar" \
LD="${CROSS_COMPILE}ld" \
RANLIB="${CROSS_COMPILE}ranlib" \
STRIP="${CROSS_COMPILE}strip" \
--enable-only64bit

configure 成功后应看到类似输出：

Primary build target: ARM64_LINUX
Version: 3.22.0

️ 编译、精简与部署

配置完成后，执行编译：

make -j$(nproc)

编译完成后，安装到临时目录：

make install DESTDIR=/tmp/valgrind-install

空间优化技巧：默认安装包大小约 210MB，对于嵌入式设备来说过于庞大。通过 strip 二进制文件并删除开发文件，可以精简到 23MB：

STRIP=${CROSS_COMPILE}strip
# Strip ELF 二进制文件
for f in /tmp/valgrind-install/opt/massif/bin/*; do
file "$f" | grep -q "ELF" && $STRIP "$f"
done
for f in /tmp/valgrind-install/opt/massif/libexec/valgrind/*; do
file "$f" | grep -q "ELF" && $STRIP "$f"
done
# 删除运行时不需要的文件
rm -rf /tmp/valgrind-install/opt/massif/include
rm -rf /tmp/valgrind-install/opt/massif/lib/pkgconfig
rm -rf /tmp/valgrind-install/opt/massif/share/doc
rm -rf /tmp/valgrind-install/opt/massif/share/man
rm -f  /tmp/valgrind-install/opt/massif/lib/valgrind/*.a

将精简后的包部署到 ARM 板：

# 在 ARM 板上创建目录
ssh root@<ARM_IP> "mkdir -p /opt/massif"
  # 拷贝文件
  scp -r /tmp/valgrind-install/opt/massif/* root@<ARM_IP>:/opt/massif/
    # 添加到 PATH (写入 /etc/profile 持久化)
    ssh root@<ARM_IP> 'echo "export PATH=/opt/massif/bin:\$PATH" >> /etc/profile'

验证部署是否成功：

ssh root@<ARM_IP> "
  export PATH=/opt/massif/bin:\$PATH
  valgrind --version
  # 应输出: valgrind-3.22.0
  "

✅ 常见问题：如果遇到 Permission denied，记得给 valgrind 和 ms_print 添加可执行权限。如果 ms_print 报错 perl not found，需要在 ARM 板上安装 Perl 解释器（大部分嵌入式系统自带）。

使用 Massif 进行堆分析

Massif 是 Valgrind 中最常用的堆分析工具之一，特别适合 C/C++ 程序的内存优化。基本使用方法：

# 运行 massif 分析程序的堆内存使用
valgrind --tool=massif --massif-out-file=/tmp/massif.out ./your_program
# 查看分析结果
ms_print /tmp/massif.out

常用 Massif 参数：

# 设置快照间隔 (默认基于指令数)
valgrind --tool=massif --time-unit=ms ./your_program
# 跟踪栈内存 (默认只跟踪堆)
valgrind --tool=massif --stacks=yes ./your_program
# 设置分析粒度
valgrind --tool=massif --detailed-freq=1 ./your_program
# 设置堆分析深度
valgrind --tool=massif --depth=10 ./your_program
# 监控特定分配函数
valgrind --tool=massif --alloc-fn=my_alloc ./your_program

应用场景：如果你从 Java 或 TypeScript 转来嵌入式开发，可能会对手动内存管理感到陌生。Massif 能够可视化堆内存的分配和释放过程，帮助你找到内存泄漏点。例如，通过 --time-unit=ms 可以按时间分析内存变化，结合 Python 脚本进行自动化分析。

[AFFILIATE_SLOT_1]

其他工具与移植指南

由于安装的是完整 Valgrind，以下工具也可在 ARM 板上使用：

Memcheck：内存错误检测（valgrind --tool=memcheck ./program）
Cachegrind：缓存分析（valgrind --tool=cachegrind ./program）
Callgrind：调用图分析（valgrind --tool=callgrind ./program）
Helgrind：线程错误检测（valgrind --tool=helgrind ./program）
DRD：线程错误检测（valgrind --tool=drd ./program）
DHAT：动态堆分析（valgrind --tool=dhat ./program）

移植到其他 ARM 板 的前提条件：目标板需满足架构为 aarch64，glibc >= 2.29，内核 >= 4.19。快速移植步骤：

# 1. 在当前 ARM 板上打包
ssh root@<SOURCE_ARM_IP> "cd /opt && tar czf /tmp/massif-aarch64.tar.gz massif/"
  # 2. 拷贝到本机
  scp root@<SOURCE_ARM_IP>:/tmp/massif-aarch64.tar.gz /tmp/
    # 3. 拷贝到目标板
    scp /tmp/massif-aarch64.tar.gz root@<TARGET_ARM_IP>:/tmp/
      # 4. 在目标板上解压
      ssh root@<TARGET_ARM_IP> "cd /opt && tar xzf /tmp/massif-aarch64.tar.gz"
        # 5. 添加到 PATH
        ssh root@<TARGET_ARM_IP> 'echo "export PATH=/opt/massif/bin:\$PATH" >> /etc/profile'
          # 6. 验证
          ssh root@<TARGET_ARM_IP> "export PATH=/opt/massif/bin:\$PATH && valgrind --version"

安装目录结构：

/opt/massif/                        (总大小约 23M)
├── bin/                            (可执行文件)
│   ├── valgrind                    (主程序入口)
│   ├── ms_print                    (massif 结果格式化输出, Perl脚本)
│   ├── vgdb                        (valgrind GDB 连接器)
│   ├── callgrind_annotate          (callgrind 结果分析)
│   ├── callgrind_control           (callgrind 控制)
│   ├── cg_annotate                 (cachegrind 结果分析)
│   ├── cg_diff                     (cachegrind 结果对比)
│   ├── cg_merge                    (cachegrind 结果合并)
│   ├── valgrind-di-server          (调试信息服务)
│   └── valgrind-listener           (远程监听)
├── lib/
│   └── valgrind/                   (suppression 文件等)
│       ├── default.supp
│       └── *.supp
├── libexec/
│   └── valgrind/                   (工具核心文件)
│       ├── massif-arm64-linux      (massif 工具核心, 静态链接)
│       ├── vgpreload_massif-arm64-linux.so
│       ├── memcheck-arm64-linux
│       ├── vgpreload_memcheck-arm64-linux.so
│       ├── cachegrind-arm64-linux
│       ├── callgrind-arm64-linux
│       ├── helgrind-arm64-linux
│       ├── drd-arm64-linux
│       ├── dhat-arm64-linux
│       ├── lackey-arm64-linux
│       ├── none-arm64-linux
│       ├── vgpreload_core-arm64-linux.so
│       └── *.xml                   (GDB 描述文件)
└── share/
    └── valgrind/                   (支持文件)

依赖说明：

主程序：动态链接，仅依赖 libc.so.6（ARM 板系统自带）
massif-arm64-linux 等工具核心：静态链接，无外部依赖
ms_print：Perl 脚本，需要 ARM 板上有 Perl 解释器

⚠️ 故障排除：如果 configure 报错 “C compiler cannot create executables”，原因是缺少 libisl.so.15，解决方法是设置 LD_LIBRARY_PATH 指向交叉编译工具链的 lib 目录。如果 valgrind 运行报 FATAL 错误，请检查内核版本是否 >= 4.19，glibc 版本是否 >= 2.29。

[AFFILIATE_SLOT_2]

总结

通过本教程，你学会了在 Ubuntu 22.04 上交叉编译 Valgrind Massif 并部署到 ARM64 开发板的完整流程。核心要点包括：正确配置交叉编译工具链、精简安装包以节省空间、以及解决常见部署问题。这套方法不仅适用于 RK3568，也兼容大多数 aarch64 嵌入式系统。无论你使用 C++、Python 还是其他语言，Valgrind 都是内存分析的利器。

发表于 2026-07-13 20:24 jzssuanfa 阅读(10) 评论(0) 收藏举报

刷新页面返回顶部