Mercurial > pub > dyncall > dyncall
comparison dynload/dynload.3 @ 0:3e629dc19168
initial from svn dyncall-1745
author | Daniel Adler |
---|---|
date | Thu, 19 Mar 2015 22:24:28 +0100 |
parents | |
children | c40e9fcccc41 |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:3e629dc19168 |
---|---|
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 |