交叉编译的三个参数：sysroot和DESTDIR、prefix

最新推荐文章于 2025-11-26 09:41:11 发布
原创 最新推荐文章于 2025-11-26 09:41:11 发布 · 6.9k 阅读 · 9 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文深入探讨了在交叉编译环境中，DESTDIR和sysroot的作用及用法，解释了它们如何帮助解决编译时路径与运行时路径不一致的问题，为开发者提供了实用的解决方案。

       软件编译过程中用到指定路径的头文件、链接指定路径的库，软件运行过程中需要在该指定路径下寻找相应资源。如gcc指定在/usr/include目录查找头文件，binutils中提供的ld命令从/lib、/usr/lib、LD_LIBRARY_PATH、/etc/ld.so.conf等指定路径进行共享库和静态库连接。交叉编译时需要在本地系统进行编译，而编译出的软件在目标系统运行，这就存在编译时指定的路径和运行时的路径不一致的矛盾。DESTDIR和sysroot配合用于解决这个问题。

       1、sysroot用于交叉编译工具的制作

       sysroot仅在交叉编译工具链用到的工具中使用，如binutils、gcc。


       2、DESTDIR、prefix用于目标系统软件的安装

       DESTDIR添加在prefix前，指定软件的安装位置。


       3、关于prefix在交叉编译工具制作中的说明

       交叉编译工具制作中，在配置时应用的prefix选项是指定生成的交叉编译工具安装在本机的路径，于后序使用交叉编译工具编辑目标系统的软件的安装路径无关。


       本文在阅读clfs、孙海勇《手把手教你制作自己的Linux系统》以及网络上相关文献的基础上写出。未完，待完善。

make 中 DESTDIR 和 --prefix 的区别
h a 6 6 6 c k 为 你解决复杂难题！
06-05 859
这两个示例分别展示了如何使用两种流行的构建系统（ + 和 + ）来编译和安装软件，并解释了 和 这两个选项的作用。这个命令运行 脚本，它是 生成的，用于检测系统环境并创建适当的 。这里： 指定了软件安装的基本目录。这意味着软件的可执行文件、库文件、头文件等将安装到 目录下及其子目录中。如果不指定 ，则默认安装到 。这个命令使用 工具来编译软件。 是一个选项，表示 可以同时运行8个作业（jobs），这样可以加快编译过程，利用多核处理器的优势。这个命令执行 目标，根据 将编译好的软件安装到
编译开源软件时，prefix, sysroot, DESTDIR怎么整
ayu_ag的专栏
03-04 7870
开发环境ubuntu12.04，x86_64，gcc4.6 arm板子环境armeabi，32bit，gcc5.3 以shell里面经常用到的file程序为例子 从ftp://ftp.astron.com/pub/file/上面下载源代码，因为我的ubuntu使用的是file5.09，不支持编译最新版本的file.5.25，所以我就下载file5.09了。
交叉编译时--sysroot，-rpath，-rpath-link，-L之间的关系与注意点
lihaicg的专栏
09-05 2058
在进行交叉编译的时候，出现 “not found (try using -rpath or -rpath-link)” 错误，可能是由于没有设置sysroot，而使用了rpath进行运行库的搜索路径指定，导致在链接的时候找不到对应的动态库。
从“踩坑”到“填坑”：交叉编译环境搭建秘籍
最新发布
远程部署调试 运行安装 项目调试 二次开发 项目技术新 持续迭代 部分源码免费分享
11-26 729
交叉编译环境搭建与依赖冲突解决方案 本文系统阐述了交叉编译技术在软件开发中的关键作用，重点分析了依赖与库版本冲突问题的成因及解决方案。文章首先介绍了交叉编译的基本概念及其在嵌入式开发、物联网等领域的应用价值，详细剖析了依赖冲突的典型表现和深层原因。针对这些问题，提出了一站式解决方案，包括：合理选择交叉编译工具链、利用Docker构建独立编译环境、精准管理依赖库以及采用静态链接等技术手段。通过智能安防监控系统开发案例，验证了该方案的有效性。最后展望了交叉编译技术在物联网等新兴领域的发展前景，为开发者提供了实用
gcc交叉编译时设置了“--sysroot“会产生哪些影响
szembed的博客
08-10 1996
-sysroot-I在做交叉编译的时候，常常涉及到一个gcc编译选项--sysroot,这个选项是用来设置目标平台根目录的。--sysroot选项的官方说明如下从--sysroot的说明可以看出，其会对编译和链接过程中，查找头文件和链接库造成影响。原本默认会从目录中搜索头文件、从/usr/lib中搜索依赖库，当设置了后则会从搜索头文件、从中搜索依赖库。--sysroot通过查看默认动态库搜索路径。
[ 物联网篇 ] 22 - ARM交叉编译器中参数配置 soft / softhp / hard
程序手艺人 - 嵌入式音频技术之旅
07-31 686
7月份开发的项目中遇到一个ARM 交叉编译器参数配置问题，前后花费的时间比较多，记录下折腾的过程。 TODO 如何评估应用程序的运算量 ? 如何测试芯片平台是否支持浮点运算？ 交叉编译器支持浮点运算和不支持浮点运算量的对比 ? 交叉编译器中参数配置(soft / softhp / hard) 三者的区别以及性能比较 ...
sysroot和prefix
weixin_34195364的博客
06-27 2186
--with-sysroot用来指定系统的root。该选项主要用于新系统（比如LFS）构建或交叉编译。比如你的LFS的root在/mnt/lfs，那么configure时指定--with-sysroot=/mnt/lfs，编译器就会使用/mnt/lfs上的header和lib，而不是host上的。交叉编译器也会设定sysroot，避免搜索默认的header和lib路径。可以写个最小程序然后gcc ...
交叉编译环境搭建实战：手把手打造uC_OS for ARM的黄金开发环境
![交叉编译环境搭建实战：手把手打造uC_OS for ARM的黄金开发环境](https://res.cloudinary.com/rsc/image/upload/b_rgb:FFFFFF,c_pad,dpr_2.625,f_auto,h_214,q_auto,w_380/c_pad,h_214,w_...这一过程依赖于**交叉编译
交叉编译链搭建实战：为全志D1h构建稳定GCC工具链的7步黄金流程
# 交叉编译链的构建艺术：从零打造全志D1h专属工具链 在嵌入式开发的世界里，当你第一次面对一块全新的芯片——比如全志D1h，心里是不是既兴奋又有点发怵？ 它不像树莓派那样开箱即用，也没有现成的IDE一键配置。但...
Linux交叉编译平台实验总结,交叉编译总结
weixin_39636696的博客
05-07 1686
思考：对交叉编译不熟悉，一些事后感觉很简单的问题事前烦恼了很久。源代码的编译大致可以分为三个类，用cmake的，用make的，　用脚本的。用cmake的最好改，其次是用脚本的，一般文档写得全。用make的往往是很简陋的，没文档，相关资料也少。总结：一.cartographer的Gmock GTest Glog模块的交叉编译首先下载Gmock GTest Glog的源码，Gmock和GTest在gi...
交叉编译 gmp
bluebird_shao的专栏
09-02 1787
GMP (GNU Multiple Precision Arithmetic Library) 是一个用于任意精度计算设计的数学库，它的主要目标应用是密码学应用和研究、互联网安全应用、代数系统、计算代数研究等。GMP 经过精心设计，无论是小操作数还是大操作数，都尽可能快，是一个高性能的数学库。自 1991 年首次发布以来，GMP 还在不断开发和维护，大约每年发布一次新版本。从版本 6 开始，GMP 在双重许可证下发布（和GNU GPL v2），这些许可证使库可以自由使用、共享和改进。
Linux编译 --prefix和DESTDIR用法(十)
Android系统攻城狮
07-14 2963
1.configure + make # ./configure --prefix=/usr --build=x86_64-unknown-linux-gnu --host=arm-none-linux-gnueabi # make -j8 # make install DESTDIR=/home 2.meson + ninja # meson build --prefix=/usr -Dgtk_doc=disabled -Dtests=disabled # DESTDIR=/home ninja -C.
交叉编译相关知识整理
SSS
05-02 1773
因为嵌入式设备的特殊性，比如其内存，性能可能相比与通用设备较弱，或者设备上缺少编译工具链等等原因，很多时候想要在嵌入式设备上使用某些程序时，需要在 在通用机器上编译好，而在嵌入式设备上运行，而这两者的cpu架构是不同的，因而需要好好整理下交叉编译。
【cmake开发（15）】交叉编译时如何设置CMAKE_SYSROOT和CMAKE_FIND_ROOT_PATH
Hali_Botebie的博客
08-22 3991
在交叉编译场景中，正确设置和以确保 CMake 能够正确地找到 ARM 架构的库、头文件和其他系统文件。应该设置为你的 ARM 文件系统根目录，即。这个变量会告诉编译器和链接器在查找标准库和系统文件时使用这个目录作为根目录。用于为 CMake 的find_系列命令（如find_path等）添加额外的搜索路径前缀。如果你有一些特定的库或头文件不在 ARM 文件系统的标准位置，或者你想要在除了之外的额外目录中搜索，你可以将那些目录添加到中。
交叉编译中的 --sysroot 等等在编译时的作用
dielucui7698的博客
08-04 2600
--sysroot=dir 的作用 如果在编译时指定了-sysroot=dir 就是为编译时指定了逻辑目录。编译过程中需要引用的库，头文件，如果要到/usr/include目录下去找的情况下，则会在前面加上逻辑目录。 如此处我们指定 -sysroot=/home/shell.albert/tools/toolschain_arm/4.4.3/arm-none-linux-gnueab...
DESTDIR and PREFIX of make
我不会编程，但不是完全不会，我会一点点
07-27 1954
up vote38down votefavorite 18 I am trying to make software install to a specific directory. I found several ways, but not sure what are the differences between them. ./configure -
GCC 编译 --sysroot
weixin_30344795的博客
08-03 3433
-sysroot 的作用 如果在编译时指定了-sysroot就是为编译时指定了逻辑目录。编译过程中需要引用的库，头文件，如果要到/usr/include目录下去找的情况下，则会在前面加上逻辑目录。 如此处我们指定 -sysroot=/home/shell.albert/tools/toolschain_arm/4.4.3/arm-none-linux-gnueabi/sys-root则如果在编...
交叉编译 cross-compiling - sysroot作用
迟来大师的博客
01-19 2002
sysroot，是交叉编译时，用来定位头文件和库文件的位置的。 A sysroot is a directory which is considered to be the root directory for the purpose of locating headers and libraries. So for example if your build toolchain wants to find/usr/include/adb.hbut you are cross-compilin...
交叉编译工具链总结
aningxiaoxixi的博客
04-20 1645
1 我们都知道如果使用gcc进行编译，那么在编译过程中，会去 /usr/include 索引头文件，会去/usr/lib 索引依赖库 那么我们用交叉编译工具链的时候，去哪里索引头文件 跟 依赖库呢？ 这就需要 --sysroot 先参考一篇文章： gcc交叉编译时设置了“–sysroot“会产生哪些影响 接着看一个脚本 SDKTARGETSYSROOT 是我编译生成的交叉编译工具链的目录 export CC=“arm-poky-linux-gnueabi-gcc -march=armv7ve -mfp
如何交叉编译一个nignx
11-22
交叉编译 Nginx 是指在一个平台上（如 x86_64 的 Linux）编译出能在另一个平台（如 ARM 架构的嵌入式设备）上运行的 Nginx 可执行文件。这在嵌入式系统开发中非常常见，比如为路由器、IoT 设备等构建 Nginx。 以下是详细步骤和示例代码来交叉编译 Nginx： --- ### ✅ 一、准备工作 #### 1. 安装依赖工具 确保主机系统已安装以下工具： - `build-essential`（或对应开发包） - `autoconf`, `automake`, `libtool` - 交叉编译工具链（例如针对 ARM） ```bash # Ubuntu/Debian 示例 sudo apt update sudo apt install build-essential autoconf automake libtool ``` #### 2. 下载 Nginx 源码 ```bash wget http://nginx.org/download/nginx-1.24.0.tar.gz tar -zxvf nginx-1.24.0.tar.gz cd nginx-1.24.0 ``` #### 3. 获取交叉编译工具链（以 ARM 为例） 假设你使用的是 GNU 的 ARM 工具链： ```bash # 安装 ARM 交叉编译器（适用于大多数 ARMv7 设备） sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf ``` 验证是否可用： ```bash arm-linux-gnueabihf-gcc --version ``` --- ### ✅ 二、配置并交叉编译 Nginx Nginx 使用 `auto` 脚本系统进行构建，不支持标准的 `./configure --host=...` 方式，因此需要手动修改其 `Makefile` 生成逻辑。 #### 编辑 `auto/cc/name` 文件（防止编译器检测失败） 编辑 `auto/cc/name`，注释掉输出编译器名称的部分，避免 configure 报错： ```bash vim auto/cc/name ``` 将内容改为： ```bash # echo $0 > $NGX_OBJS/ngx_auto_cc_log ``` #### 运行 configure 并指定交叉编译环境变量 ```bash CC=arm-linux-gnueabihf-gcc \ CXX=arm-linux-gnueabihf-g++ \ AR=arm-linux-gnueabihf-ar \ RANLIB=arm-linux-gnueabihf-ranlib \ ./configure \ --crossbuild=Linux::aarch64::unknown \ --prefix=/opt/nginx-arm \ --with-cc=arm-linux-gnueabihf-gcc \ --with-cpp=arm-linux-gnueabihf-cpp \ --with-cc-opt="-march=armv7-a" \ --without-http_rewrite_module \ --without-http_gzip_module \ --without-pcre \ --without-http_ssl_module \ --without-http_proxy_module \ --without-http_fastcgi_module \ --without-http_uwsgi_module \ --without-http_scgi_module \ --without-http_memcached_module \ --without-http_empty_gif_module \ --without-http_browser_module \ --without-http_geo_module \ --without-http_map_module \ --without-http_split_clients_module \ --without-http_referer_module \ --without-http_limit_conn_module \ --without-http_limit_req_module \ --without-http_auth_basic_module \ --without-http_access_module \ --without-http_realip_module \ --without-http_addition_module \ --without-http_degradation_module \ --without-http_flv_module \ --without-http_mp4_module \ --without-http_sub_module \ --without-http_slice_module \ --without-mail_pop3_module \ --without-mail_imap_module \ --without-mail_smtp_module \ --without-http_upstream_ip_hash_module \ --without-http_upstream_least_conn_module \ --without-http_upstream_keepalive_module \ --without-http_upstream_zone_module \ --without-threads \ --without-select_module \ --without-poll_module \ --without-kqueue_module \ --without-eventport_module \ --without-file_aio \ --without-http_dav_module \ --without-http_ssi_module ``` > 💡 **说明**： > - `--crossbuild` 告诉 Nginx 构建系统这是跨平台编译。 > - `--with-cc` 指定使用的交叉编译器。 > - 禁用大量模块是为了减少依赖（如 PCRE、OpenSSL），简化交叉编译过程。 > - 如果你需要 HTTPS 支持，需交叉编译 OpenSSL 和 PCRE 库，并链接它们。 #### 手动修复 Makefile（关键步骤） 由于 Nginx 的 auto 系统不会自动处理交叉编译时的目标架构判断，生成的 `Makefile` 中可能仍包含 `$(CC)` 直接调用本地编译器。 打开生成的 `objs/Makefile`，搜索并替换所有 `gcc` 为 `arm-linux-gnueabihf-gcc`，或者更安全地确保所有 `$(CC)` 都正确指向交叉编译器。 也可以通过 patching `auto/tools/gcc` 来固化 CC 设置。 --- ### ✅ 三、开始编译 ```bash make -j$(nproc) ``` 如果成功，会在 `objs/` 目录下生成 `nginx` 可执行文件。 检查是否为 ARM 架构： ```bash file objs/nginx ``` 输出应类似： ``` objs/nginx: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, ... ``` 表示是 ARM 架构程序。 --- ### ✅ 四、部署到目标设备 将整个 `objs` 或安装目录打包： ```bash make DESTDIR=/tmp/nginx-arm-root install ``` 然后将 `/tmp/nginx-arm-root/opt/nginx-arm` 复制到 ARM 设备上运行即可。 --- ### ✅ 补充：静态编译（可选，避免依赖问题） 若想生成静态链接版本（避免目标机缺少 libc 等库），可在 configure 时加上： ```bash --with-cc-opt="-static" --with-ld-opt="-static" ``` 但注意某些模块无法静态编译，建议最小化功能。 --- ### ✅ 注意事项 1. **第三方模块**：如果有第三方模块（如 Lua 模块），也需要交叉编译对应的库。 2. **依赖库**：PCRE、zlib、OpenSSL 都需要先交叉编译，并通过 `--with-pcre=...` 指定路径。 3. **目标系统头文件**：有时需要为目标平台提供 sysroot（即完整的 rootfs 包含 `/usr/include` 等）。 --- ### 示例完整命令汇总 ```bash # 设置环境变量 export CC=arm-linux-gnueabihf-gcc export CXX=arm-linux-gnueabihf-g++ export AR=arm-linux-gnueabihf-ar export RANLIB=arm-linux-gnueabihf-ranlib # 修改 auto/cc/name 防止报错 sed -i 's|echo \$0 > $NGX_OBJS/ngx_auto_cc_log|#echo \$0 > $NGX_OBJS/ngx_auto_cc_log|' auto/cc/name # 配置 ./configure \ --prefix=/opt/nginx-arm \ --with-cc=$CC \ --with-cpp=arm-linux-gnueabihf-cpp \ --without-http_rewrite_module \ --without-http_gzip_module \ --without-pcre \ --without-http_ssl_module \ --crossbuild=Linux::x86_64::unknown # 编辑 objs/Makefile，确认所有 gcc 替换为 arm-linux-gnueabihf-gcc # 编译 make -j8 ``` --- ###
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值