src/compiler/x86/parms.lisp

   1 ;;;; This file contains some parameterizations of various VM
   2 ;;;; attributes for the x86. This file is separate from other stuff so
   3 ;;;; that it can be compiled and loaded earlier.
   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!VM")
  15
  16 (file-comment
  17  "$Header$")
  18
  19 ;;; ### Note: we simultaneously use ``word'' to mean a 32 bit quantity
  20 ;;; and a 16 bit quantity depending on context. This is because Intel
  21 ;;; insists on calling 16 bit things words and 32 bit things
  22 ;;; double-words (or dwords). Therefore, in the instruction definition
  23 ;;; and register specs, we use the Intel convention. But whenever we
  24 ;;; are talking about stuff the rest of the lisp system might be
  25 ;;; interested in, we use ``word'' to mean the size of a descriptor
  26 ;;; object, which is 32 bits.
  27 \f
  28 ;;;; machine architecture parameters
  29
  30 (eval-when (:compile-toplevel :load-toplevel :execute)
  31
  32 (defconstant word-bits 32
  33   #!+sb-doc
  34   "Number of bits per word where a word holds one lisp descriptor.")
  35
  36 (defconstant byte-bits 8
  37   #!+sb-doc
  38   "Number of bits per byte where a byte is the smallest addressable object.")
  39
  40 (defconstant word-shift (1- (integer-length (/ word-bits byte-bits)))
  41   #!+sb-doc
  42   "Number of bits to shift between word addresses and byte addresses.")
  43
  44 (defconstant word-bytes (/ word-bits byte-bits)
  45   #!+sb-doc
  46   "Number of bytes in a word.")
  47
  48 ) ; EVAL-WHEN
  49
  50 (eval-when (:compile-toplevel :load-toplevel :execute)
  51 (defconstant float-sign-shift 31)
  52
  53 ;; These values were taken from the alpha code. The values for
  54 ;; bias and exponent min/max are not the same as shown in the 486 book.
  55 ;; They may be correct for how Python uses them.
  56 (defconstant single-float-bias 126)     ; Intel says 127
  57 (defconstant single-float-exponent-byte (byte 8 23))
  58 (defconstant single-float-significand-byte (byte 23 0))
  59 ;; The 486 book shows the exponent range -126 to +127. The Lisp
  60 ;; code that uses these values seems to want already biased numbers.
  61 (defconstant single-float-normal-exponent-min 1)
  62 (defconstant single-float-normal-exponent-max 254)
  63 (defconstant single-float-hidden-bit (ash 1 23))
  64 (defconstant single-float-trapping-nan-bit (ash 1 22))
  65
  66 (defconstant double-float-bias 1022)
  67 (defconstant double-float-exponent-byte (byte 11 20))
  68 (defconstant double-float-significand-byte (byte 20 0))
  69 (defconstant double-float-normal-exponent-min 1)
  70 (defconstant double-float-normal-exponent-max #x7FE)
  71 (defconstant double-float-hidden-bit (ash 1 20))
  72 (defconstant double-float-trapping-nan-bit (ash 1 19))
  73
  74 (defconstant long-float-bias 16382)
  75 (defconstant long-float-exponent-byte (byte 15 0))
  76 (defconstant long-float-significand-byte (byte 31 0))
  77 (defconstant long-float-normal-exponent-min 1)
  78 (defconstant long-float-normal-exponent-max #x7FFE)
  79 (defconstant long-float-hidden-bit (ash 1 31))          ; Actually not hidden
  80 (defconstant long-float-trapping-nan-bit (ash 1 30))
  81
  82 (defconstant single-float-digits
  83   (+ (byte-size single-float-significand-byte) 1))
  84
  85 (defconstant double-float-digits
  86   (+ (byte-size double-float-significand-byte) word-bits 1))
  87
  88 (defconstant long-float-digits
  89   (+ (byte-size long-float-significand-byte) word-bits 1))
  90
  91 ;;; pfw -- from i486 microprocessor programmers reference manual
  92 (defconstant float-invalid-trap-bit     (ash 1 0))
  93 (defconstant float-denormal-trap-bit       (ash 1 1))
  94 (defconstant float-divide-by-zero-trap-bit (ash 1 2))
  95 (defconstant float-overflow-trap-bit       (ash 1 3))
  96 (defconstant float-underflow-trap-bit      (ash 1 4))
  97 (defconstant float-inexact-trap-bit     (ash 1 5))
  98
  99 (defconstant float-round-to-nearest  0)
 100 (defconstant float-round-to-negative 1)
 101 (defconstant float-round-to-positive 2)
 102 (defconstant float-round-to-zero     3)
 103
 104 (defconstant float-rounding-mode   (byte 2 10))
 105 (defconstant float-sticky-bits     (byte 6 16))
 106 (defconstant float-traps-byte      (byte 6  0))
 107 (defconstant float-exceptions-byte (byte 6 16))
 108 (defconstant float-precision-control (byte 2 8))
 109 (defconstant float-fast-bit 0) ; No fast mode on x86
 110
 111 ); EVAL-WHEN
 112 \f
 113 ;;;; description of the target address space
 114
 115 ;;; where to put the different spaces
 116 ;;;
 117 ;;; FIXME: Couldn't/shouldn't these be DEFCONSTANT instead of DEFPARAMETER?
 118 ;;;
 119 ;;; FIXME: Since SBCL has a different way of distinguishing between target
 120 ;;; and host than the old CMU CL code used, the "TARGET-" prefix is
 121 ;;; redundant. Perhaps each *TARGET-FOO* should become *FOO*, probably
 122 ;;; at the same time that we unscrew the kludgy way that constants are
 123 ;;; duplicated between this file and runtime/x86-validate.h.
 124 ;;;
 125 ;;; Note: Mostly these values are black magic, inherited from CMU CL
 126 ;;; without any documentation. However, there were a few explanatory
 127 ;;; comments in the CMU CL sources:
 128 ;;;   * On Linux,
 129 ;;;     ** The space 0x08000000-0x10000000 is "C program and memory allocation".
 130 ;;;     ** The space 0x40000000-0x48000000 is reserved for shared libs.
 131 ;;;     ** The space >0xE0000000 is "C stack - Alien stack".
 132 ;;;   * On FreeBSD,
 133 ;;;     ** The space 0x0E000000-0x10000000 is "Foreign segment".
 134 ;;;     ** The space 0x20000000-0x30000000 is reserved for shared libs.
 135 ;;; And there have been a few changes since the fork:
 136 ;;;   * The FreeBSD STATIC-SPACE-START value was bumped up from
 137 ;;;     #x28000000 to #x30000000 when FreeBSD ld.so dynamic linking
 138 ;;;     support was added for FreeBSD ca. 20000910. This was to keep from
 139 ;;;     stomping on an address range that the dynamic libraries want to use.
 140 ;;;     (They want to use this address range even if we try to reserve it
 141 ;;;     with a call to validate() as the first operation in main().)
 142 #!+linux
 143 (progn
 144
 145   (defconstant read-only-space-start #x01000000)
 146
 147   (defconstant static-space-start    #x05000000)
 148
 149   (defconstant dynamic-space-start   #x09000000)
 150
 151   (defconstant control-stack-start   #x50000000)
 152   (defconstant control-stack-end     #x57fff000))
 153 #!+bsd
 154 (progn
 155
 156   (defconstant read-only-space-start #x10000000)
 157
 158   (defconstant static-space-start
 159     #!+freebsd #x30000000
 160     #!+openbsd #x28000000)
 161
 162   (defconstant control-stack-start   #x40000000)
 163   (defconstant control-stack-end     #x07fff000)
 164
 165   (defconstant dynamic-space-start   #x48000000))
 166
 167 ;;; Given that NIL is the first thing allocated in static space, we
 168 ;;; know its value at compile time:
 169 (defconstant nil-value (+ static-space-start #xb))
 170 \f
 171 ;;;; other miscellaneous constants
 172
 173 (defenum (:suffix -trap :start 8)
 174   halt
 175   pending-interrupt
 176   error
 177   cerror
 178   breakpoint
 179   function-end-breakpoint
 180   single-step-breakpoint)
 181 ;;; FIXME: It'd be nice to replace all the DEFENUMs with something
 182 ;;; a la
 183 ;;;   (WITH-DEF-ENUM (:START 8)
 184 ;;;     (DEF-ENUM HALT-TRAP)
 185 ;;;     (DEF-ENUM PENDING-INTERRUPT-TRAP)
 186 ;;;     ..)
 187 ;;; for the benefit of anyone doing a lexical search for definitions
 188 ;;; of these symbols.
 189
 190 (defenum (:prefix object-not- :suffix -trap :start 16)
 191   list
 192   instance)
 193
 194 (defenum (:prefix trace-table-)
 195   normal
 196   call-site
 197   function-prologue
 198   function-epilogue)
 199 \f
 200 ;;;; static symbols
 201
 202 ;;; These symbols are loaded into static space directly after NIL so
 203 ;;; that the system can compute their address by adding a constant
 204 ;;; amount to NIL.
 205 ;;;
 206 ;;; The fdefn objects for the static functions are loaded into static
 207 ;;; space directly after the static symbols. That way, the raw-addr
 208 ;;; can be loaded directly out of them by indirecting relative to NIL.
 209 ;;;
 210 ;;; pfw X86 doesn't have enough registers to keep these things there.
 211 ;;;     Note these spaces grow from low to high addresses.
 212 (defvar *allocation-pointer*)
 213 (defvar *binding-stack-pointer*)
 214 (defvar *x86-cgc-active-p*) ; FIXME: Document this.
 215 (defvar *static-blue-bag* nil)
 216
 217 ;;; FIXME: *!INITIAL-FDEFN-OBJECTS* and !COLD-INIT probably don't need
 218 ;;; to be in the static symbols table any more. Also, if
 219 ;;; *INTERNAL-GC-TRIGGER* really is not used, we can punt it.
 220 (defparameter *static-symbols*
 221   '(t
 222
 223     ;; The C startup code must fill these in.
 224     *posix-argv*
 225     sb!impl::*!initial-fdefn-objects*
 226
 227     ;; functions that the C code needs to call
 228     sb!impl::!cold-init
 229     sb!impl::maybe-gc
 230     sb!kernel::internal-error
 231     sb!di::handle-breakpoint
 232     sb!impl::fdefinition-object
 233
 234     ;; free pointers
 235     ;;
 236     ;; Note that these are FIXNUM word counts, not (as one might
 237     ;; expect) byte counts or SAPs. The reason seems to be that by
 238     ;; representing them this way, we can avoid consing bignums.
 239     ;; -- WHN 2000-10-02
 240     *read-only-space-free-pointer*
 241     *static-space-free-pointer*
 242     *initial-dynamic-space-free-pointer*
 243
 244     ;; things needed for non-local exit
 245     sb!impl::*current-catch-block*
 246     sb!impl::*current-unwind-protect-block*
 247     sb!c::*eval-stack-top*
 248     sb!vm::*alien-stack*
 249
 250     ;; interrupt handling
 251     sb!impl::*pseudo-atomic-atomic*
 252     sb!impl::*pseudo-atomic-interrupted*
 253     sb!unix::*interrupts-enabled*
 254     sb!unix::*interrupt-pending*
 255     sb!impl::*free-interrupt-context-index*
 256
 257     sb!vm::*allocation-pointer*
 258     sb!vm::*binding-stack-pointer*
 259     sb!vm::*internal-gc-trigger*   ; Not used.
 260
 261     ;; the floating point constants
 262     sb!vm::*fp-constant-0d0*
 263     sb!vm::*fp-constant-1d0*
 264     sb!vm::*fp-constant-0s0*
 265     sb!vm::*fp-constant-1s0*
 266     ;; The following are all long-floats.
 267     sb!vm::*fp-constant-0l0*
 268     sb!vm::*fp-constant-1l0*
 269     sb!vm::*fp-constant-pi*
 270     sb!vm::*fp-constant-l2t*
 271     sb!vm::*fp-constant-l2e*
 272     sb!vm::*fp-constant-lg2*
 273     sb!vm::*fp-constant-ln2*
 274
 275     ;; used by gencgc
 276     sb!vm::*scavenge-read-only-space*
 277
 278     ;; multi-process support
 279     sb!vm::*control-stacks*
 280
 281     ;; The ..SLOT-UNBOUND.. symbol is static in order to optimise the
 282     ;; common slot unbound check.
 283     sb!pcl::..slot-unbound..
 284
 285     ;; spare symbols
 286     sb!vm::spare-10
 287     sb!vm::spare-9
 288     sb!vm::spare-8
 289     sb!vm::spare-7
 290     sb!vm::spare-6
 291     sb!vm::spare-5
 292     sb!vm::spare-4
 293     sb!vm::spare-3
 294     sb!vm::spare-2
 295     sb!vm::spare-1
 296
 297     ;; used by cgc
 298     sb!vm::*x86-cgc-active-p*
 299     sb!vm::*static-blue-bag*            ; must be last or change C code
 300     ))
 301
 302 (defparameter *static-functions*
 303   '(length
 304     sb!kernel:two-arg-+
 305     sb!kernel:two-arg--
 306     sb!kernel:two-arg-*
 307     sb!kernel:two-arg-/
 308     sb!kernel:two-arg-<
 309     sb!kernel:two-arg->
 310     sb!kernel:two-arg-=
 311     eql
 312     sb!kernel:%negate
 313     sb!kernel:two-arg-and
 314     sb!kernel:two-arg-ior
 315     sb!kernel:two-arg-xor
 316     sb!kernel:two-arg-gcd
 317     sb!kernel:two-arg-lcm))
 318 \f
 319 ;;;; stuff added by jrd
 320
 321 ;;; FIXME: Is this used? Delete it or document it.
 322 ;;; cf the sparc PARMS.LISP
 323 (defparameter *assembly-unit-length* 8)