1 /* Copyright (C) 2001, 2009, 2010 Free Software Foundation, Inc.
3 * This library is free software; you can redistribute it and/or
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.
8 * This library is distributed in the hope that it will be useful, but
9 * WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * Lesser General Public License for more details.
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
15 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
23 #include <libguile/programs.h>
25 #define SCM_VM_BOOT_HOOK 0
26 #define SCM_VM_HALT_HOOK 1
27 #define SCM_VM_NEXT_HOOK 2
28 #define SCM_VM_BREAK_HOOK 3
29 #define SCM_VM_ENTER_HOOK 4
30 #define SCM_VM_APPLY_HOOK 5
31 #define SCM_VM_EXIT_HOOK 6
32 #define SCM_VM_RETURN_HOOK 7
33 #define SCM_VM_NUM_HOOKS 8
37 typedef SCM (*scm_t_vm_engine
) (SCM vm
, SCM program
, SCM
*argv
, int nargs
);
39 #define SCM_VM_REGULAR_ENGINE 0
40 #define SCM_VM_DEBUG_ENGINE 1
41 #define SCM_VM_NUM_ENGINES 2
44 scm_t_uint8
*ip
; /* instruction pointer */
45 SCM
*sp
; /* stack pointer */
46 SCM
*fp
; /* frame pointer */
47 size_t stack_size
; /* stack size */
48 SCM
*stack_base
; /* stack base address */
49 SCM
*stack_limit
; /* stack limit address */
50 int engine
; /* which vm engine we're using */
51 SCM hooks
[SCM_VM_NUM_HOOKS
]; /* hooks */
52 SCM options
; /* options */
53 int trace_level
; /* traces enabled if trace_level > 0 */
54 scm_t_int64 cookie
; /* used to detect unrewindable continuations */
57 SCM_API SCM scm_the_vm_fluid
;
59 #define SCM_VM_P(x) (SCM_NIMP (x) && SCM_TYP7 (x) == scm_tc7_vm)
60 #define SCM_VM_DATA(vm) ((struct scm_vm *) SCM_CELL_WORD_1 (vm))
61 #define SCM_VALIDATE_VM(pos,x) SCM_MAKE_VALIDATE (pos, x, VM_P)
63 SCM_API SCM
scm_the_vm ();
64 SCM_API SCM
scm_make_vm (void);
65 SCM_API SCM
scm_vm_apply (SCM vm
, SCM program
, SCM args
);
66 SCM_API SCM
scm_c_vm_run (SCM vm
, SCM program
, SCM
*argv
, int nargs
);
67 SCM_API SCM
scm_vm_option_ref (SCM vm
, SCM key
);
68 SCM_API SCM
scm_vm_option_set_x (SCM vm
, SCM key
, SCM val
);
70 SCM_API SCM
scm_vm_version (void);
71 SCM_API SCM
scm_the_vm (void);
72 SCM_API SCM
scm_vm_p (SCM obj
);
73 SCM_API SCM
scm_vm_ip (SCM vm
);
74 SCM_API SCM
scm_vm_sp (SCM vm
);
75 SCM_API SCM
scm_vm_fp (SCM vm
);
76 SCM_API SCM
scm_vm_boot_hook (SCM vm
);
77 SCM_API SCM
scm_vm_halt_hook (SCM vm
);
78 SCM_API SCM
scm_vm_next_hook (SCM vm
);
79 SCM_API SCM
scm_vm_break_hook (SCM vm
);
80 SCM_API SCM
scm_vm_enter_hook (SCM vm
);
81 SCM_API SCM
scm_vm_apply_hook (SCM vm
);
82 SCM_API SCM
scm_vm_exit_hook (SCM vm
);
83 SCM_API SCM
scm_vm_return_hook (SCM vm
);
84 SCM_API SCM
scm_vm_option (SCM vm
, SCM key
);
85 SCM_API SCM
scm_set_vm_option_x (SCM vm
, SCM key
, SCM val
);
86 SCM_API SCM
scm_vm_trace_level (SCM vm
);
87 SCM_API SCM
scm_set_vm_trace_level_x (SCM vm
, SCM level
);
89 #define SCM_F_VM_CONT_PARTIAL 0x1
90 #define SCM_F_VM_CONT_REWINDABLE 0x2
95 scm_t_uint8
*ra
, *mvra
;
96 scm_t_ptrdiff stack_size
;
102 #define SCM_VM_CONT_P(OBJ) (SCM_NIMP (OBJ) && SCM_TYP7 (OBJ) == scm_tc7_vm_cont)
103 #define SCM_VM_CONT_DATA(CONT) ((struct scm_vm_cont *) SCM_CELL_WORD_1 (CONT))
104 #define SCM_VM_CONT_PARTIAL_P(CONT) (SCM_VM_CONT_DATA (CONT)->flags & SCM_F_VM_CONT_PARTIAL)
105 #define SCM_VM_CONT_REWINDABLE_P(CONT) (SCM_VM_CONT_DATA (CONT)->flags & SCM_F_VM_CONT_REWINDABLE)
107 SCM_API SCM
scm_load_compiled_with_vm (SCM file
);
109 SCM_INTERNAL
void scm_i_vm_print (SCM x
, SCM port
,
110 scm_print_state
*pstate
);
111 SCM_INTERNAL SCM
scm_i_vm_capture_continuation (SCM vm
);
112 SCM_INTERNAL SCM
scm_i_vm_capture_stack (SCM
*stack_base
, SCM
*fp
, SCM
*sp
,
113 scm_t_uint8
*ra
, scm_t_uint8
*mvra
,
115 SCM_INTERNAL
void scm_i_vm_cont_print (SCM x
, SCM port
,
116 scm_print_state
*pstate
);
117 SCM_INTERNAL
void scm_bootstrap_vm (void);
118 SCM_INTERNAL
void scm_init_vm (void);
120 #endif /* _SCM_VM_H_ */