Commit | Line | Data |
---|---|---|
b2b33168 | 1 | /* Copyright (C) 2001, 2009, 2010, 2011 Free Software Foundation, Inc. |
560b9c25 AW |
2 | * * |
3 | * This library is free software; you can redistribute it and/or | |
53befeb7 NJ |
4 | * modify it under the terms of the GNU Lesser General Public License |
5 | * as published by the Free Software Foundation; either version 3 of | |
6 | * the License, or (at your option) any later version. | |
ac99cb0c | 7 | * |
53befeb7 NJ |
8 | * This library is distributed in the hope that it will be useful, but |
9 | * WITHOUT ANY WARRANTY; without even the implied warranty of | |
560b9c25 AW |
10 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
11 | * Lesser General Public License for more details. | |
ac99cb0c | 12 | * |
560b9c25 AW |
13 | * You should have received a copy of the GNU Lesser General Public |
14 | * License along with this library; if not, write to the Free Software | |
53befeb7 NJ |
15 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA |
16 | * 02110-1301 USA | |
560b9c25 | 17 | */ |
ac99cb0c KN |
18 | |
19 | #ifndef _SCM_FRAMES_H_ | |
20 | #define _SCM_FRAMES_H_ | |
21 | ||
22 | #include <libguile.h> | |
ac99cb0c KN |
23 | #include "programs.h" |
24 | ||
ac99cb0c KN |
25 | \f |
26 | /* | |
af988bbf | 27 | * VM frames |
ac99cb0c KN |
28 | */ |
29 | ||
aa3f6951 AW |
30 | /* |
31 | * It's a little confusing, but there are two representations of frames in this | |
32 | * file: frame pointers and Scheme objects wrapping those frame pointers. The | |
33 | * former uses the SCM_FRAME_... macro prefix, the latter SCM_VM_FRAME_.. | |
34 | * prefix. | |
35 | * | |
36 | * The confusing thing is that only Scheme frame objects have functions that use | |
37 | * them, and they use the scm_frame_.. prefix. Hysterical raisins. | |
38 | */ | |
39 | ||
b6368dbb LC |
40 | /* VM Frame Layout |
41 | --------------- | |
42 | ||
03e6c165 | 43 | | ... | |
6c6a4439 AW |
44 | | Intermed. val. 0 | <- fp + nargs + nlocs |
45 | +------------------+ | |
03e6c165 | 46 | | Local variable 1 | |
6c6a4439 | 47 | | Local variable 0 | <- fp + nargs |
ac99cb0c | 48 | | Argument 1 | |
6c6a4439 | 49 | | Argument 0 | <- fp = SCM_FRAME_STACK_ADDRESS (fp) |
ac99cb0c | 50 | | Program | <- fp - 1 |
6c6a4439 AW |
51 | +==================+ |
52 | | Return address | <- SCM_FRAME_UPPER_ADDRESS (fp) | |
03e6c165 AW |
53 | | MV return address| |
54 | | Dynamic link | <- fp - 4 = SCM_FRAME_DATA_ADDRESS (fp) = SCM_FRAME_LOWER_ADDRESS (fp) | |
55 | +==================+ | |
ac99cb0c | 56 | | | |
b6368dbb LC |
57 | |
58 | As can be inferred from this drawing, it is assumed that | |
59 | `sizeof (SCM *) == sizeof (SCM)', since pointers (the `link' parts) are | |
60 | assumed to be as long as SCM objects. */ | |
ac99cb0c | 61 | |
03e6c165 | 62 | #define SCM_FRAME_DATA_ADDRESS(fp) (fp - 4) |
6c6a4439 AW |
63 | #define SCM_FRAME_STACK_ADDRESS(fp) (fp) |
64 | #define SCM_FRAME_UPPER_ADDRESS(fp) (fp - 2) | |
03e6c165 | 65 | #define SCM_FRAME_LOWER_ADDRESS(fp) (fp - 4) |
af988bbf | 66 | |
2fb924f6 | 67 | #define SCM_FRAME_BYTE_CAST(x) ((scm_t_uint8 *) SCM_UNPACK (x)) |
af988bbf | 68 | #define SCM_FRAME_STACK_CAST(x) ((SCM *) SCM_UNPACK (x)) |
ac99cb0c | 69 | |
b6368dbb | 70 | #define SCM_FRAME_RETURN_ADDRESS(fp) \ |
b1b942b7 | 71 | (SCM_FRAME_BYTE_CAST (SCM_FRAME_DATA_ADDRESS (fp)[2])) |
03e6c165 | 72 | #define SCM_FRAME_SET_RETURN_ADDRESS(fp, ra) \ |
b2b33168 | 73 | ((SCM_FRAME_DATA_ADDRESS (fp)[2])) = SCM_PACK (ra) |
20d47c39 AW |
74 | #define SCM_FRAME_MV_RETURN_ADDRESS(fp) \ |
75 | (SCM_FRAME_BYTE_CAST (SCM_FRAME_DATA_ADDRESS (fp)[1])) | |
03e6c165 | 76 | #define SCM_FRAME_SET_MV_RETURN_ADDRESS(fp, mvra) \ |
b2b33168 | 77 | ((SCM_FRAME_DATA_ADDRESS (fp)[1])) = SCM_PACK (mvra) |
b6368dbb | 78 | #define SCM_FRAME_DYNAMIC_LINK(fp) \ |
20d47c39 | 79 | (SCM_FRAME_STACK_CAST (SCM_FRAME_DATA_ADDRESS (fp)[0])) |
03e6c165 | 80 | #define SCM_FRAME_SET_DYNAMIC_LINK(fp, dl) \ |
b2b33168 | 81 | ((SCM_FRAME_DATA_ADDRESS (fp)[0])) = SCM_PACK (dl) |
6c6a4439 AW |
82 | #define SCM_FRAME_VARIABLE(fp,i) SCM_FRAME_STACK_ADDRESS (fp)[i] |
83 | #define SCM_FRAME_PROGRAM(fp) SCM_FRAME_STACK_ADDRESS (fp)[-1] | |
ac99cb0c KN |
84 | |
85 | \f | |
86 | /* | |
af988bbf | 87 | * Heap frames |
ac99cb0c KN |
88 | */ |
89 | ||
aa3f6951 | 90 | struct scm_frame |
b1b942b7 AW |
91 | { |
92 | SCM stack_holder; | |
93 | SCM *fp; | |
94 | SCM *sp; | |
2fb924f6 | 95 | scm_t_uint8 *ip; |
b1b942b7 AW |
96 | scm_t_ptrdiff offset; |
97 | }; | |
98 | ||
6f3b0cc2 AW |
99 | #define SCM_VM_FRAME_P(x) (SCM_NIMP (x) && SCM_TYP7 (x) == scm_tc7_frame) |
100 | #define SCM_VM_FRAME_DATA(x) ((struct scm_frame*)SCM_CELL_WORD_1 (x)) | |
b1b942b7 AW |
101 | #define SCM_VM_FRAME_STACK_HOLDER(f) SCM_VM_FRAME_DATA(f)->stack_holder |
102 | #define SCM_VM_FRAME_FP(f) SCM_VM_FRAME_DATA(f)->fp | |
103 | #define SCM_VM_FRAME_SP(f) SCM_VM_FRAME_DATA(f)->sp | |
104 | #define SCM_VM_FRAME_IP(f) SCM_VM_FRAME_DATA(f)->ip | |
105 | #define SCM_VM_FRAME_OFFSET(f) SCM_VM_FRAME_DATA(f)->offset | |
106 | #define SCM_VALIDATE_VM_FRAME(p,x) SCM_MAKE_VALIDATE (p, x, VM_FRAME_P) | |
107 | ||
aa3f6951 AW |
108 | SCM_API SCM scm_c_make_frame (SCM stack_holder, SCM *fp, SCM *sp, |
109 | scm_t_uint8 *ip, scm_t_ptrdiff offset); | |
110 | SCM_API SCM scm_frame_p (SCM obj); | |
111 | SCM_API SCM scm_frame_procedure (SCM frame); | |
112 | SCM_API SCM scm_frame_arguments (SCM frame); | |
113 | SCM_API SCM scm_frame_source (SCM frame); | |
114 | SCM_API SCM scm_frame_num_locals (SCM frame); | |
115 | SCM_API SCM scm_frame_local_ref (SCM frame, SCM index); | |
116 | SCM_API SCM scm_frame_local_set_x (SCM frame, SCM index, SCM val); | |
2e30f398 | 117 | SCM_API SCM scm_frame_address (SCM frame); |
542f975e | 118 | SCM_API SCM scm_frame_stack_pointer (SCM frame); |
aa3f6951 AW |
119 | SCM_API SCM scm_frame_instruction_pointer (SCM frame); |
120 | SCM_API SCM scm_frame_return_address (SCM frame); | |
121 | SCM_API SCM scm_frame_mv_return_address (SCM frame); | |
122 | SCM_API SCM scm_frame_dynamic_link (SCM frame); | |
93dbc31b | 123 | SCM_API SCM scm_frame_previous (SCM frame); |
560b9c25 | 124 | |
6f3b0cc2 AW |
125 | SCM_INTERNAL void scm_i_frame_print (SCM frame, SCM port, |
126 | scm_print_state *pstate); | |
560b9c25 | 127 | SCM_INTERNAL void scm_init_frames (void); |
ac99cb0c KN |
128 | |
129 | #endif /* _SCM_FRAMES_H_ */ | |
130 | ||
131 | /* | |
132 | Local Variables: | |
133 | c-file-style: "gnu" | |
134 | End: | |
135 | */ |