src/compiler/alpha/call.lisp

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