mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-04-30 03:40:34 +02:00
510ca12687
* libguile/vm-engine.c (rtl_vm_engine): Add new VM. (vm_engine): Add support for calling RTL programs. * libguile/tags.h (scm_tc7_rtl_program): New type for procedures that run on the new VM. * libguile/evalext.c (scm_self_evaluating_p): * libguile/goops.c (scm_class_of): * libguile/print.c (iprin1): * libguile/procprop.c (scm_i_procedure_arity): * libguile/procs.c (scm_procedure_p): Add hooks for the new tc7. * libguile/programs.h: * libguile/programs.c (scm_make_rtl_program, scm_i_rtl_program_print) (scm_rtl_program_p, scm_rtl_program_code): * module/system/vm/program.scm: Add constructors and accessors for the new "RTL programs". * libguile/vm.c (rtl_boot_continuation): Define a boot program. (rtl_apply, rtl_values): New static RTL programs. * libguile/frames.c (scm_frame_num_locals): Adapt for frames of RTL programs. * libguile/frames.h: Add description of RTL frames. * libguile/Makefile.am: Add rules to generate vm-operations.h. * .gitignore: Ignore vm-operations.h. * module/system/vm/instruction.scm: * libguile/instructions.c: * libguile/instructions.h: Use vm-operations.h to define enumerated values for the new RTL opcodes. Define some helper macros to pack and unpack 32-bit instruction words. (rtl-instruction-list): New function, exported by (system vm instruction). * libguile/objcodes.c: Wire up the bits needed to detect the new RTL bytecode and load it, as appropriate.
182 lines
6.4 KiB
C
182 lines
6.4 KiB
C
/* Copyright (C) 2001, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
|
||
* *
|
||
* This library is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU Lesser General Public License
|
||
* as published by the Free Software Foundation; either version 3 of
|
||
* the License, or (at your option) any later version.
|
||
*
|
||
* This library is distributed in the hope that it will be useful, but
|
||
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
* Lesser General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Lesser General Public
|
||
* License along with this library; if not, write to the Free Software
|
||
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
||
* 02110-1301 USA
|
||
*/
|
||
|
||
#ifndef _SCM_FRAMES_H_
|
||
#define _SCM_FRAMES_H_
|
||
|
||
#include <libguile.h>
|
||
#include "programs.h"
|
||
|
||
|
||
/*
|
||
* VM frames
|
||
*/
|
||
|
||
/*
|
||
* It's a little confusing, but there are two representations of frames in this
|
||
* file: frame pointers and Scheme objects wrapping those frame pointers. The
|
||
* former uses the SCM_FRAME_... macro prefix, the latter SCM_VM_FRAME_..
|
||
* prefix.
|
||
*
|
||
* The confusing thing is that only Scheme frame objects have functions that use
|
||
* them, and they use the scm_frame_.. prefix. Hysterical raisins.
|
||
*/
|
||
|
||
/* VM Frame Layout
|
||
---------------
|
||
|
||
| ... |
|
||
| Intermed. val. 0 | <- fp + nargs + nlocs
|
||
+------------------+
|
||
| Local variable 1 |
|
||
| Local variable 0 | <- fp + nargs
|
||
| Argument 1 |
|
||
| Argument 0 | <- fp = SCM_FRAME_STACK_ADDRESS (fp)
|
||
| Program | <- fp - 1
|
||
+==================+
|
||
| Return address | <- SCM_FRAME_UPPER_ADDRESS (fp)
|
||
| MV return address|
|
||
| Dynamic link | <- fp - 4 = SCM_FRAME_DATA_ADDRESS (fp) = SCM_FRAME_LOWER_ADDRESS (fp)
|
||
+==================+
|
||
| |
|
||
|
||
As can be inferred from this drawing, it is assumed that
|
||
`sizeof (SCM *) == sizeof (SCM)', since pointers (the `link' parts) are
|
||
assumed to be as long as SCM objects. */
|
||
|
||
/* This structure maps to the contents of a VM stack frame. It can
|
||
alias a frame directly. */
|
||
struct scm_vm_frame
|
||
{
|
||
SCM *dynamic_link;
|
||
scm_t_uint8 *mv_return_address;
|
||
scm_t_uint8 *return_address;
|
||
SCM program;
|
||
SCM stack[1]; /* Variable-length */
|
||
};
|
||
|
||
#define SCM_FRAME_STRUCT(fp) \
|
||
((struct scm_vm_frame *) SCM_FRAME_DATA_ADDRESS (fp))
|
||
|
||
#define SCM_FRAME_DATA_ADDRESS(fp) (((SCM *) (fp)) - 4)
|
||
#define SCM_FRAME_STACK_ADDRESS(fp) (SCM_FRAME_STRUCT (fp)->stack)
|
||
#define SCM_FRAME_UPPER_ADDRESS(fp) ((SCM*)&SCM_FRAME_STRUCT (fp)->return_address)
|
||
#define SCM_FRAME_LOWER_ADDRESS(fp) ((SCM*)SCM_FRAME_STRUCT (fp))
|
||
|
||
#define SCM_FRAME_BYTE_CAST(x) ((scm_t_uint8 *) SCM_UNPACK (x))
|
||
#define SCM_FRAME_STACK_CAST(x) ((SCM *) SCM_UNPACK (x))
|
||
|
||
#define SCM_FRAME_RETURN_ADDRESS(fp) \
|
||
(SCM_FRAME_STRUCT (fp)->return_address)
|
||
#define SCM_FRAME_SET_RETURN_ADDRESS(fp, ra) \
|
||
SCM_FRAME_STRUCT (fp)->return_address = (ra)
|
||
#define SCM_FRAME_MV_RETURN_ADDRESS(fp) \
|
||
(SCM_FRAME_STRUCT (fp)->mv_return_address)
|
||
#define SCM_FRAME_SET_MV_RETURN_ADDRESS(fp, mvra) \
|
||
SCM_FRAME_STRUCT (fp)->mv_return_address = (mvra)
|
||
#define SCM_FRAME_DYNAMIC_LINK(fp) \
|
||
(SCM_FRAME_STRUCT (fp)->dynamic_link)
|
||
#define SCM_FRAME_SET_DYNAMIC_LINK(fp, dl) \
|
||
SCM_FRAME_DYNAMIC_LINK (fp) = (dl)
|
||
#define SCM_FRAME_VARIABLE(fp,i) \
|
||
(SCM_FRAME_STRUCT (fp)->stack[i])
|
||
#define SCM_FRAME_PROGRAM(fp) \
|
||
(SCM_FRAME_STRUCT (fp)->program)
|
||
|
||
|
||
/*
|
||
* RTL frames
|
||
*/
|
||
|
||
/* The frame format for the new RTL programs is almost like that for the
|
||
stack-vm programs. They differ in their handling of MV returns,
|
||
however. For RTL, every call is an MV call: every call has an MVRA.
|
||
Unlike the stack-vm programs, the MVRA for RTL programs is computable
|
||
from the RA -- it's always one word (4 bytes) before the RA.
|
||
|
||
Until we completely migrate to the RTL VM, we will also write the
|
||
MVRA to the stack.
|
||
|
||
When an RTL program returns multiple values, it will shuffle them
|
||
down to start contiguously from slot 0, as for a tail call. This
|
||
means that when the caller goes to access them, there are 2 or 3
|
||
empty words between the top of the caller stack and the bottom of the
|
||
values, corresponding to the frame that was just popped.
|
||
*/
|
||
|
||
#define SCM_FRAME_RTL_RETURN_ADDRESS(fp) \
|
||
((scm_t_uint32 *) SCM_FRAME_RETURN_ADDRESS (fp))
|
||
#define SCM_FRAME_SET_RTL_RETURN_ADDRESS(fp, ip) \
|
||
SCM_FRAME_SET_RETURN_ADDRESS (fp, (scm_t_uint8 *) (ip))
|
||
|
||
#define SCM_FRAME_RTL_MV_RETURN_ADDRESS(fp) \
|
||
((scm_t_uint32 *) SCM_FRAME_MV_RETURN_ADDRESS (fp))
|
||
#define SCM_FRAME_SET_RTL_MV_RETURN_ADDRESS(fp, ip) \
|
||
SCM_FRAME_SET_MV_RETURN_ADDRESS (fp, (scm_t_uint8 *) (ip))
|
||
|
||
|
||
/*
|
||
* Heap frames
|
||
*/
|
||
|
||
struct scm_frame
|
||
{
|
||
SCM stack_holder;
|
||
SCM *fp;
|
||
SCM *sp;
|
||
scm_t_uint8 *ip;
|
||
scm_t_ptrdiff offset;
|
||
};
|
||
|
||
#define SCM_VM_FRAME_P(x) (SCM_HAS_TYP7 (x, scm_tc7_frame))
|
||
#define SCM_VM_FRAME_DATA(x) ((struct scm_frame*)SCM_CELL_WORD_1 (x))
|
||
#define SCM_VM_FRAME_STACK_HOLDER(f) SCM_VM_FRAME_DATA(f)->stack_holder
|
||
#define SCM_VM_FRAME_FP(f) SCM_VM_FRAME_DATA(f)->fp
|
||
#define SCM_VM_FRAME_SP(f) SCM_VM_FRAME_DATA(f)->sp
|
||
#define SCM_VM_FRAME_IP(f) SCM_VM_FRAME_DATA(f)->ip
|
||
#define SCM_VM_FRAME_OFFSET(f) SCM_VM_FRAME_DATA(f)->offset
|
||
#define SCM_VALIDATE_VM_FRAME(p,x) SCM_MAKE_VALIDATE (p, x, VM_FRAME_P)
|
||
|
||
SCM_API SCM scm_c_make_frame (SCM stack_holder, SCM *fp, SCM *sp,
|
||
scm_t_uint8 *ip, scm_t_ptrdiff offset);
|
||
SCM_API SCM scm_frame_p (SCM obj);
|
||
SCM_API SCM scm_frame_procedure (SCM frame);
|
||
SCM_API SCM scm_frame_arguments (SCM frame);
|
||
SCM_API SCM scm_frame_source (SCM frame);
|
||
SCM_API SCM scm_frame_num_locals (SCM frame);
|
||
SCM_API SCM scm_frame_local_ref (SCM frame, SCM index);
|
||
SCM_API SCM scm_frame_local_set_x (SCM frame, SCM index, SCM val);
|
||
SCM_API SCM scm_frame_address (SCM frame);
|
||
SCM_API SCM scm_frame_stack_pointer (SCM frame);
|
||
SCM_API SCM scm_frame_instruction_pointer (SCM frame);
|
||
SCM_API SCM scm_frame_return_address (SCM frame);
|
||
SCM_API SCM scm_frame_mv_return_address (SCM frame);
|
||
SCM_API SCM scm_frame_dynamic_link (SCM frame);
|
||
SCM_API SCM scm_frame_previous (SCM frame);
|
||
|
||
SCM_INTERNAL void scm_i_frame_print (SCM frame, SCM port,
|
||
scm_print_state *pstate);
|
||
SCM_INTERNAL void scm_init_frames (void);
|
||
|
||
#endif /* _SCM_FRAMES_H_ */
|
||
|
||
/*
|
||
Local Variables:
|
||
c-file-style: "gnu"
|
||
End:
|
||
*/
|