Mercurial > pub > dyncall > dyncall
annotate dynload/dynload.3 @ 223:7076f551faf5
- dynload mach-o handling fixes for 64bit platforms
- dynload test code improvements
- dynload(3) clarification
author | Tassilo Philipp |
---|---|
date | Sat, 15 Apr 2017 15:21:37 +0200 |
parents | 28bf0b231bce |
children | f8a6e60598cc |
rev | line source |
---|---|
216
28bf0b231bce
- dynload man page clarification about resolving own symbols
Tassilo Philipp
parents:
93
diff
changeset
|
1 .\" Copyright (c) 2007-2017 Daniel Adler <dadler AT uni-goettingen DOT de>, |
0 | 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 .Sh NAME | |
19 .Nm dynload | |
20 .Nd encapsulates dynamic loading mechanisms and | |
21 gives access to functions in foreign dynamic libraries and code modules. | |
22 .Sh SYNOPSIS | |
23 .In dynload.h | |
24 .Ft DLLib * | |
25 .Fn dlLoadLibrary "const char * libpath" | |
26 .Ft void | |
27 .Fn dlFreeLibrary "DLLib * pLib" | |
28 .Ft void * | |
216
28bf0b231bce
- dynload man page clarification about resolving own symbols
Tassilo Philipp
parents:
93
diff
changeset
|
29 .Fn dlFindSymbol "DLLib * pLib" "const char * pSymbolName" |
0 | 30 .Sh DESCRIPTION |
31 The | |
32 .Nm | |
33 library provides an interface to load foreign dynamic libraries and access | |
34 to their symbols. | |
35 .Pp | |
36 .Fn dlLoadLibrary | |
37 loads a dynamic library at | |
38 .Ar libpath | |
39 and returns a handle to it for use in | |
40 .Fn dlFreeLibrary | |
41 and | |
42 .Fn dlFindSymbol | |
216
28bf0b231bce
- dynload man page clarification about resolving own symbols
Tassilo Philipp
parents:
93
diff
changeset
|
43 calls. Passing a null pointer for the |
28bf0b231bce
- dynload man page clarification about resolving own symbols
Tassilo Philipp
parents:
93
diff
changeset
|
44 .Ar libpath |
28bf0b231bce
- dynload man page clarification about resolving own symbols
Tassilo Philipp
parents:
93
diff
changeset
|
45 argument is valid, and returns a handle to the main executable of the calling code. Returns a null pointer on error. |
0 | 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 , | |
223
7076f551faf5
- dynload mach-o handling fixes for 64bit platforms
Tassilo Philipp
parents:
216
diff
changeset
|
56 or returns a null pointer if the symbol cannot be found. The name is specified as it would appear in C source code (mangled if C++, etc.). |
0 | 57 .Sh SEE ALSO |
58 .Xr dyncall 3 , | |
59 .Xr dyncallback 3 | |
93 | 60 and the dyncall manual (available in HTML and PDF format) for more information. |
0 | 61 .Sh AUTHORS |
62 .An "Daniel Adler" Aq dadler@uni-goettingen.de | |
63 .An "Tassilo Philipp" Aq tphilipp@potion-studios.com |