libtool 中的 .la 文件说明

libtool 中的 .la 文件说明

1 概述

在 Linux 系统中，libtool 是一个用于自动化编译和链接复杂软件项目的工具，特别是那些使用了共享库（.so 文件在 Linux 上，.dylib 在 macOS 上）的项目。它帮助处理各种编译器和链接器的复杂性，包括不同平台上的差异。

.la 文件是 libtool 生成的库文件的链接文件（libtool archive）。这些文件不是实际的库文件，而是包含了关于如何链接到相应库的信息的文本文件。它们对于 libtool 和一些依赖于 libtool 的工具（如 ldconfig）来说很重要，因为它们帮助这些工具找到并链接到正确的库文件。¹

libtool 主要的一个作用是在编译大型软件的过程中解决库的依赖问题；将繁重的库依赖关系的维护工作承担下来，从而释放了程序员的人力资源。libtool 提供统一的接口，隐藏了不同平台间库的名称的差异等细节，生成一个抽象的 libxx.la (其实是个文本文件)，并将该库对其它库的依赖关系，都写在该 .la 的文件中。²

在使用 libtool 构建的库中，.la 文件用于在编译时定位共享库和它的依赖关系。它不是库的直接二进制形式，而是构建系统中使用的一个辅助文件。³

官方网址：https://www.gnu.org/software/libtool/

2 .la 文件内容介绍

以下是一个名为 libgmp.la 的 .la 文件（这是一个简化的版本）：

# libmpfr.la - a libtool library file
# Generated by libtool (GNU libtool) 2.4.7 Debian-2.4.7-7

# The name that we can dlopen(3).
dlname='libmpfr.so.6'

# Names of this library.
library_names='libmpfr.so.6.2.1 libmpfr.so.6 libmpfr.so'

# The name of the static archive.
old_library='libmpfr.a'

# Linker flags that cannot go in dependency_libs.
inherited_linker_flags=''

# Libraries that this one depends upon.
dependency_libs=' /usr/lib/libgmp.la'

# Version information for libmpfr.
current=8
age=2
revision=1

# Directory that this library needs to be installed in:
libdir='/usr/lib'

它可能包含如下内容：

• dlname: 可被 dlopen() 函数调用的动态库名称，可能包含版本号。
• library_names: 动态库名称。
• old_library: 静态库名称。
• dependency_libs: 库的依赖关系。
• Version information: 库的版本信息。
• libdir: 安装路径，库文件在文件系统中的位置。

通常，开发者不需要直接处理 .la 文件。libtool 和其他工具会自动读取这些信息。然而，了解 .la 文件的存在和作用可以帮助解决链接问题或理解项目的构建过程。

3 交叉编译时的注意事项

报错信息：

libtool: link: cannot find the library `/usr/lib/libgmp.la' or unhandled argument `/usr/lib/libgmp.la'

在交叉编译过程中，由于 libgmp.la 的安装路径并非根目录下的 /usr/lib，则 libtool 此时根本找不到 libgmp.la 文件（路径不正确）。这种情况下，libtool 只会把 -lgmp 当作参数传递给 gcc 命令行。

另一种情况类似，如果 libgmp.so 不是使用 libtool 工具生成的，则 libtool 此时根本找不到 libgmp.la 文件（不存在该文件）。这种情况下，libtool 也只会把 -lgmp 当作参数传递给 gcc 命令行。

如果你了解并知悉整个过程，只需要删除 .la 文件即可解决以上问题。不幸的是，这是 libtool 的一个非常麻烦的设计，需要硬编码你用来安装软件的路径，那就有可能会导致这样的问题。⁴

接下来的博文继续聊聊关于交叉编译过程中非常重要的库搜索工具 pkg-config，敬请期待。

---

1. 文心一言：libtool .la ↩︎

2. linux中la是什么文件 ↩︎

3. Linux中后缀名为ko、o、a、so、la的文件介绍 ↩︎

4. libtool .la library file wrong path ↩︎