|
0
|
1 .\" Copyright (c) 2007-2014 Daniel Adler <dadler AT uni-goettingen DOT de>,
|
|
|
2 .\" Tassilo Philipp <tphilipp AT potion-studios DOT com>
|
|
|
3 .\"
|
|
|
4 .\" Permission to use, copy, modify, and distribute this software for any
|
|
|
5 .\" purpose with or without fee is hereby granted, provided that the above
|
|
|
6 .\" copyright notice and this permission notice appear in all copies.
|
|
|
7 .\"
|
|
|
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
|
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
|
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
|
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
|
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
|
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
|
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
|
15 .\"
|
|
|
16 .Dd $Mdocdate$
|
|
|
17 .Dt dynload 3
|
|
|
18 .Os
|
|
|
19
|
|
|
20 .Sh NAME
|
|
|
21 .Nm dynload
|
|
|
22 .Nd encapsulates dynamic loading mechanisms and
|
|
|
23 gives access to functions in foreign dynamic libraries and code modules.
|
|
|
24 .Sh SYNOPSIS
|
|
|
25 .In dynload.h
|
|
|
26 .Ft DLLib *
|
|
|
27 .Fn dlLoadLibrary "const char * libpath"
|
|
|
28 .Ft void
|
|
|
29 .Fn dlFreeLibrary "DLLib * pLib"
|
|
|
30 .Ft void *
|
|
|
31 .Fn dlFindSymbol "DLLib pLibode" "const char * pSymbolName"
|
|
|
32 .Sh DESCRIPTION
|
|
|
33 The
|
|
|
34 .Nm
|
|
|
35 library provides an interface to load foreign dynamic libraries and access
|
|
|
36 to their symbols.
|
|
|
37 .Pp
|
|
|
38 .Fn dlLoadLibrary
|
|
|
39 loads a dynamic library at
|
|
|
40 .Ar libpath
|
|
|
41 and returns a handle to it for use in
|
|
|
42 .Fn dlFreeLibrary
|
|
|
43 and
|
|
|
44 .Fn dlFindSymbol
|
|
|
45 calls.
|
|
|
46 .Pp
|
|
|
47 .Fn dlFreeLibrary
|
|
|
48 frees the loaded library with handle
|
|
|
49 .Ar pLib .
|
|
|
50 .Pp
|
|
|
51 .Fn dlFindSymbol
|
|
|
52 returns a pointer to a symbol with name
|
|
|
53 .Ar pSymbolName
|
|
|
54 in the library with handle
|
|
|
55 .Ar pLib ,
|
|
|
56 or returns a null pointer if the symbol cannot be found.
|
|
|
57 .Sh SEE ALSO
|
|
|
58 .Xr dyncall 3 ,
|
|
|
59 .Xr dyncallback 3
|
|
|
60 and the dyncall manual (available in PDF format) for a way more detailed documentation of this
|
|
|
61 library.
|
|
|
62 .Sh AUTHORS
|
|
|
63 .An "Daniel Adler" Aq dadler@uni-goettingen.de
|
|
|
64 .An "Tassilo Philipp" Aq tphilipp@potion-studios.com
|
