c 链接器标志及其文档

Question

我添加了标题 <math.h>到一个项目开始测试 fmod 函数，它返回浮点除法的小数部分。我对此还有更多问题，但我会把它留到另一个问题。

因此，在添加 header 并使用函数后，没有出现 lint 错误，然后我尝试构建程序。

我收到这个错误:

/usr/bin/ld: CMakeFiles/main.dir/main.c.o: undefined reference to symbol 'fmod@@GLIBC_2.2
.5'
//lib/x86_64-linux-gnu/libm.so.6: error adding symbols: DSO missing from command line
collect2: error: ld returned 1 exit status

好吧，我注意到 ld 意味着链接器，好吧，很好。

接下来我开始谷歌搜索错误并找到答案。我需要添加链接器标志 -lm

为什么？我不知道，所以我开始在谷歌上搜索链接器标志的含义，但我没有真正找到任何答案。回到SO发现this question and answer .

这些是主要问题下的引述。

Read the library documentation ... – pmg

...and then google. – Ori Pessach

linking semantics vary across operating systems and compilers. We'd need a lot more detail to make any useful contributions. – radical7

如果我有一个一次性文件，pkg-config 似乎没问题，但随着项目的增长，如果你遇到这些链接器错误，就很难找出问题所在。

另一个答案是阅读文档。我回到谷歌并遇到了this documentation关于math.h

但它在任何地方都没有说明要使用的实际链接器标志。

所以我的问题是@pmg 在他的回复中谈论的是什么文档？在我的系统上查找此文档的通用方法是什么，以防万一我出于某种原因无法使用谷歌？特别是因为我的计算机上有文件并且能够包含它们。

Answer 1

基本上，当您使用库中包含的函数时，您总是必须链接库。编译器默认链接了一些最常用的库(请参阅 Why do you have to link the math library in C?)。

如果您使用的是类 Unix 系统，您可以引用手册页:

man func

或

man -k func

最后一个为您提供了与 func 相关的所有手册页。还有通用手册页，如所有数学函数 (man math) 或 ascii 表 (man ascii)。

遗憾的是，并非所有手册页都报告需要添加到命令行的链接。在 math 的手册页中没有明确的 -lm 状态，但是最后报告了库的名称:

“math.h中声明的libm函数提供数学库函数”

这就足够了，因为如果库的名称是 libm，那么您知道要链接它，您应该使用:

-lm

一般规则是链接器在使用 -l 链接时删除 lib 前缀，例如参见 http://www.cs.swarthmore.edu/~newhall/unixhelp/howto_C_libraries.html