annotate dyncallback/dyncall_thunk.h @ 663:127b569978cc default tip

- another tweak handling clang trying to be too smart (see last commit)
author Tassilo Philipp
date Sun, 24 Mar 2024 13:52:44 +0100
parents 0c8838766866
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
1 /*
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
2
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
3 Package: dyncall
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
4 Library: dyncallback
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
5 File: dyncallback/dyncall_thunk.h
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
6 Description: Thunk - Interface
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
7 License:
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
8
281
f5577f6bf97a - file header cleanups for release
Tassilo Philipp
parents: 179
diff changeset
9 Copyright (c) 2007-2018 Daniel Adler <dadler@uni-goettingen.de>,
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
10 Tassilo Philipp <tphilipp@potion-studios.com>
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
11
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
12 Permission to use, copy, modify, and distribute this software for any
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
13 purpose with or without fee is hereby granted, provided that the above
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
14 copyright notice and this permission notice appear in all copies.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
15
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
16 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
17 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
18 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
19 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
20 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
21 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
22 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
23
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
24 */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
25
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
26
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
27 #ifndef DYNCALL_THUNK_H
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
28 #define DYNCALL_THUNK_H
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
29
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
30 /**
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
31 ** dyncall thunks
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
32 **
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
33 ** thunks are small-size hybrid code/data objects, created at run-time to
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
34 ** be used as function pointers with associated data and entry functions.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
35 **
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
36 ** The header contains code, that does load its address into a designated scratch
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
37 ** register and will jump to a thunk function.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
38 **
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
39 ** Thunk entry procedures are compiled functions, that are called as a result of
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
40 ** a thunk function.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
41 ** There is one thunk entry currently for supporting callbacks.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
42 **
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
43 ** Thunk context register ( ::= an available scratch register in the calling convention):
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
44 **
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
45 ** x86: eax
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
46 ** x64: rax
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
47 ** ppc: r2
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
48 ** arm: r12
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
49 ** arm64: x9
101
1ce60358fbad - mips related cleanup, mostly comments, cpp macro lib
cslag
parents: 0
diff changeset
50 ** mips: t4
653
0c8838766866 - riscv64 support for calls and callbacks (but lacking aggr and syscall support) - thanks Jun Jeon! :)
Tassilo Philipp
parents: 292
diff changeset
51 ** riscv: t5
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
52 **
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
53 **/
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
54
292
07941cbb5261 - removed relative #include
Tassilo Philipp
parents: 281
diff changeset
55 #include "dyncall_macros.h"
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
56
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
57 typedef struct DCThunk_ DCThunk;
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
58
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
59 #ifdef __cplusplus
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
60 extern "C" {
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
61 #endif
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
62
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
63 void dcbInitThunk(DCThunk* p, void (*entry)());
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
64
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
65 #if defined(DC__Arch_Intel_x86)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
66 #include "dyncall_thunk_x86.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
67 #elif defined (DC__Arch_AMD64)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
68 #include "dyncall_thunk_x64.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
69 #elif defined (DC__Arch_PPC32)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
70 #include "dyncall_thunk_ppc32.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
71 #elif defined (DC__Arch_PPC64)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
72 #include "dyncall_thunk_ppc64.h"
143
170cde9e2a83 - arm arm/thumb cleanup, sharing more files, directly
cslag
parents: 116
diff changeset
73 #elif defined (DC__Arch_ARM)
170cde9e2a83 - arm arm/thumb cleanup, sharing more files, directly
cslag
parents: 116
diff changeset
74 #include "dyncall_thunk_arm32.h"
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
75 #elif defined (DC__Arch_MIPS)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
76 #include "dyncall_thunk_mips.h"
116
c5cb02203df4 - mips n64 working thunks
cslag
parents: 101
diff changeset
77 #elif defined (DC__Arch_MIPS64)
c5cb02203df4 - mips n64 working thunks
cslag
parents: 101
diff changeset
78 #include "dyncall_thunk_mips64.h"
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
79 #elif defined (DC__Arch_Sparc)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
80 #include "dyncall_thunk_sparc32.h"
179
b11b0735b09f - renamings: sparc_v9 -> sparc64
cslag
parents: 145
diff changeset
81 #elif defined (DC__Arch_Sparc64)
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
82 #include "dyncall_thunk_sparc64.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
83 #elif defined (DC__Arch_ARM64)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
84 #include "dyncall_thunk_arm64.h"
653
0c8838766866 - riscv64 support for calls and callbacks (but lacking aggr and syscall support) - thanks Jun Jeon! :)
Tassilo Philipp
parents: 292
diff changeset
85 #elif defined (DC__Arch_RiscV64)
0c8838766866 - riscv64 support for calls and callbacks (but lacking aggr and syscall support) - thanks Jun Jeon! :)
Tassilo Philipp
parents: 292
diff changeset
86 #include "dyncall_thunk_riscv64.h"
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
87 #endif
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
88
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
89 #ifdef __cplusplus
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
90 }
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
91 #endif
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
92
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
93
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
94 #endif /* DYNCALL_THUNK_H */
101
1ce60358fbad - mips related cleanup, mostly comments, cpp macro lib
cslag
parents: 0
diff changeset
95