0.7.13.15:
[sbcl.git] / src / compiler / debug-dump.lisp
1 ;;;; stuff that creates debugger information from the compiler's
2 ;;;; internal data structures
3
4 ;;;; This software is part of the SBCL system. See the README file for
5 ;;;; more information.
6 ;;;;
7 ;;;; This software is derived from the CMU CL system, which was
8 ;;;; written at Carnegie Mellon University and released into the
9 ;;;; public domain. The software is in the public domain and is
10 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
11 ;;;; files for more information.
12
13 (in-package "SB!C")
14
15 (deftype byte-buffer () '(vector (unsigned-byte 8)))
16 (defvar *byte-buffer*)
17 (declaim (type byte-buffer *byte-buffer*))
18 \f
19 ;;;; debug blocks
20
21 (deftype location-kind ()
22   '(member :unknown-return :known-return :internal-error :non-local-exit
23            :block-start :call-site :single-value-return :non-local-entry))
24
25 ;;; The LOCATION-INFO structure holds the information what we need
26 ;;; about locations which code generation decided were "interesting".
27 (defstruct (location-info
28             (:constructor make-location-info (kind label vop))
29             (:copier nil))
30   ;; The kind of location noted.
31   (kind nil :type location-kind)
32   ;; The label pointing to the interesting code location.
33   (label nil :type (or label index null))
34   ;; The VOP that emitted this location (for node, save-set, ir2-block, etc.)
35   (vop nil :type vop))
36
37 ;;; This is called during code generation in places where there is an
38 ;;; "interesting" location: someplace where we are likely to end up
39 ;;; in the debugger, and thus want debug info.
40 (defun note-debug-location (vop label kind)
41   (declare (type vop vop) (type (or label null) label)
42            (type location-kind kind))
43   (let ((location (make-location-info kind label vop)))
44     (setf (ir2-block-locations (vop-block vop))
45           (nconc (ir2-block-locations (vop-block vop))
46                  (list location)))
47     location))
48
49 #!-sb-fluid (declaim (inline ir2-block-physenv))
50 (defun ir2-block-physenv (2block)
51   (declare (type ir2-block 2block))
52   (block-physenv (ir2-block-block 2block)))
53
54 ;;; Given a local conflicts vector and an IR2 block to represent the
55 ;;; set of live TNs, and the VAR-LOCS hash-table representing the
56 ;;; variables dumped, compute a bit-vector representing the set of
57 ;;; live variables. If the TN is environment-live, we only mark it as
58 ;;; live when it is in scope at NODE.
59 (defun compute-live-vars (live node block var-locs vop)
60   (declare (type ir2-block block) (type local-tn-bit-vector live)
61            (type hash-table var-locs) (type node node)
62            (type (or vop null) vop))
63   (let ((res (make-array (logandc2 (+ (hash-table-count var-locs) 7) 7)
64                          :element-type 'bit
65                          :initial-element 0))
66         (spilled (gethash vop
67                           (ir2-component-spilled-vops
68                            (component-info *component-being-compiled*)))))
69     (do-live-tns (tn live block)
70       (let ((leaf (tn-leaf tn)))
71         (when (and (lambda-var-p leaf)
72                    (or (not (member (tn-kind tn)
73                                     '(:environment :debug-environment)))
74                        (rassoc leaf (lexenv-vars (node-lexenv node))))
75                    (or (null spilled)
76                        (not (member tn spilled))))
77           (let ((num (gethash leaf var-locs)))
78             (when num
79               (setf (sbit res num) 1))))))
80     res))
81
82 ;;; The PC for the location most recently dumped.
83 (defvar *previous-location*)
84 (declaim (type index *previous-location*))
85
86 ;;; Dump a compiled debug-location into *BYTE-BUFFER* that describes
87 ;;; the code/source map and live info. If true, VOP is the VOP
88 ;;; associated with this location, for use in determining whether TNs
89 ;;; are spilled.
90 (defun dump-1-location (node block kind tlf-num label live var-locs vop)
91   (declare (type node node) (type ir2-block block)
92            (type local-tn-bit-vector live)
93            (type (or label index) label)
94            (type location-kind kind) (type (or index null) tlf-num)
95            (type hash-table var-locs) (type (or vop null) vop))
96
97   (vector-push-extend
98    (dpb (position-or-lose kind *compiled-code-location-kinds*)
99         compiled-code-location-kind-byte
100         0)
101    *byte-buffer*)
102
103   (let ((loc (if (fixnump label) label (label-position label))))
104     (write-var-integer (- loc *previous-location*) *byte-buffer*)
105     (setq *previous-location* loc))
106
107   (let ((path (node-source-path node)))
108     (unless tlf-num
109       (write-var-integer (source-path-tlf-number path) *byte-buffer*))
110     (write-var-integer (source-path-form-number path) *byte-buffer*))
111
112   (write-packed-bit-vector (compute-live-vars live node block var-locs vop)
113                            *byte-buffer*)
114
115   (values))
116
117 ;;; Extract context info from a Location-Info structure and use it to
118 ;;; dump a compiled code-location.
119 (defun dump-location-from-info (loc tlf-num var-locs)
120   (declare (type location-info loc) (type (or index null) tlf-num)
121            (type hash-table var-locs))
122   (let ((vop (location-info-vop loc)))
123     (dump-1-location (vop-node vop)
124                      (vop-block vop)
125                      (location-info-kind loc)
126                      tlf-num
127                      (location-info-label loc)
128                      (vop-save-set vop)
129                      var-locs
130                      vop))
131   (values))
132
133 ;;; Scan all the blocks, determining if all locations are in the same
134 ;;; TLF, and returning it or NIL.
135 (defun find-tlf-number (fun)
136   (declare (type clambda fun))
137   (let ((res (source-path-tlf-number (node-source-path (lambda-bind fun)))))
138     (declare (type (or index null) res))
139     (do-physenv-ir2-blocks (2block (lambda-physenv fun))
140       (let ((block (ir2-block-block 2block)))
141         (when (eq (block-info block) 2block)
142           (unless (eql (source-path-tlf-number
143                         (node-source-path
144                          (continuation-next
145                           (block-start block))))
146                        res)
147             (setq res nil)))
148         
149         (dolist (loc (ir2-block-locations 2block))
150           (unless (eql (source-path-tlf-number
151                         (node-source-path
152                          (vop-node (location-info-vop loc))))
153                        res)
154             (setq res nil)))))
155     res))
156
157 ;;; Dump out the number of locations and the locations for Block.
158 (defun dump-block-locations (block locations tlf-num var-locs)
159   (declare (type cblock block) (list locations))
160   (if (and locations
161            (eq (location-info-kind (first locations))
162                :non-local-entry))
163       (write-var-integer (length locations) *byte-buffer*)
164       (let ((2block (block-info block)))
165         (write-var-integer (+ (length locations) 1) *byte-buffer*)
166         (dump-1-location (continuation-next (block-start block))
167                          2block :block-start tlf-num
168                          (ir2-block-%label 2block)
169                          (ir2-block-live-out 2block)
170                          var-locs
171                          nil)))
172   (dolist (loc locations)
173     (dump-location-from-info loc tlf-num var-locs))
174   (values))
175
176 ;;; Dump the successors of Block, being careful not to fly into space
177 ;;; on weird successors.
178 (defun dump-block-successors (block physenv)
179   (declare (type cblock block) (type physenv physenv))
180   (let* ((tail (component-tail (block-component block)))
181          (succ (block-succ block))
182          (valid-succ
183           (if (and succ
184                    (or (eq (car succ) tail)
185                        (not (eq (block-physenv (car succ)) physenv))))
186               ()
187               succ)))
188     (vector-push-extend
189      (dpb (length valid-succ) compiled-debug-block-nsucc-byte 0)
190      *byte-buffer*)
191     (let ((base (block-number
192                  (node-block
193                   (lambda-bind (physenv-lambda physenv))))))
194       (dolist (b valid-succ)
195         (write-var-integer
196          (the index (- (block-number b) base))
197          *byte-buffer*))))
198   (values))
199
200 ;;; Return a vector and an integer (or null) suitable for use as the
201 ;;; BLOCKS and TLF-NUMBER in FUN's DEBUG-FUN. This requires two
202 ;;; passes to compute:
203 ;;; -- Scan all blocks, dumping the header and successors followed
204 ;;;    by all the non-elsewhere locations.
205 ;;; -- Dump the elsewhere block header and all the elsewhere 
206 ;;;    locations (if any.)
207 (defun compute-debug-blocks (fun var-locs)
208   (declare (type clambda fun) (type hash-table var-locs))
209   (setf (fill-pointer *byte-buffer*) 0)
210   (let ((*previous-location* 0)
211         (tlf-num (find-tlf-number fun))
212         (physenv (lambda-physenv fun))
213         (prev-locs nil)
214         (prev-block nil))
215     (collect ((elsewhere))
216       (do-physenv-ir2-blocks (2block physenv)
217         (let ((block (ir2-block-block 2block)))
218           (when (eq (block-info block) 2block)
219             (when prev-block
220               (dump-block-locations prev-block prev-locs tlf-num var-locs))
221             (setq prev-block block  prev-locs ())
222             (dump-block-successors block physenv)))
223         
224         (collect ((here prev-locs))
225           (dolist (loc (ir2-block-locations 2block))
226             (if (label-elsewhere-p (location-info-label loc))
227                 (elsewhere loc)
228                 (here loc)))
229           (setq prev-locs (here))))
230
231       (dump-block-locations prev-block prev-locs tlf-num var-locs)
232
233       (when (elsewhere)
234         (vector-push-extend compiled-debug-block-elsewhere-p *byte-buffer*)
235         (write-var-integer (length (elsewhere)) *byte-buffer*)
236         (dolist (loc (elsewhere))
237           (dump-location-from-info loc tlf-num var-locs))))
238
239     (values (copy-seq *byte-buffer*) tlf-num)))
240 \f
241 ;;; Return a list of DEBUG-SOURCE structures containing information
242 ;;; derived from INFO. Unless :BYTE-COMPILE T was specified, we always
243 ;;; dump the START-POSITIONS, since it is too hard figure out whether
244 ;;; we need them or not.
245 (defun debug-source-for-info (info)
246   (declare (type source-info info))
247   (let* ((file-info (source-info-file-info info))
248          (res (make-debug-source
249                :from :file
250                :created (file-info-write-date file-info)
251                :compiled (source-info-start-time info)
252                :source-root (file-info-source-root file-info)
253                :start-positions (coerce-to-smallest-eltype
254                                  (file-info-positions file-info))))
255          (name (file-info-name file-info)))
256     (etypecase name
257       ((member :lisp)
258        (setf (debug-source-from res) name)
259        (setf (debug-source-name res)
260              (coerce (file-info-forms file-info) 'simple-vector)))
261       (pathname
262        (let* ((untruename (file-info-untruename file-info))
263               (dir (pathname-directory untruename)))
264          (setf (debug-source-name res)
265                (namestring
266                 (if (and dir (eq (first dir) :absolute))
267                     untruename
268                     name))))))
269     (list res)))
270
271
272 ;;; Given an arbitrary sequence, coerce it to an unsigned vector if
273 ;;; possible. Ordinarily we coerce it to the smallest specialized
274 ;;; vector we can. However, we also have a special hack for
275 ;;; cross-compiling at bootstrap time, when arbitrarily-specialized
276 ;;; vectors aren't fully supported: in that case, we coerce it only to
277 ;;; a vector whose element size is an integer multiple of output byte
278 ;;; size.
279 (defun coerce-to-smallest-eltype (seq)
280   (let ((maxoid ;; It's probably better to avoid (UNSIGNED-BYTE 0).
281                 #-sb-xc-host 1 
282                 ;; An initial value of 255 prevents us from
283                 ;; specializing the array to anything smaller than
284                 ;; (UNSIGNED-BYTE 8), which keeps the cross-compiler's
285                 ;; portable specialized array output functions happy.
286                 #+sb-xc-host 255))
287     (flet ((frob (x)
288              (if (typep x 'unsigned-byte)
289                  (when (>= x maxoid)
290                    (setf maxoid x))
291                  (return-from coerce-to-smallest-eltype
292                    (coerce seq 'simple-vector)))))
293       (if (listp seq)
294           (dolist (i seq)
295             (frob i))
296           (dovector (i seq)
297             (frob i)))
298       (let ((specializer `(unsigned-byte ,(integer-length maxoid))))
299         ;; cross-compilers beware! It would be possible for the
300         ;; upgraded-array-element-type of (UNSIGNED-BYTE 15) to be
301         ;; (SIGNED-BYTE 16), and this is completely valid by
302         ;; ANSI. However, the cross-compiler doesn't know how to dump
303         ;; SIGNED-BYTE arrays, so better make it break now if it ever
304         ;; will:
305         #+sb-xc-host
306         (aver (subtypep (upgraded-array-element-type specializer) 
307                         'unsigned-byte))
308         (coerce seq `(simple-array ,specializer (*)))))))
309 \f
310 ;;;; variables
311
312 ;;; Return a SC-OFFSET describing TN's location.
313 (defun tn-sc-offset (tn)
314   (declare (type tn tn))
315   (make-sc-offset (sc-number (tn-sc tn))
316                   (tn-offset tn)))
317
318 ;;; Dump info to represent VAR's location being TN. ID is an integer
319 ;;; that makes VAR's name unique in the function. BUFFER is the vector
320 ;;; we stick the result in. If MINIMAL, we suppress name dumping, and
321 ;;; set the minimal flag.
322 ;;;
323 ;;; The DEBUG-VAR is only marked as always-live if the TN is
324 ;;; environment live and is an argument. If a :DEBUG-ENVIRONMENT TN,
325 ;;; then we also exclude set variables, since the variable is not
326 ;;; guaranteed to be live everywhere in that case.
327 (defun dump-1-var (fun var tn id minimal buffer)
328   (declare (type lambda-var var) (type (or tn null) tn) (type index id)
329            (type clambda fun))
330   (let* ((name (leaf-debug-name var))
331          (save-tn (and tn (tn-save-tn tn)))
332          (kind (and tn (tn-kind tn)))
333          (flags 0))
334     (declare (type index flags))
335     (when minimal
336       (setq flags (logior flags compiled-debug-var-minimal-p))
337       (unless tn
338         (setq flags (logior flags compiled-debug-var-deleted-p))))
339     (when (and (or (eq kind :environment)
340                    (and (eq kind :debug-environment)
341                         (null (basic-var-sets var))))
342                (not (gethash tn (ir2-component-spilled-tns
343                                  (component-info *component-being-compiled*))))
344                (eq (lambda-var-home var) fun))
345       (setq flags (logior flags compiled-debug-var-environment-live)))
346     (when save-tn
347       (setq flags (logior flags compiled-debug-var-save-loc-p)))
348     (unless (or (zerop id) minimal)
349       (setq flags (logior flags compiled-debug-var-id-p)))
350     (vector-push-extend flags buffer)
351     (unless minimal
352       (vector-push-extend name buffer)
353       (unless (zerop id)
354         (vector-push-extend id buffer)))
355     (if tn
356         (vector-push-extend (tn-sc-offset tn) buffer)
357         (aver minimal))
358     (when save-tn
359       (vector-push-extend (tn-sc-offset save-tn) buffer)))
360   (values))
361
362 ;;; Return a vector suitable for use as the DEBUG-FUN-VARS
363 ;;; of FUN. LEVEL is the current DEBUG-INFO quality. VAR-LOCS is a
364 ;;; hash table in which we enter the translation from LAMBDA-VARS to
365 ;;; the relative position of that variable's location in the resulting
366 ;;; vector.
367 (defun compute-vars (fun level var-locs)
368   (declare (type clambda fun) (type hash-table var-locs))
369   (collect ((vars))
370     (labels ((frob-leaf (leaf tn gensym-p)
371                (let ((name (leaf-debug-name leaf)))
372                  (when (and name (leaf-refs leaf) (tn-offset tn)
373                             (or gensym-p (symbol-package name)))
374                    (vars (cons leaf tn)))))
375              (frob-lambda (x gensym-p)
376                (dolist (leaf (lambda-vars x))
377                  (frob-leaf leaf (leaf-info leaf) gensym-p))))
378       (frob-lambda fun t)
379       (when (>= level 2)
380         (dolist (x (ir2-physenv-closure (physenv-info (lambda-physenv fun))))
381           (let ((thing (car x)))
382             (when (lambda-var-p thing)
383               (frob-leaf thing (cdr x) (= level 3)))))
384         
385         (dolist (let (lambda-lets fun))
386           (frob-lambda let (= level 3)))))
387
388     (let ((sorted (sort (vars) #'string<
389                         :key (lambda (x)
390                                (symbol-name (leaf-debug-name (car x))))))
391           (prev-name nil)
392           (id 0)
393           (i 0)
394           (buffer (make-array 0 :fill-pointer 0 :adjustable t)))
395       (declare (type (or simple-string null) prev-name)
396                (type index id i))
397       (dolist (x sorted)
398         (let* ((var (car x))
399                (name (symbol-name (leaf-debug-name var))))
400           (cond ((and prev-name (string= prev-name name))
401                  (incf id))
402                 (t
403                  (setq id 0  prev-name name)))
404           (dump-1-var fun var (cdr x) id nil buffer)
405           (setf (gethash var var-locs) i))
406         (incf i))
407       (coerce buffer 'simple-vector))))
408
409 ;;; Return a vector suitable for use as the DEBUG-FUN-VARS of
410 ;;; FUN, representing the arguments to FUN in minimal variable format.
411 (defun compute-minimal-vars (fun)
412   (declare (type clambda fun))
413   (let ((buffer (make-array 0 :fill-pointer 0 :adjustable t)))
414     (dolist (var (lambda-vars fun))
415       (dump-1-var fun var (leaf-info var) 0 t buffer))
416     (coerce buffer 'simple-vector)))
417
418 ;;; Return VAR's relative position in the function's variables (determined
419 ;;; from the VAR-LOCS hashtable).  If VAR is deleted, then return DELETED.
420 (defun debug-location-for (var var-locs)
421   (declare (type lambda-var var) (type hash-table var-locs))
422   (let ((res (gethash var var-locs)))
423     (cond (res)
424           (t
425            (aver (or (null (leaf-refs var))
426                      (not (tn-offset (leaf-info var)))))
427            'deleted))))
428 \f
429 ;;;; arguments/returns
430
431 ;;; Return a vector to be used as the COMPILED-DEBUG-FUN-ARGS for FUN.
432 ;;; If FUN is the MAIN-ENTRY for an optional dispatch, then look at
433 ;;; the ARGLIST to determine the syntax, otherwise pretend all
434 ;;; arguments are fixed.
435 ;;;
436 ;;; ### This assumption breaks down in EPs other than the main-entry,
437 ;;; since they may or may not have supplied-p vars, etc.
438 (defun compute-args (fun var-locs)
439   (declare (type clambda fun) (type hash-table var-locs))
440   (collect ((res))
441     (let ((od (lambda-optional-dispatch fun)))
442       (if (and od (eq (optional-dispatch-main-entry od) fun))
443           (let ((actual-vars (lambda-vars fun))
444                 (saw-optional nil))
445             (dolist (arg (optional-dispatch-arglist od))
446               (let ((info (lambda-var-arg-info arg))
447                     (actual (pop actual-vars)))
448                 (cond (info
449                        (case (arg-info-kind info)
450                          (:keyword
451                           (res (arg-info-key info)))
452                          (:rest
453                           (res 'rest-arg))
454                          (:more-context
455                           (res 'more-arg))
456                          (:optional
457                           (unless saw-optional
458                             (res 'optional-args)
459                             (setq saw-optional t))))
460                        (res (debug-location-for actual var-locs))
461                        (when (arg-info-supplied-p info)
462                          (res 'supplied-p)
463                          (res (debug-location-for (pop actual-vars) var-locs))))
464                       (t
465                        (res (debug-location-for actual var-locs)))))))
466           (dolist (var (lambda-vars fun))
467             (res (debug-location-for var var-locs)))))
468
469     (coerce-to-smallest-eltype (res))))
470
471 ;;; Return a vector of SC offsets describing FUN's return locations.
472 ;;; (Must be known values return...)
473 (defun compute-debug-returns (fun)
474   (coerce-to-smallest-eltype
475    (mapcar (lambda (loc)
476              (tn-sc-offset loc))
477            (return-info-locations (tail-set-info (lambda-tail-set fun))))))
478 \f
479 ;;;; debug functions
480
481 ;;; Return a C-D-F structure with all the mandatory slots filled in.
482 (defun dfun-from-fun (fun)
483   (declare (type clambda fun))
484   (let* ((2env (physenv-info (lambda-physenv fun)))
485          (dispatch (lambda-optional-dispatch fun))
486          (main-p (and dispatch
487                       (eq fun (optional-dispatch-main-entry dispatch)))))
488     (make-compiled-debug-fun
489      :name (leaf-debug-name fun)
490      :kind (if main-p nil (functional-kind fun))
491      :return-pc (tn-sc-offset (ir2-physenv-return-pc 2env))
492      :old-fp (tn-sc-offset (ir2-physenv-old-fp 2env))
493      :start-pc (label-position (ir2-physenv-environment-start 2env))
494      :elsewhere-pc (label-position (ir2-physenv-elsewhere-start 2env)))))
495
496 ;;; Return a complete C-D-F structure for FUN. This involves
497 ;;; determining the DEBUG-INFO level and filling in optional slots as
498 ;;; appropriate.
499 (defun compute-1-debug-fun (fun var-locs)
500   (declare (type clambda fun) (type hash-table var-locs))
501   (let* ((dfun (dfun-from-fun fun))
502          (actual-level (policy (lambda-bind fun) debug))
503          (level (if #!+sb-dyncount *collect-dynamic-statistics*
504                     #!-sb-dyncount nil
505                     (max actual-level 2)
506                     actual-level)))
507     (cond ((zerop level))
508           ((and (<= level 1)
509                 (let ((od (lambda-optional-dispatch fun)))
510                   (or (not od)
511                       (not (eq (optional-dispatch-main-entry od) fun)))))
512            (setf (compiled-debug-fun-vars dfun)
513                  (compute-minimal-vars fun))
514            (setf (compiled-debug-fun-arguments dfun) :minimal))
515           (t
516            (setf (compiled-debug-fun-vars dfun)
517                  (compute-vars fun level var-locs))
518            (setf (compiled-debug-fun-arguments dfun)
519                  (compute-args fun var-locs))))
520
521     (when (>= level 2)
522       (multiple-value-bind (blocks tlf-num) (compute-debug-blocks fun var-locs)
523         (setf (compiled-debug-fun-tlf-number dfun) tlf-num)
524         (setf (compiled-debug-fun-blocks dfun) blocks)))
525
526     (if (xep-p fun)
527         (setf (compiled-debug-fun-returns dfun) :standard)
528         (let ((info (tail-set-info (lambda-tail-set fun))))
529           (when info
530             (cond ((eq (return-info-kind info) :unknown)
531                    (setf (compiled-debug-fun-returns dfun)
532                          :standard))
533                   ((/= level 0)
534                    (setf (compiled-debug-fun-returns dfun)
535                          (compute-debug-returns fun)))))))
536     dfun))
537 \f
538 ;;;; full component dumping
539
540 ;;; Compute the full form (simple-vector) function map.
541 (defun compute-debug-fun-map (sorted)
542   (declare (list sorted))
543   (let* ((len (1- (* (length sorted) 2)))
544          (funs-vec (make-array len)))
545     (do ((i -1 (+ i 2))
546          (sorted sorted (cdr sorted)))
547         ((= i len))
548       (declare (fixnum i))
549       (let ((dfun (car sorted)))
550         (unless (minusp i)
551           (setf (svref funs-vec i) (car dfun)))
552         (setf (svref funs-vec (1+ i)) (cdr dfun))))
553     funs-vec))
554
555 ;;; Return a DEBUG-INFO structure describing COMPONENT. This has to be
556 ;;; called after assembly so that source map information is available.
557 (defun debug-info-for-component (component)
558   (declare (type component component))
559   (let ((dfuns nil)
560         (var-locs (make-hash-table :test 'eq))
561         (*byte-buffer* (make-array 10
562                                    :element-type '(unsigned-byte 8)
563                                    :fill-pointer 0
564                                    :adjustable t)))
565     (dolist (lambda (component-lambdas component))
566       (clrhash var-locs)
567       (push (cons (label-position (block-label (lambda-block lambda)))
568                   (compute-1-debug-fun lambda var-locs))
569             dfuns))
570     (let* ((sorted (sort dfuns #'< :key #'car))
571            (fun-map (compute-debug-fun-map sorted)))
572       (make-compiled-debug-info :name (component-name component)
573                                 :fun-map fun-map))))
574 \f
575 ;;; Write BITS out to BYTE-BUFFER in backend byte order. The length of
576 ;;; BITS must be evenly divisible by eight.
577 (defun write-packed-bit-vector (bits byte-buffer)
578   (declare (type simple-bit-vector bits) (type byte-buffer byte-buffer))
579
580   ;; Enforce constraint from CMU-CL-era comment.
581   (aver (zerop (mod (length bits) 8)))
582
583   (multiple-value-bind (initial step done)
584       (ecase *backend-byte-order*
585         (:little-endian (values 0  1  8))
586         (:big-endian    (values 7 -1 -1)))
587     (let ((shift initial)
588           (byte 0))
589       (dotimes (i (length bits))
590         (let ((int (aref bits i)))
591           (setf byte (logior byte (ash int shift)))
592           (incf shift step))
593         (when (= shift done)
594           (vector-push-extend byte byte-buffer)
595           (setf shift initial
596                 byte 0)))
597       (unless (= shift initial)
598         (vector-push-extend byte byte-buffer))))
599   (values))