|
1 // (C) Copyright John Maddock 2003. |
|
2 // Use, modification and distribution are subject to the |
|
3 // Boost Software License, Version 1.0. (See accompanying file |
|
4 // LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) |
|
5 |
|
6 /* |
|
7 * LOCATION: see http://www.boost.org for most recent version. |
|
8 * FILE auto_link.hpp |
|
9 * VERSION see <boost/version.hpp> |
|
10 * DESCRIPTION: Automatic library inclusion for Borland/Microsoft compilers. |
|
11 */ |
|
12 |
|
13 /************************************************************************* |
|
14 |
|
15 USAGE: |
|
16 ~~~~~~ |
|
17 |
|
18 Before including this header you must define one or more of define the following macros: |
|
19 |
|
20 BOOST_LIB_NAME: Required: A string containing the basename of the library, |
|
21 for example boost_regex. |
|
22 BOOST_LIB_TOOLSET: Optional: the base name of the toolset. |
|
23 BOOST_DYN_LINK: Optional: when set link to dll rather than static library. |
|
24 BOOST_LIB_DIAGNOSTIC: Optional: when set the header will print out the name |
|
25 of the library selected (useful for debugging). |
|
26 BOOST_AUTO_LINK_NOMANGLE: Specifies that we should link to BOOST_LIB_NAME.lib, |
|
27 rather than a mangled-name version. |
|
28 |
|
29 These macros will be undef'ed at the end of the header, further this header |
|
30 has no include guards - so be sure to include it only once from your library! |
|
31 |
|
32 Algorithm: |
|
33 ~~~~~~~~~~ |
|
34 |
|
35 Libraries for Borland and Microsoft compilers are automatically |
|
36 selected here, the name of the lib is selected according to the following |
|
37 formula: |
|
38 |
|
39 BOOST_LIB_PREFIX |
|
40 + BOOST_LIB_NAME |
|
41 + "_" |
|
42 + BOOST_LIB_TOOLSET |
|
43 + BOOST_LIB_THREAD_OPT |
|
44 + BOOST_LIB_RT_OPT |
|
45 "-" |
|
46 + BOOST_LIB_VERSION |
|
47 |
|
48 These are defined as: |
|
49 |
|
50 BOOST_LIB_PREFIX: "lib" for static libraries otherwise "". |
|
51 |
|
52 BOOST_LIB_NAME: The base name of the lib ( for example boost_regex). |
|
53 |
|
54 BOOST_LIB_TOOLSET: The compiler toolset name (vc6, vc7, bcb5 etc). |
|
55 |
|
56 BOOST_LIB_THREAD_OPT: "-mt" for multithread builds, otherwise nothing. |
|
57 |
|
58 BOOST_LIB_RT_OPT: A suffix that indicates the runtime library used, |
|
59 contains one or more of the following letters after |
|
60 a hiphen: |
|
61 |
|
62 s static runtime (dynamic if not present). |
|
63 d debug build (release if not present). |
|
64 g debug/diagnostic runtime (release if not present). |
|
65 p STLPort Build. |
|
66 |
|
67 BOOST_LIB_VERSION: The Boost version, in the form x_y, for Boost version x.y. |
|
68 |
|
69 |
|
70 ***************************************************************************/ |
|
71 |
|
72 #ifdef __cplusplus |
|
73 # ifndef BOOST_CONFIG_HPP |
|
74 # include <boost/config.hpp> |
|
75 # endif |
|
76 #elif defined(_MSC_VER) && !defined(__MWERKS__) && !defined(__EDG_VERSION__) |
|
77 // |
|
78 // C language compatability (no, honestly) |
|
79 // |
|
80 # define BOOST_MSVC _MSC_VER |
|
81 # define BOOST_STRINGIZE(X) BOOST_DO_STRINGIZE(X) |
|
82 # define BOOST_DO_STRINGIZE(X) #X |
|
83 #endif |
|
84 // |
|
85 // Only include what follows for known and supported compilers: |
|
86 // |
|
87 #if defined(BOOST_MSVC) \ |
|
88 || defined(__BORLANDC__) \ |
|
89 || (defined(__MWERKS__) && defined(_WIN32) && (__MWERKS__ >= 0x3000)) \ |
|
90 || (defined(__ICL) && defined(_MSC_EXTENSIONS) && (_MSC_VER >= 1200)) |
|
91 |
|
92 #ifndef BOOST_VERSION_HPP |
|
93 # include <boost/version.hpp> |
|
94 #endif |
|
95 |
|
96 #ifndef BOOST_LIB_NAME |
|
97 # error "Macro BOOST_LIB_NAME not set (internal error)" |
|
98 #endif |
|
99 |
|
100 // |
|
101 // error check: |
|
102 // |
|
103 #if defined(__MSVC_RUNTIME_CHECKS) && !defined(_DEBUG) |
|
104 # pragma message("Using the /RTC option without specifying a debug runtime will lead to linker errors") |
|
105 # pragma message("Hint: go to the code generation options and switch to one of the debugging runtimes") |
|
106 # error "Incompatible build options" |
|
107 #endif |
|
108 // |
|
109 // select toolset if not defined already: |
|
110 // |
|
111 #ifndef BOOST_LIB_TOOLSET |
|
112 // Note: no compilers before 1200 are supported |
|
113 #if defined(BOOST_MSVC) && (BOOST_MSVC < 1300) |
|
114 |
|
115 # ifdef UNDER_CE |
|
116 // vc6: |
|
117 # define BOOST_LIB_TOOLSET "evc4" |
|
118 # else |
|
119 // vc6: |
|
120 # define BOOST_LIB_TOOLSET "vc6" |
|
121 # endif |
|
122 |
|
123 #elif defined(BOOST_MSVC) && (BOOST_MSVC == 1300) |
|
124 |
|
125 // vc7: |
|
126 # define BOOST_LIB_TOOLSET "vc7" |
|
127 |
|
128 #elif defined(BOOST_MSVC) && (BOOST_MSVC == 1310) |
|
129 |
|
130 // vc71: |
|
131 # define BOOST_LIB_TOOLSET "vc71" |
|
132 |
|
133 #elif defined(BOOST_MSVC) && (BOOST_MSVC >= 1400) |
|
134 |
|
135 // vc80: |
|
136 # define BOOST_LIB_TOOLSET "vc80" |
|
137 |
|
138 #elif defined(__BORLANDC__) |
|
139 |
|
140 // CBuilder 6: |
|
141 # define BOOST_LIB_TOOLSET "bcb" |
|
142 |
|
143 #elif defined(__ICL) |
|
144 |
|
145 // Intel C++, no version number: |
|
146 # define BOOST_LIB_TOOLSET "iw" |
|
147 |
|
148 #elif defined(__MWERKS__) && (__MWERKS__ <= 0x31FF ) |
|
149 |
|
150 // Metrowerks CodeWarrior 8.x |
|
151 # define BOOST_LIB_TOOLSET "cw8" |
|
152 |
|
153 #elif defined(__MWERKS__) && (__MWERKS__ <= 0x32FF ) |
|
154 |
|
155 // Metrowerks CodeWarrior 9.x |
|
156 # define BOOST_LIB_TOOLSET "cw9" |
|
157 |
|
158 #endif |
|
159 #endif // BOOST_LIB_TOOLSET |
|
160 |
|
161 // |
|
162 // select thread opt: |
|
163 // |
|
164 #if defined(_MT) || defined(__MT__) |
|
165 # define BOOST_LIB_THREAD_OPT "-mt" |
|
166 #else |
|
167 # define BOOST_LIB_THREAD_OPT |
|
168 #endif |
|
169 |
|
170 #if defined(_MSC_VER) || defined(__MWERKS__) |
|
171 |
|
172 # ifdef _DLL |
|
173 |
|
174 # if (defined(__SGI_STL_PORT) || defined(_STLPORT_VERSION)) && (defined(_STLP_OWN_IOSTREAMS) || defined(__STL_OWN_IOSTREAMS)) |
|
175 |
|
176 # if defined(_DEBUG) && (defined(__STL_DEBUG) || defined(_STLP_DEBUG)) |
|
177 # define BOOST_LIB_RT_OPT "-gdp" |
|
178 # elif defined(_DEBUG) |
|
179 # define BOOST_LIB_RT_OPT "-gdp" |
|
180 # pragma message("warning: STLPort debug versions are built with /D_STLP_DEBUG=1") |
|
181 # error "Build options aren't compatible with pre-built libraries" |
|
182 # else |
|
183 # define BOOST_LIB_RT_OPT "-p" |
|
184 # endif |
|
185 |
|
186 # elif defined(__SGI_STL_PORT) || defined(_STLPORT_VERSION) |
|
187 |
|
188 # if defined(_DEBUG) && (defined(__STL_DEBUG) || defined(_STLP_DEBUG)) |
|
189 # define BOOST_LIB_RT_OPT "-gdpn" |
|
190 # elif defined(_DEBUG) |
|
191 # define BOOST_LIB_RT_OPT "-gdpn" |
|
192 # pragma message("warning: STLPort debug versions are built with /D_STLP_DEBUG=1") |
|
193 # error "Build options aren't compatible with pre-built libraries" |
|
194 # else |
|
195 # define BOOST_LIB_RT_OPT "-pn" |
|
196 # endif |
|
197 |
|
198 # else |
|
199 |
|
200 # if defined(_DEBUG) |
|
201 # define BOOST_LIB_RT_OPT "-gd" |
|
202 # else |
|
203 # define BOOST_LIB_RT_OPT |
|
204 # endif |
|
205 |
|
206 # endif |
|
207 |
|
208 # else |
|
209 |
|
210 # if (defined(__SGI_STL_PORT) || defined(_STLPORT_VERSION)) && (defined(_STLP_OWN_IOSTREAMS) || defined(__STL_OWN_IOSTREAMS)) |
|
211 |
|
212 # if defined(_DEBUG) && (defined(__STL_DEBUG) || defined(_STLP_DEBUG)) |
|
213 # define BOOST_LIB_RT_OPT "-sgdp" |
|
214 # elif defined(_DEBUG) |
|
215 # define BOOST_LIB_RT_OPT "-sgdp" |
|
216 # pragma message("warning: STLPort debug versions are built with /D_STLP_DEBUG=1") |
|
217 # error "Build options aren't compatible with pre-built libraries" |
|
218 # else |
|
219 # define BOOST_LIB_RT_OPT "-sp" |
|
220 # endif |
|
221 |
|
222 # elif defined(__SGI_STL_PORT) || defined(_STLPORT_VERSION) |
|
223 |
|
224 # if defined(_DEBUG) && (defined(__STL_DEBUG) || defined(_STLP_DEBUG)) |
|
225 # define BOOST_LIB_RT_OPT "-sgdpn" |
|
226 # elif defined(_DEBUG) |
|
227 # define BOOST_LIB_RT_OPT "-sgdpn" |
|
228 # pragma message("warning: STLPort debug versions are built with /D_STLP_DEBUG=1") |
|
229 # error "Build options aren't compatible with pre-built libraries" |
|
230 # else |
|
231 # define BOOST_LIB_RT_OPT "-spn" |
|
232 # endif |
|
233 |
|
234 # else |
|
235 |
|
236 # if defined(_DEBUG) |
|
237 # define BOOST_LIB_RT_OPT "-sgd" |
|
238 # else |
|
239 # define BOOST_LIB_RT_OPT "-s" |
|
240 # endif |
|
241 |
|
242 # endif |
|
243 |
|
244 # endif |
|
245 |
|
246 #elif defined(__BORLANDC__) |
|
247 |
|
248 // |
|
249 // figure out whether we want the debug builds or not: |
|
250 // |
|
251 #if __BORLANDC__ > 0x561 |
|
252 #pragma defineonoption BOOST_BORLAND_DEBUG -v |
|
253 #endif |
|
254 // |
|
255 // sanity check: |
|
256 // |
|
257 #if defined(__STL_DEBUG) || defined(_STLP_DEBUG) |
|
258 #error "Pre-built versions of the Boost libraries are not provided in STLPort-debug form" |
|
259 #endif |
|
260 |
|
261 # ifdef _RTLDLL |
|
262 |
|
263 # ifdef BOOST_BORLAND_DEBUG |
|
264 # define BOOST_LIB_RT_OPT "-d" |
|
265 # else |
|
266 # define BOOST_LIB_RT_OPT |
|
267 # endif |
|
268 |
|
269 # else |
|
270 |
|
271 # ifdef BOOST_BORLAND_DEBUG |
|
272 # define BOOST_LIB_RT_OPT "-sd" |
|
273 # else |
|
274 # define BOOST_LIB_RT_OPT "-s" |
|
275 # endif |
|
276 |
|
277 # endif |
|
278 |
|
279 #endif |
|
280 |
|
281 // |
|
282 // select linkage opt: |
|
283 // |
|
284 #if (defined(_DLL) || defined(_RTLDLL)) && defined(BOOST_DYN_LINK) |
|
285 # define BOOST_LIB_PREFIX |
|
286 #elif defined(BOOST_DYN_LINK) |
|
287 # error "Mixing a dll boost library with a static runtime is a really bad idea..." |
|
288 #else |
|
289 # define BOOST_LIB_PREFIX "lib" |
|
290 #endif |
|
291 |
|
292 // |
|
293 // now include the lib: |
|
294 // |
|
295 #if defined(BOOST_LIB_NAME) \ |
|
296 && defined(BOOST_LIB_PREFIX) \ |
|
297 && defined(BOOST_LIB_TOOLSET) \ |
|
298 && defined(BOOST_LIB_THREAD_OPT) \ |
|
299 && defined(BOOST_LIB_RT_OPT) \ |
|
300 && defined(BOOST_LIB_VERSION) |
|
301 |
|
302 #ifndef BOOST_AUTO_LINK_NOMANGLE |
|
303 # pragma comment(lib, BOOST_LIB_PREFIX BOOST_STRINGIZE(BOOST_LIB_NAME) "-" BOOST_LIB_TOOLSET BOOST_LIB_THREAD_OPT BOOST_LIB_RT_OPT "-" BOOST_LIB_VERSION ".lib") |
|
304 # ifdef BOOST_LIB_DIAGNOSTIC |
|
305 # pragma message ("Linking to lib file: " BOOST_LIB_PREFIX BOOST_STRINGIZE(BOOST_LIB_NAME) "-" BOOST_LIB_TOOLSET BOOST_LIB_THREAD_OPT BOOST_LIB_RT_OPT "-" BOOST_LIB_VERSION ".lib") |
|
306 # endif |
|
307 #else |
|
308 # pragma comment(lib, BOOST_STRINGIZE(BOOST_LIB_NAME) ".lib") |
|
309 # ifdef BOOST_LIB_DIAGNOSTIC |
|
310 # pragma message ("Linking to lib file: " BOOST_STRINGIZE(BOOST_LIB_NAME) ".lib") |
|
311 # endif |
|
312 #endif |
|
313 |
|
314 #else |
|
315 # error "some required macros where not defined (internal logic error)." |
|
316 #endif |
|
317 |
|
318 |
|
319 #endif // _MSC_VER || __BORLANDC__ |
|
320 |
|
321 // |
|
322 // finally undef any macros we may have set: |
|
323 // |
|
324 #ifdef BOOST_LIB_PREFIX |
|
325 # undef BOOST_LIB_PREFIX |
|
326 #endif |
|
327 #if defined(BOOST_LIB_NAME) |
|
328 # undef BOOST_LIB_NAME |
|
329 #endif |
|
330 // Don't undef this one: it can be set by the user and should be the |
|
331 // same for all libraries: |
|
332 //#if defined(BOOST_LIB_TOOLSET) |
|
333 //# undef BOOST_LIB_TOOLSET |
|
334 //#endif |
|
335 #if defined(BOOST_LIB_THREAD_OPT) |
|
336 # undef BOOST_LIB_THREAD_OPT |
|
337 #endif |
|
338 #if defined(BOOST_LIB_RT_OPT) |
|
339 # undef BOOST_LIB_RT_OPT |
|
340 #endif |
|
341 #if defined(BOOST_LIB_LINK_OPT) |
|
342 # undef BOOST_LIB_LINK_OPT |
|
343 #endif |
|
344 #if defined(BOOST_LIB_DEBUG_OPT) |
|
345 # undef BOOST_LIB_DEBUG_OPT |
|
346 #endif |
|
347 #if defined(BOOST_DYN_LINK) |
|
348 # undef BOOST_DYN_LINK |
|
349 #endif |
|
350 #if defined(BOOST_AUTO_LINK_NOMANGLE) |
|
351 # undef BOOST_AUTO_LINK_NOMANGLE |
|
352 #endif |
|
353 |
|
354 |
|
355 |
|
356 |
|
357 |
|
358 |
|
359 |
|
360 |
|
361 |
|
362 |
|
363 |