annotate dyncallback/dyncall_thunk.h @ 256:7520e2260097

- added to configure some detection on how to compile .s/.S with --noexecstack (or similar), as compilers' defaults are often insane - since no-execstack handling is now in build, remove .note.GNU-stack section markers (were of limites use, anyways, b/c unportable or implemented inconsistently across platforms) - some ToDo, etc. updates
author Tassilo Philipp
date Sat, 20 May 2017 00:02:59 +0200
parents b11b0735b09f
children f5577f6bf97a
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
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
9 Copyright (c) 2007-2015 Daniel Adler <dadler@uni-goettingen.de>,
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
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
51 **
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
52 **/
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
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
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
55
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
56 typedef struct DCThunk_ DCThunk;
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
57
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
58 #ifdef __cplusplus
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
59 extern "C" {
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
60 #endif
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
61
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
62 void dcbInitThunk(DCThunk* p, void (*entry)());
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
63
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
64 #if defined(DC__Arch_Intel_x86)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
65 #include "dyncall_thunk_x86.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
66 #elif defined (DC__Arch_AMD64)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
67 #include "dyncall_thunk_x64.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
68 #elif defined (DC__Arch_PPC32)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
69 #include "dyncall_thunk_ppc32.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
70 #elif defined (DC__Arch_PPC64)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
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
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
74 #elif defined (DC__Arch_MIPS)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
75 #include "dyncall_thunk_mips.h"
116
c5cb02203df4 - mips n64 working thunks
cslag
parents: 101
diff changeset
76 #elif defined (DC__Arch_MIPS64)
c5cb02203df4 - mips n64 working thunks
cslag
parents: 101
diff changeset
77 #include "dyncall_thunk_mips64.h"
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
78 #elif defined (DC__Arch_Sparc)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
79 #include "dyncall_thunk_sparc32.h"
179
b11b0735b09f - renamings: sparc_v9 -> sparc64
cslag
parents: 145
diff changeset
80 #elif defined (DC__Arch_Sparc64)
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
81 #include "dyncall_thunk_sparc64.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
82 #elif defined (DC__Arch_ARM64)
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
83 #include "dyncall_thunk_arm64.h"
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
84 #endif
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
85
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
86 #ifdef __cplusplus
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
87 }
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
88 #endif
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
89
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 /* DYNCALL_THUNK_H */
101
1ce60358fbad - mips related cleanup, mostly comments, cpp macro lib
cslag
parents: 0
diff changeset
92