1 ;;;; the VM definition of function call for the Sparc
3 ;;;; This software is part of the SBCL system. See the README file for
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.
15 ;;;; Interfaces to IR2 conversion:
17 ;;; Return a wired TN describing the N'th full call argument passing
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)))
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
32 (!def-vm-support-routine make-return-pc-passing-location (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)))
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
42 (!def-vm-support-routine make-old-fp-passing-location (standard)
44 (make-wired-tn *fixnum-primitive-type* immediate-arg-scn ocfp-offset)
45 (make-normal-tn *fixnum-primitive-type*)))
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)
52 (physenv-debug-live-tn (make-normal-tn *fixnum-primitive-type*) env)
53 (make-wired-tn *fixnum-primitive-type*
57 (!def-vm-support-routine make-return-pc-save-location (env)
59 (physenv-debug-live-tn (make-normal-tn *backend-t-primitive-type*) env)
60 (make-wired-tn *backend-t-primitive-type*
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))
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 ()
75 (make-wired-tn *fixnum-primitive-type* immediate-arg-scn nfp-offset)))
77 (!def-vm-support-routine make-stack-pointer-tn ()
78 (make-normal-tn *fixnum-primitive-type*))
80 (!def-vm-support-routine make-number-stack-pointer-tn ()
81 (make-normal-tn *fixnum-primitive-type*))
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*)))
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))))
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)
110 ;;; Used for setting up the Old-FP in local call.
111 (define-vop (current-fp)
112 (:results (val :scs (any-reg)))
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.
119 (define-vop (compute-old-nfp)
120 (:results (val :scs (any-reg)))
123 (let ((nfp (current-nfp-tn vop)))
125 (inst add val nfp (bytes-needed-for-non-descriptor-stack-frame))))))
127 ;;; Accessing a slot from an earlier stack frame is definite hackery.
128 (define-vop (ancestor-frame-ref)
129 (:args (frame-pointer :scs (descriptor-reg))
130 (variable-home-tn :load-if nil))
131 (:results (value :scs (descriptor-reg any-reg)))
134 (aver (sc-is variable-home-tn control-stack))
135 (loadw value frame-pointer (tn-offset variable-home-tn))))
136 (define-vop (ancestor-frame-set)
137 (:args (frame-pointer :scs (descriptor-reg))
138 (value :scs (descriptor-reg any-reg)))
139 (:results (variable-home-tn :load-if nil))
142 (aver (sc-is variable-home-tn control-stack))
143 (storew value frame-pointer (tn-offset variable-home-tn))))
145 (define-vop (xep-allocate-frame)
146 (:info start-lab copy-more-arg-follows)
147 (:ignore copy-more-arg-follows)
149 (:temporary (:scs (non-descriptor-reg)) temp)
151 ;; Make sure the function is aligned, and drop a label pointing to this
153 (emit-alignment n-lowtag-bits)
154 (trace-table-entry trace-table-fun-prologue)
155 (emit-label start-lab)
156 ;; Allocate function header.
157 (inst simple-fun-header-word)
158 (dotimes (i (1- simple-fun-code-offset))
160 ;; The start of the actual code.
161 ;; Fix CODE, cause the function object was passed in.
162 (inst compute-code-from-fn code-tn code-tn start-lab temp)
163 ;; Build our stack frames.
164 (inst add csp-tn cfp-tn
165 (* n-word-bytes (sb-allocated-size 'control-stack)))
166 (let ((nfp-tn (current-nfp-tn vop)))
168 (inst sub nsp-tn (bytes-needed-for-non-descriptor-stack-frame))
169 (inst add nfp-tn nsp-tn number-stack-displacement)))
170 (trace-table-entry trace-table-normal)))
172 (define-vop (allocate-frame)
173 (:results (res :scs (any-reg))
174 (nfp :scs (any-reg)))
177 (trace-table-entry trace-table-fun-prologue)
179 (inst add csp-tn csp-tn
180 (* n-word-bytes (sb-allocated-size 'control-stack)))
181 (when (ir2-physenv-number-stack-p callee)
182 (inst sub nsp-tn (bytes-needed-for-non-descriptor-stack-frame))
183 (inst add nfp nsp-tn number-stack-displacement))
184 (trace-table-entry trace-table-normal)))
186 ;;; Allocate a partial frame for passing stack arguments in a full call. Nargs
187 ;;; is the number of arguments passed. If no stack arguments are passed, then
188 ;;; we don't have to do anything.
190 (define-vop (allocate-full-call-frame)
192 (:results (res :scs (any-reg)))
194 (when (> nargs register-arg-count)
196 (inst add csp-tn csp-tn (* nargs n-word-bytes)))))
201 ;;; Emit code needed at the return-point from an unknown-values call
202 ;;; for a fixed number of values. Values is the head of the TN-REF
203 ;;; list for the locations that the values are to be received into.
204 ;;; Nvals is the number of values that are to be received (should
205 ;;; equal the length of Values).
207 ;;; Move-Temp is a Descriptor-Reg TN used as a temporary.
209 ;;; This code exploits the fact that in the unknown-values convention,
210 ;;; a single value return returns at the return PC + 8, whereas a
211 ;;; return of other than one value returns directly at the return PC.
213 ;;; If 0 or 1 values are expected, then we just emit an instruction to
214 ;;; reset the SP (which will only be executed when other than 1 value
217 ;;; In the general case, we have to do three things:
218 ;;; -- Default unsupplied register values. This need only be done when a
219 ;;; single value is returned, since register values are defaulted by the
220 ;;; called in the non-single case.
221 ;;; -- Default unsupplied stack values. This needs to be done whenever there
222 ;;; are stack values.
223 ;;; -- Reset SP. This must be done whenever other than 1 value is returned,
224 ;;; regardless of the number of values desired.
226 ;;; The general-case code looks like this:
228 b regs-defaulted ; Skip if MVs
231 move a1 null-tn ; Default register values
233 loadi nargs 1 ; Force defaulting of stack values
234 move old-fp csp ; Set up args for SP resetting
237 subcc temp nargs register-arg-count
239 b :lt default-value-7 ; jump to default code
240 loadw move-temp ocfp-tn 6 ; Move value to correct location.
242 store-stack-tn val4-tn move-temp
244 b :lt default-value-8
245 loadw move-temp ocfp-tn 7
247 store-stack-tn val5-tn move-temp
252 move csp ocfp ; Reset SP.
257 store-stack-tn val4-tn null-tn ; Nil out 7'th value. (first on stack)
260 store-stack-tn val5-tn null-tn ; Nil out 8'th value.
267 (defun default-unknown-values (vop values nvals move-temp temp lra-label)
268 (declare (type (or tn-ref null) values)
269 (type unsigned-byte nvals) (type tn move-temp temp))
272 (without-scheduling ()
273 (note-this-location vop :single-value-return)
274 (move csp-tn ocfp-tn)
276 (inst compute-code-from-lra code-tn code-tn lra-label temp))
277 (let ((regs-defaulted (gen-label))
278 (defaulting-done (gen-label))
279 (default-stack-vals (gen-label)))
280 ;; Branch off to the MV case.
281 (without-scheduling ()
282 (note-this-location vop :unknown-return)
283 (inst b regs-defaulted)
284 (if (> nvals register-arg-count)
285 (inst subcc temp nargs-tn (fixnumize register-arg-count))
286 (move csp-tn ocfp-tn)))
288 ;; Do the single value calse.
290 (val (tn-ref-across values) (tn-ref-across val)))
291 ((= i (min nvals register-arg-count)))
292 (move (tn-ref-tn val) null-tn))
293 (when (> nvals register-arg-count)
294 (inst b default-stack-vals)
295 (move ocfp-tn csp-tn))
297 (emit-label regs-defaulted)
298 (when (> nvals register-arg-count)
299 (collect ((defaults))
300 (do ((i register-arg-count (1+ i))
301 (val (do ((i 0 (1+ i))
302 (val values (tn-ref-across val)))
303 ((= i register-arg-count) val))
304 (tn-ref-across val)))
307 (let ((default-lab (gen-label))
308 (tn (tn-ref-tn val)))
309 (defaults (cons default-lab tn))
311 (inst b :le default-lab)
312 (inst ld move-temp ocfp-tn (* i n-word-bytes))
313 (inst subcc temp (fixnumize 1))
314 (store-stack-tn tn move-temp)))
316 (emit-label defaulting-done)
317 (move csp-tn ocfp-tn)
319 (let ((defaults (defaults)))
321 (assemble (*elsewhere*)
322 (emit-label default-stack-vals)
323 (trace-table-entry trace-table-fun-prologue)
324 (do ((remaining defaults (cdr remaining)))
326 (let ((def (car remaining)))
327 (emit-label (car def))
328 (when (null (cdr remaining))
329 (inst b defaulting-done))
330 (store-stack-tn (cdr def) null-tn)))
331 (trace-table-entry trace-table-normal))))))
333 (inst compute-code-from-lra code-tn code-tn lra-label temp)))
337 ;;; Emit code needed at the return point for an unknown-values call
338 ;;; for an arbitrary number of values.
340 ;;; We do the single and non-single cases with no shared code: there
341 ;;; doesn't seem to be any potential overlap, and receiving a single
342 ;;; value is more important efficiency-wise.
344 ;;; When there is a single value, we just push it on the stack,
345 ;;; returning the old SP and 1.
347 ;;; When there is a variable number of values, we move all of the
348 ;;; argument registers onto the stack, and return ARGS and NARGS.
350 ;;; ARGS and NARGS are TNs wired to the named locations. We must
351 ;;; explicitly allocate these TNs, since their lifetimes overlap with
352 ;;; the results START and COUNT. (Also, it's nice to be able to target
354 (defun receive-unknown-values (args nargs start count lra-label temp)
355 (declare (type tn args nargs start count temp))
356 (let ((variable-values (gen-label))
358 (without-scheduling ()
359 (inst b variable-values)
362 (inst compute-code-from-lra code-tn code-tn lra-label temp)
364 (storew (first *register-arg-tns*) csp-tn -1)
365 (inst sub start csp-tn 4)
366 (inst li count (fixnumize 1))
370 (assemble (*elsewhere*)
371 (trace-table-entry trace-table-fun-prologue)
372 (emit-label variable-values)
373 (inst compute-code-from-lra code-tn code-tn lra-label temp)
374 (do ((arg *register-arg-tns* (rest arg))
377 (storew (first arg) args i))
382 (trace-table-entry trace-table-normal)))
386 ;;; VOP that can be inherited by unknown values receivers. The main
387 ;;; thing this handles is allocation of the result temporaries.
388 (define-vop (unknown-values-receiver)
390 (start :scs (any-reg))
391 (count :scs (any-reg)))
392 (:temporary (:sc descriptor-reg :offset ocfp-offset
393 :from :eval :to (:result 0))
395 (:temporary (:sc any-reg :offset nargs-offset
396 :from :eval :to (:result 1))
398 (:temporary (:scs (non-descriptor-reg)) temp))
401 ;;; This hook in the codegen pass lets us insert code before fall-thru entry
402 ;;; points, local-call entry points, and tail-call entry points. The default
404 (defun emit-block-header (start-label trampoline-label fall-thru-p alignp)
405 (declare (ignore fall-thru-p alignp))
406 (when trampoline-label
407 (emit-label trampoline-label))
408 (emit-label start-label))
411 ;;;; Local call with unknown values convention return:
413 ;;; Non-TR local call for a fixed number of values passed according to the
414 ;;; unknown values convention.
416 ;;; Args are the argument passing locations, which are specified only to
417 ;;; terminate their lifetimes in the caller.
419 ;;; Values are the return value locations (wired to the standard passing
422 ;;; Save is the save info, which we can ignore since saving has been done.
423 ;;; Return-PC is the TN that the return PC should be passed in.
424 ;;; Target is a continuation pointing to the start of the called function.
425 ;;; Nvals is the number of values received.
427 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
428 ;;; registers may be tied up by the more operand. Instead, we use
429 ;;; MAYBE-LOAD-STACK-TN.
430 (define-vop (call-local)
434 (:results (values :more t))
436 (:move-args :local-call)
437 (:info arg-locs callee target nvals)
439 (:temporary (:scs (descriptor-reg) :from (:eval 0)) move-temp)
440 (:temporary (:scs (non-descriptor-reg)) temp)
441 (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)
442 (:temporary (:sc any-reg :offset ocfp-offset :from (:eval 0)) ocfp)
443 (:ignore arg-locs args ocfp)
445 (trace-table-entry trace-table-call-site)
446 (let ((label (gen-label))
447 (cur-nfp (current-nfp-tn vop)))
449 (store-stack-tn nfp-save cur-nfp))
450 (let ((callee-nfp (callee-nfp-tn callee)))
452 (maybe-load-stack-tn callee-nfp nfp)))
453 (maybe-load-stack-tn cfp-tn fp)
454 (inst compute-lra-from-code
455 (callee-return-pc-tn callee) code-tn label temp)
456 (note-this-location vop :call-site)
459 (emit-return-pc label)
460 (default-unknown-values vop values nvals move-temp temp label)
462 (load-stack-tn cur-nfp nfp-save)))
463 (trace-table-entry trace-table-normal)))
466 ;;; Non-TR local call for a variable number of return values passed according
467 ;;; to the unknown values convention. The results are the start of the values
468 ;;; glob and the number of values received.
470 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
471 ;;; registers may be tied up by the more operand. Instead, we use
472 ;;; MAYBE-LOAD-STACK-TN.
473 (define-vop (multiple-call-local unknown-values-receiver)
478 (:move-args :local-call)
479 (:info save callee target)
482 (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)
484 (trace-table-entry trace-table-call-site)
485 (let ((label (gen-label))
486 (cur-nfp (current-nfp-tn vop)))
488 (store-stack-tn nfp-save cur-nfp))
489 (let ((callee-nfp (callee-nfp-tn callee)))
491 (maybe-load-stack-tn callee-nfp nfp)))
492 (maybe-load-stack-tn cfp-tn fp)
493 (inst compute-lra-from-code
494 (callee-return-pc-tn callee) code-tn label temp)
495 (note-this-location vop :call-site)
498 (emit-return-pc label)
499 (note-this-location vop :unknown-return)
500 (receive-unknown-values values-start nvals start count label temp)
502 (load-stack-tn cur-nfp nfp-save)))
503 (trace-table-entry trace-table-normal)))
506 ;;;; Local call with known values return:
508 ;;; Non-TR local call with known return locations. Known-value return works
509 ;;; just like argument passing in local call.
511 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
512 ;;; registers may be tied up by the more operand. Instead, we use
513 ;;; MAYBE-LOAD-STACK-TN.
514 (define-vop (known-call-local)
518 (:results (res :more t))
519 (:move-args :local-call)
521 (:info save callee target)
522 (:ignore args res save)
524 (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)
525 (:temporary (:scs (non-descriptor-reg)) temp)
527 (trace-table-entry trace-table-call-site)
528 (let ((label (gen-label))
529 (cur-nfp (current-nfp-tn vop)))
531 (store-stack-tn nfp-save cur-nfp))
532 (let ((callee-nfp (callee-nfp-tn callee)))
534 (maybe-load-stack-tn callee-nfp nfp)))
535 (maybe-load-stack-tn cfp-tn fp)
536 (inst compute-lra-from-code
537 (callee-return-pc-tn callee) code-tn label temp)
538 (note-this-location vop :call-site)
541 (emit-return-pc label)
542 (note-this-location vop :known-return)
544 (load-stack-tn cur-nfp nfp-save)))
545 (trace-table-entry trace-table-normal)))
547 ;;; Return from known values call. We receive the return locations as
548 ;;; arguments to terminate their lifetimes in the returning function. We
549 ;;; restore FP and CSP and jump to the Return-PC.
551 ;;; Note: we can't use normal load-tn allocation for the fixed args, since all
552 ;;; registers may be tied up by the more operand. Instead, we use
553 ;;; MAYBE-LOAD-STACK-TN.
554 (define-vop (known-return)
555 (:args (old-fp :target old-fp-temp)
556 (return-pc :target return-pc-temp)
558 (:temporary (:sc any-reg :from (:argument 0)) old-fp-temp)
559 (:temporary (:sc descriptor-reg :from (:argument 1)) return-pc-temp)
560 (:move-args :known-return)
562 (:ignore val-locs vals)
565 (trace-table-entry trace-table-fun-epilogue)
566 (maybe-load-stack-tn old-fp-temp old-fp)
567 (maybe-load-stack-tn return-pc-temp return-pc)
569 (let ((cur-nfp (current-nfp-tn vop)))
571 (inst add nsp-tn cur-nfp
572 (- (bytes-needed-for-non-descriptor-stack-frame)
573 number-stack-displacement))))
574 (inst j return-pc-temp (- n-word-bytes other-pointer-lowtag))
575 (move cfp-tn old-fp-temp)
576 (trace-table-entry trace-table-normal)))
581 ;;; There is something of a cross-product effect with full calls.
582 ;;; Different versions are used depending on whether we know the
583 ;;; number of arguments or the name of the called function, and
584 ;;; whether we want fixed values, unknown values, or a tail call.
586 ;;; In full call, the arguments are passed creating a partial frame on
587 ;;; the stack top and storing stack arguments into that frame. On
588 ;;; entry to the callee, this partial frame is pointed to by FP. If
589 ;;; there are no stack arguments, we don't bother allocating a partial
590 ;;; frame, and instead set FP to SP just before the call.
592 ;;; This macro helps in the definition of full call VOPs by avoiding code
593 ;;; replication in defining the cross-product VOPs.
595 ;;; Name is the name of the VOP to define.
597 ;;; Named is true if the first argument is a symbol whose global function
598 ;;; definition is to be called.
600 ;;; Return is either :Fixed, :Unknown or :Tail:
601 ;;; -- If :Fixed, then the call is for a fixed number of values, returned in
602 ;;; the standard passing locations (passed as result operands).
603 ;;; -- If :Unknown, then the result values are pushed on the stack, and the
604 ;;; result values are specified by the Start and Count as in the
605 ;;; unknown-values continuation representation.
606 ;;; -- If :Tail, then do a tail-recursive call. No values are returned.
607 ;;; The Old-Fp and Return-PC are passed as the second and third arguments.
609 ;;; In non-tail calls, the pointer to the stack arguments is passed as the last
610 ;;; fixed argument. If Variable is false, then the passing locations are
611 ;;; passed as a more arg. Variable is true if there are a variable number of
612 ;;; arguments passed on the stack. Variable cannot be specified with :Tail
613 ;;; return. TR variable argument call is implemented separately.
615 ;;; In tail call with fixed arguments, the passing locations are passed as a
616 ;;; more arg, but there is no new-FP, since the arguments have been set up in
617 ;;; the current frame.
618 (defmacro define-full-call (name named return variable)
619 (aver (not (and variable (eq return :tail))))
621 ,@(when (eq return :unknown)
622 '(unknown-values-receiver)))
624 ,@(unless (eq return :tail)
625 '((new-fp :scs (any-reg) :to :eval)))
628 '(name :target name-pass)
629 '(arg-fun :target lexenv))
631 ,@(when (eq return :tail)
632 '((old-fp :target old-fp-pass)
633 (return-pc :target return-pc-pass)))
635 ,@(unless variable '((args :more t :scs (descriptor-reg)))))
637 ,@(when (eq return :fixed)
638 '((:results (values :more t))))
640 (:save-p ,(if (eq return :tail) :compute-only t))
642 ,@(unless (or (eq return :tail) variable)
643 '((:move-args :full-call)))
646 (:info ,@(unless (or variable (eq return :tail)) '(arg-locs))
647 ,@(unless variable '(nargs))
648 ,@(when (eq return :fixed) '(nvals))
652 ,@(unless (or variable (eq return :tail)) '(arg-locs))
653 ,@(unless variable '(args)))
655 (:temporary (:sc descriptor-reg
658 ,@(unless (eq return :fixed)
662 (:temporary (:sc descriptor-reg
664 :from (:argument ,(if (eq return :tail) 2 1))
669 `(:temporary (:sc descriptor-reg :offset cname-offset
670 :from (:argument ,(if (eq return :tail) 0 1))
673 `(:temporary (:sc descriptor-reg :offset lexenv-offset
674 :from (:argument ,(if (eq return :tail) 0 1))
678 (:temporary (:scs (descriptor-reg) :from (:argument 0) :to :eval)
680 (:temporary (:sc any-reg :offset nargs-offset :to :eval)
684 (mapcar #'(lambda (name offset)
685 `(:temporary (:sc descriptor-reg
689 register-arg-names *register-arg-offsets*))
690 ,@(when (eq return :fixed)
691 '((:temporary (:scs (descriptor-reg) :from :eval) move-temp)))
693 (:temporary (:scs (descriptor-reg) :to :eval) stepping)
695 ,@(unless (eq return :tail)
696 '((:temporary (:scs (non-descriptor-reg)) temp)
697 (:temporary (:sc control-stack :offset nfp-save-offset) nfp-save)))
699 (:generator ,(+ (if named 5 0)
701 (if (eq return :tail) 0 10)
703 (if (eq return :unknown) 25 0))
704 (trace-table-entry trace-table-call-site)
705 (let* ((cur-nfp (current-nfp-tn vop))
706 ,@(unless (eq return :tail)
707 '((lra-label (gen-label))))
708 (step-done-label (gen-label))
712 ,@(if (eq return :tail)
713 '((unless (location= old-fp old-fp-pass)
715 (unless (location= return-pc
725 (flet ((do-next-filler ()
726 (let* ((next (pop filler))
727 (what (if (consp next) (car next) next)))
731 `((inst sub nargs-pass csp-tn new-fp)
733 (mapcar #'(lambda (name)
736 register-arg-names)))
737 '((inst li nargs-pass (fixnumize nargs)))))
738 ,@(if (eq return :tail)
742 (inst move old-fp-pass old-fp))
744 (loadw old-fp-pass cfp-tn
745 (tn-offset old-fp)))))
749 (inst move return-pc-pass return-pc))
751 (loadw return-pc-pass cfp-tn
752 (tn-offset return-pc)))))
754 (inst add nsp-tn cur-nfp
755 (- (bytes-needed-for-non-descriptor-stack-frame)
756 number-stack-displacement))))
758 (inst compute-lra-from-code
759 return-pc-pass code-tn lra-label temp))
761 (store-stack-tn nfp-save cur-nfp))
763 (inst move old-fp-pass cfp-tn))
766 '(move cfp-tn new-fp)
767 '(if (> nargs register-arg-count)
769 (move cfp-tn csp-tn))))))
771 (insert-step-instrumenting (callable-tn)
772 ;; Conditionally insert a conditional trap:
773 (when step-instrumenting
774 ;; Get the symbol-value of SB!IMPL::*STEPPING*
775 (load-symbol-value stepping sb!impl::*stepping*)
776 (inst cmp stepping null-tn)
777 ;; If it's not null, trap.
778 (inst b :eq step-done-label)
780 ;; FIXME: this doesn't look right.
781 (note-this-location vop :step-before-vop)
782 ;; Construct a trap code with the low bits from
783 ;; SINGLE-STEP-AROUND-TRAP and the high bits from
784 ;; the register number of CALLABLE-TN.
785 (inst unimp (logior single-step-around-trap
786 (ash (reg-tn-encoding callable-tn)
788 (emit-label step-done-label))))
793 (descriptor-reg (move name-pass name))
795 (loadw name-pass cfp-tn (tn-offset name))
798 (loadw name-pass code-tn (tn-offset name)
799 other-pointer-lowtag)
801 (insert-step-instrumenting name-pass)
802 (loadw function name-pass fdefn-raw-addr-slot
803 other-pointer-lowtag)
806 (descriptor-reg (move lexenv arg-fun))
808 (loadw lexenv cfp-tn (tn-offset arg-fun))
811 (loadw lexenv code-tn (tn-offset arg-fun)
812 other-pointer-lowtag)
814 (loadw function lexenv closure-fun-slot
817 (insert-step-instrumenting function)))
823 (note-this-location vop :call-site)
825 (- (ash simple-fun-code-offset word-shift)
827 (inst move code-tn function))
831 '((emit-return-pc lra-label)
832 (default-unknown-values vop values nvals move-temp
835 (load-stack-tn cur-nfp nfp-save))))
837 '((emit-return-pc lra-label)
838 (note-this-location vop :unknown-return)
839 (receive-unknown-values values-start nvals start count
842 (load-stack-tn cur-nfp nfp-save))))
844 (trace-table-entry trace-table-normal))))
847 (define-full-call call nil :fixed nil)
848 (define-full-call call-named t :fixed nil)
849 (define-full-call multiple-call nil :unknown nil)
850 (define-full-call multiple-call-named t :unknown nil)
851 (define-full-call tail-call nil :tail nil)
852 (define-full-call tail-call-named t :tail nil)
854 (define-full-call call-variable nil :fixed t)
855 (define-full-call multiple-call-variable nil :unknown t)
858 ;;; Defined separately, since needs special code that BLT's the
860 (define-vop (tail-call-variable)
862 (args-arg :scs (any-reg) :target args)
863 (function-arg :scs (descriptor-reg) :target lexenv)
864 (old-fp-arg :scs (any-reg) :target old-fp)
865 (lra-arg :scs (descriptor-reg) :target lra))
867 (:temporary (:sc any-reg :offset nl0-offset :from (:argument 0)) args)
868 (:temporary (:sc any-reg :offset lexenv-offset :from (:argument 1)) lexenv)
869 (:temporary (:sc any-reg :offset ocfp-offset :from (:argument 2)) old-fp)
870 (:temporary (:sc any-reg :offset lra-offset :from (:argument 3)) lra)
872 (:temporary (:scs (any-reg) :from :eval) temp)
878 ;; Move these into the passing locations if they are not already there.
880 (move lexenv function-arg)
881 (move old-fp old-fp-arg)
884 ;; Clear the number stack if anything is there.
885 (let ((cur-nfp (current-nfp-tn vop)))
887 (inst add nsp-tn cur-nfp
888 (- (bytes-needed-for-non-descriptor-stack-frame)
889 number-stack-displacement))))
891 ;; And jump to the assembly-routine that does the bliting.
892 (inst ji temp (make-fixup 'tail-call-variable :assembly-routine))
896 ;;;; Unknown values return:
899 ;;; Return a single value using the unknown-values convention.
900 (define-vop (return-single)
901 (:args (old-fp :scs (any-reg))
902 (return-pc :scs (descriptor-reg))
907 (trace-table-entry trace-table-fun-epilogue)
908 ;; Clear the number stack.
909 (let ((cur-nfp (current-nfp-tn vop)))
911 (inst add nsp-tn cur-nfp
912 (- (bytes-needed-for-non-descriptor-stack-frame)
913 number-stack-displacement))))
914 ;; Clear the control stack, and restore the frame pointer.
918 (lisp-return return-pc :offset 2)
919 (trace-table-entry trace-table-normal)))
921 ;;; Do unknown-values return of a fixed number of values. The Values are
922 ;;; required to be set up in the standard passing locations. Nvals is the
923 ;;; number of values returned.
925 ;;; If returning a single value, then deallocate the current frame, restore
926 ;;; FP and jump to the single-value entry at Return-PC + 8.
928 ;;; If returning other than one value, then load the number of values returned,
929 ;;; NIL out unsupplied values registers, restore FP and return at Return-PC.
930 ;;; When there are stack values, we must initialize the argument pointer to
931 ;;; point to the beginning of the values block (which is the beginning of the
935 (old-fp :scs (any-reg))
936 (return-pc :scs (descriptor-reg) :to (:eval 1))
940 (:temporary (:sc descriptor-reg :offset a0-offset :from (:eval 0)) a0)
941 (:temporary (:sc descriptor-reg :offset a1-offset :from (:eval 0)) a1)
942 (:temporary (:sc descriptor-reg :offset a2-offset :from (:eval 0)) a2)
943 (:temporary (:sc descriptor-reg :offset a3-offset :from (:eval 0)) a3)
944 (:temporary (:sc descriptor-reg :offset a4-offset :from (:eval 0)) a4)
945 (:temporary (:sc descriptor-reg :offset a5-offset :from (:eval 0)) a5)
946 (:temporary (:sc any-reg :offset nargs-offset) nargs)
947 (:temporary (:sc any-reg :offset ocfp-offset) val-ptr)
950 (trace-table-entry trace-table-fun-epilogue)
951 ;; Clear the number stack.
952 (let ((cur-nfp (current-nfp-tn vop)))
954 (inst add nsp-tn cur-nfp
955 (- (bytes-needed-for-non-descriptor-stack-frame)
956 number-stack-displacement))))
958 ;; Clear the control stack, and restore the frame pointer.
962 (lisp-return return-pc :offset 2))
964 ;; Establish the values pointer and values count.
965 (move val-ptr cfp-tn)
966 (inst li nargs (fixnumize nvals))
967 ;; restore the frame pointer and clear as much of the control
968 ;; stack as possible.
970 (inst add csp-tn val-ptr (* nvals n-word-bytes))
971 ;; pre-default any argument register that need it.
972 (when (< nvals register-arg-count)
973 (dolist (reg (subseq (list a0 a1 a2 a3 a4 a5) nvals))
976 (lisp-return return-pc)))
977 (trace-table-entry trace-table-normal)))
979 ;;; Do unknown-values return of an arbitrary number of values (passed on the
980 ;;; stack.) We check for the common case of a single return value, and do that
981 ;;; inline using the normal single value return convention. Otherwise, we
982 ;;; branch off to code that calls an assembly-routine.
983 (define-vop (return-multiple)
985 (old-fp-arg :scs (any-reg) :to (:eval 1))
986 (lra-arg :scs (descriptor-reg) :to (:eval 1))
987 (vals-arg :scs (any-reg) :target vals)
988 (nvals-arg :scs (any-reg) :target nvals))
990 (:temporary (:sc any-reg :offset nl1-offset :from (:argument 0)) old-fp)
991 (:temporary (:sc descriptor-reg :offset lra-offset :from (:argument 1)) lra)
992 (:temporary (:sc any-reg :offset nl0-offset :from (:argument 2)) vals)
993 (:temporary (:sc any-reg :offset nargs-offset :from (:argument 3)) nvals)
994 (:temporary (:sc descriptor-reg :offset a0-offset) a0)
996 (:temporary (:scs (any-reg) :from (:eval 1)) temp)
1001 (trace-table-entry trace-table-fun-epilogue)
1002 (let ((not-single (gen-label)))
1003 ;; Clear the number stack.
1004 (let ((cur-nfp (current-nfp-tn vop)))
1006 (inst add nsp-tn cur-nfp
1007 (- (bytes-needed-for-non-descriptor-stack-frame)
1008 number-stack-displacement))))
1010 ;; Check for the single case.
1011 (inst cmp nvals-arg (fixnumize 1))
1012 (inst b :ne not-single)
1013 (inst ld a0 vals-arg)
1015 ;; Return with one value.
1016 (move csp-tn cfp-tn)
1017 (move cfp-tn old-fp-arg)
1018 (lisp-return lra-arg :offset 2)
1020 ;; Nope, not the single case.
1021 (emit-label not-single)
1022 (move old-fp old-fp-arg)
1024 (move vals vals-arg)
1025 (move nvals nvals-arg)
1026 (inst ji temp (make-fixup 'return-multiple :assembly-routine))
1028 (trace-table-entry trace-table-normal)))
1035 ;;; We don't need to do anything special for regular functions.
1036 (define-vop (setup-environment)
1040 ;; Don't bother doing anything.
1043 ;;; Get the lexical environment from it's passing location.
1044 (define-vop (setup-closure-environment)
1045 (:temporary (:sc descriptor-reg :offset lexenv-offset :target closure
1048 (:results (closure :scs (descriptor-reg)))
1053 (move closure lexenv)))
1055 ;;; Copy a more arg from the argument area to the end of the current frame.
1056 ;;; Fixed is the number of non-more arguments.
1057 (define-vop (copy-more-arg)
1058 (:temporary (:sc any-reg :offset nl0-offset) result)
1059 (:temporary (:sc any-reg :offset nl1-offset) count)
1060 (:temporary (:sc any-reg :offset nl2-offset) src)
1061 (:temporary (:sc any-reg :offset nl3-offset) dst)
1062 (:temporary (:sc descriptor-reg :offset l0-offset) temp)
1065 (let ((loop (gen-label))
1066 (do-regs (gen-label))
1068 (when (< fixed register-arg-count)
1069 ;; Save a pointer to the results so we can fill in register args.
1070 ;; We don't need this if there are more fixed args than reg args.
1071 (move result csp-tn))
1072 ;; Allocate the space on the stack.
1073 (cond ((zerop fixed)
1076 (inst add csp-tn csp-tn nargs-tn))
1078 (inst subcc count nargs-tn (fixnumize fixed))
1081 (inst add csp-tn csp-tn count)))
1082 (when (< fixed register-arg-count)
1083 ;; We must stop when we run out of stack args, not when we run out of
1085 (inst subcc count nargs-tn (fixnumize register-arg-count))
1086 ;; Everything of interest in registers.
1087 (inst b :le do-regs))
1088 ;; Initialize dst to be end of stack.
1090 ;; Initialize src to be end of args.
1091 (inst add src cfp-tn nargs-tn)
1094 ;; *--dst = *--src, --count
1095 (inst add src src (- n-word-bytes))
1096 (inst subcc count count (fixnumize 1))
1098 (inst add dst dst (- n-word-bytes))
1102 (emit-label do-regs)
1103 (when (< fixed register-arg-count)
1104 ;; Now we have to deposit any more args that showed up in registers.
1105 (inst subcc count nargs-tn (fixnumize fixed))
1106 (do ((i fixed (1+ i)))
1107 ((>= i register-arg-count))
1108 ;; Don't deposit any more than there are.
1110 (inst subcc count (fixnumize 1))
1111 ;; Store it relative to the pointer saved at the start.
1112 (storew (nth i *register-arg-tns*) result (- i fixed))))
1113 (emit-label done))))
1116 ;;; More args are stored consequtively on the stack, starting immediately at
1117 ;;; the context pointer. The context pointer is not typed, so the lowtag is 0.
1118 (define-vop (more-arg word-index-ref)
1120 (:translate %more-arg))
1122 ;;; Turn more arg (context, count) into a list.
1123 (define-vop (listify-rest-args)
1124 (:args (context-arg :target context :scs (descriptor-reg))
1125 (count-arg :target count :scs (any-reg)))
1126 (:arg-types * tagged-num)
1127 (:temporary (:scs (any-reg) :from (:argument 0)) context)
1128 (:temporary (:scs (any-reg) :from (:argument 1)) count)
1129 (:temporary (:scs (descriptor-reg) :from :eval) temp)
1130 (:temporary (:scs (non-descriptor-reg) :from :eval) dst)
1131 (:results (result :scs (descriptor-reg)))
1132 (:translate %listify-rest-args)
1136 (let* ((enter (gen-label))
1139 (dx-p (node-stack-allocate-p node)))
1140 (move context context-arg)
1141 (move count count-arg)
1142 ;; Check to see if there are any arguments.
1145 (move result null-tn)
1147 ;; We need to do this atomically.
1149 ;; Allocate a cons (2 words) for each item.
1150 (inst sll temp count 1)
1151 (allocation result temp list-pointer-lowtag
1157 ;; Compute the next cons and store it in the current one.
1159 (inst add dst dst (* 2 n-word-bytes))
1160 (storew dst dst -1 list-pointer-lowtag)
1164 (loadw temp context)
1165 (inst add context context n-word-bytes)
1167 ;; Dec count, and if != zero, go back for more.
1168 (inst subcc count (fixnumize 1))
1171 ;; Store the value into the car of the current cons (in the delay
1173 (storew temp dst 0 list-pointer-lowtag)
1175 ;; NIL out the last cons.
1176 (storew null-tn dst 1 list-pointer-lowtag))
1177 (emit-label done))))
1180 ;;; Return the location and size of the more arg glob created by Copy-More-Arg.
1181 ;;; Supplied is the total number of arguments supplied (originally passed in
1182 ;;; NARGS.) Fixed is the number of non-rest arguments.
1184 ;;; We must duplicate some of the work done by Copy-More-Arg, since at that
1185 ;;; time the environment is in a pretty brain-damaged state, preventing this
1186 ;;; info from being returned as values. What we do is compute
1187 ;;; supplied - fixed, and return a pointer that many words below the current
1189 (define-vop (more-arg-context)
1190 (:policy :fast-safe)
1191 (:translate sb!c::%more-arg-context)
1192 (:args (supplied :scs (any-reg)))
1193 (:arg-types tagged-num (:constant fixnum))
1195 (:results (context :scs (descriptor-reg))
1196 (count :scs (any-reg)))
1197 (:result-types t tagged-num)
1198 (:note "more-arg-context")
1200 (inst sub count supplied (fixnumize fixed))
1201 (inst sub context csp-tn count)))
1204 ;;; Signal wrong argument count error if Nargs isn't = to Count.
1206 (define-vop (verify-arg-count)
1207 (:policy :fast-safe)
1208 (:translate sb!c::%verify-arg-count)
1209 (:args (nargs :scs (any-reg)))
1210 (:arg-types positive-fixnum (:constant t))
1213 (:save-p :compute-only)
1216 (generate-error-code vop invalid-arg-count-error nargs)))
1217 (inst cmp nargs (fixnumize count))
1218 (if (member :sparc-v9 *backend-subfeatures*)
1219 ;; Assume we don't take the branch
1220 (inst b :ne err-lab :pn)
1221 (inst b :ne err-lab))
1224 ;;; Signal various errors.
1225 (macrolet ((frob (name error translate &rest args)
1226 `(define-vop (,name)
1228 `((:policy :fast-safe)
1229 (:translate ,translate)))
1230 (:args ,@(mapcar #'(lambda (arg)
1231 `(,arg :scs (any-reg descriptor-reg)))
1234 (:save-p :compute-only)
1236 (error-call vop ,error ,@args)))))
1237 (frob arg-count-error invalid-arg-count-error
1238 sb!c::%arg-count-error nargs)
1239 (frob type-check-error object-not-type-error sb!c::%type-check-error
1241 (frob layout-invalid-error layout-invalid-error sb!c::%layout-invalid-error
1243 (frob odd-key-args-error odd-key-args-error
1244 sb!c::%odd-key-args-error)
1245 (frob unknown-key-arg-error unknown-key-arg-error
1246 sb!c::%unknown-key-arg-error key)
1247 (frob nil-fun-returned-error nil-fun-returned-error nil fun))
1251 (define-vop (step-instrument-before-vop)
1252 (:temporary (:scs (descriptor-reg)) stepping)
1253 (:policy :fast-safe)
1256 (load-symbol-value stepping sb!impl::*stepping*)
1257 (inst cmp stepping null-tn)
1260 (note-this-location vop :step-before-vop)
1261 (inst unimp single-step-before-trap)