annotate dyncallback/dyncall_callback_arm32_arm_apple.s @ 41:00310bf92924

- doc - source consistency tweak
author cslag
date Fri, 18 Dec 2015 23:10:37 +0100
parents 3e629dc19168
children 91db39538e78
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_callback_arm32_arm_apple.s
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
6 Description: Callback Thunk - Implementation for ARM32 (ARM mode) for Apple's as
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-2011 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 .text
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
28 .code 32 /* ARM mode */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
29
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
30 .globl _dcCallbackThunkEntry
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
31 .align 4
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
32 /* sizes */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
33 .set DCThunk_size , 8
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
34 .set DCArgs_size , 24
41
cslag
parents: 0
diff changeset
35 .set DCCallback_size, 20
0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
36 .set DCValue_size , 8
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
37
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
38 /* struct DCCallback offsets and size */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
39 .set CTX_thunk , 0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
40 .set CTX_handler , 12
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
41 .set CTX_userdata , 16
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
42
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
43
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
44 /* Called by thunk - thunk stores pointer to DCCallback in r12 */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
45 _dcCallbackThunkEntry:
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
46
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
47 /* Prolog. This function never needs to spill inside its prolog, so just store the permanent registers. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
48 stmdb r13, {r4-r11, r13, r14} /* Permanent registers and stack pointer, etc... -> save area on stack (except counter). */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
49 mov r11, r13 /* Set frame pointer. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
50 sub r13, r13, #40 /* Adjust stack pointer. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
51
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
52 /* Grab arguments. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
53 mov r4, #0
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
54 stmdb r13!, {r0-r4, r11} /* Spill first 4 args to DCArgs, along with reg_count and (stack) pointer to remaining args. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
55
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
56 /* Prepare callback handler call. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
57 mov r0, r12 /* Parameter 0 (r0) = DCCallback pointer (r12, pointer to thunk). */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
58 mov r1, r13 /* Parameter 1 (r1) = DCArgs pointer (r13, stack pointer). */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
59 sub r13, r13, #DCValue_size /* Make room for return value. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
60 mov r2, r13 /* Parameter 2 (r2) = results pointer. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
61 ldr r3, [r12, #CTX_userdata] /* Parameter 3 (r3) = userdata pointer. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
62
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
63 /* Call. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
64 ldr r4, [r12, #CTX_handler] /* Load callback handler pointer into r4. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
65 mov r14, r15 /* Branch return address(r15) -> link register (r14) -- r15 always points to address of current + 2 instructions (= Epilog code). */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
66 bx r4 /* Call. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
67
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
68 /* Return value. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
69 ldmia r13, {r0, r1} /* Load return value in r0 and r1. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
70
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
71 /* Epilog. */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
72 ldmdb r11, {r4-r11, r13, r15} /* Restore permanent registers (restore stack ptr and program counter).@@@db not needed since we rewrite r13? */
3e629dc19168 initial from svn dyncall-1745
Daniel Adler
parents:
diff changeset
73