需要链接的库将根据所使用的 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): 未定义的引用
`boost::system::generic_category()'
...
/tmp/cc9ow7fd.o:在函数`boost::asio::error::get_system_category()'中:
example.cpp:(.text._ZN5boost4asio5error19get_system_categoryEv[
_ZN5boost4asio5error19get_system_categoryEv]+0x5): 未定义引用
到`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 提升
U boost::协程::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::线程::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
用于 boost::detail::thread_data_base 的 U vtable
此输出比链接器错误更易于管理。再一次,符号命名空间(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
另外,请注意linking order matters。