;; Copyright (C) 2008-2019 Free Software Foundation, Inc. ;; ;; This program is free software; you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by ;; the Free Software Foundation; either version 3 of the License, or ;; (at your option) any later version. ;; ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; ;; You should have received a copy of the GNU General Public License ;; along with this program. If not, see . ;; This file is part of the GDB testsuite. ;; It tests Scheme pretty printers. (use-modules (gdb) (gdb printing)) (define (make-pointer-iterator pointer len) (let ((next! (lambda (iter) (let* ((start (iterator-object iter)) (progress (iterator-progress iter)) (current (car progress)) (len (cdr progress))) (if (= current len) (end-of-iteration) (let ((pointer (value-add start current))) (set-car! progress (+ current 1)) (cons (format #f "[~A]" current) (value-dereference pointer)))))))) (make-iterator pointer (cons 0 len) next!))) (define (make-pointer-iterator-except pointer len) (let ((next! (lambda (iter) (if *exception-flag* (throw 'gdb:memory-error "hi bob")) (let* ((start (iterator-object iter)) (progress (iterator-progress iter)) (current (car progress)) (len (cdr progress))) (if (= current len) (end-of-iteration) (let ((pointer (value-add start current))) (set-car! progress (+ current 1)) (cons (format #f "[~A]" current) (value-dereference pointer)))))))) (make-iterator pointer (cons 0 len) next!))) ;; Test returning a from a printer. (define (make-string-printer val) (make-pretty-printer-worker #f (lambda (printer) (value-field (value-field val "whybother") "contents")) #f)) ;; Test a printer with children. (define (make-container-printer val) ;; This is a little different than the Python version in that if there's ;; an error accessing these fields we'll throw it at matcher time instead ;; of at printer time. Done this way to explore the possibilities. (let ((name (value-field val "name")) (len (value-field val "len")) (elements (value-field val "elements"))) (make-pretty-printer-worker #f (lambda (printer) (format #f "container ~A with ~A elements" name len)) (lambda (printer) (make-pointer-iterator elements (value->integer len)))))) ;; Test "array" display hint. (define (make-array-printer val) (let ((name (value-field val "name")) (len (value-field val "len")) (elements (value-field val "elements"))) (make-pretty-printer-worker "array" (lambda (printer) (format #f "array ~A with ~A elements" name len)) (lambda (printer) (make-pointer-iterator elements (value->integer len)))))) ;; Flag to make no-string-container printer throw an exception. (define *exception-flag* #f) ;; Test a printer where to_string returns #f. (define (make-no-string-container-printer val) (let ((len (value-field val "len")) (elements (value-field val "elements"))) (make-pretty-printer-worker #f (lambda (printer) #f) (lambda (printer) (make-pointer-iterator-except elements (value->integer len)))))) ;; The actual pretty-printer for pp_s is split out so that we can pass ;; in a prefix to distinguish objfile/progspace/global. (define (pp_s-printer prefix val) (let ((a (value-field val "a")) (b (value-field val "b"))) (if (not (value=? (value-address a) b)) (error (format #f "&a(~A) != b(~A)" (value-address a) b))) (format #f "~aa=<~A> b=<~A>" prefix a b))) (define (make-pp_s-printer val) (make-pretty-printer-worker #f (lambda (printer) (pp_s-printer "" val)) #f)) (define (make-pp_ss-printer val) (make-pretty-printer-worker #f (lambda (printer) (let ((a (value-field val "a")) (b (value-field val "b"))) (format #f "a=<~A> b=<~A>" a b))) #f)) (define (make-pp_sss-printer val) (make-pretty-printer-worker #f (lambda (printer) (let ((a (value-field val "a")) (b (value-field val "b"))) (format #f "a=<~A> b=<~A>" a b))) #f)) (define (make-pp_multiple_virtual-printer val) (make-pretty-printer-worker #f (lambda (printer) (format #f "pp value variable is: ~A" (value-field val "value"))) #f)) (define (make-pp_vbase1-printer val) (make-pretty-printer-worker #f (lambda (printer) (format #f "pp class name: ~A" (type-tag (value-type val)))) #f)) (define (make-pp_nullstr-printer val) (make-pretty-printer-worker #f (lambda (printer) (value->string (value-field val "s") #:encoding (arch-charset (current-arch)))) #f)) (define (make-pp_ns-printer val) (make-pretty-printer-worker "string" (lambda (printer) (let ((len (value-field val "length"))) (value->string (value-field val "null_str") #:encoding (arch-charset (current-arch)) #:length (value->integer len)))) #f)) (define *pp-ls-encoding* #f) (define (make-pp_ls-printer val) (make-pretty-printer-worker "string" (lambda (printer) (if *pp-ls-encoding* (value->lazy-string (value-field val "lazy_str") #:encoding *pp-ls-encoding*) (value->lazy-string (value-field val "lazy_str")))) #f)) (define (make-pp_hint_error-printer val) "Use an invalid value for the display hint." (make-pretty-printer-worker 42 (lambda (printer) "hint_error_val") #f)) (define (make-pp_children_as_list-printer val) (make-pretty-printer-worker #f (lambda (printer) "children_as_list_val") (lambda (printer) (make-list-iterator (list (cons "one" 1)))))) (define (make-pp_outer-printer val) (make-pretty-printer-worker #f (lambda (printer) (format #f "x = ~A" (value-field val "x"))) (lambda (printer) (make-list-iterator (list (cons "s" (value-field val "s")) (cons "x" (value-field val "x"))))))) (define (make-memory-error-string-printer val) (make-pretty-printer-worker "string" (lambda (printer) (scm-error 'gdb:memory-error "memory-error-printer" "Cannot access memory." '() '())) #f)) (define (make-pp_eval_type-printer val) (make-pretty-printer-worker #f (lambda (printer) (execute "bt" #:to-string #t) (format #f "eval=<~A>" (value-print (parse-and-eval "eval_func (123456789, 2, 3, 4, 5, 6, 7, 8)")))) #f)) (define (get-type-for-printing val) "Return type of val, stripping away typedefs, etc." (let ((type (value-type val))) (if (= (type-code type) TYPE_CODE_REF) (set! type (type-target type))) (type-strip-typedefs (type-unqualified type)))) (define (disable-matcher!) (set-pretty-printer-enabled! *pretty-printer* #f)) (define (enable-matcher!) (set-pretty-printer-enabled! *pretty-printer* #t)) (define (make-pretty-printer-dict) (let ((dict (make-hash-table))) (hash-set! dict "struct s" make-pp_s-printer) (hash-set! dict "s" make-pp_s-printer) (hash-set! dict "S" make-pp_s-printer) (hash-set! dict "struct ss" make-pp_ss-printer) (hash-set! dict "ss" make-pp_ss-printer) (hash-set! dict "const S &" make-pp_s-printer) (hash-set! dict "SSS" make-pp_sss-printer) (hash-set! dict "VirtualTest" make-pp_multiple_virtual-printer) (hash-set! dict "Vbase1" make-pp_vbase1-printer) (hash-set! dict "struct nullstr" make-pp_nullstr-printer) (hash-set! dict "nullstr" make-pp_nullstr-printer) ;; Note that we purposely omit the typedef names here. ;; Printer lookup is based on canonical name. ;; However, we do need both tagged and untagged variants, to handle ;; both the C and C++ cases. (hash-set! dict "struct string_repr" make-string-printer) (hash-set! dict "struct container" make-container-printer) (hash-set! dict "struct justchildren" make-no-string-container-printer) (hash-set! dict "string_repr" make-string-printer) (hash-set! dict "container" make-container-printer) (hash-set! dict "justchildren" make-no-string-container-printer) (hash-set! dict "struct ns" make-pp_ns-printer) (hash-set! dict "ns" make-pp_ns-printer) (hash-set! dict "struct lazystring" make-pp_ls-printer) (hash-set! dict "lazystring" make-pp_ls-printer) (hash-set! dict "struct outerstruct" make-pp_outer-printer) (hash-set! dict "outerstruct" make-pp_outer-printer) (hash-set! dict "struct hint_error" make-pp_hint_error-printer) (hash-set! dict "hint_error" make-pp_hint_error-printer) (hash-set! dict "struct children_as_list" make-pp_children_as_list-printer) (hash-set! dict "children_as_list" make-pp_children_as_list-printer) (hash-set! dict "memory_error" make-memory-error-string-printer) (hash-set! dict "eval_type_s" make-pp_eval_type-printer) dict)) ;; This is one way to register a printer that is composed of several ;; subprinters, but there's no way to disable or list individual subprinters. (define (make-pretty-printer-from-dict name dict lookup-maker) (make-pretty-printer name (lambda (matcher val) (let ((printer-maker (lookup-maker dict val))) (and printer-maker (printer-maker val)))))) (define (lookup-pretty-printer-maker-from-dict dict val) (let ((type-name (type-tag (get-type-for-printing val)))) (and type-name (hash-ref dict type-name)))) (define *pretty-printer* (make-pretty-printer-from-dict "pretty-printer-test" (make-pretty-printer-dict) lookup-pretty-printer-maker-from-dict)) (append-pretty-printer! #f *pretty-printer*) ;; Different versions of a simple pretty-printer for use in testing ;; objfile/progspace lookup. (define (make-objfile-pp_s-printer val) (make-pretty-printer-worker #f (lambda (printer) (pp_s-printer "objfile " val)) #f)) (define (install-objfile-pretty-printers! pspace objfile-name) (let ((objfiles (filter (lambda (objfile) (string-contains (objfile-filename objfile) objfile-name)) (progspace-objfiles pspace))) (dict (make-hash-table))) (if (not (= (length objfiles) 1)) (error "objfile not found or ambiguous: " objfile-name)) (hash-set! dict "s" make-objfile-pp_s-printer) (let ((pp (make-pretty-printer-from-dict "objfile-pretty-printer-test" dict lookup-pretty-printer-maker-from-dict))) (append-pretty-printer! (car objfiles) pp)))) (define (make-progspace-pp_s-printer val) (make-pretty-printer-worker #f (lambda (printer) (pp_s-printer "progspace " val)) #f)) (define (install-progspace-pretty-printers! pspace) (let ((dict (make-hash-table))) (hash-set! dict "s" make-progspace-pp_s-printer) (let ((pp (make-pretty-printer-from-dict "progspace-pretty-printer-test" dict lookup-pretty-printer-maker-from-dict))) (append-pretty-printer! pspace pp))))