gcc: multiple definition of

 

/home/tace/openav/source/SeamlessMessage/CPaoFlt.o: In function `CPaoFlt::get_m_strPrmair() const':
CPaoFlt.cpp:(.text+0x0): multiple definition of `CPaoFlt::get_m_strPrmair() const'
/home/tace/openav/source/SeamlessMessage/CPaoFlt.o:CPaoFlt.cpp:(.text+0x0): first defined here

gcc在编译过程中报函数重复定义（multiple definition of）的错误，主要有以下几点：

1. 在头文件中定义了变量或者函数，而非声明。譬如对于 foobar.h，

------------- foobar.h -----------
int foo = 10;
int bar()
{
 return 10;
}
------------- foobar.h -----------

当foobar.h 被不同的 .c 文件引用时，编译生成相应的 .o 文件，链接的时候会报 foo bar 重复定义。
一个可能想到的方法是在头文件中加入宏定义，防止头文件被重复引用，如：

------------- foobar.h -----------
#ifndef FOOBAR_H__
#define FOOBAR_H__
int foo = 10;
int bar()
{
 return 10;
}
#endif
------------- foobar.h -----------

如果你只有一个 .c 文件，你可能得到一个可以运行的程序。但如果你有两个或以上的 .c 文件引用 foobar.h ，链接时仍会报重复定义错误。

解决方法：在头文件中只声明函数、变量；对于 c++ 中的 inline 函数，在头文件中定义（编译的时候，inline 函数展开需要用到）。
对于 foobar.h 可以这样修改，为 .h 文件建立相应的 .c 文件，.h 文件中声明函数 .c 文件中定义函数，变量面前加修饰符 extern。

------------- foobar.h -----------
#ifndef FOOBAR_H__
#define FOOBAR_H__
extern int foo;
int bar();
#endif
------------- foobar.h -----------

------------- foobar.c -----------
int foo = 10;
int bar()
{
 return 10;
}
------------- foobar.c -----------

另外 static 修饰符也可以限制变量、函数的作用域，不过和本文无关了。

2. 在链接时，使用命令 gcc -o foobar main.o foobar.o foobar.o，你可能会想，怎么可能写出这样愚蠢的命令，但如果工程很大，.o 文件很多的时候，foobar.o 在不经意的时候被重复引用。如在 makefile 中：

FOO_OBJ = foo1.o foo2.o foo3.o foobar.o
BAR_OBJ = bar1.o bar2.o bar3.o foobar.o

foobar : main.o $(FOO_OBJ) $(BAR_OBJ)
    gcc -o foobar main.o $(FOO_OBJ) $(BAR_OBJ)

错误出现了，而且很难查出来，特别是在维护别人程序的时候。本人不幸的花了两天时间才找到原因，虽然很早的时候也怀疑过这个问题，结果因为大意忽略过去了。这样修改就可以了：
foobar : main.o $(FOO_OBJ) $(BAR_OBJ)
    gcc -o $@ $^

啊哈，终于知道 makefile 为什么要设置 $^ 这个变量了:)

3. 在 gcc 编译的时候，加入 -Xlinker -zmuldefs 选项，但这只是强制编译器做些手脚，程序的错误仍没被改正。该选项的具体作用还不明白，baidu不到，google用不了，万恶的GFW。

 

今天遇到的问题是：

在udp_socket.h中声明了下面三个函数：

void create_udp_socket();
void *udp_send_thread(void *);
void *udp_recv_thread(void *);

然后在udp_socket.c中实现，实现了，当然是为了被调用啊，所以在main.c的加上#include "udp_socket.h" , main函数中调用这几个函数，但是编译时发现：出现这样的错误，我就很郁闷了，记得之前代码都是这样的写的啊

gcc -o foda list.o main.o udp_socket.o  -lcstl -lpthread
udp_socket.o:(.data+0x0): multiple definition of `udp_sockfd'
main.o:(.data+0x0): first defined here
udp_socket.o:(.bss+0x0): multiple definition of `send_queue'
main.o:(.bss+0x0): first defined here
udp_socket.o:(.bss+0x4): multiple definition of `recv_queue'
main.o:(.bss+0x4): first defined here
udp_socket.o:(.bss+0x8): multiple definition of `recv_list'
main.o:(.bss+0x8): first defined here
但是在编译的flag上加上-Xlinker -zmuldefs这句就通过了，破问题害我浪费了几个小时的时间