diff options
Diffstat (limited to 'include/boost/dll/runtime_symbol_info.hpp')
| -rw-r--r-- | include/boost/dll/runtime_symbol_info.hpp | 182 |
1 files changed, 0 insertions, 182 deletions
diff --git a/include/boost/dll/runtime_symbol_info.hpp b/include/boost/dll/runtime_symbol_info.hpp deleted file mode 100644 index 58dc467a..00000000 --- a/include/boost/dll/runtime_symbol_info.hpp +++ /dev/null @@ -1,182 +0,0 @@ -// Copyright 2014 Renato Tegon Forti, Antony Polukhin. -// Copyright 2015 Antony Polukhin. -// -// Distributed under the Boost Software License, Version 1.0. -// (See accompanying file LICENSE_1_0.txt -// or copy at http://www.boost.org/LICENSE_1_0.txt) - -#ifndef BOOST_DLL_RUNTIME_SYMBOL_INFO_HPP -#define BOOST_DLL_RUNTIME_SYMBOL_INFO_HPP - -#include <boost/config.hpp> -#include <boost/predef/os.h> -#include <boost/dll/detail/aggressive_ptr_cast.hpp> -#if BOOST_OS_WINDOWS -# include <boost/detail/winapi/dll.hpp> -# include <boost/dll/detail/windows/path_from_handle.hpp> -#else -# include <dlfcn.h> -# include <boost/dll/detail/posix/program_location_impl.hpp> -#endif - -#ifdef BOOST_HAS_PRAGMA_ONCE -# pragma once -#endif - -/// \file boost/dll/runtime_symbol_info.hpp -/// \brief Provides methods for getting acceptable by boost::dll::shared_library location of symbol, source line or program. -namespace boost { namespace dll { - -namespace detail { -#if BOOST_OS_WINDOWS - inline boost::filesystem::path symbol_location_impl(const void* symbol, boost::system::error_code& ec) { - boost::filesystem::path ret; - - boost::detail::winapi::MEMORY_BASIC_INFORMATION_ mbi; - if (!boost::detail::winapi::VirtualQuery(symbol, &mbi, sizeof(mbi))) { - ec = boost::dll::detail::last_error_code(); - return ret; - } - - return boost::dll::detail::path_from_handle(reinterpret_cast<boost::detail::winapi::HMODULE_>(mbi.AllocationBase), ec); - } - - inline boost::filesystem::path program_location_impl(boost::system::error_code& ec) { - return boost::dll::detail::path_from_handle(NULL, ec); - } -#else - inline boost::filesystem::path symbol_location_impl(const void* symbol, boost::system::error_code& ec) { - boost::filesystem::path ret; - Dl_info info; - - // Some of the libc headers miss `const` in `dladdr(const void*, Dl_info*)` - const int res = dladdr(const_cast<void*>(symbol), &info); - - if (res) { - ret = info.dli_fname; - } else { - ec = boost::system::error_code( - boost::system::errc::not_supported, - boost::system::generic_category() - ); - } - - return ret; - } -#endif -} // namespace detail - - /*! - * On success returns full path and name of the binary object that holds symbol. - * \tparam T Type of the symbol, must not be explicitly specified. - * \param symbol Symbol which location is to be determined. - * \param ec Variable that will be set to the result of the operation. - * \return Path to the binary object that holds symbol or empty path in case error. - * \throws std::bad_alloc in case of insufficient memory. Overload that does not accept boost::system::error_code also throws boost::system::system_error. - * - * \b Examples: - * \code - * int var; - * void foo() {} - * - * int main() { - * dll::symbol_location(var); // returns program location - * dll::symbol_location(foo); // returns program location - * dll::symbol_location(std::cerr); // returns location of libstdc++: "/usr/lib/x86_64-linux-gnu/libstdc++.so.6" - * dll::symbol_location(std::placeholders::_1); // returns location of libstdc++: "/usr/lib/x86_64-linux-gnu/libstdc++.so.6" - * dll::symbol_location(std::puts); // returns location of libc: "/lib/x86_64-linux-gnu/libc.so.6" - * } - * \endcode - */ - template <class T> - inline boost::filesystem::path symbol_location(const T& symbol, boost::system::error_code& ec) { - ec.clear(); - return boost::dll::detail::symbol_location_impl( - boost::dll::detail::aggressive_ptr_cast<const void*>(boost::addressof(symbol)), - ec - ); - } - - //! \overload symbol_location(const T& symbol, boost::system::error_code& ec) - template <class T> - inline boost::filesystem::path symbol_location(const T& symbol) { - boost::filesystem::path ret; - boost::system::error_code ec; - ret = boost::dll::detail::symbol_location_impl( - boost::dll::detail::aggressive_ptr_cast<const void*>(boost::addressof(symbol)), - ec - ); - - if (ec) { - boost::dll::detail::report_error(ec, "boost::dll::symbol_location(const T& symbol) failed"); - } - - return ret; - } - - /// @cond - // We have anonymous namespace here to make sure that `this_line_location()` method is instantiated in - // current translation module and is not shadowed by instantiations from other modules. - namespace { - /// @endcond - - /*! - * On success returns full path and name of the binary object that holds the current line of code - * (the line in which the `this_line_location()` method was called). - * - * \param ec Variable that will be set to the result of the operation. - * \throws std::bad_alloc in case of insufficient memory. Overload that does not accept boost::system::error_code also throws boost::system::system_error. - */ - static inline boost::filesystem::path this_line_location(boost::system::error_code& ec) { - ec.clear(); - return boost::dll::symbol_location<boost::filesystem::path(boost::system::error_code& )>(this_line_location, ec); - } - - //! \overload this_line_location(boost::system::error_code& ec) - static inline boost::filesystem::path this_line_location() { - boost::filesystem::path ret; - boost::system::error_code ec; - ret = boost::dll::symbol_location<boost::filesystem::path()>(this_line_location, ec); - - if (ec) { - boost::dll::detail::report_error(ec, "boost::dll::this_line_location() failed"); - } - - return ret; - } - - /// @cond - } // anonymous namespace - /// @endcond - - /*! - * On success returns full path and name of the currently running program (the one which contains the `main()` function). - * - * Return value can be used as a parameter for shared_library. See Tutorial "Linking plugin into the executable" - * for usage example. Flag '-rdynamic' must be used when linking the plugin into the executable - * on Linux OS. - * - * \param ec Variable that will be set to the result of the operation. - * \throws std::bad_alloc in case of insufficient memory. Overload that does not accept boost::system::error_code also throws boost::system::system_error. - */ - inline boost::filesystem::path program_location(boost::system::error_code& ec) { - return boost::dll::detail::program_location_impl(ec); - } - - //! \overload program_location(boost::system::error_code& ec) { - inline boost::filesystem::path program_location() { - boost::filesystem::path ret; - boost::system::error_code ec; - ret = boost::dll::detail::program_location_impl(ec); - - if (ec) { - boost::dll::detail::report_error(ec, "boost::dll::program_location() failed"); - } - - return ret; - } - -}} // namespace boost::dll - -#endif // BOOST_DLL_RUNTIME_SYMBOL_INFO_HPP - |