ClamAV项目在Linux上交叉编译至ARM64架构指南

前言

在嵌入式开发和跨平台应用场景中，交叉编译是一项关键技术。本文将详细介绍如何在x86_64架构的Linux主机上，为ARM64(aarch64)架构的目标设备交叉编译ClamAV杀毒软件。

交叉编译基础概念

交叉编译(Cross-compilation)是指在一个平台上生成另一个平台可执行代码的过程。与本地编译不同，交叉编译需要：

1. 目标平台的工具链(编译器、链接器等)
2. 目标平台的库文件和头文件
3. 适当的构建系统配置

对于ClamAV这样的复杂项目，正确配置交叉编译环境尤为重要。

准备工作

工具链安装

首先需要安装ARM64架构的交叉编译工具链：

# 安装GCC/G++交叉编译器
sudo apt install -y g++-aarch64-linux-gnu

# 添加Rust的ARM64目标支持
rustup target add aarch64-unknown-linux-gnu

依赖库处理

ClamAV依赖多个第三方库，我们需要为目标架构安装这些库的开发包：

1. 添加ARM64架构支持：

sudo dpkg --add-architecture arm64

2. 创建新的软件源列表文件/etc/apt/sources.list.d/arm-cross-compile-sources.list，内容如下(以Ubuntu 20.04为例)：

deb [arch=arm64] http://ports.ubuntu.com/ focal main restricted
deb [arch=arm64] http://ports.ubuntu.com/ focal-updates main restricted
deb [arch=arm64] http://ports.ubuntu.com/ focal universe
deb [arch=arm64] http://ports.ubuntu.com/ focal-updates universe
deb [arch=arm64] http://ports.ubuntu.com/ focal multiverse
deb [arch=arm64] http://ports.ubuntu.com/ focal-updates multiverse
deb [arch=arm64] http://ports.ubuntu.com/ focal-backports main restricted universe multiverse

3. 安装ARM64版本的依赖库：

apt-get update && apt-get install -y \
  check:arm64 \
  libbz2-dev:arm64 \
  libcurl4-openssl-dev:arm64 \
  libjson-c-dev:arm64 \
  libmilter-dev:arm64 \
  libncurses5-dev:arm64 \
  libpcre2-dev:arm64 \
  libssl-dev:arm64 \
  libxml2-dev:arm64 \
  zlib1g-dev:arm64

安装完成后，ARM64架构的库文件将位于/usr/lib/aarch64-linux-gnu/目录下，头文件则位于标准的/usr/include/目录。

CMake工具链文件配置

CMake是ClamAV使用的构建系统，我们需要创建专门的工具链文件来指导交叉编译过程。

使用sysroot的情况

如果你的目标平台有完整的sysroot文件系统，可以使用以下配置：

# 基本平台设置
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm64)
set(CMAKE_C_COMPILER "aarch64-linux-gnu-gcc")
set(CMAKE_CXX_COMPILER "aarch64-linux-gnu-g++")
set(RUST_COMPILER_TARGET "aarch64-unknown-linux-gnu")

# 交叉编译必需的项目变量
set(HAVE_ATTRIB_ALIGNED 1)
set(HAVE_ATTRIB_PACKED 1)
set(HAVE_UNAME_SYSCALL 1)
set(HAVE_SAR 1)
set(HAVE_FD_PASSING 1)
set(MMAP_FOR_CROSSCOMPILING ON)
set(ENABLE_SYSTEMD OFF)

# Sysroot设置
set(CMAKE_SYSROOT /opt/aarch64-wrs-linux-sysroot)

不使用sysroot的情况

如果没有完整的sysroot，需要明确指定每个依赖库的位置：

# 基本平台设置同上...

# 显式设置各依赖库路径
set(JSONC_INCLUDE_DIR "/usr/include/json-c")
set(JSONC_LIBRARY "/usr/lib/aarch64-linux-gnu/libjson-c.a")
set(ENABLE_JSON_SHARED OFF)

set(BZIP2_INCLUDE_DIR "/usr/include/")
set(BZIP2_LIBRARY "/usr/lib/aarch64-linux-gnu/libbz2.a")

# 其他依赖库设置...

构建ClamAV

配置好工具链文件后，可以开始构建过程：

mkdir build-arm64 && cd build-arm64

cmake .. \
    -D CMAKE_TOOLCHAIN_FILE=(pwd)/../CMAKE_TOOLCHAIN_ARM64.cmake \
    -D ENABLE_STATIC_LIB=OFF \
    -D ENABLE_SHARED_LIB=ON \
    -D MAINTAINER_MODE=OFF \
    -D ENABLE_EXAMPLES=OFF \
    -D BYTECODE_RUNTIME=interpreter \
    -D CMAKE_BUILD_TYPE=Release \
    -D CMAKE_INSTALL_PREFIX="/usr" \
    -D CMAKE_STAGING_PREFIX=/home/user/stage/usr

make
make install

关键参数说明：

• CMAKE_TOOLCHAIN_FILE: 指定工具链配置文件路径
• ENABLE_STATIC_LIB/ENABLE_SHARED_LIB: 控制静态/动态库生成
• BYTECODE_RUNTIME: 设置为解释器模式以兼容不同架构
• CMAKE_STAGING_PREFIX: 临时安装目录，便于后续部署

验证构建结果

由于是交叉编译，无法直接在主机上运行生成的程序，但可以通过file命令验证目标架构：

file install/bin/clamscan

预期输出应包含"ARM aarch64"字样，确认生成的是ARM64架构的可执行文件。

常见问题解决

Cargo找不到正确的GCC

如果构建过程中出现cc: error: unrecognized command-line option '-m64'错误，需要设置以下环境变量：

export HOST_CC=gcc
export CC_x86_64_unknown_linux_gnu=/usr/bin/x86_64-linux-gnu-gcc
export CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER=/usr/bin/x86_64-linux-gnu-gcc

依赖库路径问题

如果CMake报告找不到某些库，可以：

1. 检查工具链文件中各库路径是否正确
2. 确认已安装对应架构的开发包
3. 尝试在工具链文件中显式设置库路径

总结

通过本文介绍的步骤，开发者可以成功在x86_64主机上为ARM64架构交叉编译ClamAV。交叉编译虽然配置复杂，但掌握了正确的方法后，可以大大提高嵌入式开发和跨平台部署的效率。对于ClamAV这样的安全软件，能够为不同架构的设备提供保护能力尤为重要。