1 ;;;; functions and macros to define and deal with internal errors
2 ;;;; (i.e. problems that can be signaled from assembler code)
4 ;;;; This software is part of the SBCL system. See the README file for
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.
13 (in-package "SB!KERNEL")
17 (defvar *internal-errors*
18 #.(map 'vector #'cdr sb!c:*backend-internal-errors*))
20 (eval-when (:compile-toplevel :execute)
22 (sb!xc:defmacro deferr (name args &rest body)
23 (let* ((rest-pos (position '&rest args))
24 (required (if rest-pos (subseq args 0 rest-pos) args))
28 (fn-name (symbolicate name "-HANDLER")))
30 ;; FIXME: Having a separate full DEFUN for each error doesn't
31 ;; seem to add much value, and it takes a lot of space. Perhaps
32 ;; we could do this dispatch with a big CASE statement instead?
33 (defun ,fn-name (name ,fp ,context ,sc-offsets)
34 ;; FIXME: It would probably be good to do *STACK-TOP-HINT*
35 ;; tricks to hide this internal error-handling logic from the
36 ;; poor high level user, so his debugger tells him about
37 ;; where his error was detected instead of telling him where
38 ;; he ended up inside the system error-handling logic.
39 (declare (ignorable name ,fp ,context ,sc-offsets))
40 (let (,@(let ((offset -1))
42 `(,var (sb!di::sub-access-debug-var-slot
49 `((,(nth (1+ rest-pos) args)
50 (mapcar (lambda (sc-offset)
51 (sb!di::sub-access-debug-var-slot
55 (nthcdr ,rest-pos ,sc-offsets))))))
57 (setf (svref *internal-errors* ,(error-number-or-lose name))
62 (deferr unknown-error (&rest args)
63 (error "unknown error:~{ ~S~})" args))
65 (deferr object-not-fun-error (object)
68 :expected-type 'function))
70 (deferr object-not-list-error (object)
73 :expected-type 'list))
75 (deferr object-not-bignum-error (object)
78 :expected-type 'bignum))
80 (deferr object-not-ratio-error (object)
83 :expected-type 'ratio))
85 (deferr object-not-single-float-error (object)
88 :expected-type 'single-float))
90 (deferr object-not-double-float-error (object)
93 :expected-type 'double-float))
96 (deferr object-not-long-float-error (object)
99 :expected-type 'long-float))
101 (deferr object-not-simple-string-error (object)
104 :expected-type 'simple-string))
106 (deferr object-not-fixnum-error (object)
109 :expected-type 'fixnum))
111 (deferr object-not-vector-error (object)
114 :expected-type 'vector))
116 (deferr object-not-string-error (object)
119 :expected-type 'string))
121 (deferr object-not-base-string-error (object)
124 :expected-type 'base-string))
126 (deferr object-not-vector-nil-error (object)
129 :expected-type '(vector nil)))
132 (deferr object-not-character-string-error (object)
135 :expected-type '(vector character)))
137 (deferr object-not-bit-vector-error (object)
140 :expected-type 'bit-vector))
142 (deferr object-not-array-error (object)
145 :expected-type 'array))
147 (deferr object-not-number-error (object)
150 :expected-type 'number))
152 (deferr object-not-rational-error (object)
155 :expected-type 'rational))
157 (deferr object-not-float-error (object)
160 :expected-type 'float))
162 (deferr object-not-real-error (object)
165 :expected-type 'real))
167 (deferr object-not-integer-error (object)
170 :expected-type 'integer))
172 (deferr object-not-cons-error (object)
175 :expected-type 'cons))
177 (deferr object-not-symbol-error (object)
180 :expected-type 'symbol))
182 (deferr undefined-fun-error (fdefn-or-symbol)
183 (error 'undefined-function
184 :name (etypecase fdefn-or-symbol
185 (symbol fdefn-or-symbol)
186 (fdefn (fdefn-name fdefn-or-symbol)))))
188 (deferr invalid-arg-count-error (nargs)
189 (error 'simple-program-error
190 :format-control "invalid number of arguments: ~S"
191 :format-arguments (list nargs)))
193 (deferr bogus-arg-to-values-list-error (list)
194 (error 'simple-type-error
198 "~@<attempt to use VALUES-LIST on a dotted list: ~2I~_~S~:>"
199 :format-arguments (list list)))
201 (deferr unbound-symbol-error (symbol)
202 (error 'unbound-variable :name symbol))
204 (deferr object-not-character-error (object)
207 :expected-type 'character))
209 (deferr object-not-sap-error (object)
212 :expected-type 'system-area-pointer))
214 (deferr invalid-unwind-error ()
215 (error 'simple-control-error
217 "attempt to RETURN-FROM a block or GO to a tag that no longer exists"
220 (deferr unseen-throw-tag-error (tag)
221 (error 'simple-control-error
222 :format-control "attempt to THROW to a tag that does not exist: ~S"
223 :format-arguments (list tag)))
225 (deferr nil-fun-returned-error (function)
226 (error 'simple-control-error
228 "A function with declared result type NIL returned:~% ~S"
229 :format-arguments (list function)))
231 (deferr nil-array-accessed-error (array)
232 (error 'nil-array-accessed-error
233 :datum array :expected-type '(not (array nil))))
235 (deferr division-by-zero-error (this that)
236 (error 'division-by-zero
238 :operands (list this that)))
240 (deferr object-not-type-error (object type)
241 (error (if (and (%instancep object)
242 (layout-invalid (%instance-layout object)))
246 :expected-type type))
248 (deferr layout-invalid-error (object layout)
249 (error 'layout-invalid
251 :expected-type (layout-classoid layout)))
253 (deferr odd-key-args-error ()
254 (error 'simple-program-error
255 :format-control "odd number of &KEY arguments"))
257 (deferr unknown-key-arg-error (key-name)
258 (error 'simple-program-error
259 :format-control "unknown &KEY argument: ~S"
260 :format-arguments (list key-name)))
262 (deferr invalid-array-index-error (array bound index)
263 (error 'simple-type-error
265 "invalid array index ~W for ~S (should be nonnegative and <~W)"
266 :format-arguments (list index array bound)
268 :expected-type `(integer 0 (,bound))))
270 (deferr object-not-simple-array-error (object)
273 :expected-type 'simple-array))
275 (deferr object-not-signed-byte-32-error (object)
278 :expected-type '(signed-byte 32)))
280 (deferr object-not-unsigned-byte-32-error (object)
283 :expected-type '(unsigned-byte 32)))
286 ((define-simple-array-internal-errors ()
290 `(deferr ,(symbolicate
292 (sb!vm:saetp-primitive-type-name saetp)
297 :expected-type '(simple-array
298 ,(sb!vm:saetp-specifier saetp)
300 sb!vm:*specialized-array-element-type-properties*))))
301 (define-simple-array-internal-errors))
303 (deferr object-not-complex-error (object)
306 :expected-type 'complex))
308 (deferr object-not-complex-rational-error (object)
311 :expected-type '(complex rational)))
313 (deferr object-not-complex-single-float-error (object)
316 :expected-type '(complex single-float)))
318 (deferr object-not-complex-double-float-error (object)
321 :expected-type '(complex double-float)))
324 (deferr object-not-complex-long-float-error (object)
327 :expected-type '(complex long-float)))
329 (deferr object-not-weak-pointer-error (object)
332 :expected-type 'weak-pointer))
334 (deferr object-not-instance-error (object)
337 :expected-type 'instance))
339 (deferr object-not-complex-vector-error (object)
342 :expected-type '(and vector (not simple-array))))
344 ;;;; fetching errorful function name
346 ;;; This flag is used to prevent infinite recursive lossage when
347 ;;; we can't find the caller for some reason.
348 (defvar *finding-name* nil)
350 (defun find-caller-name-and-frame ()
352 (values "<error finding caller name -- already finding name>" nil)
354 (let* ((*finding-name* t)
355 (frame (sb!di:frame-down (sb!di:frame-down (sb!di:top-frame))))
356 (name (sb!di:debug-fun-name
357 (sb!di:frame-debug-fun frame))))
358 (sb!di:flush-frames-above frame)
361 (values "<error finding caller name -- trapped error>" nil))
362 (sb!di:debug-condition ()
363 (values "<error finding caller name -- trapped debug-condition>"
366 (defun find-interrupted-name-and-frame ()
367 (/show0 "entering FIND-INTERRUPTED-NAME-AND-FRAME")
369 (values "<error finding interrupted name -- already finding name>" nil)
371 (let ((*finding-name* t))
372 (/show0 "in ordinary case")
373 (do ((frame (sb!di:top-frame) (sb!di:frame-down frame)))
375 (/show0 "null frame")
376 (values "<error finding interrupted name -- null frame>" nil))
377 (/show0 "at head of DO loop")
378 (when (and (sb!di::compiled-frame-p frame)
379 (sb!di::compiled-frame-escaped frame))
380 (sb!di:flush-frames-above frame)
381 (/show0 "returning from within DO loop")
382 (return (values (sb!di:debug-fun-name
383 (sb!di:frame-debug-fun frame))
386 (/show0 "trapped ERROR")
387 (values "<error finding interrupted name -- trapped error>" nil))
388 (sb!di:debug-condition ()
389 (/show0 "trapped DEBUG-CONDITION")
390 (values "<error finding interrupted name -- trapped debug-condition>"
394 ;;;; INTERNAL-ERROR signal handler
396 (defun internal-error (context continuable)
397 (declare (type system-area-pointer context))
398 (declare (ignore continuable))
399 (/show0 "entering INTERNAL-ERROR, CONTEXT=..")
401 (infinite-error-protect
402 (/show0 "about to bind ALIEN-CONTEXT")
403 (let ((alien-context (locally
404 (declare (optimize (inhibit-warnings 3)))
405 (sb!alien:sap-alien context (* os-context-t)))))
406 (/show0 "about to bind ERROR-NUMBER and ARGUMENTS")
407 (multiple-value-bind (error-number arguments)
408 (sb!vm:internal-error-args alien-context)
410 ;; There's a limit to how much error reporting we can usefully
411 ;; do before initialization is complete, but try to be a little
412 ;; bit helpful before we die.
413 (/show0 "back from INTERNAL-ERROR-ARGS, ERROR-NUMBER=..")
414 (/hexstr error-number)
415 (/show0 "cold/low ARGUMENTS=..")
417 (unless *cold-init-complete-p*
418 (%primitive print "can't recover from error in cold init, halting")
419 (%primitive sb!c:halt))
421 (multiple-value-bind (name sb!debug:*stack-top-hint*)
422 (find-interrupted-name-and-frame)
423 (/show0 "back from FIND-INTERRUPTED-NAME")
424 (let ((fp (int-sap (sb!vm:context-register alien-context
426 (handler (and (< -1 error-number (length *internal-errors*))
427 (svref *internal-errors* error-number))))
428 (cond ((null handler)
431 "unknown internal error, ~D, args=~S"
434 (mapcar (lambda (sc-offset)
435 (sb!di::sub-access-debug-var-slot
436 fp sc-offset alien-context))
438 ((not (functionp handler))
440 :format-control "internal error ~D: ~A; args=~S"
444 (mapcar (lambda (sc-offset)
445 (sb!di::sub-access-debug-var-slot
446 fp sc-offset alien-context))
449 (funcall handler name fp alien-context arguments)))))))))
451 (defun control-stack-exhausted-error ()
452 (let ((sb!debug:*stack-top-hint* nil))
453 (infinite-error-protect
454 (format *error-output*
455 "Control stack guard page temporarily disabled: proceed with caution~%")
456 (error 'control-stack-exhausted))))
458 ;;; KLUDGE: we keep a single HEAP-EXHAUSTED-ERROR object around, so
459 ;;; that we don't need to allocate it when running out of memory. Similarly
460 ;;; we pass the amounts in special variables as there may be multiple threads
461 ;;; running into trouble at the same time. The condition is created by GC-REINIT.
462 (defvar *heap-exhausted-error-condition*)
463 (defvar *heap-exhausted-error-available-bytes*)
464 (defvar *heap-exhausted-error-requested-bytes*)
466 (defun heap-exhausted-error (available requested)
467 (infinite-error-protect
468 (let ((*heap-exhausted-error-available-bytes* available)
469 (*heap-exhausted-error-requested-bytes* requested))
470 (error *heap-exhausted-error-condition*))))
472 (defun undefined-alien-variable-error ()
473 (error 'undefined-alien-variable-error))
475 (defun undefined-alien-function-error ()
476 (error 'undefined-alien-function-error))
479 (define-alien-variable current-memory-fault-address long)
482 (defun memory-fault-error ()
483 (error 'memory-fault-error
484 :address current-memory-fault-address))
486 ;;; This is SIGTRAP / EXCEPTION_BREAKPOINT that runtime could not deal
487 ;;; with. Prior to Windows we just had a Lisp side handler for
488 ;;; SIGTRAP, but now we need to deal this portably.
489 (defun unhandled-trap-error (context-sap)
490 (declare (type system-area-pointer context-sap))
491 (infinite-error-protect
492 (let ((context (sap-alien context-sap (* os-context-t))))
493 (error "Unhandled breakpoint/trap at #x~X."
494 (sap-int (sb!vm:context-pc context))))))