1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
|
// Copyright 2014 Renato Tegon Forti, Antony Polukhin.
// Copyright 2015-2016 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_SHARED_LIBRARY_MODE_HPP
#define BOOST_DLL_SHARED_LIBRARY_MODE_HPP
#include <boost/config.hpp>
#include <boost/predef/os.h>
#include <boost/predef/library/c.h>
#if BOOST_OS_WINDOWS
//#include <boost/detail/winapi/dll.hpp>
#include <boost/detail/winapi/dll.hpp>
#else
# include <dlfcn.h>
#endif
#ifdef BOOST_HAS_PRAGMA_ONCE
# pragma once
#endif
/// \file boost/dll/shared_library_load_mode.hpp
/// \brief Contains only the boost::dll::load_mode::type enum and operators related to it.
namespace boost { namespace dll { namespace load_mode {
/*! Library load modes.
*
* Each of system family provides own modes. Flags not supported by a particular platform will be silently ignored.
*
* For a detailed description of platform specific options see:
* <a href="http://msdn.microsoft.com/en-us/library/windows/desktop/ms684179(v=vs.85).aspx">Windows specific options</a>,
* <a href="http://pubs.opengroup.org/onlinepubs/000095399/functions/dlopen.html">POSIX specific options</a>.
*
*/
enum type {
#ifdef BOOST_DLL_DOXYGEN
/*!
* Default open mode. See the \b Default: comments below to find out the flags that are enabled by default.
*/
default_mode,
/*!
* \b Platforms: Windows
*
* \b Default: disabled
*
* If this value is used, and the executable module is a DLL, the system does
* not call DllMain for process and thread initialization and termination.
* Also, the system does not load additional executable modules that are
* referenced by the specified module.
*
* Note Do not use this value; it is provided only for backward compatibility.
* If you are planning to access only data or resources in the DLL, use
* LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE or LOAD_LIBRARY_AS_IMAGE_RESOURCE
* or both.
*/
dont_resolve_dll_references,
/*!
* \b Platforms: Windows
*
* \b Default: disabled
*
* If this value is used, the system does not check AppLocker rules or
* apply Software Restriction Policies for the DLL.
*/
load_ignore_code_authz_level,
/*!
* \b Platforms: Windows
*
* \b Default: disabled
*
* If this value is used and lpFileName specifies an absolute path,
* the system uses the alternate file search strategy.
*
* This value cannot be combined with any LOAD_LIBRARY_SEARCH flag.
*/
load_with_altered_search_path,
/*!
* \b Platforms: POSIX
*
* \b Default: enabled
*
* Relocations shall be performed at an implementation-defined time, ranging
* from the time of the dlopen() call until the first reference to a given
* symbol occurs.
*
* Specifying RTLD_LAZY should improve performance on implementations
* supporting dynamic symbol binding as a process may not reference all of
* the functions in any given object. And, for systems supporting dynamic
* symbol resolution for normal process execution, this behavior mimics
* the normal handling of process execution.
*/
rtld_lazy,
/*!
* \b Platforms: POSIX
*
* \b Default: disabled
*
* All necessary relocations shall be performed when the object is first
* loaded. This may waste some processing if relocations are performed for
* functions that are never referenced. This behavior may be useful for
* plugins that need to know as soon as an object is loaded that all
* symbols referenced during execution are available.
*/
rtld_now,
/*!
* \b Platforms: POSIX
*
* \b Default: disabled
*
* The object's symbols shall be made available for the relocation
* processing of any other object. In addition, symbol lookup using
* dlopen(0, mode) and an associated dlsym() allows objects loaded
* with this mode to be searched.
*/
rtld_global,
/*!
* \b Platforms: POSIX
*
* \b Default: enabled
*
* The object's symbols shall not be made available for the relocation
* processing of any other object.
*
* This is a default Windows behavior that can not be changed.
*/
rtld_local,
/*!
* \b Platforms: POSIX (requires glibc >= 2.3.4)
*
* \b Default: disabled
*
* The object will use its own symbols in preference to global symbols
* with the same name contained in libraries that have already been loaded.
* This flag is not specified in POSIX.1-2001.
*/
rtld_deepbind,
/*!
* \b Platforms: Windows, POSIX
*
* \b Default: disabled
*
* Append a platform specific extension and prefix to shared library filename before trying to load it.
* If load attempt fails, try to load with exactly specified name.
*
* \b Example:
* \code
* // Opens `./my_plugins/plugin1.dll` on Windows, `./my_plugins/libplugin1.so` on Linux, `./my_plugins/libplugin1.dylib` on MacOS.
* // If that fails, loads `./my_plugins/plugin1`
* boost::dll::shared_library lib("./my_plugins/plugin1", load_mode::append_decorations);
* \endcode
*/
append_decorations,
/*!
* \b Platforms: Windows, POSIX
*
* \b Default: disabled
*
* Allow loading from system folders if path to library contains no parent path.
*/
search_system_folders
#elif BOOST_OS_WINDOWS
default_mode = 0,
dont_resolve_dll_references = boost::detail::winapi::DONT_RESOLVE_DLL_REFERENCES_,
load_ignore_code_authz_level = boost::detail::winapi::LOAD_IGNORE_CODE_AUTHZ_LEVEL_,
load_with_altered_search_path = boost::detail::winapi::LOAD_WITH_ALTERED_SEARCH_PATH_,
rtld_lazy = 0,
rtld_now = 0,
rtld_global = 0,
rtld_local = 0,
rtld_deepbind = 0,
append_decorations = 0x00800000,
search_system_folders = (append_decorations << 1)
#else
default_mode = 0,
dont_resolve_dll_references = 0,
load_ignore_code_authz_level = 0,
load_with_altered_search_path = 0,
rtld_lazy = RTLD_LAZY,
rtld_now = RTLD_NOW,
rtld_global = RTLD_GLOBAL,
rtld_local = RTLD_LOCAL,
#if BOOST_LIB_C_GNU < BOOST_VERSION_NUMBER(2,3,4)
rtld_deepbind = 0,
#else
rtld_deepbind = RTLD_DEEPBIND,
#endif
append_decorations = 0x00800000,
search_system_folders = (append_decorations << 1)
#endif
};
/// Free operators for load_mode::type flag manipulation.
BOOST_CONSTEXPR inline type operator|(type left, type right) BOOST_NOEXCEPT {
return static_cast<type>(
static_cast<unsigned int>(left) | static_cast<unsigned int>(right)
);
}
BOOST_CXX14_CONSTEXPR inline type& operator|=(type& left, type right) BOOST_NOEXCEPT {
left = left | right;
return left;
}
BOOST_CONSTEXPR inline type operator&(type left, type right) BOOST_NOEXCEPT {
return static_cast<type>(
static_cast<unsigned int>(left) & static_cast<unsigned int>(right)
);
}
BOOST_CXX14_CONSTEXPR inline type& operator&=(type& left, type right) BOOST_NOEXCEPT {
left = left & right;
return left;
}
BOOST_CONSTEXPR inline type operator^(type left, type right) BOOST_NOEXCEPT {
return static_cast<type>(
static_cast<unsigned int>(left) ^ static_cast<unsigned int>(right)
);
}
BOOST_CXX14_CONSTEXPR inline type& operator^=(type& left, type right) BOOST_NOEXCEPT {
left = left ^ right;
return left;
}
BOOST_CONSTEXPR inline type operator~(type left) BOOST_NOEXCEPT {
return static_cast<type>(
~static_cast<unsigned int>(left)
);
}
}}} // boost::dll::load_mode
#endif // BOOST_DLL_SHARED_LIBRARY_MODE_HPP
|
