annotate doc/manual/manual_cc.tex @ 533:71c884e610f0

- integration of patches from Raphael Luba, Thekla, Inc.: * integration of aggregate-by-value (struct, union) support patch for x64 (win and sysv) * windows/x64 asm additions to specify how stack unwinds (help for debuggers, exception handling, etc.) * see Changelog for details - new calling convention modes for thiscalls (platform agnostic, was specific before) * new signature character for platform agnostic thiscalls ('*' / DC_SIGCHAR_CC_THISCALL) - dcCallF(), dcVCallF(), dcArgF() and dcVArgF(): * added support for aggregates-by-value (wasn't part of patch) * change that those functions don't implicitly call dcReset() anymore, which was unflexible (breaking change) - added macros to feature test implementation for aggregate-by-value and syscall support - changed libdyncall_s.lib and libdyncallback_s.lib order in callback test makefiles, as some toolchains are picky about order - doc: * man page updates to describe aggregate interface * manual overview changes to highlight platforms with aggregate-by-value support - test/plain: replaced tests w/ old/stale sctruct interface with new aggregate one
author Tassilo Philipp
date Thu, 21 Apr 2022 13:35:47 +0200
parents 17287342e273
children 0909837648d2
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 % Copyright (c) 2007,2009 Daniel Adler <dadler@uni-goettingen.de>,
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
4 % Tassilo Philipp <tphilipp@potion-studios.com>
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
5 %
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
6 % Permission to use, copy, modify, and distribute this software for any
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
7 % purpose with or without fee is hereby granted, provided that the above
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
8 % copyright notice and this permission notice appear in all copies.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
9 %
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
10 % THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
11 % WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
12 % MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
13 % ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
14 % WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
15 % ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
16 % OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
17 %
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
18 %//////////////////////////////////////////////////////////////////////////////
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
19
490
17287342e273 manual:
Tassilo Philipp
parents: 467
diff changeset
20 \newpage
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
21
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
22 \section{Calling Conventions}
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
23
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
24 \paragraph{Before we go any further\ldots}
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
25
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
26 It is important to understand that this section isn't a general
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
27 purpose description of the present calling conventions.
73
8326c5ced916 - doc cleanup and html work
cslag
parents: 0
diff changeset
28 It merely explains the calling conventions \textbf{for the parameter/return types
490
17287342e273 manual:
Tassilo Philipp
parents: 467
diff changeset
29 supported by \dc} (not for e.g. unsupported types like SIMD data types
17287342e273 manual:
Tassilo Philipp
parents: 467
diff changeset
30 (\_\_m64, \_\_m128, \_\_m128i, \_\_m128d), etc.).\\ We strongly advise the
17287342e273 manual:
Tassilo Philipp
parents: 467
diff changeset
31 reader not to use this document as a general purpose calling convention
17287342e273 manual:
Tassilo Philipp
parents: 467
diff changeset
32 reference.
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
33
467
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
34 \input{callconvs/callconv_x86}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
35 \input{callconvs/callconv_x64}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
36 \input{callconvs/callconv_ppc32}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
37 \input{callconvs/callconv_ppc64}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
38 \input{callconvs/callconv_arm32}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
39 \input{callconvs/callconv_arm64}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
40 \input{callconvs/callconv_mips32}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
41 \input{callconvs/callconv_mips64}\clearpage
b47168dacba6 manual:
Tassilo Philipp
parents: 200
diff changeset
42 \input{callconvs/callconv_sparc32}\clearpage
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
43 \input{callconvs/callconv_sparc64}
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
44