Mercurial > pub > dyncall > dyncall
annotate dyncallback/dyncall_thunk.h @ 211:60ec815531b9
- more doc overview corrections
author | Tassilo Philipp |
---|---|
date | Tue, 28 Mar 2017 15:36:45 +0200 |
parents | b11b0735b09f |
children | f5577f6bf97a |
rev | line source |
---|---|
0 | 1 /* |
2 | |
3 Package: dyncall | |
4 Library: dyncallback | |
5 File: dyncallback/dyncall_thunk.h | |
6 Description: Thunk - Interface | |
7 License: | |
8 | |
9 Copyright (c) 2007-2015 Daniel Adler <dadler@uni-goettingen.de>, | |
10 Tassilo Philipp <tphilipp@potion-studios.com> | |
11 | |
12 Permission to use, copy, modify, and distribute this software for any | |
13 purpose with or without fee is hereby granted, provided that the above | |
14 copyright notice and this permission notice appear in all copies. | |
15 | |
16 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | |
17 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | |
18 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | |
19 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | |
20 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | |
21 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | |
22 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | |
23 | |
24 */ | |
25 | |
26 | |
27 #ifndef DYNCALL_THUNK_H | |
28 #define DYNCALL_THUNK_H | |
29 | |
30 /** | |
31 ** dyncall thunks | |
32 ** | |
33 ** thunks are small-size hybrid code/data objects, created at run-time to | |
34 ** be used as function pointers with associated data and entry functions. | |
35 ** | |
36 ** The header contains code, that does load its address into a designated scratch | |
37 ** register and will jump to a thunk function. | |
38 ** | |
39 ** Thunk entry procedures are compiled functions, that are called as a result of | |
40 ** a thunk function. | |
41 ** There is one thunk entry currently for supporting callbacks. | |
42 ** | |
43 ** Thunk context register ( ::= an available scratch register in the calling convention): | |
44 ** | |
45 ** x86: eax | |
46 ** x64: rax | |
47 ** ppc: r2 | |
48 ** arm: r12 | |
49 ** arm64: x9 | |
101 | 50 ** mips: t4 |
0 | 51 ** |
52 **/ | |
53 | |
145
63892f03e493
- minix fix for callbacks (floats are also returned via eax/edx on minix)
cslag
parents:
143
diff
changeset
|
54 #include "../dyncall/dyncall_macros.h" |
0 | 55 |
56 typedef struct DCThunk_ DCThunk; | |
57 | |
58 #ifdef __cplusplus | |
59 extern "C" { | |
60 #endif | |
61 | |
62 void dcbInitThunk(DCThunk* p, void (*entry)()); | |
63 | |
64 #if defined(DC__Arch_Intel_x86) | |
65 #include "dyncall_thunk_x86.h" | |
66 #elif defined (DC__Arch_AMD64) | |
67 #include "dyncall_thunk_x64.h" | |
68 #elif defined (DC__Arch_PPC32) | |
69 #include "dyncall_thunk_ppc32.h" | |
70 #elif defined (DC__Arch_PPC64) | |
71 #include "dyncall_thunk_ppc64.h" | |
143
170cde9e2a83
- arm arm/thumb cleanup, sharing more files, directly
cslag
parents:
116
diff
changeset
|
72 #elif defined (DC__Arch_ARM) |
170cde9e2a83
- arm arm/thumb cleanup, sharing more files, directly
cslag
parents:
116
diff
changeset
|
73 #include "dyncall_thunk_arm32.h" |
0 | 74 #elif defined (DC__Arch_MIPS) |
75 #include "dyncall_thunk_mips.h" | |
116 | 76 #elif defined (DC__Arch_MIPS64) |
77 #include "dyncall_thunk_mips64.h" | |
0 | 78 #elif defined (DC__Arch_Sparc) |
79 #include "dyncall_thunk_sparc32.h" | |
179 | 80 #elif defined (DC__Arch_Sparc64) |
0 | 81 #include "dyncall_thunk_sparc64.h" |
82 #elif defined (DC__Arch_ARM64) | |
83 #include "dyncall_thunk_arm64.h" | |
84 #endif | |
85 | |
86 #ifdef __cplusplus | |
87 } | |
88 #endif | |
89 | |
90 | |
91 #endif /* DYNCALL_THUNK_H */ | |
101 | 92 |