tests/debug.impure.lisp

   1 ;;;; This file is for testing debugging functionality, using
   2 ;;;; test machinery which might have side effects (e.g.
   3 ;;;; executing DEFUN).
   4
   5 ;;;; This software is part of the SBCL system. See the README file for
   6 ;;;; more information.
   7 ;;;;
   8 ;;;; While most of SBCL is derived from the CMU CL system, the test
   9 ;;;; files (like this one) were written from scratch after the fork
  10 ;;;; from CMU CL.
  11 ;;;;
  12 ;;;; This software is in the public domain and is provided with
  13 ;;;; absolutely no warranty. See the COPYING and CREDITS files for
  14 ;;;; more information.
  15
  16 (cl:in-package :cl-user)
  17
  18 ;;; The debugger doesn't have any native knowledge of the interpreter
  19 (when (eq sb-ext:*evaluator-mode* :interpret)
  20   (sb-ext:quit :unix-status 104))
  21
  22 \f
  23 ;;;; Check that we get debug arglists right.
  24
  25 ;;; FIXME: This should use some get-argslist like functionality that
  26 ;;; we actually export.
  27 ;;;
  28 ;;; Return the debug arglist of the function object FUN as a list, or
  29 ;;; punt with :UNKNOWN.
  30 (defun get-arglist (fun)
  31   (declare (type function fun))
  32   ;; The Lisp-level type FUNCTION can conceal a multitude of sins..
  33   (case (sb-kernel:widetag-of fun)
  34     (#.sb-vm:simple-fun-header-widetag
  35       (sb-kernel:%simple-fun-arglist fun))
  36     (#.sb-vm:closure-header-widetag (get-arglist
  37                                      (sb-kernel:%closure-fun fun)))
  38     ;; In code/describe.lisp, ll. 227 (%describe-fun), we use a scheme
  39     ;; like above, and it seems to work. -- MNA 2001-06-12
  40     ;;
  41     ;; (There might be other cases with arglist info also.
  42     ;; SIMPLE-FUN-HEADER-WIDETAG and CLOSURE-HEADER-WIDETAG just
  43     ;; happen to be the two case that I had my nose rubbed in when
  44     ;; debugging a GC problem caused by applying %SIMPLE-FUN-ARGLIST to
  45     ;; a closure. -- WHN 2001-06-05)
  46     (t
  47      #+sb-eval
  48      (if (typep fun 'sb-eval::interpreted-function)
  49          (sb-eval::interpreted-function-lambda-list fun)
  50          :unknown)
  51      #-sb-eval
  52      :unknown)))
  53
  54 (defun zoop (zeep &key beep)
  55   blurp)
  56 (assert (equal (get-arglist #'zoop) '(zeep &key beep)))
  57
  58 ;;; Check some predefined functions too.
  59 ;;;
  60 ;;; (We don't know exactly what the arguments are, e.g. the first
  61 ;;; argument of PRINT might be SB-IMPL::OBJECT or SB-KERNEL::OBJ or
  62 ;;; whatever. But we do know the general structure that a correct
  63 ;;; answer should have, so we can safely do a lot of checks.)
  64 (destructuring-bind (object-sym &optional-sym stream-sym) (get-arglist #'print)
  65   (assert (symbolp object-sym))
  66   (assert (eql &optional-sym '&optional))
  67   (assert (symbolp stream-sym)))
  68 (destructuring-bind (dest-sym control-sym &rest-sym format-args-sym)
  69     (get-arglist #'format)
  70   (assert (symbolp dest-sym))
  71   (assert (symbolp control-sym))
  72   (assert (eql &rest-sym '&rest))
  73   (assert (symbolp format-args-sym)))
  74
  75 ;;; Check for backtraces generally being correct.  Ensure that the
  76 ;;; actual backtrace finishes (doesn't signal any errors on its own),
  77 ;;; and that it contains the frames we expect, doesn't contain any
  78 ;;; "bogus stack frame"s, and contains the appropriate toplevel call
  79 ;;; and hasn't been cut off anywhere.
  80 (defun verify-backtrace (test-function frame-specs &key (allow-stunted nil))
  81   (labels ((args-equal (want real)
  82              (cond ((eq '&rest (car want))
  83                     t)
  84                    ((endp want)
  85                     (endp real))
  86                    ((or (eq '? (car want)) (equal (car want) (car real)))
  87                     (args-equal (cdr want) (cdr real)))
  88                    (t
  89                     nil))))
  90     (let ((result nil))
  91       (block outer-handler
  92         (handler-bind
  93             ((error (lambda (condition)
  94                       ;; find the part of the backtrace we're interested in
  95                       (let* ((full-backtrace (sb-debug:backtrace-as-list))
  96                              (backtrace (member (caar frame-specs) full-backtrace
  97                                                 :key #'car
  98                                                 :test #'equal)))
  99
 100                         (setf result condition)
 101
 102                         (unless backtrace
 103                           (format t "~&//~S not in backtrace:~%   ~S~%"
 104                                   (caar frame-specs)
 105                                   full-backtrace)
 106                           (setf result nil))
 107
 108                         ;; check that we have all the frames we wanted
 109                         (mapcar
 110                          (lambda (spec frame)
 111                            (unless (or (not spec)
 112                                        (and (equal (car spec) (car frame))
 113                                             (args-equal (cdr spec)
 114                                                         (cdr frame))))
 115                              (print (list :mismatch spec frame))
 116                              (setf result nil)))
 117                          frame-specs
 118                          backtrace)
 119
 120                         ;; Make sure the backtrace isn't stunted in
 121                         ;; any way.  (Depends on running in the main
 122                         ;; thread.) FIXME: On Windows we get two
 123                         ;; extra foreign frames below regular frames.
 124                         (let ((end (last backtrace #-win32 2 #+win32 4)))
 125                           (unless (equal (caar end)
 126                                          'sb-impl::toplevel-init)
 127                             (print (list :backtrace-stunted (caar end)))
 128                             (setf result nil)))
 129                         (return-from outer-handler)))))
 130           (funcall test-function)))
 131       result)))
 132
 133 (defvar *undefined-function-frame*
 134   ;; bug 353
 135   '(#+(or x86 x86-64) "bogus stack frame"
 136     #-(or x86 x86-64) "undefined function"))
 137
 138 ;;; Test for "undefined function" (undefined_tramp) working properly.
 139 ;;; Try it with and without tail call elimination, since they can have
 140 ;;; different effects.  (Specifically, if undefined_tramp is incorrect
 141 ;;; a stunted stack can result from the tail call variant.)
 142 (flet ((optimized ()
 143          (declare (optimize (speed 2) (debug 1))) ; tail call elimination
 144          (#:undefined-function 42))
 145        (not-optimized ()
 146          (declare (optimize (speed 1) (debug 2))) ; no tail call elimination
 147          (#:undefined-function 42))
 148        (test (fun)
 149          (declare (optimize (speed 1) (debug 2))) ; no tail call elimination
 150          (funcall fun)))
 151
 152   (with-test (:name (:undefined-function :bug-346)
 153               :fails-on '(or :alpha :ppc :sparc :mips
 154                           (and :x86-64 (or :freebsd :darwin))))
 155     (assert (verify-backtrace
 156              (lambda () (test #'optimized))
 157              (list *undefined-function-frame*
 158                    (list '(flet test) #'optimized)))))
 159
 160   ;; bug 353: This test fails at least most of the time for x86/linux
 161   ;; ca. 0.8.20.16. -- WHN
 162   (with-test (:name (:undefined-function :bug-353)
 163               ;; This used to have fewer :fails-on features pre-0.9.16.38,
 164               ;; but it turns out that the bug was just being masked by
 165               ;; the presence of the IR1 stepper instrumentation (and
 166               ;; is thus again failing now that the instrumentation is
 167               ;; no more).
 168               :fails-on '(or :x86 :x86-64 :alpha :mips))
 169     (assert (verify-backtrace
 170              (lambda () (test #'not-optimized))
 171              (list *undefined-function-frame*
 172                    (list '(flet not-optimized))
 173                    (list '(flet test) #'not-optimized))))))
 174
 175 ;;; Division by zero was a common error on PPC. It depended on the
 176 ;;; return function either being before INTEGER-/-INTEGER in memory,
 177 ;;; or more than MOST-POSITIVE-FIXNUM bytes ahead. It also depends on
 178 ;;; INTEGER-/-INTEGER calling SIGNED-TRUNCATE. I believe Raymond Toy
 179 ;;; says that the Sparc backend (at least for CMUCL) inlines this, so
 180 ;;; if SBCL does the same this test is probably not good for the
 181 ;;; Sparc.
 182 ;;;
 183 ;;; Disabling tail call elimination on this will probably ensure that
 184 ;;; the return value (to the flet or the enclosing top level form) is
 185 ;;; more than MOST-POSITIVE-FIXNUM with the current spaces on OS X.
 186 ;;; Enabling it might catch other problems, so do it anyway.
 187 (flet ((optimized ()
 188          (declare (optimize (speed 2) (debug 1))) ; tail call elimination
 189          (/ 42 0))
 190        (not-optimized ()
 191          (declare (optimize (speed 1) (debug 2))) ; no tail call elimination
 192          (/ 42 0))
 193        (test (fun)
 194          (declare (optimize (speed 1) (debug 2))) ; no tail call elimination
 195          (funcall fun)))
 196   (with-test (:name (:divide-by-zero :bug-346)
 197               :fails-on '(or :alpha (and :x86-64 :darwin)))   ; bug 346
 198     (assert (verify-backtrace (lambda () (test #'optimized))
 199                               (list '(/ 42 &rest)
 200                                     (list '(flet test) #'optimized)))))
 201   (with-test (:name (:divide-by-zero :bug-356)
 202               :fails-on '(or :alpha (and :x86-64 :darwin)))   ; bug 356
 203     (assert (verify-backtrace (lambda () (test #'not-optimized))
 204                               (list '(/ 42 &rest)
 205                                     '((flet not-optimized))
 206                                     (list '(flet test) #'not-optimized))))))
 207
 208 (with-test (:name (:throw :no-such-tag)
 209             :fails-on '(or
 210                         (and :x86 :openbsd)
 211                         (and :x86 :sunos)
 212                         (and :x86 :darwin)
 213                         (and :x86 :linux)
 214                         (and :x86-64 :darwin)
 215                         (and :x86-64 :linux)
 216                         (and :x86-64 :openbsd)
 217                         (and :sparc :linux)
 218                         :alpha
 219                         :mips))
 220   (progn
 221     (defun throw-test ()
 222       (throw 'no-such-tag t))
 223     (assert (verify-backtrace #'throw-test '((throw-test))))))
 224
 225 ;;; test entry point handling in backtraces
 226
 227 (defun oops ()
 228   (error "oops"))
 229
 230 (defmacro defbt (n ll &body body)
 231   `(progn
 232      ;; normal debug info
 233      (defun ,(intern (format nil "BT.~A.1" n)) ,ll
 234        ,@body)
 235      ;; no arguments saved
 236      (defun ,(intern (format nil "BT.~A.2" n)) ,ll
 237        (declare (optimize (debug 1) (speed 3)))
 238        ,@body)
 239      ;; no lambda-list saved
 240      (defun ,(intern (format nil "BT.~A.3" n)) ,ll
 241        (declare (optimize (debug 0)))
 242        ,@body)))
 243
 244 (defbt 1 (&key key)
 245   (list key))
 246
 247 (defbt 2 (x)
 248   (list x))
 249
 250 (defbt 3 (&key (key (oops)))
 251   (list key))
 252
 253 ;;; ERROR instead of OOPS so that tail call elimination doesn't happen
 254 (defbt 4 (&optional opt)
 255   (list (error "error")))
 256
 257 (defbt 5 (&optional (opt (oops)))
 258   (list opt))
 259
 260 (defmacro with-details (bool &body body)
 261   `(let ((sb-debug:*show-entry-point-details* ,bool))
 262      ,@body))
 263
 264 (defun bug-354 (x)
 265   (error "XEPs in backtraces: ~S" x))
 266
 267 (with-test (:name :bug-354)
 268   (with-details t
 269     (assert (not (verify-backtrace (lambda () (bug-354 354))
 270                                    '((bug-354 &rest)
 271                                      ((sb-c::tl-xep bug-354) &rest))))))
 272   (assert (verify-backtrace (lambda () (bug-354 354)) '((bug-354 354)))))
 273
 274 ;;; FIXME: This test really should be broken into smaller pieces
 275 (with-test (:name (:backtrace :misc)
 276             :fails-on '(or (and :x86 (or :sunos)) (and :x86-64 :darwin)))
 277   (write-line "//tl-xep")
 278   (with-details t
 279     (assert (verify-backtrace #'namestring
 280                               '(((sb-c::tl-xep namestring) 0 ?)))))
 281   (with-details nil
 282     (assert (verify-backtrace #'namestring
 283                               '((namestring)))))
 284
 285   ;; &MORE-PROCESSOR
 286   (with-details t
 287     (assert (verify-backtrace (lambda () (bt.1.1 :key))
 288                               '(((sb-c::&more-processor bt.1.1) &rest))))
 289     (assert (verify-backtrace (lambda () (bt.1.2 :key))
 290                               '(((sb-c::&more-processor bt.1.2) &rest))))
 291     (assert (verify-backtrace (lambda () (bt.1.3 :key))
 292                               '(((sb-c::&more-processor bt.1.3) &rest)))))
 293   (with-details nil
 294     (assert (verify-backtrace (lambda () (bt.1.1 :key))
 295                               '((bt.1.1 :key))))
 296     (assert (verify-backtrace (lambda () (bt.1.2 :key))
 297                               '((bt.1.2 &rest))))
 298     (assert (verify-backtrace (lambda () (bt.1.3 :key))
 299                               '((bt.1.3 &rest)))))
 300
 301   ;; XEP
 302   (write-line "//xep")
 303   (with-details t
 304     (assert (verify-backtrace #'bt.2.1
 305                               '(((sb-c::xep bt.2.1) 0 ?))))
 306     (assert (verify-backtrace #'bt.2.2
 307                               '(((sb-c::xep bt.2.2) &rest))))
 308     (assert (verify-backtrace #'bt.2.3
 309                               '(((sb-c::xep bt.2.3) &rest)))))
 310   (with-details nil
 311     (assert (verify-backtrace #'bt.2.1
 312                               '((bt.2.1))))
 313     (assert (verify-backtrace #'bt.2.2
 314                               '((bt.2.2 &rest))))
 315     (assert (verify-backtrace #'bt.2.3
 316                               '((bt.2.3 &rest)))))
 317
 318   ;; VARARGS-ENTRY
 319   (write-line "//varargs-entry")
 320   (with-details t
 321     (assert (verify-backtrace #'bt.3.1
 322                               '(((sb-c::varargs-entry bt.3.1) :key nil))))
 323     (assert (verify-backtrace #'bt.3.2
 324                               '(((sb-c::varargs-entry bt.3.2) :key ?))))
 325     (assert (verify-backtrace #'bt.3.3
 326                               '(((sb-c::varargs-entry bt.3.3) &rest)))))
 327   (with-details nil
 328     (assert (verify-backtrace #'bt.3.1
 329                               '((bt.3.1 :key nil))))
 330     (assert (verify-backtrace #'bt.3.2
 331                               '((bt.3.2 :key ?))))
 332     (assert (verify-backtrace #'bt.3.3
 333                               '((bt.3.3 &rest)))))
 334
 335   ;; HAIRY-ARG-PROCESSOR
 336   (write-line "//hairy-args-processor")
 337   (with-details t
 338     (assert (verify-backtrace #'bt.4.1
 339                               '(((sb-c::hairy-arg-processor bt.4.1) ?))))
 340     (assert (verify-backtrace #'bt.4.2
 341                               '(((sb-c::hairy-arg-processor bt.4.2) ?))))
 342     (assert (verify-backtrace #'bt.4.3
 343                               '(((sb-c::hairy-arg-processor bt.4.3) &rest)))))
 344   (with-details nil
 345     (assert (verify-backtrace #'bt.4.1
 346                               '((bt.4.1 ?))))
 347     (assert (verify-backtrace #'bt.4.2
 348                               '((bt.4.2 ?))))
 349     (assert (verify-backtrace #'bt.4.3
 350                               '((bt.4.3 &rest)))))
 351
 352   ;; &OPTIONAL-PROCESSOR
 353   (write-line "//optional-processor")
 354   (with-details t
 355     (assert (verify-backtrace #'bt.5.1
 356                               '(((sb-c::&optional-processor bt.5.1)))))
 357     (assert (verify-backtrace #'bt.5.2
 358                               '(((sb-c::&optional-processor bt.5.2) &rest))))
 359     (assert (verify-backtrace #'bt.5.3
 360                               '(((sb-c::&optional-processor bt.5.3) &rest)))))
 361   (with-details nil
 362     (assert (verify-backtrace #'bt.5.1
 363                               '((bt.5.1))))
 364     (assert (verify-backtrace #'bt.5.2
 365                               '((bt.5.2 &rest))))
 366     (assert (verify-backtrace #'bt.5.3
 367                               '((bt.5.3 &rest))))))
 368
 369 (write-line "//compile nil")
 370 (defvar *compile-nil-error* (compile nil '(lambda (x) (cons (when x (error "oops")) nil))))
 371 (defvar *compile-nil-non-tc* (compile nil '(lambda (y) (cons (funcall *compile-nil-error* y) nil))))
 372 (assert (verify-backtrace (lambda () (funcall *compile-nil-non-tc* 13))
 373                           '(((lambda (x)) 13)
 374                             ((lambda (y)) 13))))
 375
 376 ;;;; test TRACE
 377
 378 (defun trace-this ()
 379   'ok)
 380
 381 (defun trace-fact (n)
 382   (if (zerop n)
 383       1
 384       (* n (trace-fact (1- n)))))
 385
 386 (let ((out (with-output-to-string (*trace-output*)
 387              (trace trace-this)
 388              (assert (eq 'ok (trace-this)))
 389              (untrace))))
 390   (assert (search "TRACE-THIS" out))
 391   (assert (search "returned OK" out)))
 392
 393 ;;; bug 379
 394 ;;; This is not a WITH-TEST :FAILS-ON PPC DARWIN since there are
 395 ;;; suspicions that the breakpoint trace might corrupt the whole image
 396 ;;; on that platform.
 397 #-(and (or ppc x86 x86-64) darwin)
 398 (with-test (:name (trace :encapsulate nil)
 399             :fails-on '(or :ppc :sparc :mips))
 400   (let ((out (with-output-to-string (*trace-output*)
 401                (trace trace-this :encapsulate nil)
 402                (assert (eq 'ok (trace-this)))
 403                (untrace))))
 404     (assert (search "TRACE-THIS" out))
 405     (assert (search "returned OK" out))))
 406
 407 #-(and (or ppc x86 x86-64) darwin)
 408 (with-test (:name (trace-recursive :encapsulate nil)
 409             :fails-on '(or :ppc :sparc :mips))
 410   (let ((out (with-output-to-string (*trace-output*)
 411                (trace trace-fact :encapsulate nil)
 412                (assert (= 120 (trace-fact 5)))
 413                (untrace))))
 414     (assert (search "TRACE-FACT" out))
 415     (assert (search "returned 1" out))
 416     (assert (search "returned 120" out))))
 417
 418 (with-test (:name :bug-414)
 419   (handler-bind ((warning #'error))
 420     (load (compile-file "bug-414.lisp"))
 421     (disassemble 'bug-414)))
 422
 423 ;;;; test infinite error protection
 424
 425 (defmacro nest-errors (n-levels error-form)
 426   (if (< 0 n-levels)
 427       `(handler-bind ((error (lambda (condition)
 428                                (declare (ignore condition))
 429                                ,error-form)))
 430         (nest-errors ,(1- n-levels) ,error-form))
 431       error-form))
 432
 433 (defun erroring-debugger-hook (condition old-debugger-hook)
 434   (let ((*debugger-hook* old-debugger-hook))
 435     (format t "recursive condition: ~A~%" condition) (force-output)
 436     (error "recursive condition: ~A" condition)))
 437
 438 (defun test-inifinite-error-protection ()
 439   ;; after 50 successful throws to SB-IMPL::TOPLEVEL-CATCHER sbcl used
 440   ;; to halt, it produces so much garbage that's hard to suppress that
 441   ;; it is tested only once
 442   (write-line "--HARMLESS BUT ALARMING BACKTRACE COMING UP--")
 443   (let ((*debugger-hook* #'erroring-debugger-hook))
 444     (loop repeat 1 do
 445           (let ((error-counter 0)
 446                 (*terminal-io* (make-broadcast-stream)))
 447             (assert
 448              (not (eq
 449                    :normal-exit
 450                    (catch 'sb-impl::toplevel-catcher
 451                      (nest-errors 20 (error "infinite error ~s"
 452                                             (incf error-counter)))
 453                      :normal-exit)))))))
 454   (write-line "--END OF H-B-A-B--"))
 455
 456 (enable-debugger)
 457
 458 (test-inifinite-error-protection)
 459
 460 #+sb-thread
 461 (let ((thread (sb-thread:make-thread #'test-inifinite-error-protection)))
 462   (loop while (sb-thread:thread-alive-p thread)))
 463
 464 (disable-debugger)
 465
 466 (write-line "/debug.impure.lisp done")