0.9.16.38:
[sbcl.git] / src / compiler / sparc / call.lisp
1 ;;;; the VM definition of function call for the Sparc
2
3 ;;;; This software is part of the SBCL system. See the README file for
4 ;;;; more information.
5 ;;;;
6 ;;;; This software is derived from the CMU CL system, which was
7 ;;;; written at Carnegie Mellon University and released into the
8 ;;;; public domain. The software is in the public domain and is
9 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
10 ;;;; files for more information.
11
12 (in-package "SB!VM")
13
14 \f
15 ;;;; Interfaces to IR2 conversion:
16
17 ;;; Return a wired TN describing the N'th full call argument passing
18 ;;; location.
19 (!def-vm-support-routine standard-arg-location (n)
20   (declare (type unsigned-byte n))
21   (if (< n register-arg-count)
22       (make-wired-tn *backend-t-primitive-type* register-arg-scn
23                      (elt *register-arg-offsets* n))
24       (make-wired-tn *backend-t-primitive-type* control-stack-arg-scn n)))
25
26
27 ;;; Make a passing location TN for a local call return PC.  If
28 ;;; standard is true, then use the standard (full call) location,
29 ;;; otherwise use any legal location.  Even in the non-standard case,
30 ;;; this may be restricted by a desire to use a subroutine call
31 ;;; instruction.
32 (!def-vm-support-routine make-return-pc-passing-location (standard)
33   (if standard
34       (make-wired-tn *backend-t-primitive-type* register-arg-scn lra-offset)
35       (make-restricted-tn *backend-t-primitive-type* register-arg-scn)))
36
37 ;;; This is similar to MAKE-RETURN-PC-PASSING-LOCATION, but makes a
38 ;;; location to pass OLD-FP in. This is (obviously) wired in the
39 ;;; standard convention, but is totally unrestricted in non-standard
40 ;;; conventions, since we can always fetch it off of the stack using
41 ;;; the arg pointer.
42 (!def-vm-support-routine make-old-fp-passing-location (standard)
43   (if standard
44       (make-wired-tn *fixnum-primitive-type* immediate-arg-scn ocfp-offset)
45       (make-normal-tn *fixnum-primitive-type*)))
46
47 ;;; Make the TNs used to hold Old-FP and Return-PC within the current
48 ;;; function.  We treat these specially so that the debugger can find
49 ;;; them at a known location.
50 (!def-vm-support-routine make-old-fp-save-location (env)
51   (specify-save-tn
52    (physenv-debug-live-tn (make-normal-tn *fixnum-primitive-type*) env)
53    (make-wired-tn *fixnum-primitive-type*
54                   control-stack-arg-scn
55                   ocfp-save-offset)))
56
57 (!def-vm-support-routine make-return-pc-save-location (env)
58   (specify-save-tn
59    (physenv-debug-live-tn (make-normal-tn *backend-t-primitive-type*) env)
60    (make-wired-tn *backend-t-primitive-type*
61                   control-stack-arg-scn
62                   lra-save-offset)))
63
64 ;;; Make a TN for the standard argument count passing location.  We
65 ;;; only need to make the standard location, since a count is never
66 ;;; passed when we are using non-standard conventions.
67 (!def-vm-support-routine make-arg-count-location ()
68   (make-wired-tn *fixnum-primitive-type* immediate-arg-scn nargs-offset))
69
70
71 ;;; Make a TN to hold the number-stack frame pointer.  This is
72 ;;; allocated once per component, and is component-live.
73 (!def-vm-support-routine make-nfp-tn ()
74   (component-live-tn
75    (make-wired-tn *fixnum-primitive-type* immediate-arg-scn nfp-offset)))
76
77 (!def-vm-support-routine make-stack-pointer-tn ()
78   (make-normal-tn *fixnum-primitive-type*))
79
80 (!def-vm-support-routine make-number-stack-pointer-tn ()
81   (make-normal-tn *fixnum-primitive-type*))
82
83 ;;; Return a list of TNs that can be used to represent an
84 ;;; unknown-values continuation within a function.
85 (!def-vm-support-routine make-unknown-values-locations ()
86   (list (make-stack-pointer-tn)
87         (make-normal-tn *fixnum-primitive-type*)))
88
89
90 ;;; This function is called by the ENTRY-ANALYZE phase, allowing
91 ;;; VM-dependent initialization of the IR2-COMPONENT structure.  We push
92 ;;; placeholder entries in the CONSTANTS to leave room for additional
93 ;;; noise in the code object header.
94 (!def-vm-support-routine select-component-format (component)
95   (declare (type component component))
96   (dotimes (i code-constants-offset)
97     (vector-push-extend nil
98                         (ir2-component-constants (component-info component))))
99   (values))
100 \f
101 ;;;; Frame hackery:
102
103 ;;; Return the number of bytes needed for the current non-descriptor
104 ;;; stack frame.  Non-descriptor stack frames must be multiples of 8
105 ;;; bytes on the PMAX.
106 (defun bytes-needed-for-non-descriptor-stack-frame ()
107   (* (logandc2 (1+ (sb-allocated-size 'non-descriptor-stack)) 1)
108      n-word-bytes))
109
110 ;;; Used for setting up the Old-FP in local call.
111 (define-vop (current-fp)
112   (:results (val :scs (any-reg)))
113   (:generator 1
114     (move val cfp-tn)))
115
116 ;;; Used for computing the caller's NFP for use in known-values return.  Only
117 ;;; works assuming there is no variable size stuff on the nstack.
118 ;;;
119 (define-vop (compute-old-nfp)
120   (:results (val :scs (any-reg)))
121   (:vop-var vop)
122   (:generator 1
123     (let ((nfp (current-nfp-tn vop)))
124       (when nfp
125         (inst add val nfp (bytes-needed-for-non-descriptor-stack-frame))))))
126
127
128 (define-vop (xep-allocate-frame)
129   (:info start-lab copy-more-arg-follows)
130   (:ignore copy-more-arg-follows)
131   (:vop-var vop)
132   (:temporary (:scs (non-descriptor-reg)) temp)
133   (:generator 1
134     ;; Make sure the function is aligned, and drop a label pointing to this
135     ;; function header.
136     (align n-lowtag-bits)
137     (trace-table-entry trace-table-fun-prologue)
138     (emit-label start-lab)
139     ;; Allocate function header.
140     (inst simple-fun-header-word)
141     (dotimes (i (1- simple-fun-code-offset))
142       (inst word 0))
143     ;; The start of the actual code.
144     ;; Fix CODE, cause the function object was passed in.
145     (inst compute-code-from-fn code-tn code-tn start-lab temp)
146     ;; Build our stack frames.
147     (inst add csp-tn cfp-tn
148           (* n-word-bytes (sb-allocated-size 'control-stack)))
149     (let ((nfp-tn (current-nfp-tn vop)))
150       (when nfp-tn
151         (inst sub nsp-tn (bytes-needed-for-non-descriptor-stack-frame))
152         (inst add nfp-tn nsp-tn number-stack-displacement)))
153     (trace-table-entry trace-table-normal)))
154
155 (define-vop (allocate-frame)
156   (:results (res :scs (any-reg))
157             (nfp :scs (any-reg)))
158   (:info callee)
159   (:generator 2
160     (trace-table-entry trace-table-fun-prologue)
161     (move res csp-tn)
162     (inst add csp-tn csp-tn
163           (* n-word-bytes (sb-allocated-size 'control-stack)))
164     (when (ir2-physenv-number-stack-p callee)
165       (inst sub nsp-tn (bytes-needed-for-non-descriptor-stack-frame))
166       (inst add nfp nsp-tn number-stack-displacement))
167     (trace-table-entry trace-table-normal)))
168
169 ;;; Allocate a partial frame for passing stack arguments in a full call.  Nargs
170 ;;; is the number of arguments passed.  If no stack arguments are passed, then
171 ;;; we don't have to do anything.
172 ;;;
173 (define-vop (allocate-full-call-frame)
174   (:info nargs)
175   (:results (res :scs (any-reg)))
176   (:generator 2
177     (when (> nargs register-arg-count)
178       (move res csp-tn)
179       (inst add csp-tn csp-tn (* nargs n-word-bytes)))))
180
181
182
183 \f
184 ;;; Emit code needed at the return-point from an unknown-values call
185 ;;; for a fixed number of values.  Values is the head of the TN-REF
186 ;;; list for the locations that the values are to be received into.
187 ;;; Nvals is the number of values that are to be received (should
188 ;;; equal the length of Values).
189 ;;;
190 ;;; Move-Temp is a Descriptor-Reg TN used as a temporary.
191 ;;;
192 ;;; This code exploits the fact that in the unknown-values convention,
193 ;;; a single value return returns at the return PC + 8, whereas a
194 ;;; return of other than one value returns directly at the return PC.
195 ;;;
196 ;;; If 0 or 1 values are expected, then we just emit an instruction to
197 ;;; reset the SP (which will only be executed when other than 1 value
198 ;;; is returned.)
199 ;;;
200 ;;; In the general case, we have to do three things:
201 ;;;  -- Default unsupplied register values.  This need only be done when a
202 ;;;     single value is returned, since register values are defaulted by the
203 ;;;     called in the non-single case.
204 ;;;  -- Default unsupplied stack values.  This needs to be done whenever there
205 ;;;     are stack values.
206 ;;;  -- Reset SP.  This must be done whenever other than 1 value is returned,
207 ;;;     regardless of the number of values desired.
208 ;;;
209 ;;; The general-case code looks like this:
210 #|
211         b regs-defaulted                ; Skip if MVs
212         nop
213
214         move a1 null-tn                 ; Default register values
215         ...
216         loadi nargs 1                   ; Force defaulting of stack values
217         move old-fp csp                 ; Set up args for SP resetting
218
219 regs-defaulted
220         subcc temp nargs register-arg-count
221
222         b :lt default-value-7   ; jump to default code
223         loadw move-temp ocfp-tn 6       ; Move value to correct location.
224         subcc temp 1
225         store-stack-tn val4-tn move-temp
226
227         b :lt default-value-8
228         loadw move-temp ocfp-tn 7
229         subcc temp 1
230         store-stack-tn val5-tn move-temp
231
232         ...
233
234 defaulting-done
235         move csp ocfp                   ; Reset SP.
236 <end of code>
237
238 <elsewhere>
239 default-value-7
240         store-stack-tn val4-tn null-tn  ; Nil out 7'th value. (first on stack)
241
242 default-value-8
243         store-stack-tn val5-tn null-tn  ; Nil out 8'th value.
244
245         ...
246
247         br defaulting-done
248         nop
249 |#
250 (defun default-unknown-values (vop values nvals move-temp temp lra-label)
251   (declare (type (or tn-ref null) values)
252            (type unsigned-byte nvals) (type tn move-temp temp))
253   (if (<= nvals 1)
254       (progn
255         (without-scheduling ()
256           (note-this-location vop :single-value-return)
257           (move csp-tn ocfp-tn)
258           (inst nop))
259         (inst compute-code-from-lra code-tn code-tn lra-label temp))
260       (let ((regs-defaulted (gen-label))
261             (defaulting-done (gen-label))
262             (default-stack-vals (gen-label)))
263         ;; Branch off to the MV case.
264         (without-scheduling ()
265           (note-this-location vop :unknown-return)
266           (inst b regs-defaulted)
267           (if (> nvals register-arg-count)
268               (inst subcc temp nargs-tn (fixnumize register-arg-count))
269               (move csp-tn ocfp-tn)))
270
271         ;; Do the single value calse.
272         (do ((i 1 (1+ i))
273              (val (tn-ref-across values) (tn-ref-across val)))
274             ((= i (min nvals register-arg-count)))
275           (move (tn-ref-tn val) null-tn))
276         (when (> nvals register-arg-count)
277           (inst b default-stack-vals)
278           (move ocfp-tn csp-tn))
279
280         (emit-label regs-defaulted)
281         (when (> nvals register-arg-count)
282           (collect ((defaults))
283             (do ((i register-arg-count (1+ i))
284                  (val (do ((i 0 (1+ i))
285                            (val values (tn-ref-across val)))
286                           ((= i register-arg-count) val))
287                       (tn-ref-across val)))
288                 ((null val))
289
290               (let ((default-lab (gen-label))
291                     (tn (tn-ref-tn val)))
292                 (defaults (cons default-lab tn))
293
294                 (inst b :le default-lab)
295                 (inst ld move-temp ocfp-tn (* i n-word-bytes))
296                 (inst subcc temp (fixnumize 1))
297                 (store-stack-tn tn move-temp)))
298
299             (emit-label defaulting-done)
300             (move csp-tn ocfp-tn)
301
302             (let ((defaults (defaults)))
303               (when defaults
304                 (assemble (*elsewhere*)
305                   (emit-label default-stack-vals)
306                   (trace-table-entry trace-table-fun-prologue)
307                   (do ((remaining defaults (cdr remaining)))
308                       ((null remaining))
309                     (let ((def (car remaining)))
310                       (emit-label (car def))
311                       (when (null (cdr remaining))
312                         (inst b defaulting-done))
313                       (store-stack-tn (cdr def) null-tn)))
314                   (trace-table-entry trace-table-normal))))))
315
316         (inst compute-code-from-lra code-tn code-tn lra-label temp)))
317   (values))
318
319 \f
320 ;;; Emit code needed at the return point for an unknown-values call
321 ;;; for an arbitrary number of values.
322 ;;;
323 ;;; We do the single and non-single cases with no shared code: there
324 ;;; doesn't seem to be any potential overlap, and receiving a single
325 ;;; value is more important efficiency-wise.
326 ;;;
327 ;;; When there is a single value, we just push it on the stack,
328 ;;; returning the old SP and 1.
329 ;;;
330 ;;; When there is a variable number of values, we move all of the
331 ;;; argument registers onto the stack, and return ARGS and NARGS.
332 ;;;
333 ;;; ARGS and NARGS are TNs wired to the named locations.  We must
334 ;;; explicitly allocate these TNs, since their lifetimes overlap with
335 ;;; the results START and COUNT. (Also, it's nice to be able to target
336 ;;; them.)
337 (defun receive-unknown-values (args nargs start count lra-label temp)
338   (declare (type tn args nargs start count temp))
339   (let ((variable-values (gen-label))
340         (done (gen-label)))
341     (without-scheduling ()
342       (inst b variable-values)
343       (inst nop))
344
345     (inst compute-code-from-lra code-tn code-tn lra-label temp)
346     (inst add csp-tn 4)
347     (storew (first *register-arg-tns*) csp-tn -1)
348     (inst sub start csp-tn 4)
349     (inst li count (fixnumize 1))
350
351     (emit-label done)
352
353     (assemble (*elsewhere*)
354       (trace-table-entry trace-table-fun-prologue)
355       (emit-label variable-values)
356       (inst compute-code-from-lra code-tn code-tn lra-label temp)
357       (do ((arg *register-arg-tns* (rest arg))
358            (i 0 (1+ i)))
359           ((null arg))
360         (storew (first arg) args i))
361       (move start args)
362       (move count nargs)
363       (inst b done)
364       (inst nop)
365       (trace-table-entry trace-table-normal)))
366   (values))
367
368
369 ;;; VOP that can be inherited by unknown values receivers.  The main
370 ;;; thing this handles is allocation of the result temporaries.
371 (define-vop (unknown-values-receiver)
372   (:results
373    (start :scs (any-reg))
374    (count :scs (any-reg)))
375   (:temporary (:sc descriptor-reg :offset ocfp-offset
376                    :from :eval :to (:result 0))
377               values-start)
378   (:temporary (:sc any-reg :offset nargs-offset
379                :from :eval :to (:result 1))
380               nvals)
381   (:temporary (:scs (non-descriptor-reg)) temp))
382
383
384 \f
385 ;;;; Local call with unknown values convention return:
386
387 ;;; Non-TR local call for a fixed number of values passed according to the
388 ;;; unknown values convention.
389 ;;;
390 ;;; Args are the argument passing locations, which are specified only to
391 ;;; terminate their lifetimes in the caller.
392 ;;;
393 ;;; Values are the return value locations (wired to the standard passing
394 ;;; locations).
395 ;;;
396 ;;; Save is the save info, which we can ignore since saving has been done.
397 ;;; Return-PC is the TN that the return PC should be passed in.
398 ;;; Target is a continuation pointing to the start of the called function.
399 ;;; Nvals is the number of values received.
400 ;;;
401 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
402 ;;; registers may be tied up by the more operand.  Instead, we use
403 ;;; MAYBE-LOAD-STACK-TN.
404 (define-vop (call-local)
405   (:args (fp)
406          (nfp)
407          (args :more t))
408   (:results (values :more t))
409   (:save-p t)
410   (:move-args :local-call)
411   (:info arg-locs callee target nvals)
412   (:vop-var vop)
413   (:temporary (:scs (descriptor-reg) :from (:eval 0)) move-temp)
414   (:temporary (:scs (non-descriptor-reg)) temp)
415   (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)
416   (:temporary (:sc any-reg :offset ocfp-offset :from (:eval 0)) ocfp)
417   (:ignore arg-locs args ocfp)
418   (:generator 5
419     (trace-table-entry trace-table-call-site)
420     (let ((label (gen-label))
421           (cur-nfp (current-nfp-tn vop)))
422       (when cur-nfp
423         (store-stack-tn nfp-save cur-nfp))
424       (let ((callee-nfp (callee-nfp-tn callee)))
425         (when callee-nfp
426           (maybe-load-stack-tn callee-nfp nfp)))
427       (maybe-load-stack-tn cfp-tn fp)
428       (inst compute-lra-from-code
429             (callee-return-pc-tn callee) code-tn label temp)
430       (note-this-location vop :call-site)
431       (inst b target)
432       (inst nop)
433       (emit-return-pc label)
434       (default-unknown-values vop values nvals move-temp temp label)
435       (when cur-nfp
436         (load-stack-tn cur-nfp nfp-save)))
437     (trace-table-entry trace-table-normal)))
438
439
440 ;;; Non-TR local call for a variable number of return values passed according
441 ;;; to the unknown values convention.  The results are the start of the values
442 ;;; glob and the number of values received.
443 ;;;
444 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
445 ;;; registers may be tied up by the more operand.  Instead, we use
446 ;;; MAYBE-LOAD-STACK-TN.
447 (define-vop (multiple-call-local unknown-values-receiver)
448   (:args (fp)
449          (nfp)
450          (args :more t))
451   (:save-p t)
452   (:move-args :local-call)
453   (:info save callee target)
454   (:ignore args save)
455   (:vop-var vop)
456   (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)
457   (:generator 20
458     (trace-table-entry trace-table-call-site)
459     (let ((label (gen-label))
460           (cur-nfp (current-nfp-tn vop)))
461       (when cur-nfp
462         (store-stack-tn nfp-save cur-nfp))
463       (let ((callee-nfp (callee-nfp-tn callee)))
464         (when callee-nfp
465           (maybe-load-stack-tn callee-nfp nfp)))
466       (maybe-load-stack-tn cfp-tn fp)
467       (inst compute-lra-from-code
468             (callee-return-pc-tn callee) code-tn label temp)
469       (note-this-location vop :call-site)
470       (inst b target)
471       (inst nop)
472       (emit-return-pc label)
473       (note-this-location vop :unknown-return)
474       (receive-unknown-values values-start nvals start count label temp)
475       (when cur-nfp
476         (load-stack-tn cur-nfp nfp-save)))
477     (trace-table-entry trace-table-normal)))
478
479 \f
480 ;;;; Local call with known values return:
481
482 ;;; Non-TR local call with known return locations.  Known-value return works
483 ;;; just like argument passing in local call.
484 ;;;
485 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
486 ;;; registers may be tied up by the more operand.  Instead, we use
487 ;;; MAYBE-LOAD-STACK-TN.
488 (define-vop (known-call-local)
489   (:args (fp)
490          (nfp)
491          (args :more t))
492   (:results (res :more t))
493   (:move-args :local-call)
494   (:save-p t)
495   (:info save callee target)
496   (:ignore args res save)
497   (:vop-var vop)
498   (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)
499   (:temporary (:scs (non-descriptor-reg)) temp)
500   (:generator 5
501     (trace-table-entry trace-table-call-site)
502     (let ((label (gen-label))
503           (cur-nfp (current-nfp-tn vop)))
504       (when cur-nfp
505         (store-stack-tn nfp-save cur-nfp))
506       (let ((callee-nfp (callee-nfp-tn callee)))
507         (when callee-nfp
508           (maybe-load-stack-tn callee-nfp nfp)))
509       (maybe-load-stack-tn cfp-tn fp)
510       (inst compute-lra-from-code
511             (callee-return-pc-tn callee) code-tn label temp)
512       (note-this-location vop :call-site)
513       (inst b target)
514       (inst nop)
515       (emit-return-pc label)
516       (note-this-location vop :known-return)
517       (when cur-nfp
518         (load-stack-tn cur-nfp nfp-save)))
519     (trace-table-entry trace-table-normal)))
520
521 ;;; Return from known values call.  We receive the return locations as
522 ;;; arguments to terminate their lifetimes in the returning function.  We
523 ;;; restore FP and CSP and jump to the Return-PC.
524 ;;;
525 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
526 ;;; registers may be tied up by the more operand.  Instead, we use
527 ;;; MAYBE-LOAD-STACK-TN.
528 (define-vop (known-return)
529   (:args (old-fp :target old-fp-temp)
530          (return-pc :target return-pc-temp)
531          (vals :more t))
532   (:temporary (:sc any-reg :from (:argument 0)) old-fp-temp)
533   (:temporary (:sc descriptor-reg :from (:argument 1)) return-pc-temp)
534   (:move-args :known-return)
535   (:info val-locs)
536   (:ignore val-locs vals)
537   (:vop-var vop)
538   (:generator 6
539     (trace-table-entry trace-table-fun-epilogue)
540     (maybe-load-stack-tn old-fp-temp old-fp)
541     (maybe-load-stack-tn return-pc-temp return-pc)
542     (move csp-tn cfp-tn)
543     (let ((cur-nfp (current-nfp-tn vop)))
544       (when cur-nfp
545         (inst add nsp-tn cur-nfp
546               (- (bytes-needed-for-non-descriptor-stack-frame)
547                  number-stack-displacement))))
548     (inst j return-pc-temp (- n-word-bytes other-pointer-lowtag))
549     (move cfp-tn old-fp-temp)
550     (trace-table-entry trace-table-normal)))
551
552 \f
553 ;;;; Full call:
554 ;;;
555 ;;; There is something of a cross-product effect with full calls.
556 ;;; Different versions are used depending on whether we know the
557 ;;; number of arguments or the name of the called function, and
558 ;;; whether we want fixed values, unknown values, or a tail call.
559 ;;;
560 ;;; In full call, the arguments are passed creating a partial frame on
561 ;;; the stack top and storing stack arguments into that frame.  On
562 ;;; entry to the callee, this partial frame is pointed to by FP.  If
563 ;;; there are no stack arguments, we don't bother allocating a partial
564 ;;; frame, and instead set FP to SP just before the call.
565
566 ;;; This macro helps in the definition of full call VOPs by avoiding code
567 ;;; replication in defining the cross-product VOPs.
568 ;;;
569 ;;; Name is the name of the VOP to define.
570 ;;;
571 ;;; Named is true if the first argument is a symbol whose global function
572 ;;; definition is to be called.
573 ;;;
574 ;;; Return is either :Fixed, :Unknown or :Tail:
575 ;;; -- If :Fixed, then the call is for a fixed number of values, returned in
576 ;;;    the standard passing locations (passed as result operands).
577 ;;; -- If :Unknown, then the result values are pushed on the stack, and the
578 ;;;    result values are specified by the Start and Count as in the
579 ;;;    unknown-values continuation representation.
580 ;;; -- If :Tail, then do a tail-recursive call.  No values are returned.
581 ;;;    The Old-Fp and Return-PC are passed as the second and third arguments.
582 ;;;
583 ;;; In non-tail calls, the pointer to the stack arguments is passed as the last
584 ;;; fixed argument.  If Variable is false, then the passing locations are
585 ;;; passed as a more arg.  Variable is true if there are a variable number of
586 ;;; arguments passed on the stack.  Variable cannot be specified with :Tail
587 ;;; return.  TR variable argument call is implemented separately.
588 ;;;
589 ;;; In tail call with fixed arguments, the passing locations are passed as a
590 ;;; more arg, but there is no new-FP, since the arguments have been set up in
591 ;;; the current frame.
592 (defmacro define-full-call (name named return variable)
593   (aver (not (and variable (eq return :tail))))
594   `(define-vop (,name
595                 ,@(when (eq return :unknown)
596                     '(unknown-values-receiver)))
597      (:args
598       ,@(unless (eq return :tail)
599           '((new-fp :scs (any-reg) :to :eval)))
600
601       ,(if named
602            '(name :target name-pass)
603            '(arg-fun :target lexenv))
604
605       ,@(when (eq return :tail)
606           '((old-fp :target old-fp-pass)
607             (return-pc :target return-pc-pass)))
608
609       ,@(unless variable '((args :more t :scs (descriptor-reg)))))
610
611      ,@(when (eq return :fixed)
612          '((:results (values :more t))))
613
614      (:save-p ,(if (eq return :tail) :compute-only t))
615
616      ,@(unless (or (eq return :tail) variable)
617          '((:move-args :full-call)))
618
619      (:vop-var vop)
620      (:info ,@(unless (or variable (eq return :tail)) '(arg-locs))
621             ,@(unless variable '(nargs))
622             ,@(when (eq return :fixed) '(nvals))
623             step-instrumenting)
624
625      (:ignore
626       ,@(unless (or variable (eq return :tail)) '(arg-locs))
627       ,@(unless variable '(args))
628       ;; Step instrumentation for full calls not implemented yet.
629       ;; See the PPC backend for an example.
630       step-instrumenting)
631
632      (:temporary (:sc descriptor-reg
633                   :offset ocfp-offset
634                   :from (:argument 1)
635                   ,@(unless (eq return :fixed)
636                       '(:to :eval)))
637                  old-fp-pass)
638
639      (:temporary (:sc descriptor-reg
640                   :offset lra-offset
641                   :from (:argument ,(if (eq return :tail) 2 1))
642                   :to :eval)
643                  return-pc-pass)
644
645      ,(if named
646           `(:temporary (:sc descriptor-reg :offset cname-offset
647                             :from (:argument ,(if (eq return :tail) 0 1))
648                             :to :eval)
649                        name-pass)
650           `(:temporary (:sc descriptor-reg :offset lexenv-offset
651                             :from (:argument ,(if (eq return :tail) 0 1))
652                             :to :eval)
653                        lexenv))
654
655      (:temporary (:scs (descriptor-reg) :from (:argument 0) :to :eval)
656                  function)
657      (:temporary (:sc any-reg :offset nargs-offset :to :eval)
658                  nargs-pass)
659
660      ,@(when variable
661          (mapcar #'(lambda (name offset)
662                      `(:temporary (:sc descriptor-reg
663                                    :offset ,offset
664                                    :to :eval)
665                          ,name))
666                  register-arg-names *register-arg-offsets*))
667      ,@(when (eq return :fixed)
668          '((:temporary (:scs (descriptor-reg) :from :eval) move-temp)))
669
670      ,@(unless (eq return :tail)
671          '((:temporary (:scs (non-descriptor-reg)) temp)
672            (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)))
673
674      (:generator ,(+ (if named 5 0)
675                      (if variable 19 1)
676                      (if (eq return :tail) 0 10)
677                      15
678                      (if (eq return :unknown) 25 0))
679        (trace-table-entry trace-table-call-site)
680        (let* ((cur-nfp (current-nfp-tn vop))
681               ,@(unless (eq return :tail)
682                   '((lra-label (gen-label))))
683               (filler
684                (remove nil
685                        (list :load-nargs
686                              ,@(if (eq return :tail)
687                                    '((unless (location= old-fp old-fp-pass)
688                                        :load-old-fp)
689                                      (unless (location= return-pc
690                                                         return-pc-pass)
691                                        :load-return-pc)
692                                      (when cur-nfp
693                                        :frob-nfp))
694                                    '(:comp-lra
695                                      (when cur-nfp
696                                        :frob-nfp)
697                                      :save-fp
698                                      :load-fp))))))
699          (flet ((do-next-filler ()
700                   (let* ((next (pop filler))
701                          (what (if (consp next) (car next) next)))
702                     (ecase what
703                       (:load-nargs
704                        ,@(if variable
705                              `((inst sub nargs-pass csp-tn new-fp)
706                                ,@(let ((index -1))
707                                    (mapcar #'(lambda (name)
708                                                `(loadw ,name new-fp
709                                                        ,(incf index)))
710                                            register-arg-names)))
711                              '((inst li nargs-pass (fixnumize nargs)))))
712                       ,@(if (eq return :tail)
713                             '((:load-old-fp
714                                (sc-case old-fp
715                                  (any-reg
716                                   (inst move old-fp-pass old-fp))
717                                  (control-stack
718                                   (loadw old-fp-pass cfp-tn
719                                          (tn-offset old-fp)))))
720                               (:load-return-pc
721                                (sc-case return-pc
722                                  (descriptor-reg
723                                   (inst move return-pc-pass return-pc))
724                                  (control-stack
725                                   (loadw return-pc-pass cfp-tn
726                                          (tn-offset return-pc)))))
727                               (:frob-nfp
728                                (inst add nsp-tn cur-nfp
729                                      (- (bytes-needed-for-non-descriptor-stack-frame)
730                                         number-stack-displacement))))
731                             `((:comp-lra
732                                (inst compute-lra-from-code
733                                      return-pc-pass code-tn lra-label temp))
734                               (:frob-nfp
735                                (store-stack-tn nfp-save cur-nfp))
736                               (:save-fp
737                                (inst move old-fp-pass cfp-tn))
738                               (:load-fp
739                                ,(if variable
740                                     '(move cfp-tn new-fp)
741                                     '(if (> nargs register-arg-count)
742                                          (move cfp-tn new-fp)
743                                          (move cfp-tn csp-tn))))))
744                       ((nil))))))
745
746            ,@(if named
747                  `((sc-case name
748                      (descriptor-reg (move name-pass name))
749                      (control-stack
750                       (loadw name-pass cfp-tn (tn-offset name))
751                       (do-next-filler))
752                      (constant
753                       (loadw name-pass code-tn (tn-offset name)
754                              other-pointer-lowtag)
755                       (do-next-filler)))
756                    (loadw function name-pass fdefn-raw-addr-slot
757                           other-pointer-lowtag)
758                    (do-next-filler))
759                  `((sc-case arg-fun
760                      (descriptor-reg (move lexenv arg-fun))
761                      (control-stack
762                       (loadw lexenv cfp-tn (tn-offset arg-fun))
763                       (do-next-filler))
764                      (constant
765                       (loadw lexenv code-tn (tn-offset arg-fun)
766                              other-pointer-lowtag)
767                       (do-next-filler)))
768                    (loadw function lexenv closure-fun-slot
769                           fun-pointer-lowtag)
770                    (do-next-filler)))
771            (loop
772              (if filler
773                  (do-next-filler)
774                  (return)))
775
776            (note-this-location vop :call-site)
777            (inst j function
778                  (- (ash simple-fun-code-offset word-shift)
779                     fun-pointer-lowtag))
780            (inst move code-tn function))
781
782          ,@(ecase return
783              (:fixed
784               '((emit-return-pc lra-label)
785                 (default-unknown-values vop values nvals move-temp
786                                         temp lra-label)
787                 (when cur-nfp
788                   (load-stack-tn cur-nfp nfp-save))))
789              (:unknown
790               '((emit-return-pc lra-label)
791                 (note-this-location vop :unknown-return)
792                 (receive-unknown-values values-start nvals start count
793                                         lra-label temp)
794                 (when cur-nfp
795                   (load-stack-tn cur-nfp nfp-save))))
796              (:tail)))
797        (trace-table-entry trace-table-normal))))
798
799
800 (define-full-call call nil :fixed nil)
801 (define-full-call call-named t :fixed nil)
802 (define-full-call multiple-call nil :unknown nil)
803 (define-full-call multiple-call-named t :unknown nil)
804 (define-full-call tail-call nil :tail nil)
805 (define-full-call tail-call-named t :tail nil)
806
807 (define-full-call call-variable nil :fixed t)
808 (define-full-call multiple-call-variable nil :unknown t)
809
810
811 ;;; Defined separately, since needs special code that BLT's the
812 ;;; arguments down.
813 (define-vop (tail-call-variable)
814   (:args
815    (args-arg :scs (any-reg) :target args)
816    (function-arg :scs (descriptor-reg) :target lexenv)
817    (old-fp-arg :scs (any-reg) :target old-fp)
818    (lra-arg :scs (descriptor-reg) :target lra))
819
820   (:temporary (:sc any-reg :offset nl0-offset :from (:argument 0)) args)
821   (:temporary (:sc any-reg :offset lexenv-offset :from (:argument 1)) lexenv)
822   (:temporary (:sc any-reg :offset ocfp-offset :from (:argument 2)) old-fp)
823   (:temporary (:sc any-reg :offset lra-offset :from (:argument 3)) lra)
824
825   (:temporary (:scs (any-reg) :from :eval) temp)
826
827   (:vop-var vop)
828
829   (:generator 75
830
831     ;; Move these into the passing locations if they are not already there.
832     (move args args-arg)
833     (move lexenv function-arg)
834     (move old-fp old-fp-arg)
835     (move lra lra-arg)
836
837     ;; Clear the number stack if anything is there.
838     (let ((cur-nfp (current-nfp-tn vop)))
839       (when cur-nfp
840         (inst add nsp-tn cur-nfp
841               (- (bytes-needed-for-non-descriptor-stack-frame)
842                  number-stack-displacement))))
843
844     ;; And jump to the assembly-routine that does the bliting.
845     (inst ji temp (make-fixup 'tail-call-variable :assembly-routine))
846     (inst nop)))
847
848 \f
849 ;;;; Unknown values return:
850
851
852 ;;; Return a single value using the unknown-values convention.
853 (define-vop (return-single)
854   (:args (old-fp :scs (any-reg))
855          (return-pc :scs (descriptor-reg))
856          (value))
857   (:ignore value)
858   (:vop-var vop)
859   (:generator 6
860     (trace-table-entry trace-table-fun-epilogue)
861     ;; Clear the number stack.
862     (let ((cur-nfp (current-nfp-tn vop)))
863       (when cur-nfp
864         (inst add nsp-tn cur-nfp
865               (- (bytes-needed-for-non-descriptor-stack-frame)
866                  number-stack-displacement))))
867     ;; Clear the control stack, and restore the frame pointer.
868     (move csp-tn cfp-tn)
869     (move cfp-tn old-fp)
870     ;; Out of here.
871     (lisp-return return-pc :offset 2)
872     (trace-table-entry trace-table-normal)))
873
874 ;;; Do unknown-values return of a fixed number of values.  The Values are
875 ;;; required to be set up in the standard passing locations.  Nvals is the
876 ;;; number of values returned.
877 ;;;
878 ;;; If returning a single value, then deallocate the current frame, restore
879 ;;; FP and jump to the single-value entry at Return-PC + 8.
880 ;;;
881 ;;; If returning other than one value, then load the number of values returned,
882 ;;; NIL out unsupplied values registers, restore FP and return at Return-PC.
883 ;;; When there are stack values, we must initialize the argument pointer to
884 ;;; point to the beginning of the values block (which is the beginning of the
885 ;;; current frame.)
886 (define-vop (return)
887   (:args
888    (old-fp :scs (any-reg))
889    (return-pc :scs (descriptor-reg) :to (:eval 1))
890    (values :more t))
891   (:ignore values)
892   (:info nvals)
893   (:temporary (:sc descriptor-reg :offset a0-offset :from (:eval 0)) a0)
894   (:temporary (:sc descriptor-reg :offset a1-offset :from (:eval 0)) a1)
895   (:temporary (:sc descriptor-reg :offset a2-offset :from (:eval 0)) a2)
896   (:temporary (:sc descriptor-reg :offset a3-offset :from (:eval 0)) a3)
897   (:temporary (:sc descriptor-reg :offset a4-offset :from (:eval 0)) a4)
898   (:temporary (:sc descriptor-reg :offset a5-offset :from (:eval 0)) a5)
899   (:temporary (:sc any-reg :offset nargs-offset) nargs)
900   (:temporary (:sc any-reg :offset ocfp-offset) val-ptr)
901   (:vop-var vop)
902   (:generator 6
903     (trace-table-entry trace-table-fun-epilogue)
904     ;; Clear the number stack.
905     (let ((cur-nfp (current-nfp-tn vop)))
906       (when cur-nfp
907         (inst add nsp-tn cur-nfp
908               (- (bytes-needed-for-non-descriptor-stack-frame)
909                  number-stack-displacement))))
910     (cond ((= nvals 1)
911            ;; Clear the control stack, and restore the frame pointer.
912            (move csp-tn cfp-tn)
913            (move cfp-tn old-fp)
914            ;; Out of here.
915            (lisp-return return-pc :offset 2))
916           (t
917            ;; Establish the values pointer and values count.
918            (move val-ptr cfp-tn)
919            (inst li nargs (fixnumize nvals))
920            ;; restore the frame pointer and clear as much of the control
921            ;; stack as possible.
922            (move cfp-tn old-fp)
923            (inst add csp-tn val-ptr (* nvals n-word-bytes))
924            ;; pre-default any argument register that need it.
925            (when (< nvals register-arg-count)
926              (dolist (reg (subseq (list a0 a1 a2 a3 a4 a5) nvals))
927                (move reg null-tn)))
928            ;; And away we go.
929            (lisp-return return-pc)))
930     (trace-table-entry trace-table-normal)))
931
932 ;;; Do unknown-values return of an arbitrary number of values (passed on the
933 ;;; stack.)  We check for the common case of a single return value, and do that
934 ;;; inline using the normal single value return convention.  Otherwise, we
935 ;;; branch off to code that calls an assembly-routine.
936 (define-vop (return-multiple)
937   (:args
938    (old-fp-arg :scs (any-reg) :to (:eval 1))
939    (lra-arg :scs (descriptor-reg) :to (:eval 1))
940    (vals-arg :scs (any-reg) :target vals)
941    (nvals-arg :scs (any-reg) :target nvals))
942
943   (:temporary (:sc any-reg :offset nl1-offset :from (:argument 0)) old-fp)
944   (:temporary (:sc descriptor-reg :offset lra-offset :from (:argument 1)) lra)
945   (:temporary (:sc any-reg :offset nl0-offset :from (:argument 2)) vals)
946   (:temporary (:sc any-reg :offset nargs-offset :from (:argument 3)) nvals)
947   (:temporary (:sc descriptor-reg :offset a0-offset) a0)
948
949   (:temporary (:scs (any-reg) :from (:eval 1)) temp)
950
951   (:vop-var vop)
952
953   (:generator 13
954     (trace-table-entry trace-table-fun-epilogue)
955     (let ((not-single (gen-label)))
956       ;; Clear the number stack.
957       (let ((cur-nfp (current-nfp-tn vop)))
958         (when cur-nfp
959           (inst add nsp-tn cur-nfp
960                 (- (bytes-needed-for-non-descriptor-stack-frame)
961                    number-stack-displacement))))
962
963       ;; Check for the single case.
964       (inst cmp nvals-arg (fixnumize 1))
965       (inst b :ne not-single)
966       (inst ld a0 vals-arg)
967
968       ;; Return with one value.
969       (move csp-tn cfp-tn)
970       (move cfp-tn old-fp-arg)
971       (lisp-return lra-arg :offset 2)
972
973       ;; Nope, not the single case.
974       (emit-label not-single)
975       (move old-fp old-fp-arg)
976       (move lra lra-arg)
977       (move vals vals-arg)
978       (move nvals nvals-arg)
979       (inst ji temp (make-fixup 'return-multiple :assembly-routine))
980       (inst nop))
981     (trace-table-entry trace-table-normal)))
982
983
984 \f
985 ;;;; XEP hackery:
986
987
988 ;;; We don't need to do anything special for regular functions.
989 (define-vop (setup-environment)
990   (:info label)
991   (:ignore label)
992   (:generator 0
993     ;; Don't bother doing anything.
994     ))
995
996 ;;; Get the lexical environment from it's passing location.
997 (define-vop (setup-closure-environment)
998   (:temporary (:sc descriptor-reg :offset lexenv-offset :target closure
999                :to (:result 0))
1000               lexenv)
1001   (:results (closure :scs (descriptor-reg)))
1002   (:info label)
1003   (:ignore label)
1004   (:generator 6
1005     ;; Get result.
1006     (move closure lexenv)))
1007
1008 ;;; Copy a more arg from the argument area to the end of the current frame.
1009 ;;; Fixed is the number of non-more arguments.
1010 (define-vop (copy-more-arg)
1011   (:temporary (:sc any-reg :offset nl0-offset) result)
1012   (:temporary (:sc any-reg :offset nl1-offset) count)
1013   (:temporary (:sc any-reg :offset nl2-offset) src)
1014   (:temporary (:sc any-reg :offset nl3-offset) dst)
1015   (:temporary (:sc descriptor-reg :offset l0-offset) temp)
1016   (:info fixed)
1017   (:generator 20
1018     (let ((loop (gen-label))
1019           (do-regs (gen-label))
1020           (done (gen-label)))
1021       (when (< fixed register-arg-count)
1022         ;; Save a pointer to the results so we can fill in register args.
1023         ;; We don't need this if there are more fixed args than reg args.
1024         (move result csp-tn))
1025       ;; Allocate the space on the stack.
1026       (cond ((zerop fixed)
1027              (inst cmp nargs-tn)
1028              (inst b :eq done)
1029              (inst add csp-tn csp-tn nargs-tn))
1030             (t
1031              (inst subcc count nargs-tn (fixnumize fixed))
1032              (inst b :le done)
1033              (inst nop)
1034              (inst add csp-tn csp-tn count)))
1035       (when (< fixed register-arg-count)
1036         ;; We must stop when we run out of stack args, not when we run out of
1037         ;; more args.
1038         (inst subcc count nargs-tn (fixnumize register-arg-count))
1039         ;; Everything of interest in registers.
1040         (inst b :le do-regs))
1041       ;; Initialize dst to be end of stack.
1042       (move dst csp-tn)
1043       ;; Initialize src to be end of args.
1044       (inst add src cfp-tn nargs-tn)
1045
1046       (emit-label loop)
1047       ;; *--dst = *--src, --count
1048       (inst add src src (- n-word-bytes))
1049       (inst subcc count count (fixnumize 1))
1050       (loadw temp src)
1051       (inst add dst dst (- n-word-bytes))
1052       (inst b :gt loop)
1053       (storew temp dst)
1054
1055       (emit-label do-regs)
1056       (when (< fixed register-arg-count)
1057         ;; Now we have to deposit any more args that showed up in registers.
1058         (inst subcc count nargs-tn (fixnumize fixed))
1059         (do ((i fixed (1+ i)))
1060             ((>= i register-arg-count))
1061           ;; Don't deposit any more than there are.
1062           (inst b :eq done)
1063           (inst subcc count (fixnumize 1))
1064           ;; Store it relative to the pointer saved at the start.
1065           (storew (nth i *register-arg-tns*) result (- i fixed))))
1066       (emit-label done))))
1067
1068
1069 ;;; More args are stored consequtively on the stack, starting immediately at
1070 ;;; the context pointer.  The context pointer is not typed, so the lowtag is 0.
1071 (define-vop (more-arg word-index-ref)
1072   (:variant 0 0)
1073   (:translate %more-arg))
1074
1075 ;;; Turn more arg (context, count) into a list.
1076 (defoptimizer (%listify-rest-args stack-allocate-result) ((&rest args))
1077   t)
1078
1079 (define-vop (listify-rest-args)
1080   (:args (context-arg :target context :scs (descriptor-reg))
1081          (count-arg :target count :scs (any-reg)))
1082   (:arg-types * tagged-num)
1083   (:temporary (:scs (any-reg) :from (:argument 0)) context)
1084   (:temporary (:scs (any-reg) :from (:argument 1)) count)
1085   (:temporary (:scs (descriptor-reg) :from :eval) temp)
1086   (:temporary (:scs (non-descriptor-reg) :from :eval) dst)
1087   (:results (result :scs (descriptor-reg)))
1088   (:translate %listify-rest-args)
1089   (:policy :safe)
1090   (:node-var node)
1091   (:generator 20
1092     (let* ((enter (gen-label))
1093            (loop (gen-label))
1094            (done (gen-label))
1095            (dx-p (node-stack-allocate-p node))
1096            (alloc-area-tn (if dx-p csp-tn alloc-tn)))
1097       (move context context-arg)
1098       (move count count-arg)
1099       ;; Check to see if there are any arguments.
1100       (inst cmp count)
1101       (inst b :eq done)
1102       (move result null-tn)
1103
1104       ;; We need to do this atomically.
1105       (pseudo-atomic ()
1106         (when dx-p
1107           (align-csp temp))
1108         ;; Allocate a cons (2 words) for each item.
1109         (inst andn result alloc-area-tn lowtag-mask)
1110         (inst or result list-pointer-lowtag)
1111         (move dst result)
1112         (inst sll temp count 1)
1113         (inst b enter)
1114         (inst add alloc-area-tn temp)
1115
1116         ;; Compute the next cons and store it in the current one.
1117         (emit-label loop)
1118         (inst add dst dst (* 2 n-word-bytes))
1119         (storew dst dst -1 list-pointer-lowtag)
1120
1121         ;; Grab one value.
1122         (emit-label enter)
1123         (loadw temp context)
1124         (inst add context context n-word-bytes)
1125
1126         ;; Dec count, and if != zero, go back for more.
1127         (inst subcc count (fixnumize 1))
1128         (inst b :gt loop)
1129
1130         ;; Store the value into the car of the current cons (in the delay
1131         ;; slot).
1132         (storew temp dst 0 list-pointer-lowtag)
1133
1134         ;; NIL out the last cons.
1135         (storew null-tn dst 1 list-pointer-lowtag))
1136       (emit-label done))))
1137
1138
1139 ;;; Return the location and size of the more arg glob created by Copy-More-Arg.
1140 ;;; Supplied is the total number of arguments supplied (originally passed in
1141 ;;; NARGS.)  Fixed is the number of non-rest arguments.
1142 ;;;
1143 ;;; We must duplicate some of the work done by Copy-More-Arg, since at that
1144 ;;; time the environment is in a pretty brain-damaged state, preventing this
1145 ;;; info from being returned as values.  What we do is compute
1146 ;;; supplied - fixed, and return a pointer that many words below the current
1147 ;;; stack top.
1148 (define-vop (more-arg-context)
1149   (:policy :fast-safe)
1150   (:translate sb!c::%more-arg-context)
1151   (:args (supplied :scs (any-reg)))
1152   (:arg-types tagged-num (:constant fixnum))
1153   (:info fixed)
1154   (:results (context :scs (descriptor-reg))
1155             (count :scs (any-reg)))
1156   (:result-types t tagged-num)
1157   (:note "more-arg-context")
1158   (:generator 5
1159     (inst sub count supplied (fixnumize fixed))
1160     (inst sub context csp-tn count)))
1161
1162
1163 ;;; Signal wrong argument count error if Nargs isn't = to Count.
1164 ;;;
1165 (define-vop (verify-arg-count)
1166   (:policy :fast-safe)
1167   (:translate sb!c::%verify-arg-count)
1168   (:args (nargs :scs (any-reg)))
1169   (:arg-types positive-fixnum (:constant t))
1170   (:info count)
1171   (:vop-var vop)
1172   (:save-p :compute-only)
1173   (:generator 3
1174     (let ((err-lab
1175            (generate-error-code vop invalid-arg-count-error nargs)))
1176       (inst cmp nargs (fixnumize count))
1177       (if (member :sparc-v9 *backend-subfeatures*)
1178           ;; Assume we don't take the branch
1179           (inst b :ne err-lab :pn)
1180           (inst b :ne err-lab))
1181       (inst nop))))
1182
1183 ;;; Signal various errors.
1184 (macrolet ((frob (name error translate &rest args)
1185              `(define-vop (,name)
1186                 ,@(when translate
1187                     `((:policy :fast-safe)
1188                       (:translate ,translate)))
1189                 (:args ,@(mapcar #'(lambda (arg)
1190                                      `(,arg :scs (any-reg descriptor-reg)))
1191                                  args))
1192                 (:vop-var vop)
1193                 (:save-p :compute-only)
1194                 (:generator 1000
1195                   (error-call vop ,error ,@args)))))
1196   (frob arg-count-error invalid-arg-count-error
1197     sb!c::%arg-count-error nargs)
1198   (frob type-check-error object-not-type-error sb!c::%type-check-error
1199     object type)
1200   (frob layout-invalid-error layout-invalid-error sb!c::%layout-invalid-error
1201     object layout)
1202   (frob odd-key-args-error odd-key-args-error
1203     sb!c::%odd-key-args-error)
1204   (frob unknown-key-arg-error unknown-key-arg-error
1205     sb!c::%unknown-key-arg-error key)
1206   (frob nil-fun-returned-error nil-fun-returned-error nil fun))
1207
1208 ;;; Single-stepping
1209
1210 (define-vop (step-instrument-before-vop)
1211   (:policy :fast-safe)
1212   (:vop-var vop)
1213   (:generator 3
1214     ;; Stub! See the PPC backend for an example.
1215     (note-this-location vop :step-before-vop)))