520 lines
17 KiB
Racket
520 lines
17 KiB
Racket
#lang typed/racket/base
|
|
(provide (all-defined-out))
|
|
|
|
(require "expression-structs.rkt"
|
|
"lexical-structs.rkt"
|
|
"kernel-primitives.rkt")
|
|
|
|
|
|
|
|
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
;; Registers of the machine:
|
|
|
|
(define-type StackRegisterSymbol (U 'control 'env))
|
|
(define-type AtomicRegisterSymbol (U 'val 'proc 'argcount))
|
|
(define-type RegisterSymbol (U StackRegisterSymbol AtomicRegisterSymbol))
|
|
|
|
(define-predicate AtomicRegisterSymbol? AtomicRegisterSymbol)
|
|
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
|
|
|
|
;; An operation can refer to the following arguments:
|
|
(define-type OpArg (U Const ;; an constant
|
|
Label ;; an label
|
|
Reg ;; an register
|
|
EnvLexicalReference ;; a reference into the stack
|
|
EnvPrefixReference ;; a reference into an element in the toplevel.
|
|
EnvWholePrefixReference ;; a reference into a toplevel prefix in the stack.
|
|
SubtractArg
|
|
ControlStackLabel
|
|
ControlStackLabel/MultipleValueReturn
|
|
ControlFrameTemporary
|
|
CompiledProcedureEntry
|
|
CompiledProcedureClosureReference
|
|
ModuleEntry
|
|
IsModuleInvoked
|
|
IsModuleLinked
|
|
PrimitiveKernelValue
|
|
VariableReference))
|
|
|
|
|
|
;; Targets: these are the allowable lhs's for a targetted assignment.
|
|
(define-type Target (U AtomicRegisterSymbol
|
|
EnvLexicalReference
|
|
EnvPrefixReference
|
|
PrimitivesReference
|
|
ControlFrameTemporary
|
|
ModulePrefixTarget))
|
|
|
|
|
|
;; When we need to store a value temporarily in the top control frame, we can use this as a target.
|
|
(define-struct: ControlFrameTemporary ([name : (U 'pendingContinuationMarkKey ;; for continuation marks
|
|
'pendingApplyValuesProc ;; for apply-values
|
|
'pendingBegin0Count
|
|
'pendingBegin0Values
|
|
)])
|
|
#:transparent)
|
|
|
|
|
|
;; Targetting the prefix attribute of a module.
|
|
(define-struct: ModulePrefixTarget ([path : ModuleLocator])
|
|
#:transparent)
|
|
|
|
|
|
|
|
(define-struct: Label ([name : Symbol])
|
|
#:transparent)
|
|
(define-struct: Reg ([name : AtomicRegisterSymbol])
|
|
#:transparent)
|
|
(define-struct: Const ([const : Any])
|
|
#:transparent)
|
|
|
|
;; Limited arithmetic on OpArgs
|
|
(define-struct: SubtractArg ([lhs : OpArg]
|
|
[rhs : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
;; Gets the return address embedded at the top of the control stack.
|
|
(define-struct: ControlStackLabel ()
|
|
#:transparent)
|
|
|
|
;; Gets the secondary (mulitple-value-return) return address embedded
|
|
;; at the top of the control stack.
|
|
(define-struct: ControlStackLabel/MultipleValueReturn ()
|
|
#:transparent)
|
|
|
|
;; Get the entry point of a compiled procedure.
|
|
(define-struct: CompiledProcedureEntry ([proc : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
;; Get at the nth value in a closure's list of closed values.
|
|
(define-struct: CompiledProcedureClosureReference ([proc : OpArg]
|
|
[n : Natural])
|
|
#:transparent)
|
|
|
|
|
|
(define-struct: PrimitivesReference ([name : Symbol])
|
|
#:transparent)
|
|
|
|
;; Produces the entry point of the module.
|
|
(define-struct: ModuleEntry ([name : ModuleLocator])
|
|
#:transparent)
|
|
|
|
;; Produces true if the module has already been invoked
|
|
(define-struct: IsModuleInvoked ([name : ModuleLocator])
|
|
#:transparent)
|
|
|
|
;; Produces true if the module has been loaded into the machine
|
|
(define-struct: IsModuleLinked ([name : ModuleLocator])
|
|
#:transparent)
|
|
|
|
|
|
|
|
|
|
|
|
;; instruction sequences
|
|
(define-type UnlabeledStatement (U
|
|
|
|
AssignImmediateStatement
|
|
AssignPrimOpStatement
|
|
|
|
PerformStatement
|
|
|
|
GotoStatement
|
|
TestAndJumpStatement
|
|
|
|
PopEnvironment
|
|
PushEnvironment
|
|
|
|
PushImmediateOntoEnvironment
|
|
|
|
PushControlFrame/Generic
|
|
PushControlFrame/Call
|
|
PushControlFrame/Prompt
|
|
|
|
PopControlFrame
|
|
|
|
DebugPrint
|
|
Comment
|
|
))
|
|
|
|
|
|
;; Debug print statement.
|
|
(define-struct: DebugPrint ([value : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
(define-type Statement (U UnlabeledStatement
|
|
Symbol ;; label
|
|
LinkedLabel ;; Label with a reference to a multiple-return-value label
|
|
))
|
|
|
|
|
|
(define-struct: LinkedLabel ([label : Symbol]
|
|
[linked-to : Symbol])
|
|
#:transparent)
|
|
|
|
|
|
(define-struct: AssignImmediateStatement ([target : Target]
|
|
[value : OpArg])
|
|
#:transparent)
|
|
(define-struct: AssignPrimOpStatement ([target : Target]
|
|
[op : PrimitiveOperator])
|
|
#:transparent)
|
|
|
|
|
|
;; Pop n slots from the environment, skipping past a few first.
|
|
(define-struct: PopEnvironment ([n : OpArg]
|
|
[skip : OpArg])
|
|
#:transparent)
|
|
(define-struct: PushEnvironment ([n : Natural]
|
|
[unbox? : Boolean])
|
|
#:transparent)
|
|
|
|
|
|
;; Evaluate the value, and then push it onto the top of the environment.
|
|
(define-struct: PushImmediateOntoEnvironment ([value : OpArg]
|
|
[box? : Boolean])
|
|
#:transparent)
|
|
|
|
|
|
(define-struct: PopControlFrame ()
|
|
#:transparent)
|
|
|
|
|
|
;; A generic control frame only holds marks and other temporary variables.
|
|
(define-struct: PushControlFrame/Generic ()
|
|
#:transparent)
|
|
|
|
;; Adding a frame for getting back after procedure application.
|
|
;; The 'proc register must hold either #f or a closure at the time of
|
|
;; this call, as the control frame will hold onto the called procedure record.
|
|
(define-struct: PushControlFrame/Call ([label : LinkedLabel])
|
|
#:transparent)
|
|
|
|
(define-struct: PushControlFrame/Prompt ([tag : (U OpArg DefaultContinuationPromptTag)]
|
|
[label : LinkedLabel]
|
|
;; TODO: add handler and arguments
|
|
)
|
|
#:transparent)
|
|
|
|
(define-struct: DefaultContinuationPromptTag ()
|
|
#:transparent)
|
|
(define default-continuation-prompt-tag
|
|
(make-DefaultContinuationPromptTag))
|
|
|
|
|
|
|
|
|
|
(define-struct: GotoStatement ([target : (U Label
|
|
Reg
|
|
ModuleEntry
|
|
CompiledProcedureEntry)])
|
|
#:transparent)
|
|
|
|
(define-struct: PerformStatement ([op : PrimitiveCommand])
|
|
#:transparent)
|
|
|
|
|
|
|
|
(define-struct: TestAndJumpStatement ([op : PrimitiveTest]
|
|
[label : Symbol])
|
|
#:transparent)
|
|
|
|
|
|
(define-struct: Comment ([val : Any])
|
|
#:transparent)
|
|
|
|
|
|
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
;; Primitive Operators
|
|
|
|
;; The operators that return values, that are used in AssignPrimopStatement.
|
|
(define-type PrimitiveOperator (U GetCompiledProcedureEntry
|
|
MakeCompiledProcedure
|
|
MakeCompiledProcedureShell
|
|
ApplyPrimitiveProcedure
|
|
|
|
|
|
MakeBoxedEnvironmentValue
|
|
|
|
CaptureEnvironment
|
|
CaptureControl
|
|
|
|
CallKernelPrimitiveProcedure))
|
|
|
|
;; Gets the label from the closure stored in the 'proc register and returns it.
|
|
(define-struct: GetCompiledProcedureEntry ()
|
|
#:transparent)
|
|
|
|
;; Constructs a closure, given the label, # of expected arguments,
|
|
;; and the set of lexical references into the environment that the
|
|
;; closure needs to close over.
|
|
(define-struct: MakeCompiledProcedure ([label : Symbol]
|
|
[arity : Arity]
|
|
[closed-vals : (Listof Natural)]
|
|
[display-name : (U Symbol LamPositionalName)])
|
|
#:transparent)
|
|
|
|
|
|
;; Constructs a closure shell. Like MakeCompiledProcedure, but doesn't
|
|
;; bother with trying to capture the free variables.
|
|
(define-struct: MakeCompiledProcedureShell ([label : Symbol]
|
|
[arity : Arity]
|
|
[display-name : (U Symbol LamPositionalName)])
|
|
#:transparent)
|
|
|
|
|
|
;; Applies the primitive procedure that's stored in the proc register, using
|
|
;; the argcount number of values that are bound in the environment as arguments
|
|
;; to that primitive.
|
|
(define-struct: ApplyPrimitiveProcedure ()
|
|
#:transparent)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(define-struct: CallKernelPrimitiveProcedure ([operator : KernelPrimitiveName/Inline]
|
|
|
|
[operands : (Listof OpArg)]
|
|
[expected-operand-types : (Listof OperandDomain)]
|
|
;; For each operand, #t will add code to typecheck the operand
|
|
[typechecks? : (Listof Boolean)])
|
|
#:transparent)
|
|
|
|
|
|
|
|
|
|
(define-struct: MakeBoxedEnvironmentValue ([depth : Natural])
|
|
#:transparent)
|
|
|
|
|
|
;; Capture the current environment, skipping skip frames.
|
|
(define-struct: CaptureEnvironment ([skip : Natural]
|
|
[tag : (U DefaultContinuationPromptTag OpArg)]))
|
|
|
|
;; Capture the control stack, skipping skip frames.
|
|
(define-struct: CaptureControl ([skip : Natural]
|
|
[tag : (U DefaultContinuationPromptTag OpArg)]))
|
|
|
|
|
|
|
|
|
|
;; Primitive tests (used with TestAndBranch)
|
|
(define-type PrimitiveTest (U
|
|
TestFalse
|
|
TestTrue
|
|
TestOne
|
|
TestZero
|
|
TestPrimitiveProcedure
|
|
TestClosureArityMismatch
|
|
))
|
|
(define-struct: TestFalse ([operand : OpArg]) #:transparent)
|
|
(define-struct: TestTrue ([operand : OpArg]) #:transparent)
|
|
(define-struct: TestOne ([operand : OpArg]) #:transparent)
|
|
(define-struct: TestZero ([operand : OpArg]) #:transparent)
|
|
(define-struct: TestPrimitiveProcedure ([operand : OpArg]) #:transparent)
|
|
(define-struct: TestClosureArityMismatch ([closure : OpArg]
|
|
[n : OpArg]) #:transparent)
|
|
|
|
|
|
|
|
;; Check that the value in the prefix has been defined.
|
|
;; If not, raise an error and stop evaluation.
|
|
(define-struct: CheckToplevelBound! ([depth : Natural]
|
|
[pos : Natural])
|
|
#:transparent)
|
|
|
|
;; Check the closure procedure value in 'proc and make sure it can accept the
|
|
;; # of arguments (stored as a number in the argcount register.).
|
|
(define-struct: CheckClosureArity! ([num-args : OpArg])
|
|
#:transparent)
|
|
(define-struct: CheckPrimitiveArity! ([num-args : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
|
|
;; Extends the environment with a prefix that holds
|
|
;; lookups to the namespace.
|
|
(define-struct: ExtendEnvironment/Prefix! ([names : (Listof (U False Symbol GlobalBucket ModuleVariable))])
|
|
#:transparent)
|
|
|
|
;; Adjusts the environment by pushing the values in the
|
|
;; closure (held in the proc register) into itself.
|
|
(define-struct: InstallClosureValues! ()
|
|
#:transparent)
|
|
|
|
|
|
(define-struct: SetFrameCallee! ([proc : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
;; Splices the list structure that lives in env[depth] into position.
|
|
;; Depth must evaluate to a natural.
|
|
(define-struct: SpliceListIntoStack! ([depth : OpArg])
|
|
#:transparent)
|
|
|
|
;; Unsplices the length arguments on the stack, replacing with a list of that length.
|
|
;; Side effects: touches both the environment and argcount appropriately.
|
|
(define-struct: UnspliceRestFromStack! ([depth : OpArg]
|
|
[length : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
(define-struct: FixClosureShellMap! (;; depth: where the closure shell is located in the environment
|
|
[depth : Natural]
|
|
|
|
[closed-vals : (Listof Natural)])
|
|
#:transparent)
|
|
|
|
;; Raises an exception that says that we expected a number of values.
|
|
;; Assume that argcount is not equal to expected.
|
|
(define-struct: RaiseContextExpectedValuesError! ([expected : Natural])
|
|
#:transparent)
|
|
|
|
|
|
;; Raises an exception that says that we're doing a
|
|
;; procedure application, but got sent an incorrect number.
|
|
(define-struct: RaiseArityMismatchError! ([proc : OpArg]
|
|
[expected : Arity]
|
|
[received : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
;; Raises an exception that says that we're doing a
|
|
;; procedure application, but got sent an incorrect number.
|
|
(define-struct: RaiseOperatorApplicationError! ([operator : OpArg])
|
|
#:transparent)
|
|
|
|
|
|
;; Raise a runtime error if we hit a use of an unimplemented kernel primitive.
|
|
(define-struct: RaiseUnimplementedPrimitiveError! ([name : Symbol])
|
|
#:transparent)
|
|
|
|
|
|
|
|
|
|
;; Changes over the control located at the given argument from the structure in env[1]
|
|
(define-struct: RestoreControl! ([tag : (U DefaultContinuationPromptTag OpArg)]) #:transparent)
|
|
|
|
;; Changes over the environment located at the given argument from the structure in env[0]
|
|
(define-struct: RestoreEnvironment! () #:transparent)
|
|
|
|
|
|
;; Adds a continuation mark into the current top control frame.
|
|
(define-struct: InstallContinuationMarkEntry! () #:transparent)
|
|
|
|
|
|
;; Installs a module record into the machine
|
|
(define-struct: InstallModuleEntry! ([name : Symbol]
|
|
[path : ModuleLocator]
|
|
[entry-point : Symbol])
|
|
#:transparent)
|
|
|
|
|
|
;; Mark that the module has been invoked.
|
|
(define-struct: MarkModuleInvoked! ([path : ModuleLocator])
|
|
#:transparent)
|
|
|
|
|
|
;; Give an alternative locator to the module as a main module.
|
|
;; Assumes the module has already been installed.
|
|
(define-struct: AliasModuleAsMain! ([from : ModuleLocator])
|
|
#:transparent)
|
|
|
|
;; Given the module locator, do any finalizing operations, like
|
|
;; setting up the module namespace.
|
|
(define-struct: FinalizeModuleInvokation! ([path : ModuleLocator])
|
|
#:transparent)
|
|
|
|
|
|
|
|
(define-type PrimitiveCommand (U
|
|
CheckToplevelBound!
|
|
CheckClosureArity!
|
|
CheckPrimitiveArity!
|
|
|
|
ExtendEnvironment/Prefix!
|
|
InstallClosureValues!
|
|
FixClosureShellMap!
|
|
|
|
InstallContinuationMarkEntry!
|
|
|
|
SetFrameCallee!
|
|
SpliceListIntoStack!
|
|
UnspliceRestFromStack!
|
|
|
|
RaiseContextExpectedValuesError!
|
|
RaiseArityMismatchError!
|
|
RaiseOperatorApplicationError!
|
|
RaiseUnimplementedPrimitiveError!
|
|
|
|
RestoreEnvironment!
|
|
RestoreControl!
|
|
|
|
InstallModuleEntry!
|
|
MarkModuleInvoked!
|
|
AliasModuleAsMain!
|
|
FinalizeModuleInvokation!
|
|
))
|
|
|
|
|
|
|
|
|
|
(define-type InstructionSequence (U Symbol LinkedLabel Statement instruction-sequence))
|
|
(define-struct: instruction-sequence ([statements : (Listof Statement)])
|
|
#:transparent)
|
|
(define empty-instruction-sequence (make-instruction-sequence '()))
|
|
|
|
|
|
(define-predicate Statement? Statement)
|
|
|
|
|
|
(: statements (InstructionSequence -> (Listof Statement)))
|
|
(define (statements s)
|
|
(cond [(symbol? s)
|
|
(list s)]
|
|
[(LinkedLabel? s)
|
|
(list s)]
|
|
[(Statement? s)
|
|
(list s)]
|
|
[else
|
|
(instruction-sequence-statements s)]))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;; Arity
|
|
(define-type Arity (U AtomicArity (Listof (U AtomicArity))))
|
|
(define-type AtomicArity (U Natural ArityAtLeast))
|
|
(define-struct: ArityAtLeast ([value : Natural])
|
|
#:transparent)
|
|
(define-predicate AtomicArity? AtomicArity)
|
|
(define-predicate listof-atomic-arity? (Listof AtomicArity))
|
|
|
|
|
|
|
|
|
|
(define-predicate OpArg? OpArg) |