需要链接的库将根据使用的Boost.Asio特性和其他Boost头文件确定。通常,可以通过对未定义引用的命名空间进行猜测,并检查Boost库中的符号来确定要链接的库。
在下面的所有示例中,我都使用了gcc 4.8.1。确切的错误消息并不重要,因为它们中的内容在编译器之间应该是相似的。
以包括Boost.Asio的基本程序为例:
#include <boost/asio.hpp>
int main() {}
编译此文件时:
$ g++ example.cpp -isystem /usr/local/boost_1_55_0
...
example.cpp:(.text+0x31): undefined reference to
`boost::system::generic_category()'
...
/tmp/cc9ow7fd.o: In function `boost::asio::error::get_system_category()':
example.cpp:(.text._ZN5boost4asio5error19get_system_categoryEv[
_ZN5boost4asio5error19get_system_categoryEv]+0x5): undefined reference
to `boost::system::system_category()'
请注意,未定义的引用是在boost::system
命名空间中包含的符号。如果查看已安装的Boost库列表,libboost_system.so
可能被视为一个很好的链接候选项。如果没有明显的候选项,则可以使用像nm或readelf这样的工具来检查候选库并查找符号:
$ nm --defined-only --print-file-name --demangle \
> /usr/local/lib/libboost_*.so | grep boost::system::generic_category
...
/usr/local/lib/libboost_system.so:
00000000000015c0 T boost::system::generic_category()
...
在这种情况下,boost::system::generic_category()
符号在libboost_system.so
的文本部分中定义。因此,基本程序需要链接到boost_system
:
g++ example.cpp -isystem /usr/local/boost_1_55_0 -L/usr/local/lib/ -lboost_system
这是一个稍微复杂一些的示例。该程序在协程中异步等待一个单调定时器,在由额外线程执行的协程中执行。
#include <boost/asio.hpp>
#include <boost/asio/spawn.hpp>
#include <boost/asio/steady_timer.hpp>
#include <boost/thread/thread.hpp>
boost::asio::io_service io_service;
void handler(boost::asio::yield_context yield)
{
boost::asio::steady_timer timer(io_service);
timer.expires_from_now(boost::chrono::seconds(3));
timer.async_wait(yield);
}
int main()
{
boost::asio::spawn(io_service, &handler);
boost::thread thread(boost::bind(
&boost::asio::io_service::run, &io_service));
thread.join();
}
虽然可以使用之前的相同方法,但链接器错误会导致 40 多行缠绕的模板符号,这可能会让人望而生畏。作为替代方案,可以使用
-c
选项编译示例,但不进行链接。然后,可以检查生成的目标文件中的未定义符号:
$ g++ example.cpp -isystem /usr/local/boost_1_55_0 -c
$ nm --demangle --undefined example.o | grep boost
U boost::coroutines::stack_traits::default_size()
U boost::coroutines::stack_traits::is_unbounded()
U boost::coroutines::stack_traits::maximum_size()
U boost::coroutines::stack_traits::minimum_size()
U boost::coroutines::detail::coroutine_context::jump(
boost::coroutines::detail::coroutine_context&, long, bool)
U boost::coroutines::detail::coroutine_context::coroutine_context(
void (*)(long), boost::coroutines::stack_context const&)
U boost::coroutines::detail::coroutine_context::coroutine_context()
U boost::chrono::steady_clock::now()
U boost::detail::thread_data_base::~thread_data_base()
U boost::system::system_category()
U boost::system::generic_category()
U boost::thread::join_noexcept()
U boost::thread::native_handle()
U boost::thread::start_thread_noexcept()
U boost::thread::detach()
U typeinfo for boost::detail::thread_data_base
U vtable for boost::detail::thread_data_base
这个输出比链接器错误更易于管理。再次提醒,符号命名空间 (
boost::coroutine
、
boost::chrono
、
boost::thread
和
boost::system
) 提供了关于哪个库定义符号的良好提示。上面的程序可以使用以下命令编译和链接:
g++ example.cpp -isystem /usr/local/boost_1_55_0 -L/usr/local/lib/ -lboost_coroutine -lboost_chrono -lboost_thread -lboost_system
另外,请注意
链接顺序很重要。