3 ;;;; This software is part of the SBCL system. See the README file for
6 ;;;; This software is derived from the CMU CL system, which was
7 ;;;; written at Carnegie Mellon University and released into the
8 ;;;; public domain. The software is in the public domain and is
9 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
10 ;;;; files for more information.
12 ;;; This is a linear ordering of system sources which works both to
13 ;;; compile/load the cross-compiler under the host Common Lisp and to
14 ;;; cross-compile the compiler into the under-construction target
17 ;;; Of course, it'd be very nice to have this be a dependency DAG
18 ;;; instead, so that we could do automated incremental recompilation.
19 ;;; But the dependencies are varied and subtle, and it'd be extremely
20 ;;; difficult to extract them automatically, and it'd be extremely
21 ;;; tedious and error-prone to extract them manually, so we don't
22 ;;; extract them. (It would be nice to fix this someday. The most
23 ;;; feasible approach that I can think of would be to make the
24 ;;; dependencies work on a package level, not an individual file
25 ;;; level. Doing it at the package level would make the granularity
26 ;;; coarse enough that it would probably be pretty easy to maintain
27 ;;; the dependency information manually, and the brittleness of the
28 ;;; package system would help make most violations of the declared
29 ;;; dependencies obvious at build time. -- WHN 20000803
31 ;;; FIXME: Perhaps now that a significant number of files are built
32 ;;; in warm load instead of cold load, this file should now be called
33 ;;; cold-stems-and-flags.lisp-expr? Also, perhaps this file should move
34 ;;; into the src/cold directory?
36 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
39 ;; This comes early because it's useful for debugging everywhere.
42 ;; This comes early because the cross-compilation host's backquote logic
43 ;; expand into something which can't be executed on the target Lisp (e.g.
44 ;; in CMU CL where it expands into internal functions like BACKQ-LIST), and
45 ;; by replacing the host backquote logic with our own as early as possible,
46 ;; we minimize the chance of any forms referring to host Lisp internal
47 ;; functions leaking into target Lisp code.
50 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
51 ;; various DEFSETFs and/or other DEFMACROish things, defined as early as
52 ;; possible so we don't need to fiddle with any subtleties of defining them
53 ;; before any possible use
55 ;; KLUDGE: It would be nice to reimplement most or all of these as
56 ;; functions (possibly inlined functions) so that we wouldn't need to
57 ;; worry so much about forcing them all to be defined before any possible
58 ;; use. It might be pretty tedious, though, working through any
59 ;; transforms and translators and optimizers and so forth to make sure
60 ;; that they can handle the change. -- WHN 19990919
63 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
64 ;;; cross-compiler-only replacements for stuff which in target Lisp would be
65 ;;; supplied by basic machinery
67 ("code/cross-misc" :not-target)
68 ("code/cross-float" :not-target)
69 ("code/cross-io" :not-target)
70 ("code/cross-sap" :not-target)
72 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
73 ;;; stuff needed early both in cross-compilation host and in target Lisp
76 ("code/early-defbangmethod")
81 ("code/primordial-extensions")
83 ;; for various constants e.g. SB!VM:*TARGET-MOST-POSITIVE-FIXNUM* and
84 ;; SB!VM:LOWTAG-BITS, needed by "early-objdef" and others
85 ("compiler/generic/early-vm")
86 ("compiler/generic/early-objdef")
87 ("compiler/target/parms")
88 ("code/early-array") ; needs "early-vm" numbers
90 ("code/parse-body") ; on host for PARSE-BODY
91 ("code/parse-defmacro") ; on host for PARSE-DEFMACRO
92 ("code/boot-extensions") ; on host for COLLECT etc.
93 ("code/early-extensions") ; on host for SYMBOLICATE etc.
94 ("code/late-extensions") ; FIXME: maybe no longer needed on host now that
95 ; we are no longer doing PRINT-HERALD stuff
96 ("compiler/deftype") ; on host for SB!XC:DEFTYPE
97 ("code/early-alieneval") ; for vars needed both at build time and at runtime
99 ("code/specializable-array")
104 ;; mostly needed by stuff from comcom, but also used by "x86-vm"
105 ("code/debug-var-io")
107 ("code/cold-init-helper-macros")
109 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
110 ;;; basic machinery for the target Lisp. Note that although most of these
111 ;;; files are flagged :NOT-HOST, a few might not be.
113 ("code/target-defbangmethod" :not-host)
115 ("code/early-print" :not-host)
116 ("code/early-pprint" :not-host)
117 ("code/early-impl" :not-host)
119 ("code/target-extensions" :not-host)
121 ("code/early-defstructs" :not-host) ; gotta-be-first DEFSTRUCTs
123 ("code/defbangstruct")
125 ;; This needs DEF!STRUCT, and is itself needed early so that structure
126 ;; accessors and inline functions defined here can be compiled inline
127 ;; later. (Avoiding full calls not only increases efficiency, but also
128 ;; avoids some cold init issues involving full calls to structure
132 ("code/lisp-stream" :not-host)
134 ("code/sysmacs" :not-host)
136 ;; "assembly/assemfile" was here in the sequence inherited from
137 ;; CMU CL worldcom.lisp, but also appears later in the sequence
138 ;; inherited from CMU CL comcom.lisp. We shouldn't need two versions,
139 ;; so I've deleted the one here. -- WHN 19990620
141 ;; FIXME: There are lots of "maybe" notes in this file, e.g.
142 ;; "maybe should be :BYTE-COMPILE T". Once the system is stable,
145 ("code/early-target-error" :not-host) ; maybe should be :BYTE-COMPILE T
146 ;; FIXME: maybe should be called "target-error", with "late-target-error"
147 ;; called "condition"
149 ;; a comment from classic CMU CL:
150 ;; "These guys can supposedly come in any order, but not really.
151 ;; Some are put at the end so that macros don't run interpreted
153 ;; Dunno exactly what this meant or whether it still holds. -- WHN 19990803
154 ;; FIXME: more informative and up-to-date comment?
155 ("code/globals" :not-host)
156 ("code/kernel" :not-host)
157 ("code/toplevel" :not-host)
158 ("code/cold-error" :not-host)
159 ("code/fdefinition" :not-host)
160 ;; FIXME: Figure out some way to make the compiler macro for INFO
161 ;; available for compilation of "code/fdefinition".
163 ;; In classic CMU CL, code/type was here. I've since split that into
164 ;; lots of smaller pieces, some of which are here and some of which
165 ;; are handled later in the sequence, when the cross-compiler is
166 ;; built. -- WHN 19990620
167 ("code/target-type" :not-host)
169 ("code/pred" :not-host)
171 ("code/target-alieneval" :not-host)
172 ("code/target-c-call" :not-host)
173 ("code/target-allocate" :not-host)
175 ("code/array" :not-host)
176 ("code/target-sxhash" :not-host)
178 ("code/list" :not-host)
179 ("code/seq" :not-host) ; "code/seq" should come after "code/list".
180 ("code/coerce" :not-host)
182 ("code/string" :not-host)
183 ("code/mipsstrops" :not-host)
185 ("code/unix" :not-host)
187 #!+mach ("code/mach" :not-host)
188 #!+mach ("code/mach-os" :not-host)
189 #!+sunos ("code/sunos-os" :not-host)
190 #!+hpux ("code/hpux-os" :not-host)
191 #!+osf1 ("code/osf1-os" :not-host)
192 #!+irix ("code/irix-os" :not-host)
193 #!+bsd ("code/bsd-os" :not-host)
194 #!+linux ("code/linux-os" :not-host)
196 ;; KLUDGE: I'd prefer to have this done with a "code/target" softlink
197 ;; instead of a bunch of reader macros. -- WHN 19990308
198 #!+pmax ("code/pmax-vm" :not-host)
199 #!+(and sparc svr4) ("code/sparc-svr4-vm" :not-host)
200 #!+(and sparc (not svr4)) ("code/sparc-vm" :not-host)
201 #!+rt ("code/rt-vm" :not-host)
202 #!+hppa ("code/hppa-vm" :not-host)
203 #!+x86 ("code/x86-vm" :not-host)
204 #!+alpha ("code/alpha-vm" :not-host)
205 #!+sgi ("code/sgi-vm" :not-host)
207 ("code/target-signal" :not-host) ; needs OS-CONTEXT-T from x86-vm
209 ("code/symbol" :not-host)
210 ("code/bignum" :not-host)
211 ("code/target-numbers" :not-host)
212 ("code/float-trap" :not-host)
213 ("code/float" :not-host)
214 ("code/irrat" :not-host)
216 ("code/char" :not-host)
217 ("code/target-misc" :not-host)
220 #!-gengc ("code/room" :not-host)
221 #!-gengc ("code/gc" :not-host)
222 #!-gengc ("code/purify" :not-host)
224 #!+gengc ("code/gengc" :not-host)
226 ("code/stream" :not-host)
227 ("code/print" :not-host)
228 ("code/pprint" :not-host) ; maybe should be :BYTE-COMPILE T
229 ("code/early-format")
230 ("code/target-format" :not-host) ; maybe should be :BYTE-COMPILE T
231 ("code/defpackage" :not-host)
232 ("code/pp-backq" :not-host) ; maybe should be :BYTE-COMPILE T
234 ("code/error-error" :not-host) ; needs WITH-STANDARD-IO-SYNTAX macro
236 ("code/serve-event" :not-host)
237 ("code/fd-stream" :not-host)
239 ("code/module" :not-host) ; maybe should be :BYTE-COMPILE T
244 ("code/target-eval" :not-host) ; FIXME: uses INFO, wants compiler macro
246 ("code/interr" :not-host)
248 ("code/query" :not-host) ; maybe should be :BYTE-COMPILE T
250 ("code/sort" :not-host)
251 ("code/time" :not-host)
252 ("code/weak" :not-host)
253 ("code/final" :not-host)
255 #!+mp ("code/multi-proc" :not-host)
257 ("code/setf-funs" :not-host)
259 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
260 ;;; compiler (and a few miscellaneous files whose dependencies make it
261 ;;; convenient to stick them here)
269 ;; ("code/defbangmacro" was here until sbcl-0.6.7.3.)
272 ("compiler/generic/vm-macs")
274 ;; needed by "compiler/vop"
277 ;; for e.g. BLOCK-ANNOTATION, needed by "compiler/vop"
280 ;; for e.g. PRIMITIVE-TYPE, needed by "vmdef"
283 ;; needed by "vm" and "primtype"
286 ;; for e.g. MAX-VOP-TN-REFS, needed by "meta-vmdef"
290 ("compiler/target/backend-parms")
292 ;; for INFO and SB!XC:MACRO-FUNCTION, needed by defmacro.lisp
293 ("compiler/globaldb")
294 ("compiler/info-functions")
297 ("code/force-delayed-defbangmacros")
299 ("compiler/late-macros")
301 ;; for e.g. DEF-PRIMITIVE-TYPE, needed by primtype.lisp, and
302 ;; DEFINE-STORAGE-CLASS, needed by target/vm.lisp
303 ("compiler/meta-vmdef")
305 ;; for e.g. DESCRIPTOR-REG, needed by primtype.lisp
306 ("compiler/target/vm")
308 ;; for e.g. SPECIFIER-TYPE, needed by primtype.lisp
311 ;; FIXME: Classic CMU CL had SAFETY 2 DEBUG 2 set around the compilation
312 ;; of "code/class". Why?
315 ;; The definitions for CONDITION and CONDITION-CLASS depend on
316 ;; SLOT-CLASS, defined in classes.lisp.
317 ("code/late-target-error" :not-host) ; FIXME: maybe should be :BYTE-COMPILE T
319 ("compiler/generic/primtype")
321 ;; the implementation of the compiler-affecting part of forms like
322 ;; DEFMACRO and DEFTYPE; must be loaded before we can start
324 ("compiler/parse-lambda-list")
326 ;; for DEFSTRUCT ALIEN-TYPE, needed by host-type.lisp
327 ("code/host-alieneval")
329 ;; can't be done until definition of e.g. DEF-ALIEN-TYPE-CLASS in
330 ;; host-alieneval.lisp
333 ;; SB!XC:DEFTYPE is needed in order to compile late-target-type
334 ;; in the host Common Lisp, and in order to run, it needs
335 ;; %COMPILER-DEFTYPE.
336 ("compiler/compiler-deftype")
338 ;; These appear here in the build sequence because they require
339 ;; * the macro INFO, defined in globaldb.lisp, and
340 ;; * the function PARSE-DEFMACRO, defined in parse-defmacro.lisp,
341 ;; and because they define
342 ;; * the function SPECIFIER-TYPE, which is used in fndb.lisp.
344 ("code/deftypes-for-target")
346 ;; The inline definition of TYPEP-TO-LAYOUT here needs inline
347 ;; functions defined in classes.lisp, and is needed in turn by
348 ;; the target version of "code/defstruct".
349 ("code/target-defstruct" :not-host)
351 ;; stuff needed by "code/defstruct"
352 ("code/cross-type" :not-target)
353 ("compiler/generic/vm-type")
355 ;; The DEFSTRUCT machinery needs SB!XC:SUBTYPEP, defined in
356 ;; "code/late-type", and SB!XC:TYPEP, defined in "code/cross-type",
357 ;; and SPECIALIZE-ARRAY-TYPE, defined in "compiler/generic/vm-type".
360 ;; ALIEN-VALUE has to be defined as a class (done by DEFSTRUCT
361 ;; machinery) before we can set its superclasses here.
364 ("compiler/knownfun")
366 ;; needs IR1-ATTRIBUTES macro, defined in knownfun.lisp
367 ("compiler/proclaim")
369 ;; This needs not just the SB!XC:DEFSTRUCT machinery, but also
370 ;; the TYPE= stuff defined in late-type.lisp, and the
371 ;; CHECK-FUNCTION-NAME defined in proclaim.lisp.
372 ("code/force-delayed-defbangstructs")
376 ("compiler/compiler-error")
380 ;; These define target types needed by fndb.lisp.
388 ;; KLUDGE: Much stuff above here is the type system and/or the INFO
389 ;; system, not really the compiler proper. It might be easier to
390 ;; understand the system if those things were split off into packages
391 ;; SB-TYPE and SB-INFO and built in their own sections. -- WHN 20000124
393 ;; In classic CMU CL (re)build order, these were done later, but
394 ;; in building from scratch, these must be loaded before
395 ;; "compiler/generic/objdef" in order to allow forms like
396 ;; (DEFINE-PRIMITIVE-OBJECT (..) (CAR ..) ..) to work.
398 ("compiler/generic/vm-fndb")
400 ("compiler/generic/objdef")
402 ("compiler/generic/interr")
404 ("compiler/bit-util")
406 ("compiler/early-assem") ; has ASSEMBLY-UNIT-related stuff needed by core.lisp
408 ;; core.lisp contains DEFSTRUCT CORE-OBJECT, and "compiler/main.lisp"
409 ;; does lots of (TYPEP FOO 'CORE-OBJECT), so it's nice to compile this
410 ;; before "compiler/main.lisp" so that those can be coded efficiently
411 ;; (and so that they don't cause lots of annoying compiler warnings
412 ;; about undefined types).
413 ("compiler/generic/core")
417 ("code/fop") ; needs macros from code/host-load.lisp
420 ("compiler/disassem")
423 ("compiler/trace-table") ; needs EMIT-LABEL macro from compiler/assem.lisp
425 ;; Compiling this file requires fop definitions from code/fop.lisp
426 ;; and trace table definitions from compiler/trace-table.lisp.
429 ("compiler/main") ; needs DEFSTRUCT FASL-FILE from compiler/dump.lisp
430 ("compiler/target-main" :not-host)
435 ;; Compiling this file requires the macros SB!ASSEM:EMIT-LABEL and
436 ;; SB!ASSEM:EMIT-POST-IT, defined in assem.lisp.
437 ("compiler/late-vmdef")
439 ("compiler/ir1final")
440 ("compiler/array-tran")
442 ("compiler/typetran")
443 ("compiler/generic/vm-typetran")
444 ("compiler/float-tran")
449 ("compiler/checkgen")
450 ("compiler/constraint")
458 ("compiler/debug-dump")
459 ("compiler/generic/utils")
460 ("assembly/assemfile")
462 ("compiler/fixup") ; for DEFSTRUCT FIXUP, used by insts.lisp
464 ("compiler/target/insts")
465 ("compiler/target/macros")
467 ("assembly/target/support")
469 ("compiler/target/move")
470 ("compiler/target/float")
471 ("compiler/target/sap")
472 ("compiler/target/system")
473 ("compiler/target/char")
474 ("compiler/target/memory")
475 ("compiler/target/static-fn")
476 ("compiler/target/arith")
477 ("compiler/target/subprim")
479 ("compiler/target/debug")
480 ("compiler/target/c-call")
481 ("compiler/target/cell")
482 ("compiler/target/values")
483 ("compiler/target/alloc")
484 ("compiler/target/call")
485 ("compiler/target/nlx")
486 ("compiler/target/show")
487 ("compiler/target/array"
488 ;; KLUDGE: Compiling this file raises alarming warnings of the form
489 ;; Argument FOO to VOP CHECK-BOUND has SC restriction
490 ;; DESCRIPTOR-REG which is not allowed by the operand type:
491 ;; (:OR POSITIVE-FIXNUM)
492 ;; This seems not to be something that I broke, but rather a "feature"
493 ;; inherited from classic CMU CL. (Debian cmucl_2.4.8.deb compiling
494 ;; Debian cmucl_2.4.8.tar.gz raises the same warning). Thus, even though
495 ;; these warnings are severe enough that they would ordinarily abort
496 ;; compilation, for now we blithely ignore them and press on to more
497 ;; pressing problems. Someday, though, it would be nice to figure out
498 ;; what the problem is and fix it.. -- WHN 19990323
500 ("compiler/target/pred")
501 ("compiler/target/type-vops")
503 ("assembly/target/assem-rtns" :assem)
504 ("assembly/target/array" :assem)
505 ("assembly/target/arith" :assem)
506 ("assembly/target/alloc" :assem)
508 ("compiler/pseudo-vops")
510 ("compiler/aliencomp")
520 ;; KLUDGE: This has #!+GENGC things in it which are intended to
521 ;; overwrite code in ir2tran.lisp, so it has to come after ir2tran.lisp.
523 ;; FIXME: Those things should probably be ir2tran.lisp instead, and the
524 ;; things they now overwrite should instead be #!-GENGC so they're never
525 ;; generated in the first place.
526 ("compiler/generic/vm-ir2tran")
528 ("compiler/copyprop")
529 ("compiler/represent")
530 ("compiler/generic/vm-tran")
535 #!+sb-dyncount ("compiler/dyncount")
536 #!+sb-dyncount ("code/dyncount")
538 ;; needed by OPEN-FASL-FILE, which is called by COMPILE-FILE
541 ;; needed by various unhappy-path cases in the cross-compiler
544 ;; This wasn't in classic CMU CL "comcom.lisp", but it has some stuff
545 ;; that Python-as-cross-compiler has turned out to need.
548 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
549 ;; files which are only needed in the target system, and/or which are
550 ;; only possible in the target system, and which depend in some way
551 ;; (directly or indirectly) on stuff compiled as part of the compiler
553 ("compiler/generic/target-core" :not-host) ; uses stuff from
554 ; "compiler/generic/core"
556 ("code/target-sap" :not-host) ; uses SAP-INT-TYPE
557 ("code/target-package" :not-host) ; needs "code/package"
558 ("code/target-random" :not-host) ; needs "code/random"
559 ("code/target-hash-table" :not-host) ; needs "code/hash-table"
560 ("code/reader" :not-host) ; needs "code/readtable"
561 ("code/target-pathname" :not-host) ; needs "code/pathname", maybe
562 ; should be :BYTE-COMPILE T
563 ("code/filesys" :not-host) ; needs HOST from "code/pathname",
564 ; maybe should be :BYTE-COMPILE T
565 ("code/save" :not-host) ; uses the definition of PATHNAME
566 ; from "code/pathname"
567 ("code/sharpm" :not-host) ; uses stuff from "code/reader"
569 ;; stuff for byte compilation. This works only in the target system,
570 ;; because fundamental BYTE-FUNCTION-OR-CLOSURE types are implemented
571 ;; as nonportable FUNCALLABLE-INSTANCEs.
572 ("code/byte-types" :not-host)
573 ("compiler/byte-comp")
574 ("compiler/target-byte-comp" :not-host)
575 ;; FIXME: Could byte-interp be moved here? It'd be logical..
577 ;; defines SB!DI:DO-DEBUG-FUNCTION-BLOCKS, needed by target-disassem.lisp
578 ("code/debug-int" :not-host)
580 ;; target-only assemblerish stuff
581 ("compiler/target-disassem" :not-host)
582 ("compiler/target/target-insts" :not-host)
584 ;; the IR1 interpreter (as opposed to the byte code interpreter)
585 #!+sb-interpreter ("compiler/eval-comp" :not-host)
586 #!+sb-interpreter ("compiler/eval" :not-host)
588 ("code/debug" :not-host) ; maybe should be :BYTE-COMPILE T
590 ;; These can't be compiled until CONDITION and DEFINE-CONDITION
591 ;; are defined, and they also use SB-DEBUG:*STACK-TOP-HINT*.
592 ("code/parse-defmacro-errors" :not-host)
594 ("code/bit-bash" :not-host) ; needs %NEGATE from assembly/target/arith
596 ("code/byte-interp" :not-host) ; needs *SYSTEM-CONSTANT-CODES* from byte-comp
598 ("code/target-load" :not-host) ; needs specials from code/load.lisp
600 ;; FIXME: Does this really need stuff from compiler/dump.lisp?
601 ("compiler/target-dump" :not-host) ; needs stuff from compiler/dump.lisp
603 ("code/cold-init" :not-host) ; needs (SETF EXTERN-ALIEN) macroexpansion
605 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
606 ;; target macros and DECLAIMs installed at build-the-cross-compiler time
608 ;; Declare all target special variables defined by ANSI now, so that
609 ;; we don't have to worry about any of them being bound incorrectly
610 ;; when the compiler processes code which appears before the appropriate
611 ;; DEFVAR or DEFPARAMETER.
614 ;; fundamental target macros (e.g. CL:DO and CL:DEFUN) and support
617 ;; FIXME: Since a lot of this code is just macros, perhaps it should be
620 ("code/destructuring-bind")
626 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
628 ;; other target-code-building stuff which can't be processed until
629 ;; machinery like SB!XC:DEFMACRO exists
631 ("code/late-format") ; needs SB!XC:DEFMACRO
632 ("code/sxhash") ; needs SB!XC:DEFINE-MODIFY-MACRO
634 ("code/late-defbangmethod"))