共享库和 ldflags 出现“未定义的引用”错误答案

【问题标题】："Undefined reference" error with shared library and ldflags共享库和 ldflags 出现“未定义的引用”错误
【发布时间】：2013-10-14 14:40:02
【问题描述】：

尝试使用 make 在 QEMU 中编译我的代码时，我在链接阶段收到 undefined reference 错误。 Afaik 配置参数是正确的，因此应该正确使用共享库进行链接，但也许我忽略了一些东西。

任何帮助将不胜感激！

以下是我已经收集到的很多附加信息：

解决方案：见Zach's answer

我现在通过将LIBS+=-lcity 添加到Makefile.target 文件来管理它。

谢谢大家！

更新：

make V=1 输出：

cc -Werror -fPIE -DPIE -m64 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64
-D_LARGEFILE_SOURCE -Wstrict-prototypes -Wredundant-decls -Wall -Wundef
-Wwrite-strings -Wmissing-prototypes -fno-strict-aliasing -I/home/user/cityhash
-Wendif-labels -Wmissing-include-dirs -Wempty-body -Wnested-externs
-Wformat-security -Wformat-y2k -Winit-self -Wignored-qualifiers
-Wold-style-declaration -Wold-style-definition -Wtype-limits
-fstack-protector-all -I/usr/include/p11-kit-1     -I/usr/include/libpng12
-I/usr/include/pixman-1     -I../linux-headers -I..
-I/home/user/qemu/target-i386 -DNEED_CPU_H -I/home/user/qemu/include -pthread
-I/usr/include/glib-2.0 -I/usr/lib/x86_64-linux-gnu/glib-2.0/include   -O2
-D_FORTIFY_SOURCE=2 -g  -Wl,--warn-common -Wl,-z,relro -Wl,-z,now -pie -m64 -g
-L/home/user/lib -Wl,-rpath=/home/user/lib -lcity -o qemu-system-x86_64 [… all
*.o files … ] ../libqemuutil.a ../libqemustub.a   -lrt -pthread -lgthread-2.0
-lrt -lglib-2.0    -lutil -lrbd -lrados -lbluetooth   -lcurl   -lncurses -ltinfo
-lbrlapi  -luuid -lpng12   -ljpeg -lsasl2 -lgnutls   -lSDL   -lX11  -lz -laio
-lpixman-1   -lm

接下来是我在下面写的正常错误输出（LINK 除外，在这种情况下丢失了）。

错误：

~/qemu$ make
...
  LINK  x86_64-softmmu/qemu-system-x86_64
my_code.o: In function `function`:
/home/user/qemu/my_code.c:982: undefined reference to `CityHash64'
...
collect2: error: ld returned 1 exit status
make[1]: *** [qemu-system-x86_64] Error 1
make: *** [subdir-x86_64-softmmu] Error 2

配置参数：

./configure [...] \
    --extra-cflags='-I/home/user/cityhash' \
    --extra-ldflags='-L/home/user/lib -Wl,-rpath=/home/user/lib -lcity'

文件夹结构：

~
├─ cityhash/
│  ├─ city.h
│  └─ ...
├─ lib/
│  ├─ libcity.so
│  └─ ...
└─ qemu/

标头包含和函数用法（my_code.c）：

[...]
 11  #include "city.h"

982  hash = CityHash64(buf, len);
[...]

共享库的Nm输出：

~/lib$ nm libcity.so
[...]
0000000000000fdc T CityHash64
[...]

制作过程中的 Strace 输出：

~/qemu$ strace -f -o ../strace.out -- make
[...]
16111 stat("/home/user/lib/libcity.so", {st_mode=S_IFREG|0755, st_size=18468, ...}) = 0
16111 open("/home/user/lib/libcity.so", O_RDONLY) = 7
16111 fcntl(7, F_GETFD)                 = 0
16111 fcntl(7, F_SETFD, FD_CLOEXEC)     = 0
16111 fstat(7, {st_mode=S_IFREG|0755, st_size=18468, ...}) = 0
16111 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x2aaaaaad9000
16111 lseek(7, 0, SEEK_SET)             = 0
16111 read(7, "\177ELF\2\1\1\0\0\0\0\0\0\0\0\0\3\0>\0\1\0\0\0`\7\0\0\0\0\0\0"..., 4096) = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 brk(0x2129000)                    = 0x2129000
16111 lseek(7, 12288, SEEK_SET)         = 12288
16111 read(7, "9\23\2%\25\0\2\4\1\364\0\2\4\1\2E\23\0\2\4\1\2>\23\0\2\4\1\203\0\2\4"..., 4096) = 4096
16111 lseek(7, 16384, SEEK_SET)         = 16384
16111 lseek(7, 16384, SEEK_SET)         = 16384
16111 lseek(7, 0, SEEK_SET)             = 0
16111 read(7, "\177ELF\2\1\1\0\0\0\0\0\0\0\0\0\3\0>\0\1\0\0\0`\7\0\0\0\0\0\0"..., 4096) = 4096
16111 lseek(7, 12288, SEEK_SET)         = 12288
16111 read(7, "9\23\2%\25\0\2\4\1\364\0\2\4\1\2E\23\0\2\4\1\2>\23\0\2\4\1\203\0\2\4"..., 4096) = 4096
16111 lseek(7, 0, SEEK_SET)             = 0
16111 read(7, "\177ELF\2\1\1\0\0\0\0\0\0\0\0\0\3\0>\0\1\0\0\0`\7\0\0\0\0\0\0"..., 4096) = 4096
16111 lseek(7, 8192, SEEK_SET)          = 8192
16111 read(7, "\6\2\233\f\7\10\0\0$\0\0\0\314\1\0\0\314\354\377\377\210\0\0\0\0A\16\20\206\2C\r"..., 4096) = 4096
16111 lseek(7, 12288, SEEK_SET)         = 12288
16111 lseek(7, 12288, SEEK_SET)         = 12288
16111 lseek(7, 12288, SEEK_SET)         = 12288
16111 lseek(7, 12288, SEEK_SET)         = 12288
16111 read(7, "9\23\2%\25\0\2\4\1\364\0\2\4\1\2E\23\0\2\4\1\2>\23\0\2\4\1\203\0\2\4"..., 4096) = 4096
16111 lseek(7, 8192, SEEK_SET)          = 8192
16111 read(7, "\6\2\233\f\7\10\0\0$\0\0\0\314\1\0\0\314\354\377\377\210\0\0\0\0A\16\20\206\2C\r"..., 4096) = 4096
16111 lseek(7, 0, SEEK_SET)             = 0
16111 read(7, "\177ELF\2\1\1\0\0\0\0\0\0\0\0\0\3\0>\0\1\0\0\0`\7\0\0\0\0\0\0"..., 4096) = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
16111 lseek(7, 4096, SEEK_SET)          = 4096
[...]
16111 close(7)                          = 0
[...]

【问题讨论】：

该错误来自链接还是简单的 .c 编译？鉴于消息，我认为是编译。如果是这样，您是否在正在编译的 .c 文件中包含了正确的 .h 文件？ ld 错误消息通常不会给出引用的行。
@CharlieBurns 链接过程中发生错误，我忘记了，现在在我的问题的make 输出中添加了此信息。头文件是正确的，cflags中的路径也是正确的。
链接命令可能在顶层 Makefile 调用的子树中的 Makefile 之一中。在它工作的机器上，.configure 是否以完全相同的方式调用？实际的链接命令可能会出现在“LINK”注释之前或之后的日志文件中。或者他们可能已经让它沉默了，这是一件很痛苦的事情。无论如何，这是一个谜，如果你弄明白了，请告诉我们。
使用grep -r "\-lcity" . 之类的东西应该很容易，不是吗？
您似乎已经发现了为什么默认的静默规则是一件坏事。用make V=1 重复链接，make 输出中的无信息LINK ... 行应替换为实际的链接器调用，这是我们调试时需要知道的。

标签： c gcc linker shared-libraries qemu

【解决方案1】：

好的，这似乎是链接排序问题。链接命令行的关键位是：

-g -L/home/user/lib -Wl,-rpath=/home/user/lib -lcity -o qemu-system-x86_64

然后

[... all *.o files ...] ../libqemuutil.a ../libqemustub.a 
-lrt -pthread -lgthread2.0 [... more libraries ...]

问题是-lcity 需要在命令行上的所有.o 文件之后出现，因为顺序很重要：库只搜索目标文件中未解析的符号在命令行之前它们。

这可能是 Automake 生成的 Makefile，这意味着您需要将 -lcity 放入 LDADD 以进行违规链接操作，而不是 LDFLAGS。也许可以使用--extra-libs=-lcity 配置选项来完成此操作（从--extra-ldflags 中删除-lcity，但保留您拥有的所有其他内容）。如果没有，请尝试make LDADD=-lcity。如果 that 不起作用（它很有可能破坏需要在 LDADD 中的其他东西）你将不得不深入研究生成的 Makefile （从 Makefile.am 中看不到）并查看是否有其他变量可以在命令行中设置。

【讨论】：