aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRamiro Polla <ramiro.polla@gmail.com>2007-06-28 05:50:08 +0000
committerRamiro Polla <ramiro.polla@gmail.com>2007-06-28 05:50:08 +0000
commit4c4b268c43f61ec03f07eb883b739135df3f6eb4 (patch)
tree9b3433d5e6fb2c62fb25dc8e83d8982f29bfa968
downloaddlfcn-win32-4c4b268c43f61ec03f07eb883b739135df3f6eb4.tar.gz
dlfcn-win32-4c4b268c43f61ec03f07eb883b739135df3f6eb4.tar.bz2
dlfcn-win32-4c4b268c43f61ec03f07eb883b739135df3f6eb4.zip
Initial Revision
-rw-r--r--COPYING504
-rw-r--r--Makefile77
-rw-r--r--README11
-rwxr-xr-xconfigure151
-rw-r--r--dlfcn.c260
-rw-r--r--dlfcn.h45
-rw-r--r--test.c157
-rw-r--r--testdll.c26
8 files changed, 1231 insertions, 0 deletions
diff --git a/COPYING b/COPYING
new file mode 100644
index 0000000..268a240
--- /dev/null
+++ b/COPYING
@@ -0,0 +1,504 @@
1 GNU LESSER GENERAL PUBLIC LICENSE
2 Version 2.1, February 1999
3
4 Copyright (C) 1991, 1999 Free Software Foundation, Inc.
5 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
6 Everyone is permitted to copy and distribute verbatim copies
7 of this license document, but changing it is not allowed.
8
9[This is the first released version of the Lesser GPL. It also counts
10 as the successor of the GNU Library Public License, version 2, hence
11 the version number 2.1.]
12
13 Preamble
14
15 The licenses for most software are designed to take away your
16freedom to share and change it. By contrast, the GNU General Public
17Licenses are intended to guarantee your freedom to share and change
18free software--to make sure the software is free for all its users.
19
20 This license, the Lesser General Public License, applies to some
21specially designated software packages--typically libraries--of the
22Free Software Foundation and other authors who decide to use it. You
23can use it too, but we suggest you first think carefully about whether
24this license or the ordinary General Public License is the better
25strategy to use in any particular case, based on the explanations below.
26
27 When we speak of free software, we are referring to freedom of use,
28not price. Our General Public Licenses are designed to make sure that
29you have the freedom to distribute copies of free software (and charge
30for this service if you wish); that you receive source code or can get
31it if you want it; that you can change the software and use pieces of
32it in new free programs; and that you are informed that you can do
33these things.
34
35 To protect your rights, we need to make restrictions that forbid
36distributors to deny you these rights or to ask you to surrender these
37rights. These restrictions translate to certain responsibilities for
38you if you distribute copies of the library or if you modify it.
39
40 For example, if you distribute copies of the library, whether gratis
41or for a fee, you must give the recipients all the rights that we gave
42you. You must make sure that they, too, receive or can get the source
43code. If you link other code with the library, you must provide
44complete object files to the recipients, so that they can relink them
45with the library after making changes to the library and recompiling
46it. And you must show them these terms so they know their rights.
47
48 We protect your rights with a two-step method: (1) we copyright the
49library, and (2) we offer you this license, which gives you legal
50permission to copy, distribute and/or modify the library.
51
52 To protect each distributor, we want to make it very clear that
53there is no warranty for the free library. Also, if the library is
54modified by someone else and passed on, the recipients should know
55that what they have is not the original version, so that the original
56author's reputation will not be affected by problems that might be
57introduced by others.
58
59 Finally, software patents pose a constant threat to the existence of
60any free program. We wish to make sure that a company cannot
61effectively restrict the users of a free program by obtaining a
62restrictive license from a patent holder. Therefore, we insist that
63any patent license obtained for a version of the library must be
64consistent with the full freedom of use specified in this license.
65
66 Most GNU software, including some libraries, is covered by the
67ordinary GNU General Public License. This license, the GNU Lesser
68General Public License, applies to certain designated libraries, and
69is quite different from the ordinary General Public License. We use
70this license for certain libraries in order to permit linking those
71libraries into non-free programs.
72
73 When a program is linked with a library, whether statically or using
74a shared library, the combination of the two is legally speaking a
75combined work, a derivative of the original library. The ordinary
76General Public License therefore permits such linking only if the
77entire combination fits its criteria of freedom. The Lesser General
78Public License permits more lax criteria for linking other code with
79the library.
80
81 We call this license the "Lesser" General Public License because it
82does Less to protect the user's freedom than the ordinary General
83Public License. It also provides other free software developers Less
84of an advantage over competing non-free programs. These disadvantages
85are the reason we use the ordinary General Public License for many
86libraries. However, the Lesser license provides advantages in certain
87special circumstances.
88
89 For example, on rare occasions, there may be a special need to
90encourage the widest possible use of a certain library, so that it becomes
91a de-facto standard. To achieve this, non-free programs must be
92allowed to use the library. A more frequent case is that a free
93library does the same job as widely used non-free libraries. In this
94case, there is little to gain by limiting the free library to free
95software only, so we use the Lesser General Public License.
96
97 In other cases, permission to use a particular library in non-free
98programs enables a greater number of people to use a large body of
99free software. For example, permission to use the GNU C Library in
100non-free programs enables many more people to use the whole GNU
101operating system, as well as its variant, the GNU/Linux operating
102system.
103
104 Although the Lesser General Public License is Less protective of the
105users' freedom, it does ensure that the user of a program that is
106linked with the Library has the freedom and the wherewithal to run
107that program using a modified version of the Library.
108
109 The precise terms and conditions for copying, distribution and
110modification follow. Pay close attention to the difference between a
111"work based on the library" and a "work that uses the library". The
112former contains code derived from the library, whereas the latter must
113be combined with the library in order to run.
114
115 GNU LESSER GENERAL PUBLIC LICENSE
116 TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
117
118 0. This License Agreement applies to any software library or other
119program which contains a notice placed by the copyright holder or
120other authorized party saying it may be distributed under the terms of
121this Lesser General Public License (also called "this License").
122Each licensee is addressed as "you".
123
124 A "library" means a collection of software functions and/or data
125prepared so as to be conveniently linked with application programs
126(which use some of those functions and data) to form executables.
127
128 The "Library", below, refers to any such software library or work
129which has been distributed under these terms. A "work based on the
130Library" means either the Library or any derivative work under
131copyright law: that is to say, a work containing the Library or a
132portion of it, either verbatim or with modifications and/or translated
133straightforwardly into another language. (Hereinafter, translation is
134included without limitation in the term "modification".)
135
136 "Source code" for a work means the preferred form of the work for
137making modifications to it. For a library, complete source code means
138all the source code for all modules it contains, plus any associated
139interface definition files, plus the scripts used to control compilation
140and installation of the library.
141
142 Activities other than copying, distribution and modification are not
143covered by this License; they are outside its scope. The act of
144running a program using the Library is not restricted, and output from
145such a program is covered only if its contents constitute a work based
146on the Library (independent of the use of the Library in a tool for
147writing it). Whether that is true depends on what the Library does
148and what the program that uses the Library does.
149
150 1. You may copy and distribute verbatim copies of the Library's
151complete source code as you receive it, in any medium, provided that
152you conspicuously and appropriately publish on each copy an
153appropriate copyright notice and disclaimer of warranty; keep intact
154all the notices that refer to this License and to the absence of any
155warranty; and distribute a copy of this License along with the
156Library.
157
158 You may charge a fee for the physical act of transferring a copy,
159and you may at your option offer warranty protection in exchange for a
160fee.
161
162 2. You may modify your copy or copies of the Library or any portion
163of it, thus forming a work based on the Library, and copy and
164distribute such modifications or work under the terms of Section 1
165above, provided that you also meet all of these conditions:
166
167 a) The modified work must itself be a software library.
168
169 b) You must cause the files modified to carry prominent notices
170 stating that you changed the files and the date of any change.
171
172 c) You must cause the whole of the work to be licensed at no
173 charge to all third parties under the terms of this License.
174
175 d) If a facility in the modified Library refers to a function or a
176 table of data to be supplied by an application program that uses
177 the facility, other than as an argument passed when the facility
178 is invoked, then you must make a good faith effort to ensure that,
179 in the event an application does not supply such function or
180 table, the facility still operates, and performs whatever part of
181 its purpose remains meaningful.
182
183 (For example, a function in a library to compute square roots has
184 a purpose that is entirely well-defined independent of the
185 application. Therefore, Subsection 2d requires that any
186 application-supplied function or table used by this function must
187 be optional: if the application does not supply it, the square
188 root function must still compute square roots.)
189
190These requirements apply to the modified work as a whole. If
191identifiable sections of that work are not derived from the Library,
192and can be reasonably considered independent and separate works in
193themselves, then this License, and its terms, do not apply to those
194sections when you distribute them as separate works. But when you
195distribute the same sections as part of a whole which is a work based
196on the Library, the distribution of the whole must be on the terms of
197this License, whose permissions for other licensees extend to the
198entire whole, and thus to each and every part regardless of who wrote
199it.
200
201Thus, it is not the intent of this section to claim rights or contest
202your rights to work written entirely by you; rather, the intent is to
203exercise the right to control the distribution of derivative or
204collective works based on the Library.
205
206In addition, mere aggregation of another work not based on the Library
207with the Library (or with a work based on the Library) on a volume of
208a storage or distribution medium does not bring the other work under
209the scope of this License.
210
211 3. You may opt to apply the terms of the ordinary GNU General Public
212License instead of this License to a given copy of the Library. To do
213this, you must alter all the notices that refer to this License, so
214that they refer to the ordinary GNU General Public License, version 2,
215instead of to this License. (If a newer version than version 2 of the
216ordinary GNU General Public License has appeared, then you can specify
217that version instead if you wish.) Do not make any other change in
218these notices.
219
220 Once this change is made in a given copy, it is irreversible for
221that copy, so the ordinary GNU General Public License applies to all
222subsequent copies and derivative works made from that copy.
223
224 This option is useful when you wish to copy part of the code of
225the Library into a program that is not a library.
226
227 4. You may copy and distribute the Library (or a portion or
228derivative of it, under Section 2) in object code or executable form
229under the terms of Sections 1 and 2 above provided that you accompany
230it with the complete corresponding machine-readable source code, which
231must be distributed under the terms of Sections 1 and 2 above on a
232medium customarily used for software interchange.
233
234 If distribution of object code is made by offering access to copy
235from a designated place, then offering equivalent access to copy the
236source code from the same place satisfies the requirement to
237distribute the source code, even though third parties are not
238compelled to copy the source along with the object code.
239
240 5. A program that contains no derivative of any portion of the
241Library, but is designed to work with the Library by being compiled or
242linked with it, is called a "work that uses the Library". Such a
243work, in isolation, is not a derivative work of the Library, and
244therefore falls outside the scope of this License.
245
246 However, linking a "work that uses the Library" with the Library
247creates an executable that is a derivative of the Library (because it
248contains portions of the Library), rather than a "work that uses the
249library". The executable is therefore covered by this License.
250Section 6 states terms for distribution of such executables.
251
252 When a "work that uses the Library" uses material from a header file
253that is part of the Library, the object code for the work may be a
254derivative work of the Library even though the source code is not.
255Whether this is true is especially significant if the work can be
256linked without the Library, or if the work is itself a library. The
257threshold for this to be true is not precisely defined by law.
258
259 If such an object file uses only numerical parameters, data
260structure layouts and accessors, and small macros and small inline
261functions (ten lines or less in length), then the use of the object
262file is unrestricted, regardless of whether it is legally a derivative
263work. (Executables containing this object code plus portions of the
264Library will still fall under Section 6.)
265
266 Otherwise, if the work is a derivative of the Library, you may
267distribute the object code for the work under the terms of Section 6.
268Any executables containing that work also fall under Section 6,
269whether or not they are linked directly with the Library itself.
270
271 6. As an exception to the Sections above, you may also combine or
272link a "work that uses the Library" with the Library to produce a
273work containing portions of the Library, and distribute that work
274under terms of your choice, provided that the terms permit
275modification of the work for the customer's own use and reverse
276engineering for debugging such modifications.
277
278 You must give prominent notice with each copy of the work that the
279Library is used in it and that the Library and its use are covered by
280this License. You must supply a copy of this License. If the work
281during execution displays copyright notices, you must include the
282copyright notice for the Library among them, as well as a reference
283directing the user to the copy of this License. Also, you must do one
284of these things:
285
286 a) Accompany the work with the complete corresponding
287 machine-readable source code for the Library including whatever
288 changes were used in the work (which must be distributed under
289 Sections 1 and 2 above); and, if the work is an executable linked
290 with the Library, with the complete machine-readable "work that
291 uses the Library", as object code and/or source code, so that the
292 user can modify the Library and then relink to produce a modified
293 executable containing the modified Library. (It is understood
294 that the user who changes the contents of definitions files in the
295 Library will not necessarily be able to recompile the application
296 to use the modified definitions.)
297
298 b) Use a suitable shared library mechanism for linking with the
299 Library. A suitable mechanism is one that (1) uses at run time a
300 copy of the library already present on the user's computer system,
301 rather than copying library functions into the executable, and (2)
302 will operate properly with a modified version of the library, if
303 the user installs one, as long as the modified version is
304 interface-compatible with the version that the work was made with.
305
306 c) Accompany the work with a written offer, valid for at
307 least three years, to give the same user the materials
308 specified in Subsection 6a, above, for a charge no more
309 than the cost of performing this distribution.
310
311 d) If distribution of the work is made by offering access to copy
312 from a designated place, offer equivalent access to copy the above
313 specified materials from the same place.
314
315 e) Verify that the user has already received a copy of these
316 materials or that you have already sent this user a copy.
317
318 For an executable, the required form of the "work that uses the
319Library" must include any data and utility programs needed for
320reproducing the executable from it. However, as a special exception,
321the materials to be distributed need not include anything that is
322normally distributed (in either source or binary form) with the major
323components (compiler, kernel, and so on) of the operating system on
324which the executable runs, unless that component itself accompanies
325the executable.
326
327 It may happen that this requirement contradicts the license
328restrictions of other proprietary libraries that do not normally
329accompany the operating system. Such a contradiction means you cannot
330use both them and the Library together in an executable that you
331distribute.
332
333 7. You may place library facilities that are a work based on the
334Library side-by-side in a single library together with other library
335facilities not covered by this License, and distribute such a combined
336library, provided that the separate distribution of the work based on
337the Library and of the other library facilities is otherwise
338permitted, and provided that you do these two things:
339
340 a) Accompany the combined library with a copy of the same work
341 based on the Library, uncombined with any other library
342 facilities. This must be distributed under the terms of the
343 Sections above.
344
345 b) Give prominent notice with the combined library of the fact
346 that part of it is a work based on the Library, and explaining
347 where to find the accompanying uncombined form of the same work.
348
349 8. You may not copy, modify, sublicense, link with, or distribute
350the Library except as expressly provided under this License. Any
351attempt otherwise to copy, modify, sublicense, link with, or
352distribute the Library is void, and will automatically terminate your
353rights under this License. However, parties who have received copies,
354or rights, from you under this License will not have their licenses
355terminated so long as such parties remain in full compliance.
356
357 9. You are not required to accept this License, since you have not
358signed it. However, nothing else grants you permission to modify or
359distribute the Library or its derivative works. These actions are
360prohibited by law if you do not accept this License. Therefore, by
361modifying or distributing the Library (or any work based on the
362Library), you indicate your acceptance of this License to do so, and
363all its terms and conditions for copying, distributing or modifying
364the Library or works based on it.
365
366 10. Each time you redistribute the Library (or any work based on the
367Library), the recipient automatically receives a license from the
368original licensor to copy, distribute, link with or modify the Library
369subject to these terms and conditions. You may not impose any further
370restrictions on the recipients' exercise of the rights granted herein.
371You are not responsible for enforcing compliance by third parties with
372this License.
373
374 11. If, as a consequence of a court judgment or allegation of patent
375infringement or for any other reason (not limited to patent issues),
376conditions are imposed on you (whether by court order, agreement or
377otherwise) that contradict the conditions of this License, they do not
378excuse you from the conditions of this License. If you cannot
379distribute so as to satisfy simultaneously your obligations under this
380License and any other pertinent obligations, then as a consequence you
381may not distribute the Library at all. For example, if a patent
382license would not permit royalty-free redistribution of the Library by
383all those who receive copies directly or indirectly through you, then
384the only way you could satisfy both it and this License would be to
385refrain entirely from distribution of the Library.
386
387If any portion of this section is held invalid or unenforceable under any
388particular circumstance, the balance of the section is intended to apply,
389and the section as a whole is intended to apply in other circumstances.
390
391It is not the purpose of this section to induce you to infringe any
392patents or other property right claims or to contest validity of any
393such claims; this section has the sole purpose of protecting the
394integrity of the free software distribution system which is
395implemented by public license practices. Many people have made
396generous contributions to the wide range of software distributed
397through that system in reliance on consistent application of that
398system; it is up to the author/donor to decide if he or she is willing
399to distribute software through any other system and a licensee cannot
400impose that choice.
401
402This section is intended to make thoroughly clear what is believed to
403be a consequence of the rest of this License.
404
405 12. If the distribution and/or use of the Library is restricted in
406certain countries either by patents or by copyrighted interfaces, the
407original copyright holder who places the Library under this License may add
408an explicit geographical distribution limitation excluding those countries,
409so that distribution is permitted only in or among countries not thus
410excluded. In such case, this License incorporates the limitation as if
411written in the body of this License.
412
413 13. The Free Software Foundation may publish revised and/or new
414versions of the Lesser General Public License from time to time.
415Such new versions will be similar in spirit to the present version,
416but may differ in detail to address new problems or concerns.
417
418Each version is given a distinguishing version number. If the Library
419specifies a version number of this License which applies to it and
420"any later version", you have the option of following the terms and
421conditions either of that version or of any later version published by
422the Free Software Foundation. If the Library does not specify a
423license version number, you may choose any version ever published by
424the Free Software Foundation.
425
426 14. If you wish to incorporate parts of the Library into other free
427programs whose distribution conditions are incompatible with these,
428write to the author to ask for permission. For software which is
429copyrighted by the Free Software Foundation, write to the Free
430Software Foundation; we sometimes make exceptions for this. Our
431decision will be guided by the two goals of preserving the free status
432of all derivatives of our free software and of promoting the sharing
433and reuse of software generally.
434
435 NO WARRANTY
436
437 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
438WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
439EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
440OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
441KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
442IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
443PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
444LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
445THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
446
447 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
448WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
449AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
450FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
451CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
452LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
453RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
454FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
455SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
456DAMAGES.
457
458 END OF TERMS AND CONDITIONS
459
460 How to Apply These Terms to Your New Libraries
461
462 If you develop a new library, and you want it to be of the greatest
463possible use to the public, we recommend making it free software that
464everyone can redistribute and change. You can do so by permitting
465redistribution under these terms (or, alternatively, under the terms of the
466ordinary General Public License).
467
468 To apply these terms, attach the following notices to the library. It is
469safest to attach them to the start of each source file to most effectively
470convey the exclusion of warranty; and each file should have at least the
471"copyright" line and a pointer to where the full notice is found.
472
473 <one line to give the library's name and a brief idea of what it does.>
474 Copyright (C) <year> <name of author>
475
476 This library is free software; you can redistribute it and/or
477 modify it under the terms of the GNU Lesser General Public
478 License as published by the Free Software Foundation; either
479 version 2 of the License, or (at your option) any later version.
480
481 This library is distributed in the hope that it will be useful,
482 but WITHOUT ANY WARRANTY; without even the implied warranty of
483 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
484 Lesser General Public License for more details.
485
486 You should have received a copy of the GNU Lesser General Public
487 License along with this library; if not, write to the Free Software
488 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
489
490Also add information on how to contact you by electronic and paper mail.
491
492You should also get your employer (if you work as a programmer) or your
493school, if any, to sign a "copyright disclaimer" for the library, if
494necessary. Here is a sample; alter the names:
495
496 Yoyodyne, Inc., hereby disclaims all copyright interest in the
497 library `Frob' (a library for tweaking knobs) written by James Random Hacker.
498
499 <signature of Ty Coon>, 1 April 1990
500 Ty Coon, President of Vice
501
502That's all there is to it!
503
504
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..f98579a
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,77 @@
1#
2# dlfcn-win32 Makefile
3#
4include config.mak
5
6ifeq ($(BUILD_SHARED),yes)
7 TARGETS+=libdl.dll
8 SHFLAGS+=-Wl,--out-implib,libdl.dll.a
9 INSTALL+=shared-install
10endif
11ifeq ($(BUILD_STATIC),yes)
12 TARGETS+=libdl.a
13 INSTALL+=static-install
14endif
15ifeq ($(BUILD_MSVC),yes)
16 SHFLAGS+=-Wl,--output-def,libdl.def
17 LIBCMD=lib
18 INSTALL+=lib-install
19else
20 LIBCMD=echo ignoring lib
21endif
22ifeq ($(DO_STRIP),yes)
23 STRIP=strip
24else
25 STRIP=echo ignoring strip
26endif
27
28all: $(TARGETS)
29
30dlfcn.o:
31 $(CC) -o dlfcn.o -c dlfcn.c -O3 -fomit-frame-pointer
32
33libdl.a: dlfcn.o
34 ar cru libdl.a dlfcn.o
35 ranlib libdl.a
36
37libdl.dll: dlfcn.o
38 $(CC) $(SHFLAGS) -shared -o libdl.dll dlfcn.o
39 $(LIBCMD) /machine:i386 /def:libdl.def
40
41shared-install:
42 mkdir -p $(DESTDIR)$(PREFIX)/bin
43 cp libdl.dll $(DESTDIR)$(PREFIX)/bin
44 $(STRIP) $(DESTDIR)$(PREFIX)/bin/libdl.dll
45 mkdir -p $(DESTDIR)$(PREFIX)/lib
46 cp libdl.dll.a $(DESTDIR)$(PREFIX)/lib
47 mkdir -p $(DESTDIR)$(PREFIX)/include
48 cp dlfcn.h $(DESTDIR)$(PREFIX)/include
49
50static-install:
51 mkdir -p $(DESTDIR)$(PREFIX)/lib
52 cp libdl.a $(DESTDIR)$(PREFIX)/lib
53 mkdir -p $(DESTDIR)$(PREFIX)/include
54 cp dlfcn.h $(DESTDIR)$(PREFIX)/include
55
56lib-install:
57 mkdir -p $(DESTDIR)$(PREFIX)/lib
58 cp libdl.lib $(DESTDIR)$(PREFIX)/lib
59
60install: $(INSTALL)
61
62test.exe:
63 $(CC) -o test.exe test.c -L. -ldl
64
65testdll.dll:
66 $(CC) -shared -o testdll.dll testdll.c
67
68test: $(TARGETS) test.exe testdll.dll
69 test.exe
70
71clean::
72 rm -f dlfcn.o libdl.dll libdl.a libdl.def libdl.dll.a libdl.lib libdl.exp test.exe testdll.dll
73
74distclean: clean
75 rm -f config.mak
76
77.PHONY: clean distclean install test
diff --git a/README b/README
new file mode 100644
index 0000000..192480d
--- /dev/null
+++ b/README
@@ -0,0 +1,11 @@
1dlfcn-win32 is an implementation of dlfcn for Windows.
2
3It follows the standard as described here:
4http://www.opengroup.org/onlinepubs/009695399/basedefs/dlfcn.h.html
5http://www.opengroup.org/onlinepubs/009695399/functions/dlerror.html
6http://www.opengroup.org/onlinepubs/009695399/functions/dlsym.html
7http://www.opengroup.org/onlinepubs/009695399/functions/dlclose.html
8http://www.opengroup.org/onlinepubs/009695399/functions/dlopen.html
9
10Written by Ramiro Polla
11Released under the LGPL \ No newline at end of file
diff --git a/configure b/configure
new file mode 100755
index 0000000..f5d8c64
--- /dev/null
+++ b/configure
@@ -0,0 +1,151 @@
1#!/bin/sh
2# dlfcn-win32 configure script
3#
4# Parts copied from FFmpeg's configure
5#
6
7set_all(){
8 value=$1
9 shift
10 for var in $*; do
11 eval $var=$value
12 done
13}
14
15enable(){
16 set_all yes $*
17}
18
19disable(){
20 set_all no $*
21}
22
23enabled(){
24 eval test "x\$$1" = "xyes"
25}
26
27disabled(){
28 eval test "x\$$1" = "xno"
29}
30
31show_help(){
32 echo "Usage: configure [options]"
33 echo "Options: [defaults in brackets after descriptions]"
34 echo "All \"enable\" options have \"disable\" counterparts"
35 echo
36 echo " --help print this message"
37 echo " --prefix=PREFIX install in PREFIX [$PREFIX]"
38 echo " --enable-shared build shared libraries [no]"
39 echo " --enable-static build static libraries [yes]"
40 echo " --enable-msvc create msvc-compatible import lib [auto]"
41 echo " --enable-strip strip shared library [yes]"
42 echo
43 echo " --cc=CC use C compiler CC [$cc]"
44 echo " --make=MAKE use specified make [$make]"
45 exit 1
46}
47
48die_unknown(){
49 echo "Unknown option \"$1\"."
50 echo "See $0 --help for available options."
51 exit 1
52}
53
54PREFIX="/mingw"
55cc="gcc"
56
57DEFAULT="msvc
58"
59
60DEFAULT_NO="shared
61"
62
63DEFAULT_YES="static
64 strip
65"
66
67CMDLINE_SELECT="$DEFAULT
68 $DEFAULT_NO
69 $DEFAULT_YES
70"
71
72enable $DEFAULT_YES
73disable $DEFAULT_NO
74
75for opt do
76 optval="${opt#*=}"
77 case "$opt" in
78 --help)
79 show_help
80 ;;
81 --prefix=*)
82 PREFIX="$optval"
83 ;;
84 --cc=*)
85 cc="$optval"
86 ;;
87 --make=*)
88 make="$optval"
89 ;;
90 --enable-?*|--disable-?*)
91 eval `echo "$opt" | sed 's/--/action=/;s/-/ option=/;s/-/_/g'`
92 echo "$CMDLINE_SELECT" | grep -q "^ *$option\$" || die_unknown $opt
93 $action $option
94 ;;
95 *)
96 die_unknown $opt
97 ;;
98 esac
99done
100
101disabled shared && disabled static && {
102 echo "At least one library type must be set.";
103 exit 1;
104}
105
106# simple cc test
107cat > /tmp/test.c << EOF
108int function(void)
109{ return 0; }
110EOF
111$cc -shared -o /tmp/test.dll /tmp/test.c
112
113test "$?" = !0 && {
114 echo "$cc could not create shared file.";
115 echo "Make sure your system is working properly.";
116 exit 1;
117}
118
119if enabled msvc; then
120 disabled shared && {
121 echo "MSVC understands static libraries created by gcc."
122 echo "There's no need to create an import lib."
123 exit 1
124 }
125 lib /? >& /dev/null || {
126 echo "MSVC's lib command not found."
127 echo "Make sure MSVC is installed and its bin folder is in your \$PATH."
128 exit 1
129 }
130fi
131
132if enabled shared; then
133 lib /? >& /dev/null && enable msvc || disable msvc
134fi
135
136echo "# Automatically generated by configure" > config.mak
137echo "PREFIX=$PREFIX" >> config.mak
138echo "CC=$cc" >> config.mak
139echo "BUILD_SHARED=$shared" >> config.mak
140echo "BUILD_STATIC=$static" >> config.mak
141echo "BUILD_MSVC=$msvc" >> config.mak
142echo "DO_STRIP=$strip" >> config.mak
143
144echo "prefix: $PREFIX"
145echo "cc: $cc"
146echo "static: $static"
147echo "shared: $shared"
148enabled shared && {
149 echo "msvc: $msvc";
150 echo "strip: $strip";
151}
diff --git a/dlfcn.c b/dlfcn.c
new file mode 100644
index 0000000..f56a262
--- /dev/null
+++ b/dlfcn.c
@@ -0,0 +1,260 @@
1/*
2 * dlfcn-win32
3 * Copyright (c) 2007 Ramiro Polla
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
9 *
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
14 *
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18 */
19
20#include <windows.h>
21#include <stdio.h>
22
23#include "dlfcn.h"
24
25/* Note:
26 * MSDN says these functions are not thread-safe. We make no efforts to have
27 * any kind of thread safety.
28 */
29
30/* I have no special reason to have set MAX_GLOBAL_OBJECTS to this value. Any
31 * comments are welcome.
32 */
33#define MAX_OBJECTS 255
34
35static HMODULE global_objects[MAX_OBJECTS];
36
37/* This function adds an object to the list of global objects.
38 * The implementation is very simple and slow.
39 * TODO: should failing this function be enough to fail the call to dlopen( )?
40 */
41static void global_object_add( HMODULE hModule )
42{
43 int i;
44
45 for( i = 0 ; i < MAX_OBJECTS ; i++ )
46 {
47 if( !global_objects[i] )
48 {
49 global_objects[i] = hModule;
50 break;
51 }
52 }
53}
54
55static void global_object_rem( HMODULE hModule )
56{
57 int i;
58
59 for( i = 0 ; i < MAX_OBJECTS ; i++ )
60 {
61 if( global_objects[i] == hModule )
62 {
63 global_objects[i] = 0;
64 break;
65 }
66 }
67}
68
69/* Argument to last function. Used in dlerror( ) */
70static char last_name[MAX_PATH];
71
72static int copy_string( char *dest, int dest_size, const char *src )
73{
74 int i = 0;
75
76 if( src && dest )
77 {
78 for( i = 0 ; i < dest_size-1 ; i++ )
79 {
80 if( !src[i] )
81 break;
82 else
83 dest[i] = src[i];
84 }
85 }
86 dest[i] = '\0';
87
88 return i;
89}
90
91void *dlopen( const char *file, int mode )
92{
93 HMODULE hModule;
94 UINT uMode;
95
96 /* Do not let Windows display the critical-error-handler message box */
97 uMode = SetErrorMode( SEM_FAILCRITICALERRORS );
98
99 if( file == 0 )
100 {
101 /* Save NULL pointer for error message */
102 sprintf( last_name, "0x%p", file );
103
104 /* POSIX says that if the value of file is 0, a handle on a global
105 * symbol object must be provided. That object must be able to access
106 * all symbols from the original program file, and any objects loaded
107 * with the RTLD_GLOBAL flag.
108 * The return value from GetModuleHandle( ) allows us to retrieve
109 * symbols only from the original program file. For objects loaded with
110 * the RTLD_GLOBAL flag, we create our own list later on.
111 */
112 hModule = GetModuleHandle( NULL );
113 }
114 else
115 {
116 char lpFileName[MAX_PATH];
117 int i;
118
119 /* MSDN says backslashes *must* be used instead of forward slashes. */
120 for( i = 0 ; i < sizeof(lpFileName)-1 ; i++ )
121 {
122 if( !file[i] )
123 break;
124 else if( file[i] == '/' )
125 lpFileName[i] = '\\';
126 else
127 lpFileName[i] = file[i];
128 }
129 lpFileName[i] = '\0';
130
131 /* Save file name for error message */
132 copy_string( last_name, sizeof(last_name), lpFileName );
133
134 /* POSIX says the search path is implementation-defined.
135 * LOAD_WITH_ALTERED_SEARCH_PATH is used to make it behave more closely
136 * to UNIX's search paths (start with system folders instead of current
137 * folder).
138 */
139 hModule = LoadLibraryEx( (LPSTR) lpFileName, NULL,
140 LOAD_WITH_ALTERED_SEARCH_PATH );
141
142 /* If the object was loaded with RTLD_GLOBAL, add it to list of global
143 * objects, so that its symbols may be retrieved even if the handle for
144 * the original program file is passed. POSIX says that if the same
145 * file is specified in multiple invocations, and any of them are
146 * RTLD_GLOBAL, even if any further invocations use RTLD_LOCAL, the
147 * symbols will remain global.
148 */
149 if( hModule && (mode & RTLD_GLOBAL) )
150 global_object_add( hModule );
151 }
152
153 /* Return to previous state of the error-mode bit flags. */
154 SetErrorMode( uMode );
155
156 return (void *) hModule;
157}
158
159int dlclose( void *handle )
160{
161 HMODULE hModule = (HMODULE) handle;
162 BOOL ret;
163
164 /* Save handle for error message */
165 sprintf( last_name, "0x%p", handle );
166
167 ret = FreeLibrary( hModule );
168
169 /* If the object was loaded with RTLD_GLOBAL, remove it from list of global
170 * objects.
171 */
172 if( ret )
173 global_object_rem( hModule );
174
175 /* dlclose's return value in inverted in relation to FreeLibrary's. */
176 ret = !ret;
177
178 return (int) ret;
179}
180
181void *dlsym( void *handle, const char *name )
182{
183 FARPROC symbol;
184
185 /* Save symbol name for error message */
186 copy_string( last_name, sizeof(last_name), name );
187
188 symbol = GetProcAddress( handle, name );
189
190 if( symbol == NULL )
191 {
192 HMODULE hModule;
193
194 /* If the handle for the original program file is passed, also search
195 * in all globally loaded objects.
196 */
197
198 hModule = GetModuleHandle( NULL );
199
200 if( hModule == handle )
201 {
202 int i;
203
204 for( i = 0 ; i < MAX_OBJECTS ; i++ )
205 {
206 if( global_objects[i] != 0 )
207 {
208 symbol = GetProcAddress( global_objects[i], name );
209 if( symbol != NULL )
210 break;
211 }
212 }
213 }
214
215 CloseHandle( hModule );
216 }
217
218 return (void*) symbol;
219}
220
221char *dlerror( void )
222{
223 DWORD dwMessageId;
224 /* POSIX says this function doesn't have to be thread-safe, so we use one
225 * static buffer.
226 * MSDN says the buffer cannot be larger than 64K bytes, so we set it to
227 * the limit.
228 */
229 static char lpBuffer[65535];
230 DWORD ret;
231
232 dwMessageId = GetLastError( );
233
234 if( dwMessageId == 0 )
235 return NULL;
236
237 /* Format error message to:
238 * "<argument to function that failed>": <Windows localized error message>
239 */
240 ret = copy_string( lpBuffer, sizeof(lpBuffer), "\"" );
241 ret += copy_string( lpBuffer+ret, sizeof(lpBuffer)-ret, last_name );
242 ret += copy_string( lpBuffer+ret, sizeof(lpBuffer)-ret, "\": " );
243 ret += FormatMessage( FORMAT_MESSAGE_FROM_SYSTEM, NULL, dwMessageId,
244 MAKELANGID( LANG_NEUTRAL, SUBLANG_DEFAULT ),
245 lpBuffer+ret, sizeof(lpBuffer)-ret, NULL );
246
247 if( ret > 1 )
248 {
249 /* POSIX says the string must not have trailing <newline> */
250 if( lpBuffer[ret-2] == '\r' && lpBuffer[ret-1] == '\n' )
251 lpBuffer[ret-2] = '\0';
252 }
253
254 /* POSIX says that invoking dlerror( ) a second time, immediately following
255 * a prior invocation, shall result in NULL being returned.
256 */
257 SetLastError(0);
258
259 return lpBuffer;
260}
diff --git a/dlfcn.h b/dlfcn.h
new file mode 100644
index 0000000..dfc2551
--- /dev/null
+++ b/dlfcn.h
@@ -0,0 +1,45 @@
1/*
2 * dlfcn-win32
3 * Copyright (c) 2007 Ramiro Polla
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
9 *
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
14 *
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18 */
19
20#ifndef DLFCN_H
21#define DLFCN_H
22
23/* POSIX says these are implementation-defined.
24 * To simplify use with Windows API, we treat them the same way.
25 */
26
27#define RTLD_LAZY 0
28#define RTLD_NOW 0
29
30#define RTLD_GLOBAL (1 << 1)
31#define RTLD_LOCAL (1 << 2)
32
33/* These two were added in The Open Group Base Specifications Issue 6.
34 * Note: All other RTLD_* flags in any dlfcn.h are not standard compliant.
35 */
36
37#define RTLD_DEFAULT 0
38#define RTLD_NEXT 0
39
40void *dlopen ( const char *file, int mode );
41int dlclose( void *handle );
42void *dlsym ( void *handle, const char *name );
43char *dlerror( void );
44
45#endif /* DLFCN_H */
diff --git a/test.c b/test.c
new file mode 100644
index 0000000..832c000
--- /dev/null
+++ b/test.c
@@ -0,0 +1,157 @@
1/*
2 * dlfcn-win32
3 * Copyright (c) 2007 Ramiro Polla
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
9 *
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
14 *
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18 */
19
20#include <stdio.h>
21#include "dlfcn.h"
22
23/* This is what this test does:
24 * - Open library with RTLD_GLOBAL
25 * - Get global object
26 * - Get symbol from library through library object <- works
27 * - Run function if it worked
28 * - Get symbol from library through global object <- works
29 * - Run function if it worked
30 * - Close library
31 * - Open library with RTLD_LOCAL
32 * - Get symbol from library through library object <- works
33 * - Run function if it worked
34 * - Get symbol from library through global object <- fails
35 * - Run function if it worked
36 * - Open library again (without closing it first) with RTLD_GLOBAL
37 * - Get symbol from library through global object <- works
38 * - Close library
39 * - Close global object
40 */
41
42int main()
43{
44 void *global;
45 void *library;
46 char *error;
47 int (*function)( void );
48 int ret;
49
50 library = dlopen( "testdll.dll", RTLD_GLOBAL );
51 if( !library )
52 {
53 error = dlerror( );
54 printf( "Could not open library globally: %s\n", error ? error : "" );
55 }
56 else
57 printf( "Opened library globally: %p\n", library );
58
59 global = dlopen( 0, RTLD_GLOBAL );
60 if( !global )
61 {
62 error = dlerror( );
63 printf( "Could not open global handle: %s\n", error ? error : "" );
64 }
65 else
66 printf( "Got global handle: %p\n", global );
67
68 function = dlsym( library, "function" );
69 if( !function )
70 {
71 error = dlerror( );
72 printf( "Could not get symbol from library handle: %s\n",
73 error ? error : "" );
74 }
75 else
76 printf( "Got symbol from library handle: %p\n", function );
77
78 if( function )
79 function( );
80
81 function = dlsym( global, "function" );
82 if( !function )
83 {
84 error = dlerror( );
85 printf( "Could not get symbol from global handle: %s\n",
86 error ? error : "" );
87 }
88 else
89 printf( "Got symbol from global handle: %p\n", function );
90
91 if( function )
92 function( );
93
94 ret = dlclose( library );
95 if( ret )
96 {
97 error = dlerror( );
98 printf( "Could not close library: %s\n", error ? error : "" );
99 }
100 else
101 printf( "Closed library.\n" );
102
103 library = dlopen( "testdll.dll", RTLD_LOCAL );
104 if( !library )
105 {
106 error = dlerror( );
107 printf( "Could not open library locally: %s\n", error ? error : "" );
108 }
109 else
110 printf( "Opened library locally: %p\n", library );
111
112 function = dlsym( library, "function" );
113 if( !function )
114 {
115 error = dlerror( );
116 printf( "Could not get symbol from library handle: %s\n",
117 error ? error : "" );
118 }
119 else
120 printf( "Got symbol from library handle: %p\n", function );
121
122 if( function )
123 function( );
124
125 function = dlsym( global, "function" );
126 if( !function )
127 {
128 error = dlerror( );
129 printf( "Could not get symbol from global handle: %s\n",
130 error ? error : "" );
131 }
132 else
133 printf( "Got symbol from global handle: %p\n", function );
134
135 if( function )
136 function( );
137
138 ret = dlclose( library );
139 if( ret )
140 {
141 error = dlerror( );
142 printf( "Could not close library: %s\n", error ? error : "" );
143 }
144 else
145 printf( "Closed library.\n" );
146
147 ret = dlclose( global );
148 if( ret )
149 {
150 error = dlerror( );
151 printf( "Could not close global handle: %s\n", error ? error : "" );
152 }
153 else
154 printf( "Closed global handle.\n" );
155
156 return 0;
157}
diff --git a/testdll.c b/testdll.c
new file mode 100644
index 0000000..851dc59
--- /dev/null
+++ b/testdll.c
@@ -0,0 +1,26 @@
1/*
2 * dlfcn-win32
3 * Copyright (c) 2007 Ramiro Polla
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
9 *
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
14 *
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18 */
19
20#include <stdio.h>
21
22int function( void )
23{
24 printf( "Hello, world!\n" );
25 return 0;
26}