Typo fixes in comments
[sbcl.git] / src / compiler / pack.lisp
1 ;;;; This file contains the implementation-independent code for Pack
2 ;;;; phase in the compiler. Pack is responsible for assigning TNs to
3 ;;;; storage allocations or "register allocation".
4
5 ;;;; This software is part of the SBCL system. See the README file for
6 ;;;; more information.
7 ;;;;
8 ;;;; This software is derived from the CMU CL system, which was
9 ;;;; written at Carnegie Mellon University and released into the
10 ;;;; public domain. The software is in the public domain and is
11 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
12 ;;;; files for more information.
13
14 (in-package "SB!C")
15
16 ;;; for debugging: some parameters controlling which optimizations we
17 ;;; attempt
18 (defvar *pack-assign-costs* t)
19 (defvar *pack-optimize-saves* t)
20 ;;; FIXME: Perhaps SB-FLUID should be renamed to SB-TWEAK and these
21 ;;; should be made conditional on SB-TWEAK.
22
23 (declaim (ftype (function (component) index) ir2-block-count))
24 \f
25 ;;;; conflict determination
26
27 ;;; Return true if the element at the specified offset in SB has a
28 ;;; conflict with TN:
29 ;;; -- If a component-live TN (:COMPONENT kind), then iterate over
30 ;;;    all the blocks. If the element at OFFSET is used anywhere in
31 ;;;    any of the component's blocks (always-live /= 0), then there
32 ;;;    is a conflict.
33 ;;; -- If TN is global (Confs true), then iterate over the blocks TN
34 ;;;    is live in (using TN-GLOBAL-CONFLICTS). If the TN is live
35 ;;;    everywhere in the block (:LIVE), then there is a conflict
36 ;;;    if the element at offset is used anywhere in the block
37 ;;;    (Always-Live /= 0). Otherwise, we use the local TN number for
38 ;;;    TN in block to find whether TN has a conflict at Offset in
39 ;;;    that block.
40 ;;; -- If TN is local, then we just check for a conflict in the block
41 ;;;    it is local to.
42 (defun offset-conflicts-in-sb (tn sb offset)
43   (declare (type tn tn) (type finite-sb sb) (type index offset))
44   (let ((confs (tn-global-conflicts tn))
45         (kind (tn-kind tn)))
46     (cond
47      ((eq kind :component)
48       (let ((loc-live (svref (finite-sb-always-live sb) offset)))
49         (dotimes (i (ir2-block-count *component-being-compiled*) nil)
50           (when (/= (sbit loc-live i) 0)
51             (return t)))))
52      (confs
53       (let ((loc-confs (svref (finite-sb-conflicts sb) offset))
54             (loc-live (svref (finite-sb-always-live sb) offset)))
55         (do ((conf confs (global-conflicts-next-tnwise conf)))
56             ((null conf)
57              nil)
58           (let* ((block (global-conflicts-block conf))
59                  (num (ir2-block-number block)))
60             (if (eq (global-conflicts-kind conf) :live)
61                 (when (/= (sbit loc-live num) 0)
62                   (return t))
63                 (when (/= (sbit (svref loc-confs num)
64                                 (global-conflicts-number conf))
65                           0)
66                   (return t)))))))
67      (t
68       (/= (sbit (svref (svref (finite-sb-conflicts sb) offset)
69                        (ir2-block-number (tn-local tn)))
70                 (tn-local-number tn))
71           0)))))
72
73 ;;; Return true if TN has a conflict in SC at the specified offset.
74 (defun conflicts-in-sc (tn sc offset)
75   (declare (type tn tn) (type sc sc) (type index offset))
76   (let ((sb (sc-sb sc)))
77     (dotimes (i (sc-element-size sc) nil)
78       (when (offset-conflicts-in-sb tn sb (+ offset i))
79         (return t)))))
80
81 ;;; Add TN's conflicts into the conflicts for the location at OFFSET
82 ;;; in SC. We iterate over each location in TN, adding to the
83 ;;; conflicts for that location:
84 ;;; -- If TN is a :COMPONENT TN, then iterate over all the blocks,
85 ;;;    setting all of the local conflict bits and the always-live bit.
86 ;;;    This records a conflict with any TN that has a LTN number in
87 ;;;    the block, as well as with :ALWAYS-LIVE and :ENVIRONMENT TNs.
88 ;;; -- If TN is global, then iterate over the blocks TN is live in. In
89 ;;;    addition to setting the always-live bit to represent the conflict
90 ;;;    with TNs live throughout the block, we also set bits in the
91 ;;;    local conflicts. If TN is :ALWAYS-LIVE in the block, we set all
92 ;;;    the bits, otherwise we OR in the local conflict bits.
93 ;;; -- If the TN is local, then we just do the block it is local to,
94 ;;;    setting always-live and OR'ing in the local conflicts.
95 (defun add-location-conflicts (tn sc offset optimize)
96   (declare (type tn tn) (type sc sc) (type index offset))
97   (let ((confs (tn-global-conflicts tn))
98         (sb (sc-sb sc))
99         (kind (tn-kind tn)))
100     (dotimes (i (sc-element-size sc))
101       (declare (type index i))
102       (let* ((this-offset (+ offset i))
103              (loc-confs (svref (finite-sb-conflicts sb) this-offset))
104              (loc-live (svref (finite-sb-always-live sb) this-offset)))
105         (cond
106          ((eq kind :component)
107           (dotimes (num (ir2-block-count *component-being-compiled*))
108             (declare (type index num))
109             (setf (sbit loc-live num) 1)
110             (set-bit-vector (svref loc-confs num))))
111          (confs
112           (do ((conf confs (global-conflicts-next-tnwise conf)))
113               ((null conf))
114             (let* ((block (global-conflicts-block conf))
115                    (num (ir2-block-number block))
116                    (local-confs (svref loc-confs num)))
117               (declare (type local-tn-bit-vector local-confs))
118               (setf (sbit loc-live num) 1)
119               (if (eq (global-conflicts-kind conf) :live)
120                   (set-bit-vector local-confs)
121                   (bit-ior local-confs (global-conflicts-conflicts conf) t)))))
122          (t
123           (let ((num (ir2-block-number (tn-local tn))))
124             (setf (sbit loc-live num) 1)
125             (bit-ior (the local-tn-bit-vector (svref loc-confs num))
126                      (tn-local-conflicts tn) t))))
127         ;; Calculating ALWAYS-LIVE-COUNT is moderately expensive, and
128         ;; currently the information isn't used unless (> SPEED
129         ;; COMPILE-SPEED).
130         (when optimize
131           (setf (svref (finite-sb-always-live-count sb) this-offset)
132                 (find-location-usage sb this-offset))))))
133   (values))
134
135 ;; A rought measure of how much a given OFFSET in SB is currently
136 ;; used. Current implementation counts the amount of blocks where the
137 ;; offset has been marked as ALWAYS-LIVE.
138 (defun find-location-usage (sb offset)
139   (declare (optimize speed))
140   (declare (type sb sb) (type index offset))
141   (let* ((always-live (svref (finite-sb-always-live sb) offset)))
142     (declare (simple-bit-vector always-live))
143     (count 1 always-live)))
144
145 ;;; Return the total number of IR2-BLOCKs in COMPONENT.
146 (defun ir2-block-count (component)
147   (declare (type component component))
148   (do ((2block (block-info (block-next (component-head component)))
149                (ir2-block-next 2block)))
150       ((null 2block)
151        (error "What?  No ir2 blocks have a non-nil number?"))
152     (when (ir2-block-number 2block)
153       (return (1+ (ir2-block-number 2block))))))
154
155 ;;; Ensure that the conflicts vectors for each :FINITE SB are large
156 ;;; enough for the number of blocks allocated. Also clear any old
157 ;;; conflicts and reset the current size to the initial size.
158 (defun init-sb-vectors (component)
159   (let ((nblocks (ir2-block-count component)))
160     (dolist (sb *backend-sb-list*)
161       (unless (eq (sb-kind sb) :non-packed)
162         (let* ((conflicts (finite-sb-conflicts sb))
163                (always-live (finite-sb-always-live sb))
164                (always-live-count (finite-sb-always-live-count sb))
165                (max-locs (length conflicts))
166                (last-count (finite-sb-last-block-count sb)))
167           (unless (zerop max-locs)
168             (let ((current-size (length (the simple-vector
169                                              (svref conflicts 0)))))
170               (cond
171                ((> nblocks current-size)
172                 (let ((new-size (max nblocks (* current-size 2))))
173                   (declare (type index new-size))
174                   (dotimes (i max-locs)
175                     (declare (type index i))
176                     (let ((new-vec (make-array new-size)))
177                       (let ((old (svref conflicts i)))
178                         (declare (simple-vector old))
179                         (dotimes (j current-size)
180                           (declare (type index j))
181                           (setf (svref new-vec j)
182                                 (clear-bit-vector (svref old j)))))
183
184                       (do ((j current-size (1+ j)))
185                           ((= j new-size))
186                         (declare (type index j))
187                         (setf (svref new-vec j)
188                               (make-array local-tn-limit :element-type 'bit
189                                           :initial-element 0)))
190                       (setf (svref conflicts i) new-vec))
191                     (setf (svref always-live i)
192                           (make-array new-size :element-type 'bit
193                                       :initial-element 0))
194                     (setf (svref always-live-count i) 0))))
195                (t
196                 (dotimes (i (finite-sb-current-size sb))
197                   (declare (type index i))
198                   (let ((conf (svref conflicts i)))
199                     (declare (simple-vector conf))
200                     (dotimes (j last-count)
201                       (declare (type index j))
202                       (clear-bit-vector (svref conf j))))
203                   (clear-bit-vector (svref always-live i))
204                   (setf (svref always-live-count i) 0))))))
205
206           (setf (finite-sb-last-block-count sb) nblocks)
207           (setf (finite-sb-current-size sb) (sb-size sb))
208           (setf (finite-sb-last-offset sb) 0))))))
209
210 ;;; Expand the :UNBOUNDED SB backing SC by either the initial size or
211 ;;; the SC element size, whichever is larger. If NEEDED-SIZE is
212 ;;; larger, then use that size.
213 (defun grow-sc (sc &optional (needed-size 0))
214   (declare (type sc sc) (type index needed-size))
215   (let* ((sb (sc-sb sc))
216          (size (finite-sb-current-size sb))
217          (align-mask (1- (sc-alignment sc)))
218          (inc (max (sb-size sb)
219                    (+ (sc-element-size sc)
220                       (- (logandc2 (+ size align-mask) align-mask)
221                          size))
222                    (- needed-size size)))
223          (new-size (+ size inc))
224          (conflicts (finite-sb-conflicts sb))
225          (block-size (if (zerop (length conflicts))
226                          (ir2-block-count *component-being-compiled*)
227                          (length (the simple-vector (svref conflicts 0))))))
228     (declare (type index inc new-size))
229     (aver (eq (sb-kind sb) :unbounded))
230
231     (when (> new-size (length conflicts))
232       (let ((new-conf (make-array new-size)))
233         (replace new-conf conflicts)
234         (do ((i size (1+ i)))
235             ((= i new-size))
236           (declare (type index i))
237           (let ((loc-confs (make-array block-size)))
238             (dotimes (j block-size)
239               (setf (svref loc-confs j)
240                     (make-array local-tn-limit
241                                 :initial-element 0
242                                 :element-type 'bit)))
243             (setf (svref new-conf i) loc-confs)))
244         (setf (finite-sb-conflicts sb) new-conf))
245
246       (let ((new-live (make-array new-size)))
247         (replace new-live (finite-sb-always-live sb))
248         (do ((i size (1+ i)))
249             ((= i new-size))
250           (setf (svref new-live i)
251                 (make-array block-size
252                             :initial-element 0
253                             :element-type 'bit)))
254         (setf (finite-sb-always-live sb) new-live))
255
256       (let ((new-live-count (make-array new-size)))
257         (declare (optimize speed)) ;; FILL deftransform
258         (replace new-live-count (finite-sb-always-live-count sb))
259         (fill new-live-count 0 :start size)
260         (setf (finite-sb-always-live-count sb) new-live-count))
261
262       (let ((new-tns (make-array new-size :initial-element nil)))
263         (replace new-tns (finite-sb-live-tns sb))
264         (fill (finite-sb-live-tns sb) nil)
265         (setf (finite-sb-live-tns sb) new-tns)))
266
267     (setf (finite-sb-current-size sb) new-size))
268   (values))
269
270 \f
271 ;;;; internal errors
272
273 ;;; Give someone a hard time because there isn't any load function
274 ;;; defined to move from SRC to DEST.
275 (defun no-load-fun-error (src dest)
276   (let* ((src-sc (tn-sc src))
277          (src-name (sc-name src-sc))
278          (dest-sc (tn-sc dest))
279          (dest-name (sc-name dest-sc)))
280     (cond ((eq (sb-kind (sc-sb src-sc)) :non-packed)
281            (unless (member src-sc (sc-constant-scs dest-sc))
282              (error "loading from an invalid constant SC?~@
283                      VM definition inconsistent, try recompiling."))
284            (error "no load function defined to load SC ~S ~
285                    from its constant SC ~S"
286                   dest-name src-name))
287           ((member src-sc (sc-alternate-scs dest-sc))
288            (error "no load function defined to load SC ~S from its ~
289                    alternate SC ~S"
290                   dest-name src-name))
291           ((member dest-sc (sc-alternate-scs src-sc))
292            (error "no load function defined to save SC ~S in its ~
293                    alternate SC ~S"
294                   src-name dest-name))
295           (t
296            ;; FIXME: "VM definition is inconsistent" shouldn't be a
297            ;; possibility in SBCL.
298            (error "loading to/from SCs that aren't alternates?~@
299                    VM definition is inconsistent, try recompiling.")))))
300
301 ;;; Called when we failed to pack TN. If RESTRICTED is true, then we
302 ;;; are restricted to pack TN in its SC.
303 (defun failed-to-pack-error (tn restricted)
304   (declare (type tn tn))
305   (let* ((sc (tn-sc tn))
306          (scs (cons sc (sc-alternate-scs sc))))
307     (cond
308      (restricted
309       (error "failed to pack restricted TN ~S in its SC ~S"
310              tn (sc-name sc)))
311      (t
312       (aver (not (find :unbounded scs
313                        :key (lambda (x) (sb-kind (sc-sb x))))))
314       (let ((ptype (tn-primitive-type tn)))
315         (cond
316          (ptype
317           (aver (member (sc-number sc) (primitive-type-scs ptype)))
318           (error "SC ~S doesn't have any :UNBOUNDED alternate SCs, but is~@
319                   a SC for primitive-type ~S."
320                  (sc-name sc) (primitive-type-name ptype)))
321          (t
322           (error "SC ~S doesn't have any :UNBOUNDED alternate SCs."
323                  (sc-name sc)))))))))
324
325 ;;; Return a list of format arguments describing how TN is used in
326 ;;; OP's VOP.
327 (defun describe-tn-use (loc tn op)
328   (let* ((vop (tn-ref-vop op))
329          (args (vop-args vop))
330          (results (vop-results vop))
331          (name (with-output-to-string (stream)
332                  (print-tn-guts tn stream)))
333          (2comp (component-info *component-being-compiled*))
334          temp)
335     (cond
336      ((setq temp (position-in #'tn-ref-across tn args :key #'tn-ref-tn))
337       `("~2D: ~A (~:R argument)" ,loc ,name ,(1+ temp)))
338      ((setq temp (position-in #'tn-ref-across tn results :key #'tn-ref-tn))
339       `("~2D: ~A (~:R result)" ,loc ,name ,(1+ temp)))
340      ((setq temp (position-in #'tn-ref-across tn args :key #'tn-ref-load-tn))
341       `("~2D: ~A (~:R argument load TN)" ,loc ,name ,(1+ temp)))
342      ((setq temp (position-in #'tn-ref-across tn results :key
343                               #'tn-ref-load-tn))
344       `("~2D: ~A (~:R result load TN)" ,loc ,name ,(1+ temp)))
345      ((setq temp (position-in #'tn-ref-across tn (vop-temps vop)
346                               :key #'tn-ref-tn))
347       `("~2D: ~A (temporary ~A)" ,loc ,name
348         ,(operand-parse-name (elt (vop-parse-temps
349                                    (vop-parse-or-lose
350                                     (vop-info-name  (vop-info vop))))
351                                   temp))))
352      ((eq (tn-kind tn) :component)
353       `("~2D: ~A (component live)" ,loc ,name))
354      ((position-in #'tn-next tn (ir2-component-wired-tns 2comp))
355       `("~2D: ~A (wired)" ,loc ,name))
356      ((position-in #'tn-next tn (ir2-component-restricted-tns 2comp))
357       `("~2D: ~A (restricted)" ,loc ,name))
358      (t
359       `("~2D: not referenced?" ,loc)))))
360
361 ;;; If load TN packing fails, try to give a helpful error message. We
362 ;;; find a TN in each location that conflicts, and print it.
363 (defun failed-to-pack-load-tn-error (scs op)
364   (declare (list scs) (type tn-ref op))
365   (collect ((used)
366             (unused))
367     (dolist (sc scs)
368       (let* ((sb (sc-sb sc))
369              (confs (finite-sb-live-tns sb)))
370         (aver (eq (sb-kind sb) :finite))
371         (dolist (el (sc-locations sc))
372           (declare (type index el))
373           (let ((conf (load-tn-conflicts-in-sc op sc el t)))
374             (if conf
375                 (used (describe-tn-use el conf op))
376                 (do ((i el (1+ i))
377                      (end (+ el (sc-element-size sc))))
378                     ((= i end)
379                      (unused el))
380                   (declare (type index i end))
381                   (let ((victim (svref confs i)))
382                     (when victim
383                       (used (describe-tn-use el victim op))
384                       (return t)))))))))
385
386     (multiple-value-bind (arg-p n more-p costs load-scs incon)
387         (get-operand-info op)
388       (declare (ignore costs load-scs))
389         (aver (not more-p))
390         (error "unable to pack a Load-TN in SC ~{~A~#[~^~;, or ~:;,~]~} ~
391                 for the ~:R ~:[result~;argument~] to~@
392                 the ~S VOP,~@
393                 ~:[since all SC elements are in use:~:{~%~@?~}~%~;~
394                 ~:*but these SC elements are not in use:~%  ~S~%Bug?~*~]~
395                 ~:[~;~@
396                 Current cost info inconsistent with that in effect at compile ~
397                 time. Recompile.~%Compilation order may be incorrect.~]"
398                (mapcar #'sc-name scs)
399                n arg-p
400                (vop-info-name (vop-info (tn-ref-vop op)))
401                (unused) (used)
402                incon))))
403
404 ;;; This is called when none of the SCs that we can load OP into are
405 ;;; allowed by OP's primitive-type.
406 (defun no-load-scs-allowed-by-primitive-type-error (ref)
407   (declare (type tn-ref ref))
408   (let* ((tn (tn-ref-tn ref))
409          (ptype (tn-primitive-type tn)))
410     (multiple-value-bind (arg-p pos more-p costs load-scs incon)
411         (get-operand-info ref)
412       (declare (ignore costs))
413       (aver (not more-p))
414       (error "~S is not valid as the ~:R ~:[result~;argument~] to VOP:~
415               ~%  ~S,~@
416               since the TN's primitive type ~S doesn't allow any of the SCs~@
417               allowed by the operand restriction:~%  ~S~
418               ~:[~;~@
419               Current cost info inconsistent with that in effect at compile ~
420               time. Recompile.~%Compilation order may be incorrect.~]"
421              tn pos arg-p
422              (template-name (vop-info (tn-ref-vop ref)))
423              (primitive-type-name ptype)
424              (mapcar #'sc-name (listify-restrictions load-scs))
425              incon))))
426 \f
427 ;;;; register saving
428
429 ;;; Do stuff to note that TN is spilled at VOP for the debugger's benefit.
430 (defun note-spilled-tn (tn vop)
431   (when (and (tn-leaf tn) (vop-save-set vop))
432     (let ((2comp (component-info *component-being-compiled*)))
433       (setf (gethash tn (ir2-component-spilled-tns 2comp)) t)
434       (pushnew tn (gethash vop (ir2-component-spilled-vops 2comp)))))
435   (values))
436
437 ;;; Make a save TN for TN, pack it, and return it. We copy various
438 ;;; conflict information from the TN so that pack does the right
439 ;;; thing.
440 (defun pack-save-tn (tn)
441   (declare (type tn tn))
442   (let ((res (make-tn 0 :save nil nil)))
443     (dolist (alt (sc-alternate-scs (tn-sc tn))
444                  (error "no unbounded alternate for SC ~S"
445                         (sc-name (tn-sc tn))))
446       (when (eq (sb-kind (sc-sb alt)) :unbounded)
447         (setf (tn-save-tn tn) res)
448         (setf (tn-save-tn res) tn)
449         (setf (tn-sc res) alt)
450         (pack-tn res t nil)
451         (return res)))))
452
453 ;;; Find the load function for moving from SRC to DEST and emit a
454 ;;; MOVE-OPERAND VOP with that function as its info arg.
455 (defun emit-operand-load (node block src dest before)
456   (declare (type node node) (type ir2-block block)
457            (type tn src dest) (type (or vop null) before))
458   (emit-load-template node block
459                       (template-or-lose 'move-operand)
460                       src dest
461                       (list (or (svref (sc-move-funs (tn-sc dest))
462                                        (sc-number (tn-sc src)))
463                                 (no-load-fun-error src dest)))
464                       before)
465   (values))
466
467 ;;; Find the preceding use of the VOP NAME in the emit order, starting
468 ;;; with VOP. We must find the VOP in the same IR1 block.
469 (defun reverse-find-vop (name vop)
470   (do* ((block (vop-block vop) (ir2-block-prev block))
471         (last vop (ir2-block-last-vop block)))
472        (nil)
473     (aver (eq (ir2-block-block block) (ir2-block-block (vop-block vop))))
474     (do ((current last (vop-prev current)))
475         ((null current))
476       (when (eq (vop-info-name (vop-info current)) name)
477         (return-from reverse-find-vop current)))))
478
479 ;;; For TNs that have other than one writer, we save the TN before
480 ;;; each call. If a local call (MOVE-ARGS is :LOCAL-CALL), then we
481 ;;; scan back for the ALLOCATE-FRAME VOP, and emit the save there.
482 ;;; This is necessary because in a self-recursive local call, the
483 ;;; registers holding the current arguments may get trashed by setting
484 ;;; up the call arguments. The ALLOCATE-FRAME VOP marks a place at
485 ;;; which the values are known to be good.
486 (defun save-complex-writer-tn (tn vop)
487   (let ((save (or (tn-save-tn tn)
488                   (pack-save-tn tn)))
489         (node (vop-node vop))
490         (block (vop-block vop))
491         (next (vop-next vop)))
492     (when (eq (tn-kind save) :specified-save)
493       (setf (tn-kind save) :save))
494     (aver (eq (tn-kind save) :save))
495     (emit-operand-load node block tn save
496                        (if (eq (vop-info-move-args (vop-info vop))
497                                :local-call)
498                            (reverse-find-vop 'allocate-frame vop)
499                            vop))
500     (emit-operand-load node block save tn next)))
501
502 ;;; Return a VOP after which is an OK place to save the value of TN.
503 ;;; For correctness, it is only required that this location be after
504 ;;; any possible write and before any possible restore location.
505 ;;;
506 ;;; In practice, we return the unique writer VOP, but give up if the
507 ;;; TN is ever read by a VOP with MOVE-ARGS :LOCAL-CALL. This prevents
508 ;;; us from being confused by non-tail local calls.
509 ;;;
510 ;;; When looking for writes, we have to ignore uses of MOVE-OPERAND,
511 ;;; since they will correspond to restores that we have already done.
512 (defun find-single-writer (tn)
513   (declare (type tn tn))
514   (do ((write (tn-writes tn) (tn-ref-next write))
515        (res nil))
516       ((null write)
517        (when (and res
518                   (do ((read (tn-reads tn) (tn-ref-next read)))
519                       ((not read) t)
520                     (when (eq (vop-info-move-args
521                                (vop-info
522                                 (tn-ref-vop read)))
523                               :local-call)
524                       (return nil))))
525          (tn-ref-vop res)))
526
527     (unless (eq (vop-info-name (vop-info (tn-ref-vop write)))
528                 'move-operand)
529       (when res (return nil))
530       (setq res write))))
531
532 ;;; Try to save TN at a single location. If we succeed, return T,
533 ;;; otherwise NIL.
534 (defun save-single-writer-tn (tn)
535   (declare (type tn tn))
536   (let* ((old-save (tn-save-tn tn))
537          (save (or old-save (pack-save-tn tn)))
538          (writer (find-single-writer tn)))
539     (when (and writer
540                (or (not old-save)
541                    (eq (tn-kind old-save) :specified-save)))
542       (emit-operand-load (vop-node writer) (vop-block writer)
543                          tn save (vop-next writer))
544       (setf (tn-kind save) :save-once)
545       t)))
546
547 ;;; Restore a TN with a :SAVE-ONCE save TN.
548 (defun restore-single-writer-tn (tn vop)
549   (declare (type tn) (type vop vop))
550   (let ((save (tn-save-tn tn)))
551     (aver (eq (tn-kind save) :save-once))
552     (emit-operand-load (vop-node vop) (vop-block vop) save tn (vop-next vop)))
553   (values))
554
555 ;;; Save a single TN that needs to be saved, choosing save-once if
556 ;;; appropriate. This is also called by SPILL-AND-PACK-LOAD-TN.
557 (defun basic-save-tn (tn vop)
558   (declare (type tn tn) (type vop vop))
559   (let ((save (tn-save-tn tn)))
560     (cond ((and save (eq (tn-kind save) :save-once))
561            (restore-single-writer-tn tn vop))
562           ((save-single-writer-tn tn)
563            (restore-single-writer-tn tn vop))
564           (t
565            (save-complex-writer-tn tn vop))))
566   (values))
567
568 ;;; Scan over the VOPs in BLOCK, emiting saving code for TNs noted in
569 ;;; the codegen info that are packed into saved SCs.
570 (defun emit-saves (block)
571   (declare (type ir2-block block))
572   (do ((vop (ir2-block-start-vop block) (vop-next vop)))
573       ((null vop))
574     (when (eq (vop-info-save-p (vop-info vop)) t)
575       (do-live-tns (tn (vop-save-set vop) block)
576         (when (and (sc-save-p (tn-sc tn))
577                    (not (eq (tn-kind tn) :component)))
578           (basic-save-tn tn vop)))))
579
580   (values))
581 \f
582 ;;;; optimized saving
583
584 ;;; Save TN if it isn't a single-writer TN that has already been
585 ;;; saved. If multi-write, we insert the save BEFORE the specified
586 ;;; VOP. CONTEXT is a VOP used to tell which node/block to use for the
587 ;;; new VOP.
588 (defun save-if-necessary (tn before context)
589   (declare (type tn tn) (type (or vop null) before) (type vop context))
590   (let ((save (tn-save-tn tn)))
591     (when (eq (tn-kind save) :specified-save)
592       (setf (tn-kind save) :save))
593     (aver (member (tn-kind save) '(:save :save-once)))
594     (unless (eq (tn-kind save) :save-once)
595       (or (save-single-writer-tn tn)
596           (emit-operand-load (vop-node context) (vop-block context)
597                              tn save before))))
598   (values))
599
600 ;;; Load the TN from its save location, allocating one if necessary.
601 ;;; The load is inserted BEFORE the specified VOP. CONTEXT is a VOP
602 ;;; used to tell which node/block to use for the new VOP.
603 (defun restore-tn (tn before context)
604   (declare (type tn tn) (type (or vop null) before) (type vop context))
605   (let ((save (or (tn-save-tn tn) (pack-save-tn tn))))
606     (emit-operand-load (vop-node context) (vop-block context)
607                        save tn before))
608   (values))
609
610 ;;; Start scanning backward at the end of BLOCK, looking which TNs are
611 ;;; live and looking for places where we have to save. We manipulate
612 ;;; two sets: SAVES and RESTORES.
613 ;;;
614 ;;; SAVES is a set of all the TNs that have to be saved because they
615 ;;; are restored after some call. We normally delay saving until the
616 ;;; beginning of the block, but we must save immediately if we see a
617 ;;; write of the saved TN. We also immediately save all TNs and exit
618 ;;; when we see a NOTE-ENVIRONMENT-START VOP, since saves can't be
619 ;;; done before the environment is properly initialized.
620 ;;;
621 ;;; RESTORES is a set of all the TNs read (and not written) between
622 ;;; here and the next call, i.e. the set of TNs that must be restored
623 ;;; when we reach the next (earlier) call VOP. Unlike SAVES, this set
624 ;;; is cleared when we do the restoring after a call. Any TNs that
625 ;;; were in RESTORES are moved into SAVES to ensure that they are
626 ;;; saved at some point.
627 ;;;
628 ;;; SAVES and RESTORES are represented using both a list and a
629 ;;; bit-vector so that we can quickly iterate and test for membership.
630 ;;; The incoming SAVES and RESTORES args are used for computing these
631 ;;; sets (the initial contents are ignored.)
632 ;;;
633 ;;; When we hit a VOP with :COMPUTE-ONLY SAVE-P (an internal error
634 ;;; location), we pretend that all live TNs were read, unless (= speed
635 ;;; 3), in which case we mark all the TNs that are live but not
636 ;;; restored as spilled.
637 (defun optimized-emit-saves-block (block saves restores)
638   (declare (type ir2-block block) (type simple-bit-vector saves restores))
639   (let ((1block (ir2-block-block block))
640         (saves-list ())
641         (restores-list ())
642         (skipping nil))
643     (declare (list saves-list restores-list))
644     (clear-bit-vector saves)
645     (clear-bit-vector restores)
646     (do-live-tns (tn (ir2-block-live-in block) block)
647       (when (and (sc-save-p (tn-sc tn))
648                  (not (eq (tn-kind tn) :component)))
649         (let ((num (tn-number tn)))
650           (setf (sbit restores num) 1)
651           (push tn restores-list))))
652
653     (do ((block block (ir2-block-prev block))
654          (prev nil block))
655         ((not (eq (ir2-block-block block) 1block))
656          (aver (not skipping))
657          (dolist (save saves-list)
658            (let ((start (ir2-block-start-vop prev)))
659              (save-if-necessary save start start)))
660          prev)
661       (do ((vop (ir2-block-last-vop block) (vop-prev vop)))
662           ((null vop))
663         (let ((info (vop-info vop)))
664           (case (vop-info-name info)
665             (allocate-frame
666              (aver skipping)
667              (setq skipping nil))
668             (note-environment-start
669              (aver (not skipping))
670              (dolist (save saves-list)
671                (save-if-necessary save (vop-next vop) vop))
672              (return-from optimized-emit-saves-block block)))
673
674           (unless skipping
675             (do ((write (vop-results vop) (tn-ref-across write)))
676                 ((null write))
677               (let* ((tn (tn-ref-tn write))
678                      (num (tn-number tn)))
679                 (unless (zerop (sbit restores num))
680                   (setf (sbit restores num) 0)
681                   (setq restores-list
682                         (delete tn restores-list :test #'eq)))
683                 (unless (zerop (sbit saves num))
684                   (setf (sbit saves num) 0)
685                   (save-if-necessary tn (vop-next vop) vop)
686                   (setq saves-list
687                         (delete tn saves-list :test #'eq))))))
688
689           (macrolet ((save-note-read (tn)
690                        `(let* ((tn ,tn)
691                                (num (tn-number tn)))
692                           (when (and (sc-save-p (tn-sc tn))
693                                      (zerop (sbit restores num))
694                                      (not (eq (tn-kind tn) :component)))
695                           (setf (sbit restores num) 1)
696                           (push tn restores-list)))))
697
698             (case (vop-info-save-p info)
699               ((t)
700                (dolist (tn restores-list)
701                  (restore-tn tn (vop-next vop) vop)
702                  (let ((num (tn-number tn)))
703                    (when (zerop (sbit saves num))
704                      (push tn saves-list)
705                      (setf (sbit saves num) 1))))
706                (setq restores-list nil)
707                (clear-bit-vector restores))
708               (:compute-only
709                (cond ((policy (vop-node vop) (= speed 3))
710                       (do-live-tns (tn (vop-save-set vop) block)
711                         (when (zerop (sbit restores (tn-number tn)))
712                           (note-spilled-tn tn vop))))
713                      (t
714                       (do-live-tns (tn (vop-save-set vop) block)
715                         (save-note-read tn))))))
716
717             (if (eq (vop-info-move-args info) :local-call)
718                 (setq skipping t)
719                 (do ((read (vop-args vop) (tn-ref-across read)))
720                     ((null read))
721                   (save-note-read (tn-ref-tn read))))))))))
722
723 ;;; This is like EMIT-SAVES, only different. We avoid redundant saving
724 ;;; within the block, and don't restore values that aren't used before
725 ;;; the next call. This function is just the top level loop over the
726 ;;; blocks in the component, which locates blocks that need saving
727 ;;; done.
728 (defun optimized-emit-saves (component)
729   (declare (type component component))
730   (let* ((gtn-count (1+ (ir2-component-global-tn-counter
731                          (component-info component))))
732          (saves (make-array gtn-count :element-type 'bit))
733          (restores (make-array gtn-count :element-type 'bit))
734          (block (ir2-block-prev (block-info (component-tail component))))
735          (head (block-info (component-head component))))
736     (loop
737       (when (eq block head) (return))
738       (when (do ((vop (ir2-block-start-vop block) (vop-next vop)))
739                 ((null vop) nil)
740               (when (eq (vop-info-save-p (vop-info vop)) t)
741                 (return t)))
742         (setq block (optimized-emit-saves-block block saves restores)))
743       (setq block (ir2-block-prev block)))))
744
745 ;;; Iterate over the normal TNs, finding the cost of packing on the
746 ;;; stack in units of the number of references. We count all
747 ;;; references as +1, and subtract out REGISTER-SAVE-PENALTY for each
748 ;;; place where we would have to save a register.
749 (defun assign-tn-costs (component)
750   (do-ir2-blocks (block component)
751     (do ((vop (ir2-block-start-vop block) (vop-next vop)))
752         ((null vop))
753       (when (eq (vop-info-save-p (vop-info vop)) t)
754         (do-live-tns (tn (vop-save-set vop) block)
755           (decf (tn-cost tn) *backend-register-save-penalty*)))))
756
757   (do ((tn (ir2-component-normal-tns (component-info component))
758            (tn-next tn)))
759       ((null tn))
760     (let ((cost (tn-cost tn)))
761       (declare (fixnum cost))
762       (do ((ref (tn-reads tn) (tn-ref-next ref)))
763           ((null ref))
764         (incf cost))
765       (do ((ref (tn-writes tn) (tn-ref-next ref)))
766           ((null ref))
767         (incf cost))
768       (setf (tn-cost tn) cost))))
769
770 ;;; Iterate over the normal TNs, storing the depth of the deepest loop
771 ;;; that the TN is used in TN-LOOP-DEPTH.
772 (defun assign-tn-depths (component)
773   (when *loop-analyze*
774     (do-ir2-blocks (block component)
775       (do ((vop (ir2-block-start-vop block)
776                 (vop-next vop)))
777           ((null vop))
778         (flet ((find-all-tns (head-fun)
779                  (collect ((tns))
780                    (do ((ref (funcall head-fun vop) (tn-ref-across ref)))
781                        ((null ref))
782                      (tns (tn-ref-tn ref)))
783                    (tns))))
784           (dolist (tn (nconc (find-all-tns #'vop-args)
785                              (find-all-tns #'vop-results)
786                              (find-all-tns #'vop-temps)
787                              ;; What does "references in this VOP
788                              ;; mean"? Probably something that isn't
789                              ;; useful in this context, since these
790                              ;; TN-REFs are linked with TN-REF-NEXT
791                              ;; instead of TN-REF-ACROSS. --JES
792                              ;; 2004-09-11
793                              ;; (find-all-tns #'vop-refs)
794                              ))
795             (setf (tn-loop-depth tn)
796                   (max (tn-loop-depth tn)
797                        (let* ((ir1-block (ir2-block-block (vop-block vop)))
798                               (loop (block-loop ir1-block)))
799                          (if loop
800                              (loop-depth loop)
801                              0))))))))))
802
803 \f
804 ;;;; load TN packing
805
806 ;;; These variables indicate the last location at which we computed
807 ;;; the Live-TNs. They hold the BLOCK and VOP values that were passed
808 ;;; to COMPUTE-LIVE-TNS.
809 (defvar *live-block*)
810 (defvar *live-vop*)
811
812 ;;; If we unpack some TNs, then we mark all affected blocks by
813 ;;; sticking them in this hash-table. This is initially null. We
814 ;;; create the hashtable if we do any unpacking.
815 (defvar *repack-blocks*)
816 (declaim (type list *repack-blocks*))
817
818 ;;; Set the LIVE-TNS vectors in all :FINITE SBs to represent the TNs
819 ;;; live at the end of BLOCK.
820 (defun init-live-tns (block)
821   (dolist (sb *backend-sb-list*)
822     (when (eq (sb-kind sb) :finite)
823       (fill (finite-sb-live-tns sb) nil)))
824
825   (do-live-tns (tn (ir2-block-live-in block) block)
826     (let* ((sc (tn-sc tn))
827            (sb (sc-sb sc)))
828       (when (eq (sb-kind sb) :finite)
829         ;; KLUDGE: we can have "live" TNs that are neither read
830         ;; to nor written from, due to more aggressive (type-
831         ;; directed) constant propagation.  Such TNs will never
832         ;; be assigned an offset nor be in conflict with anything.
833         ;;
834         ;; Ideally, it seems to me we could make sure these TNs
835         ;; are never allocated in the first place in
836         ;; ASSIGN-LAMBDA-VAR-TNS.
837         (if (tn-offset tn)
838             (do ((offset (tn-offset tn) (1+ offset))
839                  (end (+ (tn-offset tn) (sc-element-size sc))))
840                 ((= offset end))
841               (declare (type index offset end))
842               (setf (svref (finite-sb-live-tns sb) offset) tn))
843             (assert (and (null (tn-reads tn))
844                          (null (tn-writes tn))))))))
845
846   (setq *live-block* block)
847   (setq *live-vop* (ir2-block-last-vop block))
848
849   (values))
850
851 ;;; Set the LIVE-TNs in :FINITE SBs to represent the TNs live
852 ;;; immediately after the evaluation of VOP in BLOCK, excluding
853 ;;; results of the VOP. If VOP is null, then compute the live TNs at
854 ;;; the beginning of the block. Sequential calls on the same block
855 ;;; must be in reverse VOP order.
856 (defun compute-live-tns (block vop)
857   (declare (type ir2-block block) (type vop vop))
858   (unless (eq block *live-block*)
859     (init-live-tns block))
860
861   (do ((current *live-vop* (vop-prev current)))
862       ((eq current vop)
863        (do ((res (vop-results vop) (tn-ref-across res)))
864            ((null res))
865          (let* ((tn (tn-ref-tn res))
866                 (sc (tn-sc tn))
867                 (sb (sc-sb sc)))
868            (when (eq (sb-kind sb) :finite)
869              (do ((offset (tn-offset tn) (1+ offset))
870                   (end (+ (tn-offset tn) (sc-element-size sc))))
871                  ((= offset end))
872                (declare (type index offset end))
873                (setf (svref (finite-sb-live-tns sb) offset) nil))))))
874     (do ((ref (vop-refs current) (tn-ref-next-ref ref)))
875         ((null ref))
876       (let ((ltn (tn-ref-load-tn ref)))
877         (when ltn
878           (let* ((sc (tn-sc ltn))
879                  (sb (sc-sb sc)))
880             (when (eq (sb-kind sb) :finite)
881               (let ((tns (finite-sb-live-tns sb)))
882                 (do ((offset (tn-offset ltn) (1+ offset))
883                      (end (+ (tn-offset ltn) (sc-element-size sc))))
884                     ((= offset end))
885                   (declare (type index offset end))
886                   (aver (null (svref tns offset)))))))))
887
888       (let* ((tn (tn-ref-tn ref))
889              (sc (tn-sc tn))
890              (sb (sc-sb sc)))
891         (when (eq (sb-kind sb) :finite)
892           (let ((tns (finite-sb-live-tns sb)))
893             (do ((offset (tn-offset tn) (1+ offset))
894                  (end (+ (tn-offset tn) (sc-element-size sc))))
895                 ((= offset end))
896               (declare (type index offset end))
897               (if (tn-ref-write-p ref)
898                   (setf (svref tns offset) nil)
899                   (let ((old (svref tns offset)))
900                     (aver (or (null old) (eq old tn)))
901                     (setf (svref tns offset) tn)))))))))
902
903   (setq *live-vop* vop)
904   (values))
905
906 ;;; This is kind of like OFFSET-CONFLICTS-IN-SB, except that it uses
907 ;;; the VOP refs to determine whether a Load-TN for OP could be packed
908 ;;; in the specified location, disregarding conflicts with TNs not
909 ;;; referenced by this VOP. There is a conflict if either:
910 ;;;  1. The reference is a result, and the same location is either:
911 ;;;     -- Used by some other result.
912 ;;;     -- Used in any way after the reference (exclusive).
913 ;;;  2. The reference is an argument, and the same location is either:
914 ;;;     -- Used by some other argument.
915 ;;;     -- Used in any way before the reference (exclusive).
916 ;;;
917 ;;; In 1 (and 2) above, the first bullet corresponds to result-result
918 ;;; (and argument-argument) conflicts. We need this case because there
919 ;;; aren't any TN-REFs to represent the implicit reading of results or
920 ;;; writing of arguments.
921 ;;;
922 ;;; The second bullet corresponds to conflicts with temporaries or
923 ;;; between arguments and results.
924 ;;;
925 ;;; We consider both the TN-REF-TN and the TN-REF-LOAD-TN (if any) to
926 ;;; be referenced simultaneously and in the same way. This causes
927 ;;; load-TNs to appear live to the beginning (or end) of the VOP, as
928 ;;; appropriate.
929 ;;;
930 ;;; We return a conflicting TN if there is a conflict.
931 (defun load-tn-offset-conflicts-in-sb (op sb offset)
932   (declare (type tn-ref op) (type finite-sb sb) (type index offset))
933   (aver (eq (sb-kind sb) :finite))
934   (let ((vop (tn-ref-vop op)))
935     (labels ((tn-overlaps (tn)
936                (let ((sc (tn-sc tn))
937                      (tn-offset (tn-offset tn)))
938                  (when (and (eq (sc-sb sc) sb)
939                             (<= tn-offset offset)
940                             (< offset
941                                (the index
942                                     (+ tn-offset (sc-element-size sc)))))
943                    tn)))
944              (same (ref)
945                (let ((tn (tn-ref-tn ref))
946                      (ltn (tn-ref-load-tn ref)))
947                  (or (tn-overlaps tn)
948                      (and ltn (tn-overlaps ltn)))))
949              (is-op (ops)
950                (do ((ops ops (tn-ref-across ops)))
951                    ((null ops) nil)
952                  (let ((found (same ops)))
953                    (when (and found (not (eq ops op)))
954                      (return found)))))
955              (is-ref (refs end)
956                (do ((refs refs (tn-ref-next-ref refs)))
957                    ((eq refs end) nil)
958                  (let ((found (same refs)))
959                  (when found (return found))))))
960       (declare (inline is-op is-ref tn-overlaps))
961       (if (tn-ref-write-p op)
962           (or (is-op (vop-results vop))
963               (is-ref (vop-refs vop) op))
964           (or (is-op (vop-args vop))
965               (is-ref (tn-ref-next-ref op) nil))))))
966
967 ;;; Iterate over all the elements in the SB that would be allocated by
968 ;;; allocating a TN in SC at Offset, checking for conflict with
969 ;;; load-TNs or other TNs (live in the LIVE-TNS, which must be set
970 ;;; up.) We also return true if there aren't enough locations after
971 ;;; Offset to hold a TN in SC. If Ignore-Live is true, then we ignore
972 ;;; the live-TNs, considering only references within Op's VOP.
973 ;;;
974 ;;; We return a conflicting TN, or :OVERFLOW if the TN won't fit.
975 (defun load-tn-conflicts-in-sc (op sc offset ignore-live)
976   (let* ((sb (sc-sb sc))
977          (size (finite-sb-current-size sb)))
978     (do ((i offset (1+ i))
979          (end (+ offset (sc-element-size sc))))
980         ((= i end) nil)
981       (declare (type index i end))
982       (let ((res (or (when (>= i size) :overflow)
983                      (and (not ignore-live)
984                           (svref (finite-sb-live-tns sb) i))
985                      (load-tn-offset-conflicts-in-sb op sb i))))
986         (when res (return res))))))
987
988 ;;; If a load-TN for OP is targeted to a legal location in SC, then
989 ;;; return the offset, otherwise return NIL. We see whether the target
990 ;;; of the operand is packed, and try that location. There isn't any
991 ;;; need to chain down the target path, since everything is packed
992 ;;; now.
993 ;;;
994 ;;; We require the target to be in SC (and not merely to overlap with
995 ;;; SC). This prevents SC information from being lost in load TNs (we
996 ;;; won't pack a load TN in ANY-REG when it is targeted to a
997 ;;; DESCRIPTOR-REG.) This shouldn't hurt the code as long as all
998 ;;; relevant overlapping SCs are allowed in the operand SC
999 ;;; restriction.
1000 (defun find-load-tn-target (op sc)
1001   (declare (inline member))
1002   (let ((target (tn-ref-target op)))
1003     (when target
1004       (let* ((tn (tn-ref-tn target))
1005              (loc (tn-offset tn)))
1006         (if (and (eq (tn-sc tn) sc)
1007                  (member (the index loc) (sc-locations sc))
1008                  (not (load-tn-conflicts-in-sc op sc loc nil)))
1009             loc
1010             nil)))))
1011
1012 ;;; Select a legal location for a load TN for Op in SC. We just
1013 ;;; iterate over the SC's locations. If we can't find a legal
1014 ;;; location, return NIL.
1015 (defun select-load-tn-location (op sc)
1016   (declare (type tn-ref op) (type sc sc))
1017
1018   ;; Check any target location first.
1019   (let ((target (tn-ref-target op)))
1020     (when target
1021       (let* ((tn (tn-ref-tn target))
1022              (loc (tn-offset tn)))
1023         (when (and (eq (sc-sb sc) (sc-sb (tn-sc tn)))
1024                    (member (the index loc) (sc-locations sc))
1025                    (not (load-tn-conflicts-in-sc op sc loc nil)))
1026               (return-from select-load-tn-location loc)))))
1027
1028   (dolist (loc (sc-locations sc) nil)
1029     (unless (load-tn-conflicts-in-sc op sc loc nil)
1030       (return loc))))
1031
1032 (defevent unpack-tn "Unpacked a TN to satisfy operand SC restriction.")
1033
1034 ;;; Make TN's location the same as for its save TN (allocating a save
1035 ;;; TN if necessary.) Delete any save/restore code that has been
1036 ;;; emitted thus far. Mark all blocks containing references as needing
1037 ;;; to be repacked.
1038 (defun unpack-tn (tn)
1039   (event unpack-tn)
1040   (let ((stn (or (tn-save-tn tn)
1041                  (pack-save-tn tn))))
1042     (setf (tn-sc tn) (tn-sc stn))
1043     (setf (tn-offset tn) (tn-offset stn))
1044     (flet ((zot (refs)
1045              (do ((ref refs (tn-ref-next ref)))
1046                  ((null ref))
1047                (let ((vop (tn-ref-vop ref)))
1048                  (if (eq (vop-info-name (vop-info vop)) 'move-operand)
1049                      (delete-vop vop)
1050                      (pushnew (vop-block vop) *repack-blocks*))))))
1051       (zot (tn-reads tn))
1052       (zot (tn-writes tn))))
1053
1054   (values))
1055
1056 (defevent unpack-fallback "Unpacked some operand TN.")
1057
1058 ;;; This is called by PACK-LOAD-TN where there isn't any location free
1059 ;;; that we can pack into. What we do is move some live TN in one of
1060 ;;; the specified SCs to memory, then mark all blocks that reference
1061 ;;; the TN as needing repacking. If we succeed, we throw to UNPACKED-TN.
1062 ;;; If we fail, we return NIL.
1063 ;;;
1064 ;;; We can unpack any live TN that appears in the NORMAL-TNs list
1065 ;;; (isn't wired or restricted.) We prefer to unpack TNs that are not
1066 ;;; used by the VOP. If we can't find any such TN, then we unpack some
1067 ;;; argument or result TN. The only way we can fail is if all
1068 ;;; locations in SC are used by load-TNs or temporaries in VOP.
1069 (defun unpack-for-load-tn (sc op)
1070   (declare (type sc sc) (type tn-ref op))
1071   (let ((sb (sc-sb sc))
1072         (normal-tns (ir2-component-normal-tns
1073                      (component-info *component-being-compiled*)))
1074         (node (vop-node (tn-ref-vop op)))
1075         (fallback nil))
1076     (flet ((unpack-em (victims)
1077              (pushnew (vop-block (tn-ref-vop op)) *repack-blocks*)
1078              (dolist (victim victims)
1079                (event unpack-tn node)
1080                (unpack-tn victim))
1081              (throw 'unpacked-tn nil)))
1082       (dolist (loc (sc-locations sc))
1083         (declare (type index loc))
1084         (block SKIP
1085           (collect ((victims nil adjoin))
1086             (do ((i loc (1+ i))
1087                  (end (+ loc (sc-element-size sc))))
1088                 ((= i end))
1089               (declare (type index i end))
1090               (let ((victim (svref (finite-sb-live-tns sb) i)))
1091                 (when victim
1092                   (unless (find-in #'tn-next victim normal-tns)
1093                     (return-from SKIP))
1094                   (victims victim))))
1095
1096             (let ((conf (load-tn-conflicts-in-sc op sc loc t)))
1097               (cond ((not conf)
1098                      (unpack-em (victims)))
1099                     ((eq conf :overflow))
1100                     ((not fallback)
1101                      (cond ((find conf (victims))
1102                             (setq fallback (victims)))
1103                            ((find-in #'tn-next conf normal-tns)
1104                             (setq fallback (list conf))))))))))
1105
1106       (when fallback
1107         (event unpack-fallback node)
1108         (unpack-em fallback))))
1109
1110   nil)
1111
1112 ;;; Try to pack a load TN in the SCs indicated by Load-SCs. If we run
1113 ;;; out of SCs, then we unpack some TN and try again. We return the
1114 ;;; packed load TN.
1115 ;;;
1116 ;;; Note: we allow a Load-TN to be packed in the target location even
1117 ;;; if that location is in a SC not allowed by the primitive type.
1118 ;;; (The SC must still be allowed by the operand restriction.) This
1119 ;;; makes move VOPs more efficient, since we won't do a move from the
1120 ;;; stack into a non-descriptor any-reg through a descriptor argument
1121 ;;; load-TN. This does give targeting some real semantics, making it
1122 ;;; not a pure advisory to pack. It allows pack to do some packing it
1123 ;;; wouldn't have done before.
1124 (defun pack-load-tn (load-scs op)
1125   (declare (type sc-vector load-scs) (type tn-ref op))
1126   (let ((vop (tn-ref-vop op)))
1127     (compute-live-tns (vop-block vop) vop))
1128
1129   (let* ((tn (tn-ref-tn op))
1130          (ptype (tn-primitive-type tn))
1131          (scs (svref load-scs (sc-number (tn-sc tn)))))
1132     (let ((current-scs scs)
1133           (allowed ()))
1134       (loop
1135         (cond
1136          ((null current-scs)
1137           (unless allowed
1138             (no-load-scs-allowed-by-primitive-type-error op))
1139           (dolist (sc allowed)
1140             (unpack-for-load-tn sc op))
1141           (failed-to-pack-load-tn-error allowed op))
1142         (t
1143          (let* ((sc (svref *backend-sc-numbers* (pop current-scs)))
1144                 (target (find-load-tn-target op sc)))
1145            (when (or target (sc-allowed-by-primitive-type sc ptype))
1146              (let ((loc (or target
1147                             (select-load-tn-location op sc))))
1148                (when loc
1149                  (let ((res (make-tn 0 :load nil sc)))
1150                    (setf (tn-offset res) loc)
1151                    (return res))))
1152              (push sc allowed)))))))))
1153
1154 ;;; Scan a list of load-SCs vectors and a list of TN-REFS threaded by
1155 ;;; TN-REF-ACROSS. When we find a reference whose TN doesn't satisfy
1156 ;;; the restriction, we pack a Load-TN and load the operand into it.
1157 ;;; If a load-tn has already been allocated, we can assume that the
1158 ;;; restriction is satisfied.
1159 #!-sb-fluid (declaim (inline check-operand-restrictions))
1160 (defun check-operand-restrictions (scs ops)
1161   (declare (list scs) (type (or tn-ref null) ops))
1162
1163   ;; Check the targeted operands first.
1164   (do ((scs scs (cdr scs))
1165        (op ops (tn-ref-across op)))
1166       ((null scs))
1167       (let ((target (tn-ref-target op)))
1168         (when target
1169            (let* ((load-tn (tn-ref-load-tn op))
1170                   (load-scs (svref (car scs)
1171                                    (sc-number
1172                                     (tn-sc (or load-tn (tn-ref-tn op)))))))
1173              (if load-tn
1174                  (aver (eq load-scs t))
1175                (unless (eq load-scs t)
1176                        (setf (tn-ref-load-tn op)
1177                              (pack-load-tn (car scs) op))))))))
1178
1179   (do ((scs scs (cdr scs))
1180        (op ops (tn-ref-across op)))
1181       ((null scs))
1182       (let ((target (tn-ref-target op)))
1183         (unless target
1184            (let* ((load-tn (tn-ref-load-tn op))
1185                   (load-scs (svref (car scs)
1186                                    (sc-number
1187                                     (tn-sc (or load-tn (tn-ref-tn op)))))))
1188              (if load-tn
1189                  (aver (eq load-scs t))
1190                (unless (eq load-scs t)
1191                        (setf (tn-ref-load-tn op)
1192                              (pack-load-tn (car scs) op))))))))
1193
1194   (values))
1195
1196 ;;; Scan the VOPs in BLOCK, looking for operands whose SC restrictions
1197 ;;; aren't satisfied. We do the results first, since they are
1198 ;;; evaluated later, and our conflict analysis is a backward scan.
1199 (defun pack-load-tns (block)
1200   (catch 'unpacked-tn
1201     (let ((*live-block* nil)
1202           (*live-vop* nil))
1203       (do ((vop (ir2-block-last-vop block) (vop-prev vop)))
1204           ((null vop))
1205         (let ((info (vop-info vop)))
1206           (check-operand-restrictions (vop-info-result-load-scs info)
1207                                       (vop-results vop))
1208           (check-operand-restrictions (vop-info-arg-load-scs info)
1209                                       (vop-args vop))))))
1210   (values))
1211 \f
1212 ;;;; targeting
1213
1214 ;;; Link the TN-REFS READ and WRITE together using the TN-REF-TARGET
1215 ;;; when this seems like a good idea. Currently we always do, as this
1216 ;;; increases the success of load-TN targeting.
1217 (defun target-if-desirable (read write)
1218   (declare (type tn-ref read write))
1219   ;; As per the comments at the definition of TN-REF-TARGET, read and
1220   ;; write refs are always paired, with TARGET in the read pointing to
1221   ;; the write and vice versa.
1222   (aver (eq (tn-ref-write-p read)
1223             (not (tn-ref-write-p write))))
1224   (setf (tn-ref-target read) write)
1225   (setf (tn-ref-target write) read))
1226
1227 ;;; If TN can be packed into SC so as to honor a preference to TARGET,
1228 ;;; then return the offset to pack at, otherwise return NIL. TARGET
1229 ;;; must be already packed.
1230 (defun check-ok-target (target tn sc)
1231   (declare (type tn target tn) (type sc sc) (inline member))
1232   (let* ((loc (tn-offset target))
1233          (target-sc (tn-sc target))
1234          (target-sb (sc-sb target-sc)))
1235     (declare (type index loc))
1236     ;; We can honor a preference if:
1237     ;; -- TARGET's location is in SC's locations.
1238     ;; -- The element sizes of the two SCs are the same.
1239     ;; -- TN doesn't conflict with target's location.
1240     (if (and (eq target-sb (sc-sb sc))
1241              (or (eq (sb-kind target-sb) :unbounded)
1242                  (member loc (sc-locations sc)))
1243              (= (sc-element-size target-sc) (sc-element-size sc))
1244              (not (conflicts-in-sc tn sc loc))
1245              (zerop (mod loc (sc-alignment sc))))
1246         loc
1247         nil)))
1248
1249 ;;; Scan along the target path from TN, looking at readers or writers.
1250 ;;; When we find a packed TN, return CHECK-OK-TARGET of that TN. If
1251 ;;; there is no target, or if the TN has multiple readers (writers),
1252 ;;; then we return NIL. We also always return NIL after 10 iterations
1253 ;;; to get around potential circularity problems.
1254 ;;;
1255 ;;; FIXME: (30 minutes of reverse engineering?) It'd be nice to
1256 ;;; rewrite the header comment here to explain the interface and its
1257 ;;; motivation, and move remarks about implementation details (like
1258 ;;; 10!) inside.
1259 (defun find-ok-target-offset (tn sc)
1260   (declare (type tn tn) (type sc sc))
1261   (flet ((frob-slot (slot-fun)
1262            (declare (type function slot-fun))
1263            (let ((count 10)
1264                  (current tn))
1265              (declare (type index count))
1266              (loop
1267               (let ((refs (funcall slot-fun current)))
1268                 (unless (and (plusp count)
1269                              refs
1270                              (not (tn-ref-next refs)))
1271                   (return nil))
1272                 (let ((target (tn-ref-target refs)))
1273                   (unless target (return nil))
1274                   (setq current (tn-ref-tn target))
1275                   (when (tn-offset current)
1276                     (return (check-ok-target current tn sc)))
1277                   (decf count)))))))
1278     (declare (inline frob-slot)) ; until DYNAMIC-EXTENT works
1279     (or (frob-slot #'tn-reads)
1280         (frob-slot #'tn-writes))))
1281 \f
1282 ;;;; location selection
1283
1284 ;;; Select some location for TN in SC, returning the offset if we
1285 ;;; succeed, and NIL if we fail.
1286 ;;;
1287 ;;; For :UNBOUNDED SCs just find the smallest correctly aligned offset
1288 ;;; where the TN doesn't conflict with the TNs that have already been
1289 ;;; packed. For :FINITE SCs try to pack the TN into the most heavily
1290 ;;; used locations first (as estimated in FIND-LOCATION-USAGE).
1291 ;;;
1292 ;;; Historically SELECT-LOCATION tried did the opposite and tried to
1293 ;;; distribute the TNs evenly across the available locations. At least
1294 ;;; on register-starved architectures (x86) this seems to be a bad
1295 ;;; strategy. -- JES 2004-09-11
1296 (defun select-location (tn sc &key use-reserved-locs optimize)
1297   (declare (type tn tn) (type sc sc) (inline member))
1298   (let* ((sb (sc-sb sc))
1299          (element-size (sc-element-size sc))
1300          (alignment (sc-alignment sc))
1301          (align-mask (1- alignment))
1302          (size (finite-sb-current-size sb)))
1303     (flet ((attempt-location (start-offset)
1304              (dotimes (i element-size
1305                        (return-from select-location start-offset))
1306                (declare (type index i))
1307                (let ((offset (+ start-offset i)))
1308                  (when (offset-conflicts-in-sb tn sb offset)
1309                    (return (logandc2 (the index (+ (the index (1+ offset))
1310                                                    align-mask))
1311                                      align-mask)))))))
1312       (if (eq (sb-kind sb) :unbounded)
1313           (loop with offset = 0
1314                 until (> (+ offset element-size) size) do
1315                 (setf offset (attempt-location offset)))
1316           (let ((locations (sc-locations sc)))
1317             (when optimize
1318               (setf locations
1319                     (stable-sort (copy-list locations) #'>
1320                                  :key (lambda (location-offset)
1321                                         (loop for offset from location-offset
1322                                               repeat element-size
1323                                               maximize (svref
1324                                                         (finite-sb-always-live-count sb)
1325                                                         offset))))))
1326             (dolist (offset locations)
1327               (when (or use-reserved-locs
1328                         (not (member offset
1329                                      (sc-reserve-locations sc))))
1330                 (attempt-location offset))))))))
1331
1332 ;;; If a save TN, return the saved TN, otherwise return TN. This is
1333 ;;; useful for getting the conflicts of a TN that might be a save TN.
1334 (defun original-tn (tn)
1335   (declare (type tn tn))
1336   (if (member (tn-kind tn) '(:save :save-once :specified-save))
1337       (tn-save-tn tn)
1338       tn))
1339 \f
1340 ;;;; pack interface
1341
1342 ;;; Attempt to pack TN in all possible SCs, first in the SC chosen by
1343 ;;; representation selection, then in the alternate SCs in the order
1344 ;;; they were specified in the SC definition. If the TN-COST is
1345 ;;; negative, then we don't attempt to pack in SCs that must be saved.
1346 ;;; If Restricted, then we can only pack in TN-SC, not in any
1347 ;;; Alternate-SCs.
1348 ;;;
1349 ;;; If we are attempting to pack in the SC of the save TN for a TN
1350 ;;; with a :SPECIFIED-SAVE TN, then we pack in that location, instead
1351 ;;; of allocating a new stack location.
1352 (defun pack-tn (tn restricted optimize)
1353   (declare (type tn tn))
1354   (let* ((original (original-tn tn))
1355          (fsc (tn-sc tn))
1356          (alternates (unless restricted (sc-alternate-scs fsc)))
1357          (save (tn-save-tn tn))
1358          (specified-save-sc
1359           (when (and save
1360                      (eq (tn-kind save) :specified-save))
1361             (tn-sc save))))
1362     (do ((sc fsc (pop alternates)))
1363         ((null sc)
1364          (failed-to-pack-error tn restricted))
1365       (when (eq sc specified-save-sc)
1366         (unless (tn-offset save)
1367           (pack-tn save nil optimize))
1368         (setf (tn-offset tn) (tn-offset save))
1369         (setf (tn-sc tn) (tn-sc save))
1370         (return))
1371       (when (or restricted
1372                 (not (and (minusp (tn-cost tn)) (sc-save-p sc))))
1373         (let ((loc (or (find-ok-target-offset original sc)
1374                        (select-location original sc)
1375                        (and restricted
1376                             (select-location original sc :use-reserved-locs t))
1377                        (when (eq (sb-kind (sc-sb sc)) :unbounded)
1378                          (grow-sc sc)
1379                          (or (select-location original sc)
1380                              (error "failed to pack after growing SC?"))))))
1381           (when loc
1382             (add-location-conflicts original sc loc optimize)
1383             (setf (tn-sc tn) sc)
1384             (setf (tn-offset tn) loc)
1385             (return))))))
1386   (values))
1387
1388 ;;; Pack a wired TN, checking that the offset is in bounds for the SB,
1389 ;;; and that the TN doesn't conflict with some other TN already packed
1390 ;;; in that location. If the TN is wired to a location beyond the end
1391 ;;; of a :UNBOUNDED SB, then grow the SB enough to hold the TN.
1392 ;;;
1393 ;;; ### Checking for conflicts is disabled for :SPECIFIED-SAVE TNs.
1394 ;;; This is kind of a hack to make specifying wired stack save
1395 ;;; locations for local call arguments (such as OLD-FP) work, since
1396 ;;; the caller and callee OLD-FP save locations may conflict when the
1397 ;;; save locations don't really (due to being in different frames.)
1398 (defun pack-wired-tn (tn optimize)
1399   (declare (type tn tn))
1400   (let* ((sc (tn-sc tn))
1401          (sb (sc-sb sc))
1402          (offset (tn-offset tn))
1403          (end (+ offset (sc-element-size sc)))
1404          (original (original-tn tn)))
1405     (when (> end (finite-sb-current-size sb))
1406       (unless (eq (sb-kind sb) :unbounded)
1407         (error "~S is wired to a location that is out of bounds." tn))
1408       (grow-sc sc end))
1409
1410     ;; For non-x86 ports the presence of a save-tn associated with a
1411     ;; tn is used to identify the old-fp and return-pc tns. It depends
1412     ;; on the old-fp and return-pc being passed in registers.
1413     #!-(or x86 x86-64)
1414     (when (and (not (eq (tn-kind tn) :specified-save))
1415                (conflicts-in-sc original sc offset))
1416       (error "~S is wired to a location that it conflicts with." tn))
1417
1418     ;; Use the above check, but only print a verbose warning. This can
1419     ;; be helpful for debugging the x86 port.
1420     #+nil
1421     (when (and (not (eq (tn-kind tn) :specified-save))
1422                (conflicts-in-sc original sc offset))
1423           (format t "~&* Pack-wired-tn possible conflict:~%  ~
1424                      tn: ~S; tn-kind: ~S~%  ~
1425                      sc: ~S~%  ~
1426                      sb: ~S; sb-name: ~S; sb-kind: ~S~%  ~
1427                      offset: ~S; end: ~S~%  ~
1428                      original ~S~%  ~
1429                      tn-save-tn: ~S; tn-kind of tn-save-tn: ~S~%"
1430                   tn (tn-kind tn) sc
1431                   sb (sb-name sb) (sb-kind sb)
1432                   offset end
1433                   original
1434                   (tn-save-tn tn) (tn-kind (tn-save-tn tn))))
1435
1436     ;; On the x86 ports the old-fp and return-pc are often passed on
1437     ;; the stack so the above hack for the other ports does not always
1438     ;; work. Here the old-fp and return-pc tns are identified by being
1439     ;; on the stack in their standard save locations.
1440     #!+(or x86 x86-64)
1441     (when (and (not (eq (tn-kind tn) :specified-save))
1442                (not (and (string= (sb-name sb) "STACK")
1443                          (or (= offset 0)
1444                              (= offset 1))))
1445                (conflicts-in-sc original sc offset))
1446       (error "~S is wired to a location that it conflicts with." tn))
1447
1448     (add-location-conflicts original sc offset optimize)))
1449
1450 (defevent repack-block "Repacked a block due to TN unpacking.")
1451
1452 ;;; KLUDGE: Prior to SBCL version 0.8.9.xx, this function was known as
1453 ;;; PACK-BEFORE-GC-HOOK, but was non-functional since approximately
1454 ;;; version 0.8.3.xx since the removal of GC hooks from the system.
1455 ;;; This currently (as of 2004-04-12) runs now after every call to
1456 ;;; PACK, rather than -- as was originally intended -- once per GC
1457 ;;; cycle; this is probably non-optimal, and might require tuning,
1458 ;;; maybe to be called when the data structures exceed a certain size,
1459 ;;; or maybe once every N times.  The KLUDGE is that this rewrite has
1460 ;;; done nothing to improve the reentrance or threadsafety of the
1461 ;;; compiler; it still fails to be callable from several threads at
1462 ;;; the same time.
1463 ;;;
1464 ;;; Brief experiments indicate that during a compilation cycle this
1465 ;;; causes about 10% more consing, and takes about 1%-2% more time.
1466 ;;;
1467 ;;; -- CSR, 2004-04-12
1468 (defun clean-up-pack-structures ()
1469   (dolist (sb *backend-sb-list*)
1470     (unless (eq (sb-kind sb) :non-packed)
1471       (let ((size (sb-size sb)))
1472         (fill (finite-sb-always-live sb) nil)
1473         (setf (finite-sb-always-live sb)
1474               (make-array size
1475                           :initial-element
1476                           #-sb-xc #*
1477                           ;; The cross-compiler isn't very good at
1478                           ;; dumping specialized arrays, so we delay
1479                           ;; construction of this SIMPLE-BIT-VECTOR
1480                           ;; until runtime.
1481                           #+sb-xc (make-array 0 :element-type 'bit)))
1482         (setf (finite-sb-always-live-count sb)
1483               (make-array size
1484                           :initial-element
1485                           #-sb-xc #*
1486                           ;; Ibid
1487                           #+sb-xc (make-array 0 :element-type 'fixnum)))
1488
1489         (fill (finite-sb-conflicts sb) nil)
1490         (setf (finite-sb-conflicts sb)
1491               (make-array size :initial-element '#()))
1492
1493         (fill (finite-sb-live-tns sb) nil)
1494         (setf (finite-sb-live-tns sb)
1495               (make-array size :initial-element nil))))))
1496
1497 (defun pack (component)
1498   (unwind-protect
1499        (let ((optimize nil)
1500              (2comp (component-info component)))
1501          (init-sb-vectors component)
1502
1503          ;; Determine whether we want to do more expensive packing by
1504          ;; checking whether any blocks in the component have (> SPEED
1505          ;; COMPILE-SPEED).
1506          ;;
1507          ;; FIXME: This means that a declaration can have a minor
1508          ;; effect even outside its scope, and as the packing is done
1509          ;; component-globally it'd be tricky to use strict scoping. I
1510          ;; think this is still acceptable since it's just a tradeoff
1511          ;; between compilation speed and allocation quality and
1512          ;; doesn't affect the semantics of the generated code in any
1513          ;; way. -- JES 2004-10-06
1514          (do-ir2-blocks (block component)
1515            (when (policy (block-last (ir2-block-block block))
1516                          (> speed compilation-speed))
1517              (setf optimize t)
1518              (return)))
1519
1520          ;; Call the target functions.
1521          (do-ir2-blocks (block component)
1522            (do ((vop (ir2-block-start-vop block) (vop-next vop)))
1523                ((null vop))
1524              (let ((target-fun (vop-info-target-fun (vop-info vop))))
1525                (when target-fun
1526                  (funcall target-fun vop)))))
1527
1528          ;; Pack wired TNs first.
1529          (do ((tn (ir2-component-wired-tns 2comp) (tn-next tn)))
1530              ((null tn))
1531            (pack-wired-tn tn optimize))
1532
1533          ;; Pack restricted component TNs.
1534          (do ((tn (ir2-component-restricted-tns 2comp) (tn-next tn)))
1535              ((null tn))
1536            (when (eq (tn-kind tn) :component)
1537              (pack-tn tn t optimize)))
1538
1539          ;; Pack other restricted TNs.
1540          (do ((tn (ir2-component-restricted-tns 2comp) (tn-next tn)))
1541              ((null tn))
1542            (unless (tn-offset tn)
1543              (pack-tn tn t optimize)))
1544
1545          ;; Assign costs to normal TNs so we know which ones should
1546          ;; always be packed on the stack.
1547          (when *pack-assign-costs*
1548            (assign-tn-costs component)
1549            (assign-tn-depths component))
1550
1551          ;; Allocate normal TNs, starting with the TNs that are used
1552          ;; in deep loops.
1553          (collect ((tns))
1554            (do-ir2-blocks (block component)
1555              (let ((ltns (ir2-block-local-tns block)))
1556                (do ((i (1- (ir2-block-local-tn-count block)) (1- i)))
1557                    ((minusp i))
1558                  (declare (fixnum i))
1559                  (let ((tn (svref ltns i)))
1560                    (unless (or (null tn)
1561                                (eq tn :more)
1562                                (tn-offset tn))
1563                      ;; If loop analysis has been disabled we might as
1564                      ;; well revert to the old behaviour of just
1565                      ;; packing TNs linearly as they appear.
1566                      (unless *loop-analyze*
1567                        (pack-tn tn nil optimize))
1568                      (tns tn))))))
1569            (dolist (tn (stable-sort (tns)
1570                                     (lambda (a b)
1571                                       (cond
1572                                         ((> (tn-loop-depth a)
1573                                             (tn-loop-depth b))
1574                                          t)
1575                                         ((= (tn-loop-depth a)
1576                                             (tn-loop-depth b))
1577                                          (> (tn-cost a) (tn-cost b)))
1578                                         (t nil)))))
1579              (unless (tn-offset tn)
1580                (pack-tn tn nil optimize))))
1581
1582          ;; Pack any leftover normal TNs. This is to deal with :MORE TNs,
1583          ;; which could possibly not appear in any local TN map.
1584          (do ((tn (ir2-component-normal-tns 2comp) (tn-next tn)))
1585              ((null tn))
1586            (unless (tn-offset tn)
1587              (pack-tn tn nil optimize)))
1588
1589          ;; Do load TN packing and emit saves.
1590          (let ((*repack-blocks* nil))
1591            (cond ((and optimize *pack-optimize-saves*)
1592                   (optimized-emit-saves component)
1593                   (do-ir2-blocks (block component)
1594                     (pack-load-tns block)))
1595                  (t
1596                   (do-ir2-blocks (block component)
1597                     (emit-saves block)
1598                     (pack-load-tns block))))
1599            (loop
1600               (unless *repack-blocks* (return))
1601               (let ((orpb *repack-blocks*))
1602                 (setq *repack-blocks* nil)
1603                 (dolist (block orpb)
1604                   (event repack-block)
1605                   (pack-load-tns block)))))
1606
1607          (values))
1608     (clean-up-pack-structures)))