doc/html/boost_dll.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   5 <title>Chapter&#160;14.&#160;Boost.DLL</title>
   6 <link rel="stylesheet" href="../../doc/src/boostbook.css" type="text/css">
   7 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
   8 <link rel="home" href="index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
   9 <link rel="up" href="libraries.html" title="Part&#160;I.&#160;The Boost C++ Libraries (BoostBook Subset)">
  10 <link rel="prev" href="boost/local_time/tz_database.html" title="Type definition tz_database">
  11 <link rel="next" href="boost_dll/getting_started.html" title="Getting started">
  12 </head>
  13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  14 <table cellpadding="2" width="100%"><tr>
  15 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../boost.png"></td>
  16 <td align="center"><a href="../../index.html">Home</a></td>
  17 <td align="center"><a href="../../libs/libraries.htm">Libraries</a></td>
  18 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  19 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  20 <td align="center"><a href="../../more/index.htm">More</a></td>
  21 </tr></table>
  22 <hr>
  23 <div class="spirit-nav">
  24 <a accesskey="p" href="boost/local_time/tz_database.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost_dll/getting_started.html"><img src="../../doc/src/images/next.png" alt="Next"></a>
  25 </div>
  26 <div class="chapter">
  27 <div class="titlepage"><div>
  28 <div><h2 class="title">
  29 <a name="boost_dll"></a>Chapter&#160;14.&#160;Boost.DLL</h2></div>
  30 <div><div class="author"><h3 class="author">
  31 <span class="firstname">Renato</span> <span class="surname">Forti</span>
  32 </h3></div></div>
  33 <div><div class="author"><h3 class="author">
  34 <span class="firstname">Antony</span> <span class="surname">Polukhin</span>
  35 </h3></div></div>
  36 <div><p class="copyright">Copyright &#169; 2014 Renato Tegon Forti, Antony Polukhin</p></div>
  37 <div><p class="copyright">Copyright &#169; 2015 Antony Polukhin</p></div>
  38 <div><p class="copyright">Copyright &#169; 2016 Antony Polukhin, Klemens Morgenstern</p></div>
  39 <div><p class="copyright">Copyright &#169; 2017-2019 Antony Polukhin</p></div>
  40 <div><div class="legalnotice">
  41 <a name="boost_dll.legal"></a><p>
  42         Distributed under the Boost Software License, Version 1.0. (See accompanying
  43         file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
  44       </p>
  45 </div></div>
  46 </div></div>
  47 <div class="toc">
  48 <p><b>Table of Contents</b></p>
  49 <dl class="toc">
  50 <dt><span class="section"><a href="boost_dll.html#boost_dll.introduction">Motivation</a></span></dt>
  51 <dt><span class="section"><a href="boost_dll/getting_started.html">Getting started</a></span></dt>
  52 <dt><span class="section"><a href="boost_dll/tutorial.html">Tutorial</a></span></dt>
  53 <dd><dl>
  54 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.plugin_basics">Plugin basics</a></span></dt>
  55 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.factory_method_in_plugin">Factory
  56       method in plugin</a></span></dt>
  57 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.searching_for_a_symbol_in_multiple_plugins">Searching
  58       for a symbol in multiple plugins</a></span></dt>
  59 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.linking_plugin_into_the_executable">Linking
  60       plugin into the executable</a></span></dt>
  61 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.symbol_shadowing_problem__linux_">Symbol
  62       shadowing problem (Linux)</a></span></dt>
  63 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.executing_callbacks_on_library_unload">Executing
  64       callbacks on library unload</a></span></dt>
  65 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.querying_libraries_for_symbols">Querying
  66       libraries for symbols</a></span></dt>
  67 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.advanced_library_reference_counting">Advanced
  68       library reference counting</a></span></dt>
  69 <dt><span class="section"><a href="boost_dll/tutorial.html#boost_dll.tutorial.importing_a_c_function_from_windows_dll">Importing
  70       a C function from Windows dll</a></span></dt>
  71 </dl></dd>
  72 <dt><span class="section"><a href="boost_dll/mangled_import.html">Mangled Import</a></span></dt>
  73 <dd><dl>
  74 <dt><span class="section"><a href="boost_dll/mangled_import.html#boost_dll.mangled_import.support___requirements">Support
  75       &amp; Requirements</a></span></dt>
  76 <dt><span class="section"><a href="boost_dll/mangled_import.html#boost_dll.mangled_import.mangled_import_example">Mangled
  77       Import Example</a></span></dt>
  78 <dt><span class="section"><a href="boost_dll/mangled_import.html#boost_dll.mangled_import.class_import">Class Import</a></span></dt>
  79 <dt><span class="section"><a href="boost_dll/mangled_import.html#boost_dll.mangled_import.overloading_qualifiers">Overloading
  80       qualifiers</a></span></dt>
  81 </dl></dd>
  82 <dt><span class="section"><a href="boost_dll/missuses.html">Missuses</a></span></dt>
  83 <dt><span class="section"><a href="boost_dll/reference.html">Reference</a></span></dt>
  84 <dd><dl>
  85 <dt><span class="section"><a href="boost_dll/reference.html#shared_library_reference">Shared Library Reference</a></span></dt>
  86 <dt><span class="section"><a href="boost_dll/reference.html#shared_library_refcountable_reference">Shared Library Refcountable Reference</a></span></dt>
  87 </dl></dd>
  88 <dt><span class="section"><a href="boost_dll/limitations.html">Limitations</a></span></dt>
  89 <dd><dl>
  90 <dt><span class="section"><a href="boost_dll/limitations.html#boost_dll.limitations.exporting_weak_symbols__fails_on_mingw__android_">Exporting
  91       weak symbols (Fails on MinGW, Android)</a></span></dt>
  92 <dt><span class="section"><a href="boost_dll/limitations.html#boost_dll.limitations.user_defined_section_names__fails_on_sunos___oracle_solaris_studio_compilers_">User
  93       defined section names (Fails on SunOS + Oracle Solaris Studio Compilers)</a></span></dt>
  94 <dt><span class="section"><a href="boost_dll/limitations.html#boost_dll.limitations.multithread">Thread safe library
  95       loading (Fails on FreeBSD, MacOS, iOS and some other)</a></span></dt>
  96 <dt><span class="section"><a href="boost_dll/limitations.html#boost_dll.limitations.nested">Nested Function Definitions</a></span></dt>
  97 </dl></dd>
  98 <dt><span class="section"><a href="boost_dll/f_a_q_.html">F.A.Q.</a></span></dt>
  99 <dt><span class="section"><a href="boost_dll/design_rationale.html">Design Rationale</a></span></dt>
 100 <dd><dl>
 101 <dt><span class="section"><a href="boost_dll/design_rationale.html#boost_dll.design_rationale.abi_portability_across_compilers">ABI
 102       portability across compilers</a></span></dt>
 103 <dt><span class="section"><a href="boost_dll/design_rationale.html#boost_dll.design_rationale.user_s_plugin_api">User's
 104       plugin API</a></span></dt>
 105 <dt><span class="section"><a href="boost_dll/design_rationale.html#boost_dll.design_rationale.performance_and_memory_allocations">Performance
 106       and memory allocations</a></span></dt>
 107 <dt><span class="section"><a href="boost_dll/design_rationale.html#boost_dll.design_rationale.self_loading">Self loading</a></span></dt>
 108 <dt><span class="section"><a href="boost_dll/design_rationale.html#boost_dll.design_rationale.aliases_vs_mangling">Aliases
 109       vs Mangling</a></span></dt>
 110 </dl></dd>
 111 <dt><span class="section"><a href="boost_dll/dependencies.html">Dependencies</a></span></dt>
 112 <dt><span class="section"><a href="boost_dll/revision_history.html">Revision History</a></span></dt>
 113 <dt><span class="section"><a href="boost_dll/acknowledgements.html">Acknowledgements</a></span></dt>
 114 </dl>
 115 </div>
 116 <div class="section">
 117 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 118 <a name="boost_dll.introduction"></a><a class="link" href="boost_dll.html#boost_dll.introduction" title="Motivation">Motivation</a>
 119 </h2></div></div></div>
 120 <p>
 121       Adding a specific features to an existing software applications at runtime
 122       could be useful in many cases. Such extensions, or plugins, are usually implemented
 123       using Dynamic Library Modules (DLL,SO/DSO) loaded at runtime.
 124     </p>
 125 <p>
 126       This library was designed to simplify plugin development using C++ in a portable
 127       cross-platform manner.
 128     </p>
 129 <p>
 130       Library provides a portable across platforms way to:
 131     </p>
 132 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 133 <li class="listitem">
 134           load libraries
 135         </li>
 136 <li class="listitem">
 137           import any native functions and variables
 138         </li>
 139 <li class="listitem">
 140           make alias names for C++ mangled functions and symbols
 141         </li>
 142 <li class="listitem">
 143           query libraries for sections and exported symbols
 144         </li>
 145 <li class="listitem">
 146           self loading and self querying
 147         </li>
 148 <li class="listitem">
 149           getting program and module location by exported symbol
 150         </li>
 151 </ul></div>
 152 </div>
 153 </div>
 154 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
 155 <td align="left"><p><small>Last revised: December 10, 2019 at 00:26:54 GMT</small></p></td>
 156 <td align="right"><div class="copyright-footer"></div></td>
 157 </tr></table>
 158 <hr>
 159 <div class="spirit-nav">
 160 <a accesskey="p" href="boost/local_time/tz_database.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="boost_dll/getting_started.html"><img src="../../doc/src/images/next.png" alt="Next"></a>
 161 </div>
 162 </body>
 163 </html>