lisp/emacs-lisp/find-gc.el

   1 ;;; find-gc.el --- detect functions that call the garbage collector
   2
   3 ;; Copyright (C) 1992, 2001-2014 Free Software Foundation, Inc.
   4
   5 ;; Maintainer: emacs-devel@gnu.org
   6
   7 ;; This file is part of GNU Emacs.
   8
   9 ;; GNU Emacs is free software: you can redistribute it and/or modify
  10 ;; it under the terms of the GNU General Public License as published by
  11 ;; the Free Software Foundation, either version 3 of the License, or
  12 ;; (at your option) any later version.
  13
  14 ;; GNU Emacs is distributed in the hope that it will be useful,
  15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 ;; GNU General Public License for more details.
  18
  19 ;; You should have received a copy of the GNU General Public License
  20 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  21
  22 ;;; Commentary:
  23
  24 ;; Produce in find-gc-unsafe-list the set of all functions that may invoke GC.
  25 ;; This expects the Emacs sources to live in find-gc-source-directory.
  26
  27 ;;; Code:
  28
  29 (defvar find-gc-unsafe-list nil
  30   "The list of unsafe functions is placed here by `find-gc-unsafe'.")
  31
  32 (defvar find-gc-source-directory
  33   (file-name-as-directory (expand-file-name "src" source-directory))
  34   "Directory containing Emacs C sources.")
  35
  36 (defvar find-gc-subrs-callers nil
  37   "Alist of users of subrs, from GC testing.
  38 Each entry has the form (FUNCTION . FUNCTIONS-THAT-CALL-IT).")
  39
  40 (defvar find-gc-subrs-called nil
  41   "Alist of subrs called, in GC testing.
  42 Each entry has the form (FUNCTION . FUNCTIONS-IT-CALLS).")
  43
  44
  45 ;;; Functions on this list are safe, even if they appear to be able
  46 ;;; to call the target.
  47
  48 (defvar find-gc-noreturn-list '(Fsignal Fthrow wrong_type_argument))
  49
  50 ;;; This was originally generated directory-files, but there were
  51 ;;; too many files there that were not actually compiled.  The
  52 ;;; list below was created for a HP-UX 7.0 system.
  53
  54 (defvar find-gc-source-files
  55   '("dispnew.c" "scroll.c" "xdisp.c" "window.c"
  56     "term.c" "cm.c" "emacs.c" "keyboard.c" "macros.c"
  57     "keymap.c" "sysdep.c" "buffer.c" "filelock.c"
  58     "insdel.c" "marker.c" "minibuf.c" "fileio.c"
  59     "dired.c" "cmds.c" "casefiddle.c"
  60     "indent.c" "search.c" "regex.c" "undo.c"
  61     "alloc.c" "data.c" "doc.c" "editfns.c"
  62     "callint.c" "eval.c" "fns.c" "print.c" "lread.c"
  63     "syntax.c" "unexcoff.c"
  64     "bytecode.c" "process.c" "callproc.c" "doprnt.c"
  65     "xterm.c" "xfns.c"))
  66
  67
  68 (defun find-gc-unsafe ()
  69   "Return a list of unsafe functions--that is, which can call GC.
  70 Also store it in `find-gc-unsafe-list'."
  71   (trace-call-tree nil)
  72   (trace-use-tree)
  73   (find-unsafe-funcs 'Fgarbage_collect)
  74   (setq find-gc-unsafe-list
  75         (sort find-gc-unsafe-list
  76               (function (lambda (x y)
  77                           (string-lessp (car x) (car y))))))
  78 )
  79
  80 ;;; This does a depth-first search to find all functions that can
  81 ;;; ultimately call the function "target".  The result is an a-list
  82 ;;; in find-gc-unsafe-list; the cars are the unsafe functions, and the cdrs
  83 ;;; are (one of) the unsafe functions that these functions directly
  84 ;;; call.
  85
  86 (defun find-unsafe-funcs (target)
  87   (setq find-gc-unsafe-list (list (list target)))
  88   (trace-unsafe target)
  89 )
  90
  91 (defun trace-unsafe (func)
  92   (let ((used (assq func find-gc-subrs-callers)))
  93     (or used
  94         (error "No find-gc-subrs-callers for %s" (car find-gc-unsafe-list)))
  95     (while (setq used (cdr used))
  96       (or (assq (car used) find-gc-unsafe-list)
  97           (memq (car used) find-gc-noreturn-list)
  98           (progn
  99             (push (cons (car used) func) find-gc-unsafe-list)
 100             (trace-unsafe (car used))))))
 101 )
 102
 103
 104
 105
 106 (defun trace-call-tree (&optional ignored)
 107   (message "Setting up directories...")
 108   (setq find-gc-subrs-called nil)
 109   (let ((case-fold-search nil)
 110         (default-directory find-gc-source-directory)
 111         (files find-gc-source-files)
 112         name entry rtlfile)
 113     (dolist (file files)
 114       (message "Compiling %s..." file)
 115       (call-process "gcc" nil nil nil "-I" "." "-I" "../lib"
 116                     "-fdump-rtl-expand" "-o" null-device "-c" file)
 117       (setq rtlfile
 118             (file-expand-wildcards (format "%s.*.expand" file) t))
 119       (if (/= 1 (length rtlfile))
 120           (message "Error compiling `%s'?" file)
 121         (with-temp-buffer
 122           (insert-file-contents (setq rtlfile (car rtlfile)))
 123           (delete-file rtlfile)
 124           (while (re-search-forward ";; Function \\|(call_insn " nil t)
 125             (if (= (char-after (- (point) 3)) ?o)
 126                 (progn
 127                   (looking-at "[a-zA-Z0-9_]+")
 128                   (setq name (intern (match-string 0)))
 129                   (message "%s : %s" (car files) name)
 130                   (setq entry (list name)
 131                         find-gc-subrs-called
 132                         (cons entry find-gc-subrs-called)))
 133               (if (looking-at ".*\n?.*\"\\([A-Za-z0-9_]+\\)\"")
 134                   (progn
 135                     (setq name (intern (match-string 1)))
 136                     (or (memq name (cdr entry))
 137                         (setcdr entry (cons name (cdr entry)))))))))))))
 138
 139 (defun trace-use-tree ()
 140   (setq find-gc-subrs-callers (mapcar 'list (mapcar 'car find-gc-subrs-called)))
 141   (let ((ptr find-gc-subrs-called)
 142         p2 found)
 143     (while ptr
 144       (setq p2 (car ptr))
 145       (while (setq p2 (cdr p2))
 146         (if (setq found (assq (car p2) find-gc-subrs-callers))
 147             (setcdr found (cons (car (car ptr)) (cdr found)))))
 148       (setq ptr (cdr ptr))))
 149 )
 150
 151 (provide 'find-gc)
 152
 153 ;;; find-gc.el ends here