*** empty log message ***
[emacs.git] / lisp / gdb-ui.el
blob1ae70eb6f8bea54bb7ba1df08f99712c7e64afb9
1 ;;; gdb-ui.el --- User Interface for running GDB
3 ;; Author: Nick Roberts <nick@nick.uklinux.net>
4 ;; Maintainer: FSF
5 ;; Keywords: unix, tools
7 ;; Copyright (C) 2002 Free Software Foundation, Inc.
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 2, or (at your option)
14 ;; any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24 ;; Boston, MA 02111-1307, USA.
26 ;;; Commentary:
28 ;; This mode acts as a graphical user interface to GDB. You can interact with
29 ;; GDB through the GUD buffer in the usual way, but there are also further
30 ;; buffers which control the execution and describe the state of your program.
31 ;; It separates the input/output of your program from that of GDB and displays
32 ;; expressions and their current values in their own buffers. It also uses
33 ;; features of Emacs 21 such as the display margin for breakpoints, and the
34 ;; toolbar (see the GDB Graphical Interface section in the Emacs info manual).
36 ;; Start the debugger with M-x gdba.
38 ;; This file is based on gdba.el from GDB 5.0 written by Tom Lord and Jim
39 ;; Kingdon and uses GDB's annotation interface. You don't need to know about
40 ;; annotations to use this mode as a debugger, but if you are interested
41 ;; developing the mode itself, then see the Annotations section in the GDB
42 ;; info manual.
44 ;; Known Bugs:
45 ;; Does not auto-display arrays of structures or structures containing arrays.
46 ;; On MS Windows, Gdb 5.1.1 from MinGW 2.0 does not flush the output from the
47 ;; inferior.
49 ;;; Code:
51 (require 'gud)
53 (defcustom gdb-window-height 20
54 "Number of lines in a frame for a displayed expression in GDB-UI."
55 :type 'integer
56 :group 'gud)
58 (defcustom gdb-window-width 30
59 "Width of a frame for a displayed expression in GDB-UI."
60 :type 'integer
61 :group 'gud)
63 (defvar gdb-current-address "main" "Initialisation for Assembler buffer.")
64 (defvar gdb-previous-address nil)
65 (defvar gdb-previous-frame nil)
66 (defvar gdb-current-frame "main")
67 (defvar gdb-display-in-progress nil)
68 (defvar gdb-dive nil)
69 (defvar gdb-view-source t "Non-nil means that source code can be viewed")
70 (defvar gdb-selected-view 'source "Code type that user wishes to view")
71 (defvar gdb-buffer-type nil)
72 (defvar gdb-variables '()
73 "A list of variables that are local to the GUD buffer.")
76 ;;;###autoload
77 (defun gdba (command-line)
78 "Run gdb on program FILE in buffer *gud-FILE*.
79 The directory containing FILE becomes the initial working directory
80 and source-file directory for your debugger.
82 If `gdb-many-windows' is nil (the default value) then gdb starts with
83 just two windows : the GUD and the source buffer. If it is t the
84 following layout will appear (keybindings given in relevant buffer) :
86 ---------------------------------------------------------------------
87 GDB Toolbar
88 ---------------------------------------------------------------------
89 GUD buffer (I/O of GDB) | Locals buffer
93 ---------------------------------------------------------------------
94 Source buffer | Input/Output (of debuggee) buffer
95 | (comint-mode)
102 ---------------------------------------------------------------------
103 Stack buffer | Breakpoints buffer
104 RET gdb-frames-select | SPC gdb-toggle-breakpoint
105 | RET gdb-goto-breakpoint
106 | d gdb-delete-breakpoint
107 ---------------------------------------------------------------------
109 All the buffers share the toolbar and source should always display in the same
110 window e.g after typing g on a breakpoint in the breakpoints buffer. Breakpoint
111 icons are displayed both by setting a break with gud-break and by typing break
112 in the GUD buffer.
114 This works best (depending on the size of your monitor) using most of the
115 screen.
117 Displayed expressions appear in separate frames. Arrays may be displayed
118 as slices and visualised using the graph program from plotutils if installed.
119 Pointers in structures may be followed in a tree-like fashion.
121 The following interactive lisp functions help control operation :
123 `gdb-many-windows' - Toggle the number of windows gdb uses.
124 `gdb-restore-windows' - To restore the window layout."
126 (interactive (list (gud-query-cmdline 'gdba)))
128 ;; Let's start with a basic gud-gdb buffer and then modify it a bit.
129 (gdb command-line)
131 (set (make-local-variable 'gud-minor-mode) 'gdba)
132 (set (make-local-variable 'gud-marker-filter) 'gud-gdba-marker-filter)
134 (gud-def gud-break (if (not (string-equal mode-name "Assembler"))
135 (gud-call "break %f:%l" arg)
136 (save-excursion
137 (beginning-of-line)
138 (forward-char 2)
139 (gud-call "break *%a" arg)))
140 "\C-b" "Set breakpoint at current line or address.")
142 (gud-def gud-remove (if (not (string-equal mode-name "Assembler"))
143 (gud-call "clear %f:%l" arg)
144 (save-excursion
145 (beginning-of-line)
146 (forward-char 2)
147 (gud-call "clear *%a" arg)))
148 "\C-d" "Remove breakpoint at current line or address.")
150 (gud-def gud-until (if (not (string-equal mode-name "Assembler"))
151 (gud-call "until %f:%l" arg)
152 (save-excursion
153 (beginning-of-line)
154 (forward-char 2)
155 (gud-call "until *%a" arg)))
156 "\C-u" "Continue to current line or address.")
158 (setq comint-input-sender 'gdb-send)
160 ;; (re-)initialise
161 (setq gdb-current-address "main")
162 (setq gdb-previous-address nil)
163 (setq gdb-previous-frame nil)
164 (setq gdb-current-frame "main")
165 (setq gdb-display-in-progress nil)
166 (setq gdb-dive nil)
167 (setq gdb-view-source t)
168 (setq gdb-selected-view 'source)
170 (mapc 'make-local-variable gdb-variables)
171 (setq gdb-buffer-type 'gdba)
173 (gdb-clear-inferior-io)
175 (if (eq window-system 'w32)
176 (gdb-enqueue-input (list "set new-console off\n" 'ignore)))
177 (gdb-enqueue-input (list "set height 0\n" 'ignore))
178 ;; find source file and compilation directory here
179 (gdb-enqueue-input (list "server list main\n" 'ignore)) ; C program
180 (gdb-enqueue-input (list "server list MAIN__\n" 'ignore)) ; Fortran program
181 (gdb-enqueue-input (list "server info source\n" 'gdb-source-info))
183 (run-hooks 'gdba-mode-hook))
185 (defun gud-display ()
186 "Auto-display (possibly dereferenced) C expression at point."
187 (interactive)
188 (save-excursion
189 (let ((expr (gud-find-c-expr)))
190 (gdb-enqueue-input
191 (list (concat "server ptype " expr "\n")
192 `(lambda () (gud-display1 ,expr)))))))
194 (defun gud-display1 (expr)
195 (goto-char (point-min))
196 (if (looking-at "No symbol")
197 (progn
198 (gdb-set-output-sink 'user)
199 (gud-call (concat "server ptype " expr)))
200 (goto-char (- (point-max) 1))
201 (if (equal (char-before) (string-to-char "\*"))
202 (gud-call (concat "display* " expr))
203 (gud-call (concat "display " expr)))))
205 ; this would messy because these bindings don't work with M-x gdb
206 ; (define-key global-map "\C-x\C-a\C-a" 'gud-display)
207 ; (define-key gud-minor-mode-map "\C-c\C-a" 'gud-display)
211 ;; ======================================================================
213 ;; In this world, there are gdb variables (of unspecified
214 ;; representation) and buffers associated with those objects.
215 ;; The list of variables is built up by the expansions of
216 ;; def-gdb-variable
218 (defmacro def-gdb-var (root-symbol &optional default doc)
219 (let* ((root (symbol-name root-symbol))
220 (accessor (intern (concat "gdb-get-" root)))
221 (setter (intern (concat "gdb-set-" root)))
222 (name (intern (concat "gdb-" root))))
223 `(progn
224 (defvar ,name ,default ,doc)
225 (if (not (memq ',name gdb-variables))
226 (push ',name gdb-variables))
227 (defun ,accessor ()
228 (buffer-local-value ',name gud-comint-buffer))
229 (defun ,setter (val)
230 (with-current-buffer gud-comint-buffer
231 (setq ,name val))))))
233 (def-gdb-var buffer-type nil
234 "One of the symbols bound in gdb-buffer-rules")
236 (def-gdb-var burst ""
237 "A string of characters from gdb that have not yet been processed.")
239 (def-gdb-var input-queue ()
240 "A list of gdb command objects.")
242 (def-gdb-var prompting nil
243 "True when gdb is idle with no pending input.")
245 (def-gdb-var output-sink 'user
246 "The disposition of the output of the current gdb command.
247 Possible values are these symbols:
249 user -- gdb output should be copied to the GUD buffer
250 for the user to see.
252 inferior -- gdb output should be copied to the inferior-io buffer
254 pre-emacs -- output should be ignored util the post-prompt
255 annotation is received. Then the output-sink
256 becomes:...
257 emacs -- output should be collected in the partial-output-buffer
258 for subsequent processing by a command. This is the
259 disposition of output generated by commands that
260 gdb mode sends to gdb on its own behalf.
261 post-emacs -- ignore input until the prompt annotation is
262 received, then go to USER disposition.
265 (def-gdb-var current-item nil
266 "The most recent command item sent to gdb.")
268 (def-gdb-var pending-triggers '()
269 "A list of trigger functions that have run later than their output
270 handlers.")
272 ;; end of gdb variables
274 (defun gdb-get-target-string ()
275 (with-current-buffer gud-comint-buffer
276 gud-target-name))
280 ;; gdb buffers.
282 ;; Each buffer has a TYPE -- a symbol that identifies the function
283 ;; of that particular buffer.
285 ;; The usual gdb interaction buffer is given the type `gdba' and
286 ;; is constructed specially.
288 ;; Others are constructed by gdb-get-create-buffer and
289 ;; named according to the rules set forth in the gdb-buffer-rules-assoc
291 (defvar gdb-buffer-rules-assoc '())
293 (defun gdb-get-buffer (key)
294 "Return the gdb buffer tagged with type KEY.
295 The key should be one of the cars in `gdb-buffer-rules-assoc'."
296 (save-excursion
297 (gdb-look-for-tagged-buffer key (buffer-list))))
299 (defun gdb-get-create-buffer (key)
300 "Create a new gdb buffer of the type specified by KEY.
301 The key should be one of the cars in `gdb-buffer-rules-assoc'."
302 (or (gdb-get-buffer key)
303 (let* ((rules (assoc key gdb-buffer-rules-assoc))
304 (name (funcall (gdb-rules-name-maker rules)))
305 (new (get-buffer-create name)))
306 (with-current-buffer new
307 ;; FIXME: This should be set after calling the function, since the
308 ;; function should run kill-all-local-variables.
309 (set (make-local-variable 'gdb-buffer-type) key)
310 (if (cdr (cdr rules))
311 (funcall (car (cdr (cdr rules)))))
312 (set (make-local-variable 'gud-comint-buffer) gud-comint-buffer)
313 (set (make-local-variable 'gud-minor-mode) 'gdba)
314 (set (make-local-variable 'tool-bar-map) gud-tool-bar-map)
315 new))))
317 (defun gdb-rules-name-maker (rules) (car (cdr rules)))
319 (defun gdb-look-for-tagged-buffer (key bufs)
320 (let ((retval nil))
321 (while (and (not retval) bufs)
322 (set-buffer (car bufs))
323 (if (eq gdb-buffer-type key)
324 (setq retval (car bufs)))
325 (setq bufs (cdr bufs)))
326 retval))
329 ;; This assoc maps buffer type symbols to rules. Each rule is a list of
330 ;; at least one and possible more functions. The functions have these
331 ;; roles in defining a buffer type:
333 ;; NAME - Return a name for this buffer type.
335 ;; The remaining function(s) are optional:
337 ;; MODE - called in a new buffer with no arguments, should establish
338 ;; the proper mode for the buffer.
341 (defun gdb-set-buffer-rules (buffer-type &rest rules)
342 (let ((binding (assoc buffer-type gdb-buffer-rules-assoc)))
343 (if binding
344 (setcdr binding rules)
345 (push (cons buffer-type rules)
346 gdb-buffer-rules-assoc))))
348 ;; GUD buffers are an exception to the rules
349 (gdb-set-buffer-rules 'gdba 'error)
352 ;; Partial-output buffer : This accumulates output from a command executed on
353 ;; behalf of emacs (rather than the user).
355 (gdb-set-buffer-rules 'gdb-partial-output-buffer
356 'gdb-partial-output-name)
358 (defun gdb-partial-output-name ()
359 (concat "*partial-output-"
360 (gdb-get-target-string)
361 "*"))
364 (gdb-set-buffer-rules 'gdb-inferior-io
365 'gdb-inferior-io-name
366 'gdb-inferior-io-mode)
368 (defun gdb-inferior-io-name ()
369 (concat "*input/output of "
370 (gdb-get-target-string)
371 "*"))
373 (defvar gdb-inferior-io-mode-map
374 (let ((map (make-sparse-keymap)))
375 (define-key map "\C-c\C-c" 'gdb-inferior-io-interrupt)
376 (define-key map "\C-c\C-z" 'gdb-inferior-io-stop)
377 (define-key map "\C-c\C-\\" 'gdb-inferior-io-quit)
378 (define-key map "\C-c\C-d" 'gdb-inferior-io-eof)
379 map))
381 (define-derived-mode gdb-inferior-io-mode comint-mode "Debuggee I/O"
382 "Major mode for gdb inferior-io."
383 :syntax-table nil :abbrev-table nil
384 ;; We want to use comint because it has various nifty and familiar
385 ;; features. We don't need a process, but comint wants one, so create
386 ;; a dummy one.
387 (make-comint-in-buffer
388 (substring (buffer-name) 1 (- (length (buffer-name)) 1))
389 (current-buffer) "hexl")
390 (setq comint-input-sender 'gdb-inferior-io-sender))
392 (defun gdb-inferior-io-sender (proc string)
393 ;; PROC is the pseudo-process created to satisfy comint.
394 (with-current-buffer (process-buffer proc)
395 (setq proc (get-buffer-process gud-comint-buffer))
396 (process-send-string proc string)
397 (process-send-string proc "\n")))
399 (defun gdb-inferior-io-interrupt ()
400 "Interrupt the program being debugged."
401 (interactive)
402 (interrupt-process
403 (get-buffer-process gud-comint-buffer) comint-ptyp))
405 (defun gdb-inferior-io-quit ()
406 "Send quit signal to the program being debugged."
407 (interactive)
408 (quit-process
409 (get-buffer-process gud-comint-buffer) comint-ptyp))
411 (defun gdb-inferior-io-stop ()
412 "Stop the program being debugged."
413 (interactive)
414 (stop-process
415 (get-buffer-process gud-comint-buffer) comint-ptyp))
417 (defun gdb-inferior-io-eof ()
418 "Send end-of-file to the program being debugged."
419 (interactive)
420 (process-send-eof
421 (get-buffer-process gud-comint-buffer)))
425 ;; gdb communications
428 ;; INPUT: things sent to gdb
430 ;; The queues are lists. Each element is either a string (indicating user or
431 ;; user-like input) or a list of the form:
433 ;; (INPUT-STRING HANDLER-FN)
435 ;; The handler function will be called from the partial-output buffer when the
436 ;; command completes. This is the way to write commands which invoke gdb
437 ;; commands autonomously.
439 ;; These lists are consumed tail first.
442 (defun gdb-send (proc string)
443 "A comint send filter for gdb.
444 This filter may simply queue output for a later time."
445 (gdb-enqueue-input (concat string "\n")))
447 ;; Note: Stuff enqueued here will be sent to the next prompt, even if it
448 ;; is a query, or other non-top-level prompt.
450 (defun gdb-enqueue-input (item)
451 (if (gdb-get-prompting)
452 (progn
453 (gdb-send-item item)
454 (gdb-set-prompting nil))
455 (gdb-set-input-queue
456 (cons item (gdb-get-input-queue)))))
458 (defun gdb-dequeue-input ()
459 (let ((queue (gdb-get-input-queue)))
460 (and queue
461 (if (not (cdr queue))
462 (let ((answer (car queue)))
463 (gdb-set-input-queue '())
464 answer)
465 (gdb-take-last-elt queue)))))
467 ;; Don't use this in general.
468 (defun gdb-take-last-elt (l)
469 (if (cdr (cdr l))
470 (gdb-take-last-elt (cdr l))
471 (let ((answer (car (cdr l))))
472 (setcdr l '())
473 answer)))
477 ;; output -- things gdb prints to emacs
479 ;; GDB output is a stream interrupted by annotations.
480 ;; Annotations can be recognized by their beginning
481 ;; with \C-j\C-z\C-z<tag><opt>\C-j
483 ;; The tag is a string obeying symbol syntax.
485 ;; The optional part `<opt>' can be either the empty string
486 ;; or a space followed by more data relating to the annotation.
487 ;; For example, the SOURCE annotation is followed by a filename,
488 ;; line number and various useless goo. This data must not include
489 ;; any newlines.
492 (defcustom gud-gdba-command-name "gdb -annotate=2 -noasync"
493 "Default command to execute an executable under the GDB-UI debugger."
494 :type 'string
495 :group 'gud)
497 (defvar gdb-annotation-rules
498 '(("pre-prompt" gdb-pre-prompt)
499 ("prompt" gdb-prompt)
500 ("commands" gdb-subprompt)
501 ("overload-choice" gdb-subprompt)
502 ("query" gdb-subprompt)
503 ("prompt-for-continue" gdb-subprompt)
504 ("post-prompt" gdb-post-prompt)
505 ("source" gdb-source)
506 ("starting" gdb-starting)
507 ("exited" gdb-stopping)
508 ("signalled" gdb-stopping)
509 ("signal" gdb-stopping)
510 ("breakpoint" gdb-stopping)
511 ("watchpoint" gdb-stopping)
512 ("frame-begin" gdb-frame-begin)
513 ("stopped" gdb-stopped)
514 ("display-begin" gdb-display-begin)
515 ("display-end" gdb-display-end)
516 ; GDB commands info stack, info locals and frame generate an error-begin
517 ; annotation at start when there is no stack but this is a quirk/bug in
518 ; annotations.
519 ; ("error-begin" gdb-error-begin)
520 ("display-number-end" gdb-display-number-end)
521 ("array-section-begin" gdb-array-section-begin)
522 ("array-section-end" gdb-array-section-end)
523 ;; ("elt" gdb-elt)
524 ("field-begin" gdb-field-begin)
525 ("field-end" gdb-field-end)
526 ) "An assoc mapping annotation tags to functions which process them.")
528 (defconst gdb-source-spec-regexp
529 "\\(.*\\):\\([0-9]*\\):[0-9]*:[a-z]*:\\(0x[a-f0-9]*\\)")
531 ;; Do not use this except as an annotation handler.
532 (defun gdb-source (args)
533 (string-match gdb-source-spec-regexp args)
534 ;; Extract the frame position from the marker.
535 (setq gud-last-frame
536 (cons
537 (match-string 1 args)
538 (string-to-int (match-string 2 args))))
539 (setq gdb-current-address (match-string 3 args))
540 (setq gdb-view-source t))
542 (defun gdb-send-item (item)
543 (gdb-set-current-item item)
544 (if (stringp item)
545 (progn
546 (gdb-set-output-sink 'user)
547 (process-send-string (get-buffer-process gud-comint-buffer) item))
548 (progn
549 (gdb-clear-partial-output)
550 (gdb-set-output-sink 'pre-emacs)
551 (process-send-string (get-buffer-process gud-comint-buffer)
552 (car item)))))
554 (defun gdb-pre-prompt (ignored)
555 "An annotation handler for `pre-prompt'. This terminates the collection of
556 output from a previous command if that happens to be in effect."
557 (let ((sink (gdb-get-output-sink)))
558 (cond
559 ((eq sink 'user) t)
560 ((eq sink 'emacs)
561 (gdb-set-output-sink 'post-emacs)
562 (let ((handler
563 (car (cdr (gdb-get-current-item)))))
564 (with-current-buffer (gdb-get-create-buffer 'gdb-partial-output-buffer)
565 (funcall handler))))
567 (gdb-set-output-sink 'user)
568 (error "Phase error in gdb-pre-prompt (got %s)" sink)))))
570 (defun gdb-prompt (ignored)
571 "An annotation handler for `prompt'.
572 This sends the next command (if any) to gdb."
573 (let ((sink (gdb-get-output-sink)))
574 (cond
575 ((eq sink 'user) t)
576 ((eq sink 'post-emacs)
577 (gdb-set-output-sink 'user))
579 (gdb-set-output-sink 'user)
580 (error "Phase error in gdb-prompt (got %s)" sink))))
581 (let ((input (gdb-dequeue-input)))
582 (if input
583 (gdb-send-item input)
584 (progn
585 (gdb-set-prompting t)
586 (gud-display-frame)))))
588 (defun gdb-subprompt (ignored)
589 "An annotation handler for non-top-level prompts."
590 (gdb-set-prompting t))
592 (defun gdb-starting (ignored)
593 "An annotation handler for `starting'. This says that I/O for the
594 subprocess is now the program being debugged, not GDB."
595 (let ((sink (gdb-get-output-sink)))
596 (cond
597 ((eq sink 'user)
598 (progn
599 (setq gud-running t)
600 (gdb-set-output-sink 'inferior)))
601 (t (error "Unexpected `starting' annotation")))))
603 (defun gdb-stopping (ignored)
604 "An annotation handler for `exited' and other annotations which say that I/O
605 for the subprocess is now GDB, not the program being debugged."
606 (let ((sink (gdb-get-output-sink)))
607 (cond
608 ((eq sink 'inferior)
609 (gdb-set-output-sink 'user))
610 (t (error "Unexpected stopping annotation")))))
612 (defun gdb-frame-begin (ignored)
613 (let ((sink (gdb-get-output-sink)))
614 (cond
615 ((eq sink 'inferior)
616 (gdb-set-output-sink 'user))
617 ((eq sink 'user) t)
618 ((eq sink 'emacs) t)
619 (t (error "Unexpected frame-begin annotation (%S)" sink)))))
621 (defun gdb-stopped (ignored)
622 "An annotation handler for `stopped'. It is just like gdb-stopping, except
623 that if we already set the output sink to 'user in gdb-stopping, that is fine."
624 (setq gud-running nil)
625 (let ((sink (gdb-get-output-sink)))
626 (cond
627 ((eq sink 'inferior)
628 (gdb-set-output-sink 'user))
629 ((eq sink 'user) t)
630 (t (error "Unexpected stopped annotation")))))
632 (defun gdb-post-prompt (ignored)
633 "An annotation handler for `post-prompt'. This begins the collection of
634 output from the current command if that happens to be appropriate."
635 (if (not (gdb-get-pending-triggers))
636 (progn
637 (gdb-get-current-frame)
638 (gdb-invalidate-frames)
639 (gdb-invalidate-breakpoints)
640 (gdb-invalidate-assembler)
641 (gdb-invalidate-registers)
642 (gdb-invalidate-locals)
643 (gdb-invalidate-display)
644 (gdb-invalidate-threads)))
645 (let ((sink (gdb-get-output-sink)))
646 (cond
647 ((eq sink 'user) t)
648 ((eq sink 'pre-emacs)
649 (gdb-set-output-sink 'emacs))
651 (gdb-set-output-sink 'user)
652 (error "Phase error in gdb-post-prompt (got %s)" sink)))))
654 ;; If we get an error whilst evaluating one of the expressions
655 ;; we won't get the display-end annotation. Set the sink back to
656 ;; user to make sure that the error message is seen.
657 ;; NOT USED: see annotation-rules for reason.
658 ;(defun gdb-error-begin (ignored)
659 ; (gdb-set-output-sink 'user))
661 (defun gdb-display-begin (ignored)
662 (gdb-set-output-sink 'emacs)
663 (gdb-clear-partial-output)
664 (setq gdb-display-in-progress t))
666 (defvar gdb-expression-buffer-name nil)
667 (defvar gdb-display-number nil)
668 (defvar gdb-dive-display-number nil)
670 (defun gdb-display-number-end (ignored)
671 (set-buffer (gdb-get-buffer 'gdb-partial-output-buffer))
672 (setq gdb-display-number (buffer-string))
673 (setq gdb-expression-buffer-name
674 (concat "*display " gdb-display-number "*"))
675 (save-excursion
676 (if (progn
677 (set-buffer (window-buffer))
678 gdb-dive)
679 (progn
680 (let ((number gdb-display-number))
681 (switch-to-buffer
682 (set-buffer (get-buffer-create gdb-expression-buffer-name)))
683 (gdb-expressions-mode)
684 (setq gdb-dive-display-number number)))
685 (set-buffer (get-buffer-create gdb-expression-buffer-name))
686 (if (display-graphic-p)
687 (catch 'frame-exists
688 (dolist (frame (frame-list))
689 (if (string-equal (frame-parameter frame 'name)
690 gdb-expression-buffer-name)
691 (throw 'frame-exists nil)))
692 (gdb-expressions-mode)
693 (make-frame `((height . ,gdb-window-height)
694 (width . ,gdb-window-width)
695 (tool-bar-lines . nil)
696 (menu-bar-lines . nil)
697 (minibuffer . nil))))
698 (gdb-expressions-mode)
699 (gdb-display-buffer (get-buffer gdb-expression-buffer-name)))))
700 (set-buffer (gdb-get-buffer 'gdb-partial-output-buffer))
701 (setq gdb-dive nil))
703 (defvar gdb-nesting-level nil)
704 (defvar gdb-expression nil)
705 (defvar gdb-point nil)
706 (defvar gdb-annotation-arg nil)
708 (defun gdb-delete-line ()
709 "Delete the current line."
710 (delete-region (line-beginning-position) (line-beginning-position 2)))
712 (defun gdb-display-end (ignored)
713 (set-buffer (gdb-get-buffer 'gdb-partial-output-buffer))
714 (goto-char (point-min))
715 (search-forward ": ")
716 (looking-at "\\(.*?\\) =")
717 (let ((char "")
718 (gdb-temp-value (match-string 1)))
719 ;;move * to front of expression if necessary
720 (if (looking-at ".*\\*")
721 (progn
722 (setq char "*")
723 (setq gdb-temp-value (substring gdb-temp-value 1 nil))))
724 (with-current-buffer gdb-expression-buffer-name
725 (setq gdb-expression gdb-temp-value)
726 (if (not (string-match "::" gdb-expression))
727 (setq gdb-expression (concat char gdb-current-frame
728 "::" gdb-expression))
729 ;;else put * back on if necessary
730 (setq gdb-expression (concat char gdb-expression)))
731 (if (not header-line-format)
732 (setq header-line-format (concat "-- " gdb-expression " %-")))))
734 ;;-if scalar/string
735 (if (not (re-search-forward "##" nil t))
736 (progn
737 (with-current-buffer gdb-expression-buffer-name
738 (let ((buffer-read-only nil))
739 (delete-region (point-min) (point-max))
740 (insert-buffer-substring
741 (gdb-get-buffer 'gdb-partial-output-buffer)))))
742 ;; display expression name...
743 (goto-char (point-min))
744 (let ((start (progn (point)))
745 (end (progn (end-of-line) (point))))
746 (with-current-buffer gdb-expression-buffer-name
747 (let ((buffer-read-only nil))
748 (delete-region (point-min) (point-max))
749 (insert-buffer-substring (gdb-get-buffer
750 'gdb-partial-output-buffer)
751 start end)
752 (insert "\n"))))
753 (goto-char (point-min))
754 (re-search-forward "##" nil t)
755 (setq gdb-nesting-level 0)
756 (if (looking-at "array-section-begin")
757 (progn
758 (gdb-delete-line)
759 (setq gdb-point (point))
760 (gdb-array-format)))
761 (if (looking-at "field-begin \\(.\\)")
762 (progn
763 (setq gdb-annotation-arg (match-string 1))
764 (gdb-field-format-begin))))
765 (with-current-buffer gdb-expression-buffer-name
766 (if gdb-dive-display-number
767 (progn
768 (let ((buffer-read-only nil))
769 (goto-char (point-max))
770 (insert "\n")
771 (insert-text-button "[back]" 'type 'gdb-display-back)))))
772 (gdb-clear-partial-output)
773 (gdb-set-output-sink 'user)
774 (setq gdb-display-in-progress nil))
776 (define-button-type 'gdb-display-back
777 'help-echo "mouse-2, RET: go back to previous display buffer"
778 'action (lambda (button) (gdb-display-go-back)))
780 (defun gdb-display-go-back ()
781 ;; delete display so they don't accumulate and delete buffer
782 (let ((number gdb-display-number))
783 (gdb-enqueue-input
784 (list (concat "server delete display " number "\n") 'ignore))
785 (switch-to-buffer (concat "*display " gdb-dive-display-number "*"))
786 (kill-buffer (get-buffer (concat "*display " number "*")))))
788 ;; prefix annotations with ## and process whole output in one chunk
789 ;; in gdb-partial-output-buffer (to allow recursion).
791 ;; array-section flags are just removed again but after counting. They
792 ;; might also be useful for arrays of structures and structures with arrays.
793 (defun gdb-array-section-begin (args)
794 (if gdb-display-in-progress
795 (progn
796 (with-current-buffer (gdb-get-buffer 'gdb-partial-output-buffer)
797 (goto-char (point-max))
798 (insert (concat "\n##array-section-begin " args "\n"))))))
800 (defun gdb-array-section-end (ignored)
801 (if gdb-display-in-progress
802 (progn
803 (with-current-buffer (gdb-get-buffer 'gdb-partial-output-buffer)
804 (goto-char (point-max))
805 (insert "\n##array-section-end\n")))))
807 (defun gdb-field-begin (args)
808 (if gdb-display-in-progress
809 (progn
810 (with-current-buffer (gdb-get-buffer 'gdb-partial-output-buffer)
811 (goto-char (point-max))
812 (insert (concat "\n##field-begin " args "\n"))))))
814 (defun gdb-field-end (ignored)
815 (if gdb-display-in-progress
816 (progn
817 (with-current-buffer (gdb-get-buffer 'gdb-partial-output-buffer)
818 (goto-char (point-max))
819 (insert "\n##field-end\n")))))
821 (defun gdb-elt (ignored)
822 (if gdb-display-in-progress
823 (progn
824 (goto-char (point-max))
825 (insert "\n##elt\n"))))
827 (defun gdb-field-format-begin ()
828 ;; get rid of ##field-begin
829 (gdb-delete-line)
830 (gdb-insert-field)
831 (setq gdb-nesting-level (+ gdb-nesting-level 1))
832 (while (re-search-forward "##" nil t)
833 ;; keep making recursive calls...
834 (if (looking-at "field-begin \\(.\\)")
835 (progn
836 (setq gdb-annotation-arg (match-string 1))
837 (gdb-field-format-begin)))
838 ;; until field-end.
839 (if (looking-at "field-end") (gdb-field-format-end))))
841 (defun gdb-field-format-end ()
842 ;; get rid of ##field-end and `,' or `}'
843 (gdb-delete-line)
844 (gdb-delete-line)
845 (setq gdb-nesting-level (- gdb-nesting-level 1)))
847 (defvar gdb-dive-map
848 (let ((map (make-sparse-keymap)))
849 (define-key map [mouse-2] 'gdb-dive)
850 (define-key map [S-mouse-2] 'gdb-dive-new-frame)
851 map))
853 (defun gdb-dive (event)
854 "Dive into structure."
855 (interactive "e")
856 (setq gdb-dive t)
857 (gdb-dive-new-frame event))
859 (defun gdb-dive-new-frame (event)
860 "Dive into structure and display in a new frame."
861 (interactive "e")
862 (save-excursion
863 (mouse-set-point event)
864 (let ((point (point)) (gdb-full-expression gdb-expression)
865 (end (progn (end-of-line) (point)))
866 (gdb-part-expression "") (gdb-last-field nil) (gdb-display-char nil))
867 (beginning-of-line)
868 (if (looking-at "\*") (setq gdb-display-char "*"))
869 (re-search-forward "\\(\\S-+\\) = " end t)
870 (setq gdb-last-field (match-string-no-properties 1))
871 (goto-char (match-beginning 1))
872 (let ((last-column (current-column)))
873 (while (re-search-backward "\\s-\\(\\S-+\\) = {" nil t)
874 (goto-char (match-beginning 1))
875 (if (and (< (current-column) last-column)
876 (> (count-lines 1 (point)) 1))
877 (progn
878 (setq gdb-part-expression
879 (concat "." (match-string-no-properties 1)
880 gdb-part-expression))
881 (setq last-column (current-column))))))
882 ;; * not needed for components of a pointer to a structure in gdb
883 (if (string-equal "*" (substring gdb-full-expression 0 1))
884 (setq gdb-full-expression (substring gdb-full-expression 1 nil)))
885 (setq gdb-full-expression
886 (concat gdb-full-expression gdb-part-expression "." gdb-last-field))
887 (gdb-enqueue-input
888 (list (concat "server display" gdb-display-char
889 " " gdb-full-expression "\n")
890 'ignore)))))
892 (defun gdb-insert-field ()
893 (let ((start (progn (point)))
894 (end (progn (next-line) (point)))
895 (num 0))
896 (with-current-buffer gdb-expression-buffer-name
897 (let ((buffer-read-only nil))
898 (if (string-equal gdb-annotation-arg "\*") (insert "\*"))
899 (while (<= num gdb-nesting-level)
900 (insert "\t")
901 (setq num (+ num 1)))
902 (insert-buffer-substring (gdb-get-buffer
903 'gdb-partial-output-buffer)
904 start end)
905 (add-text-properties
906 (- (point) (- end start)) (- (point) 1)
907 `(mouse-face highlight
908 local-map ,gdb-dive-map
909 help-echo "mouse-2: dive, S-mouse-2: dive in a new frame"))))
910 (delete-region start end)))
912 (defvar gdb-values nil)
914 (defun gdb-array-format ()
915 (while (re-search-forward "##" nil t)
916 ;; keep making recursive calls...
917 (if (looking-at "array-section-begin")
918 (progn
919 ;;get rid of ##array-section-begin
920 (gdb-delete-line)
921 (setq gdb-nesting-level (+ gdb-nesting-level 1))
922 (gdb-array-format)))
923 ;;until *matching* array-section-end is found
924 (if (looking-at "array-section-end")
925 (if (eq gdb-nesting-level 0)
926 (progn
927 (let ((values (buffer-substring gdb-point (- (point) 2))))
928 (with-current-buffer gdb-expression-buffer-name
929 (setq gdb-values
930 (concat "{" (replace-regexp-in-string "\n" "" values)
931 "}"))
932 (gdb-array-format1))))
933 ;;else get rid of ##array-section-end etc
934 (gdb-delete-line)
935 (setq gdb-nesting-level (- gdb-nesting-level 1))
936 (gdb-array-format)))))
938 (defvar gdb-array-start nil)
939 (defvar gdb-array-stop nil)
941 (defvar gdb-array-slice-map
942 (let ((map (make-sparse-keymap)))
943 (define-key map "\r" 'gdb-array-slice)
944 (define-key map [mouse-2] 'gdb-mouse-array-slice)
945 map))
947 (defun gdb-mouse-array-slice (event)
948 "Select an array slice to display."
949 (interactive "e")
950 (mouse-set-point event)
951 (gdb-array-slice))
953 (defun gdb-array-slice ()
954 (interactive)
955 (save-excursion
956 (let ((n -1) (stop 0) (start 0) (point (point)))
957 (beginning-of-line)
958 (while (search-forward "[" point t)
959 (setq n (+ n 1)))
960 (setq start (string-to-int (read-string "Start index: ")))
961 (aset gdb-array-start n start)
962 (setq stop (string-to-int (read-string "Stop index: ")))
963 (aset gdb-array-stop n stop)))
964 (gdb-array-format1))
966 (defvar gdb-display-string nil)
967 (defvar gdb-array-size nil)
969 (defun gdb-array-format1 ()
970 (setq gdb-display-string "")
971 (let ((buffer-read-only nil))
972 (delete-region (point-min) (point-max))
973 (let ((gdb-value-list (split-string gdb-values ", ")))
974 (string-match "\\({+\\)" (car gdb-value-list))
975 (let* ((depth (- (match-end 1) (match-beginning 1)))
976 (indices (make-vector depth '0))
977 (index 0) (num 0) (array-start "")
978 (array-stop "") (array-slice "") (array-range nil)
979 (flag t) (indices-string ""))
980 (dolist (gdb-value gdb-value-list)
981 (string-match "{*\\([^}]*\\)\\(}*\\)" gdb-value)
982 (setq num 0)
983 (while (< num depth)
984 (setq indices-string
985 (concat indices-string
986 "[" (int-to-string (aref indices num)) "]"))
987 (if (not (= (aref gdb-array-start num) -1))
988 (if (or (< (aref indices num) (aref gdb-array-start num))
989 (> (aref indices num) (aref gdb-array-stop num)))
990 (setq flag nil))
991 (aset gdb-array-size num (aref indices num)))
992 (setq num (+ num 1)))
993 (if flag
994 (let ((gdb-display-value (match-string 1 gdb-value)))
995 (setq gdb-display-string (concat gdb-display-string " "
996 gdb-display-value))
997 (insert
998 (concat indices-string "\t" gdb-display-value "\n"))))
999 (setq indices-string "")
1000 (setq flag t)
1001 ;; 0<= index < depth, start at right : (- depth 1)
1002 (setq index (- (- depth 1)
1003 (- (match-end 2) (match-beginning 2))))
1004 ;;don't set for very last brackets
1005 (when (>= index 0)
1006 (aset indices index (+ 1 (aref indices index)))
1007 (setq num (+ 1 index))
1008 (while (< num depth)
1009 (aset indices num 0)
1010 (setq num (+ num 1)))))
1011 (setq num 0)
1012 (while (< num depth)
1013 (if (= (aref gdb-array-start num) -1)
1014 (progn
1015 (aset gdb-array-start num 0)
1016 (aset gdb-array-stop num (aref indices num))))
1017 (setq array-start (int-to-string (aref gdb-array-start num)))
1018 (setq array-stop (int-to-string (aref gdb-array-stop num)))
1019 (setq array-range (concat "[" array-start
1020 ":" array-stop "]"))
1021 (add-text-properties
1022 1 (+ (length array-start) (length array-stop) 2)
1023 `(mouse-face highlight
1024 local-map ,gdb-array-slice-map
1025 help-echo "mouse-2, RET: select slice for this index") array-range)
1026 (goto-char (point-min))
1027 (setq array-slice (concat array-slice array-range))
1028 (setq num (+ num 1)))
1029 (goto-char (point-min))
1030 (insert "Array Size : ")
1031 (setq num 0)
1032 (while (< num depth)
1033 (insert
1034 (concat "["
1035 (int-to-string (+ (aref gdb-array-size num) 1)) "]"))
1036 (setq num (+ num 1)))
1037 (insert
1038 (concat "\n Slice : " array-slice "\n\nIndex\tValues\n\n"))))))
1040 (defun gud-gdba-marker-filter (string)
1041 "A gud marker filter for gdb. Handle a burst of output from GDB."
1042 (let (
1043 ;; Recall the left over burst from last time
1044 (burst (concat (gdb-get-burst) string))
1045 ;; Start accumulating output for the GUD buffer
1046 (output ""))
1048 ;; Process all the complete markers in this chunk.
1049 (while (string-match "\n\032\032\\(.*\\)\n" burst)
1050 (let ((annotation (match-string 1 burst)))
1052 ;; Stuff prior to the match is just ordinary output.
1053 ;; It is either concatenated to OUTPUT or directed
1054 ;; elsewhere.
1055 (setq output
1056 (gdb-concat-output
1057 output
1058 (substring burst 0 (match-beginning 0))))
1060 ;; Take that stuff off the burst.
1061 (setq burst (substring burst (match-end 0)))
1063 ;; Parse the tag from the annotation, and maybe its arguments.
1064 (string-match "\\(\\S-*\\) ?\\(.*\\)" annotation)
1065 (let* ((annotation-type (match-string 1 annotation))
1066 (annotation-arguments (match-string 2 annotation))
1067 (annotation-rule (assoc annotation-type
1068 gdb-annotation-rules)))
1069 ;; Call the handler for this annotation.
1070 (if annotation-rule
1071 (funcall (car (cdr annotation-rule))
1072 annotation-arguments)
1073 ;; Else the annotation is not recognized. Ignore it silently,
1074 ;; so that GDB can add new annotations without causing
1075 ;; us to blow up.
1076 ))))
1078 ;; Does the remaining text end in a partial line?
1079 ;; If it does, then keep part of the burst until we get more.
1080 (if (string-match "\n\\'\\|\n\032\\'\\|\n\032\032.*\\'"
1081 burst)
1082 (progn
1083 ;; Everything before the potential marker start can be output.
1084 (setq output
1085 (gdb-concat-output output
1086 (substring burst 0 (match-beginning 0))))
1088 ;; Everything after, we save, to combine with later input.
1089 (setq burst (substring burst (match-beginning 0))))
1091 ;; In case we know the burst contains no partial annotations:
1092 (progn
1093 (setq output (gdb-concat-output output burst))
1094 (setq burst "")))
1096 ;; Save the remaining burst for the next call to this function.
1097 (gdb-set-burst burst)
1098 output))
1100 (defun gdb-concat-output (so-far new)
1101 (let ((sink (gdb-get-output-sink )))
1102 (cond
1103 ((eq sink 'user) (concat so-far new))
1104 ((or (eq sink 'pre-emacs) (eq sink 'post-emacs)) so-far)
1105 ((eq sink 'emacs)
1106 (gdb-append-to-partial-output new)
1107 so-far)
1108 ((eq sink 'inferior)
1109 (gdb-append-to-inferior-io new)
1110 so-far)
1111 (t (error "Bogon output sink %S" sink)))))
1113 (defun gdb-append-to-partial-output (string)
1114 (with-current-buffer (gdb-get-create-buffer 'gdb-partial-output-buffer)
1115 (goto-char (point-max))
1116 (insert string)))
1118 (defun gdb-clear-partial-output ()
1119 (with-current-buffer (gdb-get-create-buffer 'gdb-partial-output-buffer)
1120 (delete-region (point-min) (point-max))))
1122 (defun gdb-append-to-inferior-io (string)
1123 (with-current-buffer (gdb-get-create-buffer 'gdb-inferior-io)
1124 (goto-char (point-max))
1125 (insert-before-markers string))
1126 (if (not (string-equal string ""))
1127 (gdb-display-buffer (gdb-get-create-buffer 'gdb-inferior-io))))
1129 (defun gdb-clear-inferior-io ()
1130 (with-current-buffer (gdb-get-create-buffer 'gdb-inferior-io)
1131 (delete-region (point-min) (point-max))))
1134 ;; One trick is to have a command who's output is always available in a buffer
1135 ;; of it's own, and is always up to date. We build several buffers of this
1136 ;; type.
1138 ;; There are two aspects to this: gdb has to tell us when the output for that
1139 ;; command might have changed, and we have to be able to run the command
1140 ;; behind the user's back.
1142 ;; The output phasing associated with the variable gdb-output-sink
1143 ;; help us to run commands behind the user's back.
1145 ;; Below is the code for specificly managing buffers of output from one
1146 ;; command.
1149 ;; The trigger function is suitable for use in the assoc GDB-ANNOTATION-RULES
1150 ;; It adds an input for the command we are tracking. It should be the
1151 ;; annotation rule binding of whatever gdb sends to tell us this command
1152 ;; might have changed it's output.
1154 ;; NAME is the function name. DEMAND-PREDICATE tests if output is really needed.
1155 ;; GDB-COMMAND is a string of such. OUTPUT-HANDLER is the function bound to the
1156 ;; input in the input queue (see comment about ``gdb communications'' above).
1158 (defmacro def-gdb-auto-update-trigger (name demand-predicate gdb-command
1159 output-handler)
1160 `(defun ,name (&optional ignored)
1161 (if (and (,demand-predicate)
1162 (not (member ',name
1163 (gdb-get-pending-triggers))))
1164 (progn
1165 (gdb-enqueue-input
1166 (list ,gdb-command ',output-handler))
1167 (gdb-set-pending-triggers
1168 (cons ',name
1169 (gdb-get-pending-triggers)))))))
1171 (defmacro def-gdb-auto-update-handler (name trigger buf-key custom-defun)
1172 `(defun ,name ()
1173 (gdb-set-pending-triggers
1174 (delq ',trigger
1175 (gdb-get-pending-triggers)))
1176 (let ((buf (gdb-get-buffer ',buf-key)))
1177 (and buf
1178 (with-current-buffer buf
1179 (let ((p (point))
1180 (buffer-read-only nil))
1181 (delete-region (point-min) (point-max))
1182 (insert-buffer-substring (gdb-get-create-buffer
1183 'gdb-partial-output-buffer))
1184 (goto-char p)))))
1185 ;; put customisation here
1186 (,custom-defun)))
1188 (defmacro def-gdb-auto-updated-buffer (buffer-key trigger-name gdb-command
1189 output-handler-name custom-defun)
1190 `(progn
1191 (def-gdb-auto-update-trigger ,trigger-name
1192 ;; The demand predicate:
1193 (lambda () (gdb-get-buffer ',buffer-key))
1194 ,gdb-command
1195 ,output-handler-name)
1196 (def-gdb-auto-update-handler ,output-handler-name
1197 ,trigger-name ,buffer-key ,custom-defun)))
1201 ;; Breakpoint buffer : This displays the output of `info breakpoints'.
1203 (gdb-set-buffer-rules 'gdb-breakpoints-buffer
1204 'gdb-breakpoints-buffer-name
1205 'gdb-breakpoints-mode)
1207 (def-gdb-auto-updated-buffer gdb-breakpoints-buffer
1208 ;; This defines the auto update rule for buffers of type
1209 ;; `gdb-breakpoints-buffer'.
1211 ;; It defines a function to serve as the annotation handler that
1212 ;; handles the `foo-invalidated' message. That function is called:
1213 gdb-invalidate-breakpoints
1215 ;; To update the buffer, this command is sent to gdb.
1216 "server info breakpoints\n"
1218 ;; This also defines a function to be the handler for the output
1219 ;; from the command above. That function will copy the output into
1220 ;; the appropriately typed buffer. That function will be called:
1221 gdb-info-breakpoints-handler
1222 ;; buffer specific functions
1223 gdb-info-breakpoints-custom)
1225 (defvar gdb-cdir nil "Compilation directory.")
1227 (defconst breakpoint-xpm-data "/* XPM */
1228 static char *magick[] = {
1229 /* columns rows colors chars-per-pixel */
1230 \"12 12 2 1\",
1231 \" c red\",
1232 \"+ c None\",
1233 /* pixels */
1234 \"++++++++++++\",
1235 \"+++ +++\",
1236 \"++ ++\",
1237 \"+ +\",
1238 \"+ +\",
1239 \"+ +\",
1240 \"+ +\",
1241 \"+ +\",
1242 \"+ +\",
1243 \"++ ++\",
1244 \"+++ +++\",
1245 \"++++++++++++\"
1247 "XPM data used for breakpoint icon.")
1249 (defconst breakpoint-enabled-pbm-data
1251 12 12\",
1252 0 0 0 0 0 0 0 0 0 0 0 0
1253 0 0 0 1 1 1 1 1 1 0 0 0
1254 0 0 1 1 1 1 1 1 1 1 0 0
1255 0 1 1 1 1 1 1 1 1 1 1 0
1256 0 1 1 1 1 1 1 1 1 1 1 0
1257 0 1 1 1 1 1 1 1 1 1 1 0
1258 0 1 1 1 1 1 1 1 1 1 1 0
1259 0 1 1 1 1 1 1 1 1 1 1 0
1260 0 1 1 1 1 1 1 1 1 1 1 0
1261 0 0 1 1 1 1 1 1 1 1 0 0
1262 0 0 0 1 1 1 1 1 1 0 0 0
1263 0 0 0 0 0 0 0 0 0 0 0 0"
1264 "PBM data used for enabled breakpoint icon.")
1266 (defconst breakpoint-disabled-pbm-data
1268 12 12\",
1269 0 0 0 0 0 0 0 0 0 0 0 0
1270 0 0 0 1 0 1 0 1 0 0 0 0
1271 0 0 1 0 1 0 1 0 1 0 0 0
1272 0 1 0 1 0 1 0 1 0 1 0 0
1273 0 0 1 0 1 0 1 0 1 0 1 0
1274 0 1 0 1 0 1 0 1 0 1 0 0
1275 0 0 1 0 1 0 1 0 1 0 1 0
1276 0 1 0 1 0 1 0 1 0 1 0 0
1277 0 0 1 0 1 0 1 0 1 0 1 0
1278 0 0 0 1 0 1 0 1 0 1 0 0
1279 0 0 0 0 1 0 1 0 1 0 0 0
1280 0 0 0 0 0 0 0 0 0 0 0 0"
1281 "PBM data used for disabled breakpoint icon.")
1283 (defvar breakpoint-enabled-icon
1284 (find-image `((:type xpm :data ,breakpoint-xpm-data)
1285 (:type pbm :data ,breakpoint-enabled-pbm-data)))
1286 "Icon for enabled breakpoint in display margin")
1288 (defvar breakpoint-disabled-icon
1289 (find-image `((:type xpm :data ,breakpoint-xpm-data :conversion disabled)
1290 (:type pbm :data ,breakpoint-disabled-pbm-data)))
1291 "Icon for disabled breakpoint in display margin")
1293 ;;-put breakpoint icons in relevant margins (even those set in the GUD buffer)
1294 (defun gdb-info-breakpoints-custom ()
1295 (let ((flag)(address))
1297 ;; remove all breakpoint-icons in source buffers but not assembler buffer
1298 (dolist (buffer (buffer-list))
1299 (with-current-buffer buffer
1300 (if (and (eq gud-minor-mode 'gdba)
1301 (not (string-match "^\*" (buffer-name))))
1302 (if (display-images-p)
1303 (remove-images (point-min) (point-max))
1304 (gdb-remove-strings (point-min) (point-max))))))
1305 (with-current-buffer (gdb-get-buffer 'gdb-breakpoints-buffer)
1306 (save-excursion
1307 (goto-char (point-min))
1308 (while (< (point) (- (point-max) 1))
1309 (forward-line 1)
1310 (if (looking-at "[^\t].*breakpoint")
1311 (progn
1312 (looking-at "[0-9]*\\s-*\\S-*\\s-*\\S-*\\s-*\\(.\\)")
1313 (setq flag (char-after (match-beginning 1)))
1314 (beginning-of-line)
1315 (if (re-search-forward "in\\s-+\\S-+\\s-+at\\s-+" nil t)
1316 (progn
1317 (looking-at "\\(\\S-*\\):\\([0-9]+\\)")
1318 (let ((line (match-string 2)) (buffer-read-only nil)
1319 (file (match-string 1)))
1320 (add-text-properties (point-at-bol) (point-at-eol)
1321 '(mouse-face highlight
1322 help-echo "mouse-2, RET: visit breakpoint"))
1323 (with-current-buffer
1324 (find-file-noselect
1325 (if (file-exists-p file) file
1326 (expand-file-name file gdb-cdir)))
1327 (save-current-buffer
1328 (set (make-local-variable 'gud-minor-mode) 'gdba)
1329 (set (make-local-variable 'tool-bar-map)
1330 gud-tool-bar-map)
1331 (setq left-margin-width 2)
1332 (if (get-buffer-window (current-buffer))
1333 (set-window-margins (get-buffer-window
1334 (current-buffer))
1335 left-margin-width
1336 right-margin-width)))
1337 ;; only want one breakpoint icon at each location
1338 (save-excursion
1339 (goto-line (string-to-number line))
1340 (let ((start (progn (beginning-of-line)
1341 (- (point) 1)))
1342 (end (progn (end-of-line) (+ (point) 1))))
1343 (if (display-images-p)
1344 (progn
1345 (remove-images start end)
1346 (if (eq ?y flag)
1347 (put-image breakpoint-enabled-icon
1348 (+ start 1)
1349 "breakpoint icon enabled"
1350 'left-margin)
1351 (put-image breakpoint-disabled-icon
1352 (+ start 1)
1353 "breakpoint icon disabled"
1354 'left-margin)))
1355 (gdb-remove-strings start end)
1356 (if (eq ?y flag)
1357 (gdb-put-string "B" (+ start 1))
1358 (gdb-put-string "b" (+ start 1))))))))))))
1359 (end-of-line)))))
1360 (if (gdb-get-buffer 'gdb-assembler-buffer) (gdb-assembler-custom)))
1362 (defun gdb-breakpoints-buffer-name ()
1363 (with-current-buffer gud-comint-buffer
1364 (concat "*breakpoints of " (gdb-get-target-string) "*")))
1366 (defun gdb-display-breakpoints-buffer ()
1367 (interactive)
1368 (gdb-display-buffer
1369 (gdb-get-create-buffer 'gdb-breakpoints-buffer)))
1371 (defun gdb-frame-breakpoints-buffer ()
1372 (interactive)
1373 (switch-to-buffer-other-frame
1374 (gdb-get-create-buffer 'gdb-breakpoints-buffer)))
1376 (defvar gdb-breakpoints-mode-map
1377 (let ((map (make-sparse-keymap))
1378 (menu (make-sparse-keymap "Breakpoints")))
1379 (define-key menu [toggle] '("Toggle" . gdb-toggle-breakpoint))
1380 (define-key menu [delete] '("Delete" . gdb-delete-breakpoint))
1381 (define-key menu [goto] '("Goto" . gdb-goto-breakpoint))
1383 (suppress-keymap map)
1384 (define-key map [menu-bar breakpoints] (cons "Breakpoints" menu))
1385 (define-key map " " 'gdb-toggle-breakpoint)
1386 (define-key map "d" 'gdb-delete-breakpoint)
1387 (define-key map "\r" 'gdb-goto-breakpoint)
1388 (define-key map [mouse-2] 'gdb-mouse-goto-breakpoint)
1389 map))
1391 (defun gdb-breakpoints-mode ()
1392 "Major mode for gdb breakpoints.
1394 \\{gdb-breakpoints-mode-map}"
1395 (setq major-mode 'gdb-breakpoints-mode)
1396 (setq mode-name "Breakpoints")
1397 (use-local-map gdb-breakpoints-mode-map)
1398 (setq buffer-read-only t)
1399 (gdb-invalidate-breakpoints))
1401 (defun gdb-toggle-breakpoint ()
1402 "Enable/disable the breakpoint at current line."
1403 (interactive)
1404 (save-excursion
1405 (beginning-of-line 1)
1406 (if (not (looking-at "\\([0-9]+\\).*point\\s-*\\S-*\\s-*\\(.\\)"))
1407 (error "Not recognized as break/watchpoint line")
1408 (gdb-enqueue-input
1409 (list
1410 (concat
1411 (if (eq ?y (char-after (match-beginning 2)))
1412 "server disable "
1413 "server enable ")
1414 (match-string 1) "\n")
1415 'ignore)))))
1417 (defun gdb-delete-breakpoint ()
1418 "Delete the breakpoint at current line."
1419 (interactive)
1420 (beginning-of-line 1)
1421 (if (not (looking-at "\\([0-9]+\\).*point\\s-*\\S-*\\s-*\\(.\\)"))
1422 (error "Not recognized as break/watchpoint line")
1423 (gdb-enqueue-input
1424 (list (concat "server delete " (match-string 1) "\n") 'ignore))))
1426 (defvar gdb-source-window nil)
1428 (defun gdb-goto-breakpoint ()
1429 "Display the file in the source buffer at the breakpoint specified on the
1430 current line."
1431 (interactive)
1432 (save-excursion
1433 (beginning-of-line 1)
1434 (re-search-forward "in\\s-+\\S-+\\s-+at\\s-+" nil t)
1435 (looking-at "\\(\\S-*\\):\\([0-9]+\\)"))
1436 (if (match-string 2)
1437 (let ((line (match-string 2))
1438 (file (match-string 1)))
1439 (save-selected-window
1440 (select-window gdb-source-window)
1441 (switch-to-buffer (find-file-noselect
1442 (if (file-exists-p file)
1443 file
1444 (expand-file-name file gdb-cdir))))
1445 (goto-line (string-to-number line))))))
1447 (defun gdb-mouse-goto-breakpoint (event)
1448 "Display the file in the source buffer at the selected breakpoint."
1449 (interactive "e")
1450 (mouse-set-point event)
1451 (gdb-goto-breakpoint))
1454 ;; Frames buffer. This displays a perpetually correct bactracktrace
1455 ;; (from the command `where').
1457 ;; Alas, if your stack is deep, it is costly.
1459 (gdb-set-buffer-rules 'gdb-stack-buffer
1460 'gdb-stack-buffer-name
1461 'gdb-frames-mode)
1463 (def-gdb-auto-updated-buffer gdb-stack-buffer
1464 gdb-invalidate-frames
1465 "server where\n"
1466 gdb-info-frames-handler
1467 gdb-info-frames-custom)
1469 (defun gdb-info-frames-custom ()
1470 (with-current-buffer (gdb-get-buffer 'gdb-stack-buffer)
1471 (save-excursion
1472 (let ((buffer-read-only nil))
1473 (goto-char (point-min))
1474 (while (< (point) (point-max))
1475 (add-text-properties (point-at-bol) (point-at-eol)
1476 '(mouse-face highlight
1477 help-echo "mouse-2, RET: Select frame"))
1478 (beginning-of-line)
1479 (if (or (looking-at "^#[0-9]*\\s-*\\S-* in \\(\\S-*\\)")
1480 (looking-at "^#[0-9]*\\s-*\\(\\S-*\\)"))
1481 (if (equal (match-string 1) gdb-current-frame)
1482 (put-text-property (point-at-bol) (point-at-eol)
1483 'face
1484 `(:background ,(face-attribute 'default :foreground)
1485 :foreground ,(face-attribute 'default :background)))))
1486 (forward-line 1))))))
1488 (defun gdb-stack-buffer-name ()
1489 (with-current-buffer gud-comint-buffer
1490 (concat "*stack frames of " (gdb-get-target-string) "*")))
1492 (defun gdb-display-stack-buffer ()
1493 (interactive)
1494 (gdb-display-buffer
1495 (gdb-get-create-buffer 'gdb-stack-buffer)))
1497 (defun gdb-frame-stack-buffer ()
1498 (interactive)
1499 (switch-to-buffer-other-frame
1500 (gdb-get-create-buffer 'gdb-stack-buffer)))
1502 (defvar gdb-frames-mode-map
1503 (let ((map (make-sparse-keymap)))
1504 (suppress-keymap map)
1505 (define-key map "\r" 'gdb-frames-select)
1506 (define-key map [mouse-2] 'gdb-frames-mouse-select)
1507 map))
1509 (defun gdb-frames-mode ()
1510 "Major mode for gdb frames.
1512 \\{gdb-frames-mode-map}"
1513 (setq major-mode 'gdb-frames-mode)
1514 (setq mode-name "Frames")
1515 (setq buffer-read-only t)
1516 (use-local-map gdb-frames-mode-map)
1517 (font-lock-mode -1)
1518 (gdb-invalidate-frames))
1520 (defun gdb-get-frame-number ()
1521 (save-excursion
1522 (let* ((pos (re-search-backward "^#\\([0-9]*\\)" nil t))
1523 (n (or (and pos (match-string-no-properties 1)) "0")))
1524 n)))
1526 (defun gdb-frames-select ()
1527 "Make the frame on the current line become the current frame and display the
1528 source in the source buffer."
1529 (interactive)
1530 (gdb-enqueue-input
1531 (list (concat "server frame " (gdb-get-frame-number) "\n") 'ignore))
1532 (gud-display-frame))
1534 (defun gdb-frames-mouse-select (event)
1535 "Make the selected frame become the current frame and display the source in
1536 the source buffer."
1537 (interactive "e")
1538 (mouse-set-point event)
1539 (gdb-frames-select))
1542 ;; Threads buffer. This displays a selectable thread list.
1544 (gdb-set-buffer-rules 'gdb-threads-buffer
1545 'gdb-threads-buffer-name
1546 'gdb-threads-mode)
1548 (def-gdb-auto-updated-buffer gdb-threads-buffer
1549 gdb-invalidate-threads
1550 "info threads\n"
1551 gdb-info-threads-handler
1552 gdb-info-threads-custom)
1554 (defun gdb-info-threads-custom ()
1555 (with-current-buffer (gdb-get-buffer 'gdb-threads-buffer)
1556 (let ((buffer-read-only nil))
1557 (goto-char (point-min))
1558 (while (< (point) (point-max))
1559 (add-text-properties (point-at-bol) (point-at-eol)
1560 '(mouse-face highlight
1561 help-echo "mouse-2, RET: select thread"))
1562 (forward-line 1)))))
1564 (defun gdb-threads-buffer-name ()
1565 (with-current-buffer gud-comint-buffer
1566 (concat "*threads of " (gdb-get-target-string) "*")))
1568 (defun gdb-display-threads-buffer ()
1569 (interactive)
1570 (gdb-display-buffer
1571 (gdb-get-create-buffer 'gdb-threads-buffer)))
1573 (defun gdb-frame-threads-buffer ()
1574 (interactive)
1575 (switch-to-buffer-other-frame
1576 (gdb-get-create-buffer 'gdb-threads-buffer)))
1578 (defvar gdb-threads-mode-map
1579 (let ((map (make-sparse-keymap)))
1580 (suppress-keymap map)
1581 (define-key map "\r" 'gdb-threads-select)
1582 (define-key map [mouse-2] 'gdb-threads-mouse-select)
1583 map))
1585 (defun gdb-threads-mode ()
1586 "Major mode for gdb frames.
1588 \\{gdb-frames-mode-map}"
1589 (setq major-mode 'gdb-threads-mode)
1590 (setq mode-name "Threads")
1591 (setq buffer-read-only t)
1592 (use-local-map gdb-threads-mode-map)
1593 (gdb-invalidate-threads))
1595 (defun gdb-get-thread-number ()
1596 (save-excursion
1597 (re-search-backward "^\\s-*\\([0-9]*\\)" nil t)
1598 (match-string-no-properties 1)))
1601 (defun gdb-threads-select ()
1602 "Make the thread on the current line become the current thread and display the
1603 source in the source buffer."
1604 (interactive)
1605 (gdb-enqueue-input
1606 (list (concat "thread " (gdb-get-thread-number) "\n") 'ignore))
1607 (gud-display-frame))
1609 (defun gdb-threads-mouse-select (event)
1610 "Make the selected frame become the current frame and display the source in
1611 the source buffer."
1612 (interactive "e")
1613 (mouse-set-point event)
1614 (gdb-threads-select))
1617 ;; Registers buffer.
1619 (gdb-set-buffer-rules 'gdb-registers-buffer
1620 'gdb-registers-buffer-name
1621 'gdb-registers-mode)
1623 (def-gdb-auto-updated-buffer gdb-registers-buffer
1624 gdb-invalidate-registers
1625 "server info registers\n"
1626 gdb-info-registers-handler
1627 gdb-info-registers-custom)
1629 (defun gdb-info-registers-custom ())
1631 (defvar gdb-registers-mode-map
1632 (let ((map (make-sparse-keymap)))
1633 (suppress-keymap map)
1634 map))
1636 (defun gdb-registers-mode ()
1637 "Major mode for gdb registers.
1639 \\{gdb-registers-mode-map}"
1640 (setq major-mode 'gdb-registers-mode)
1641 (setq mode-name "Registers")
1642 (setq buffer-read-only t)
1643 (use-local-map gdb-registers-mode-map)
1644 (gdb-invalidate-registers))
1646 (defun gdb-registers-buffer-name ()
1647 (with-current-buffer gud-comint-buffer
1648 (concat "*registers of " (gdb-get-target-string) "*")))
1650 (defun gdb-display-registers-buffer ()
1651 (interactive)
1652 (gdb-display-buffer
1653 (gdb-get-create-buffer 'gdb-registers-buffer)))
1655 (defun gdb-frame-registers-buffer ()
1656 (interactive)
1657 (switch-to-buffer-other-frame
1658 (gdb-get-create-buffer 'gdb-registers-buffer)))
1661 ;; Locals buffer.
1663 (gdb-set-buffer-rules 'gdb-locals-buffer
1664 'gdb-locals-buffer-name
1665 'gdb-locals-mode)
1667 (def-gdb-auto-updated-buffer gdb-locals-buffer
1668 gdb-invalidate-locals
1669 "server info locals\n"
1670 gdb-info-locals-handler
1671 gdb-info-locals-custom)
1673 ;; Abbreviate for arrays and structures.
1674 ;; These can be expanded using gud-display.
1675 (defun gdb-info-locals-handler nil
1676 (gdb-set-pending-triggers (delq 'gdb-invalidate-locals
1677 (gdb-get-pending-triggers)))
1678 (let ((buf (gdb-get-buffer 'gdb-partial-output-buffer)))
1679 (with-current-buffer buf
1680 (goto-char (point-min))
1681 (while (re-search-forward "^ .*\n" nil t)
1682 (replace-match "" nil nil))
1683 (goto-char (point-min))
1684 (while (re-search-forward "{[-0-9, {}\]*\n" nil t)
1685 (replace-match "(array);\n" nil nil))
1686 (goto-char (point-min))
1687 (while (re-search-forward "{.*=.*\n" nil t)
1688 (replace-match "(structure);\n" nil nil))))
1689 (let ((buf (gdb-get-buffer 'gdb-locals-buffer)))
1690 (and buf (with-current-buffer buf
1691 (let ((p (point))
1692 (buffer-read-only nil))
1693 (delete-region (point-min) (point-max))
1694 (insert-buffer-substring (gdb-get-create-buffer
1695 'gdb-partial-output-buffer))
1696 (goto-char p)))))
1697 (run-hooks 'gdb-info-locals-hook))
1699 (defun gdb-info-locals-custom ()
1700 nil)
1702 (defvar gdb-locals-mode-map
1703 (let ((map (make-sparse-keymap)))
1704 (suppress-keymap map)
1705 map))
1707 (defun gdb-locals-mode ()
1708 "Major mode for gdb locals.
1710 \\{gdb-locals-mode-map}"
1711 (setq major-mode 'gdb-locals-mode)
1712 (setq mode-name "Locals")
1713 (setq buffer-read-only t)
1714 (use-local-map gdb-locals-mode-map)
1715 (gdb-invalidate-locals))
1717 (defun gdb-locals-buffer-name ()
1718 (with-current-buffer gud-comint-buffer
1719 (concat "*locals of " (gdb-get-target-string) "*")))
1721 (defun gdb-display-locals-buffer ()
1722 (interactive)
1723 (gdb-display-buffer
1724 (gdb-get-create-buffer 'gdb-locals-buffer)))
1726 (defun gdb-frame-locals-buffer ()
1727 (interactive)
1728 (switch-to-buffer-other-frame
1729 (gdb-get-create-buffer 'gdb-locals-buffer)))
1732 ;; Display expression buffer.
1734 (gdb-set-buffer-rules 'gdb-display-buffer
1735 'gdb-display-buffer-name
1736 'gdb-display-mode)
1738 (def-gdb-auto-updated-buffer gdb-display-buffer
1739 ;; `gdb-display-buffer'.
1740 gdb-invalidate-display
1741 "server info display\n"
1742 gdb-info-display-handler
1743 gdb-info-display-custom)
1745 (defun gdb-info-display-custom ()
1746 (let ((display-list nil))
1747 (with-current-buffer (gdb-get-buffer 'gdb-display-buffer)
1748 (goto-char (point-min))
1749 (while (< (point) (- (point-max) 1))
1750 (forward-line 1)
1751 (if (looking-at "\\([0-9]+\\): \\([ny]\\)")
1752 (setq display-list
1753 (cons (string-to-int (match-string 1)) display-list)))
1754 (end-of-line)))
1755 (if (not (display-graphic-p))
1756 (progn
1757 (dolist (buffer (buffer-list))
1758 (if (string-match "\\*display \\([0-9]+\\)\\*" (buffer-name buffer))
1759 (progn
1760 (let ((number
1761 (match-string 1 (buffer-name buffer))))
1762 (if (not (memq (string-to-int number) display-list))
1763 (kill-buffer
1764 (get-buffer (concat "*display " number "*")))))))))
1765 (gdb-delete-frames display-list))))
1767 (defun gdb-delete-frames (display-list)
1768 (dolist (frame (frame-list))
1769 (let ((frame-name (frame-parameter frame 'name)))
1770 (if (string-match "\\*display \\([0-9]+\\)\\*" frame-name)
1771 (progn
1772 (let ((number (match-string 1 frame-name)))
1773 (if (not (memq (string-to-int number) display-list))
1774 (progn (kill-buffer
1775 (get-buffer (concat "*display " number "*")))
1776 (delete-frame frame)))))))))
1778 (defvar gdb-display-mode-map
1779 (let ((map (make-sparse-keymap))
1780 (menu (make-sparse-keymap "Display")))
1781 (define-key menu [toggle] '("Toggle" . gdb-toggle-display))
1782 (define-key menu [delete] '("Delete" . gdb-delete-display))
1784 (suppress-keymap map)
1785 (define-key map [menu-bar display] (cons "Display" menu))
1786 (define-key map " " 'gdb-toggle-display)
1787 (define-key map "d" 'gdb-delete-display)
1788 map))
1790 (defun gdb-display-mode ()
1791 "Major mode for gdb display.
1793 \\{gdb-display-mode-map}"
1794 (setq major-mode 'gdb-display-mode)
1795 (setq mode-name "Display")
1796 (setq buffer-read-only t)
1797 (use-local-map gdb-display-mode-map)
1798 (gdb-invalidate-display))
1800 (defun gdb-display-buffer-name ()
1801 (with-current-buffer gud-comint-buffer
1802 (concat "*Displayed expressions of " (gdb-get-target-string) "*")))
1804 (defun gdb-display-display-buffer ()
1805 (interactive)
1806 (gdb-display-buffer
1807 (gdb-get-create-buffer 'gdb-display-buffer)))
1809 (defun gdb-frame-display-buffer ()
1810 (interactive)
1811 (switch-to-buffer-other-frame
1812 (gdb-get-create-buffer 'gdb-display-buffer)))
1814 (defun gdb-toggle-display ()
1815 "Enable/disable the displayed expression at current line."
1816 (interactive)
1817 (save-excursion
1818 (beginning-of-line 1)
1819 (if (not (looking-at "\\([0-9]+\\): \\([ny]\\)"))
1820 (error "No expression on this line")
1821 (gdb-enqueue-input
1822 (list
1823 (concat
1824 (if (eq ?y (char-after (match-beginning 2)))
1825 "server disable display "
1826 "server enable display ")
1827 (match-string 1) "\n")
1828 'ignore)))))
1830 (defun gdb-delete-display ()
1831 "Delete the displayed expression at current line."
1832 (interactive)
1833 (with-current-buffer (gdb-get-buffer 'gdb-display-buffer)
1834 (beginning-of-line 1)
1835 (if (not (looking-at "\\([0-9]+\\): \\([ny]\\)"))
1836 (error "No expression on this line")
1837 (let ((number (match-string 1)))
1838 (gdb-enqueue-input
1839 (list (concat "server delete display " number "\n") 'ignore))))))
1841 (defvar gdb-expressions-mode-map
1842 (let ((map (make-sparse-keymap)))
1843 (suppress-keymap map)
1844 (define-key map "v" 'gdb-array-visualise)
1845 (define-key map "q" 'gdb-delete-expression)
1846 (define-key map [mouse-3] 'gdb-expressions-popup-menu)
1847 map))
1849 (defvar gdb-expressions-mode-menu
1850 '("GDB Expressions Commands"
1851 "----"
1852 ["Visualise" gdb-array-visualise t]
1853 ["Delete" gdb-delete-expression t])
1854 "Menu for `gdb-expressions-mode'.")
1856 (defun gdb-expressions-popup-menu (event)
1857 "Explicit Popup menu as this buffer doesn't have a menubar."
1858 (interactive "@e")
1859 (mouse-set-point event)
1860 (popup-menu gdb-expressions-mode-menu))
1862 (defun gdb-expressions-mode ()
1863 "Major mode for display expressions.
1865 \\{gdb-expressions-mode-map}"
1866 (setq major-mode 'gdb-expressions-mode)
1867 (setq mode-name "Expressions")
1868 (use-local-map gdb-expressions-mode-map)
1869 (make-local-variable 'gdb-display-number)
1870 (make-local-variable 'gdb-values)
1871 (make-local-variable 'gdb-expression)
1872 (set (make-local-variable 'gdb-display-string) nil)
1873 (set (make-local-variable 'gdb-dive-display-number) nil)
1874 (set (make-local-variable 'gud-minor-mode) 'gdba)
1875 (set (make-local-variable 'gdb-array-start) (make-vector 16 '-1))
1876 (set (make-local-variable 'gdb-array-stop) (make-vector 16 '-1))
1877 (set (make-local-variable 'gdb-array-size) (make-vector 16 '-1))
1878 (setq buffer-read-only t))
1881 ;;;; Window management
1883 ;;; The way we abuse the dedicated-p flag is pretty gross, but seems
1884 ;;; to do the right thing. Seeing as there is no way for Lisp code to
1885 ;;; get at the use_time field of a window, I'm not sure there exists a
1886 ;;; more elegant solution without writing C code.
1888 (defun gdb-display-buffer (buf &optional size)
1889 (let ((must-split nil)
1890 (answer nil))
1891 (unwind-protect
1892 (progn
1893 (walk-windows
1894 #'(lambda (win)
1895 (if (or (eq gud-comint-buffer (window-buffer win))
1896 (eq gdb-source-window win))
1897 (set-window-dedicated-p win t))))
1898 (setq answer (get-buffer-window buf))
1899 (if (not answer)
1900 (let ((window (get-lru-window)))
1901 (if window
1902 (progn
1903 (set-window-buffer window buf)
1904 (setq answer window))
1905 (setq must-split t)))))
1906 (walk-windows
1907 #'(lambda (win)
1908 (if (or (eq gud-comint-buffer (window-buffer win))
1909 (eq gdb-source-window win))
1910 (set-window-dedicated-p win nil)))))
1911 (if must-split
1912 (let* ((largest (get-largest-window))
1913 (cur-size (window-height largest))
1914 (new-size (and size (< size cur-size) (- cur-size size))))
1915 (setq answer (split-window largest new-size))
1916 (set-window-buffer answer buf)))
1917 answer))
1919 (defun gdb-display-source-buffer (buffer)
1920 (if (eq gdb-selected-view 'source)
1921 (progn
1922 (if (window-live-p gdb-source-window)
1923 (set-window-buffer gdb-source-window buffer)
1924 (gdb-display-buffer buffer)
1925 (setq gdb-source-window (get-buffer-window buffer)))
1926 gdb-source-window)
1927 (if (window-live-p gdb-source-window)
1928 (set-window-buffer gdb-source-window
1929 (gdb-get-buffer 'gdb-assembler-buffer))
1930 (let ((buf (gdb-get-buffer 'gdb-assembler-buffer)))
1931 (gdb-display-buffer buf)
1932 (setq gdb-source-window (get-buffer-window buf))))
1933 nil))
1936 ;;; Shared keymap initialization:
1938 (let ((menu (make-sparse-keymap "GDB-Frames")))
1939 (define-key gud-menu-map [frames]
1940 `(menu-item "GDB-Frames" ,menu :visible (eq gud-minor-mode 'gdba)))
1941 (define-key menu [gdb] '("Gdb" . gdb-frame-gdb-buffer))
1942 (define-key menu [locals] '("Locals" . gdb-frame-locals-buffer))
1943 (define-key menu [registers] '("Registers" . gdb-frame-registers-buffer))
1944 (define-key menu [frames] '("Stack" . gdb-frame-stack-buffer))
1945 (define-key menu [breakpoints] '("Breakpoints" . gdb-frame-breakpoints-buffer))
1946 (define-key menu [display] '("Display" . gdb-frame-display-buffer))
1947 (define-key menu [threads] '("Threads" . gdb-frame-threads-buffer))
1948 ; (define-key menu [assembler] '("Assembler" . gdb-frame-assembler-buffer))
1951 (let ((menu (make-sparse-keymap "GDB-Windows")))
1952 (define-key gud-menu-map [displays]
1953 `(menu-item "GDB-Windows" ,menu :visible (eq gud-minor-mode 'gdba)))
1954 (define-key menu [gdb] '("Gdb" . gdb-display-gdb-buffer))
1955 (define-key menu [locals] '("Locals" . gdb-display-locals-buffer))
1956 (define-key menu [registers] '("Registers" . gdb-display-registers-buffer))
1957 (define-key menu [frames] '("Stack" . gdb-display-stack-buffer))
1958 (define-key menu [breakpoints] '("Breakpoints" . gdb-display-breakpoints-buffer))
1959 (define-key menu [display] '("Display" . gdb-display-display-buffer))
1960 (define-key menu [threads] '("Threads" . gdb-display-threads-buffer))
1961 ; (define-key menu [assembler] '("Assembler" . gdb-display-assembler-buffer))
1964 (let ((menu (make-sparse-keymap "View")))
1965 (define-key gud-menu-map [view]
1966 `(menu-item "View" ,menu :visible (eq gud-minor-mode 'gdba)))
1967 ; (define-key menu [both] '(menu-item "Both" gdb-view-both
1968 ; :help "Display both source and assembler"
1969 ; :button (:radio . (eq gdb-selected-view 'both))))
1970 (define-key menu [assembler] '(menu-item "Assembler" gdb-view-assembler
1971 :help "Display assembler only"
1972 :button (:radio . (eq gdb-selected-view 'assembler))))
1973 (define-key menu [source] '(menu-item "Source" gdb-view-source-function
1974 :help "Display source only"
1975 :button (:radio . (eq gdb-selected-view 'source)))))
1977 (let ((menu (make-sparse-keymap "GDB-UI")))
1978 (define-key gud-menu-map [ui]
1979 `(menu-item "GDB-UI" ,menu :visible (eq gud-minor-mode 'gdba)))
1980 (define-key menu [gdb-restore-windows]
1981 '("Restore window layout" . gdb-restore-windows))
1982 (define-key menu [gdb-many-windows]
1983 (menu-bar-make-toggle gdb-many-windows gdb-many-windows
1984 "Display other windows" "Many Windows %s"
1985 "Display locals, stack and breakpoint information")))
1987 (defun gdb-frame-gdb-buffer ()
1988 (interactive)
1989 (switch-to-buffer-other-frame
1990 (gdb-get-create-buffer 'gdba)))
1992 (defun gdb-display-gdb-buffer ()
1993 (interactive)
1994 (gdb-display-buffer
1995 (gdb-get-create-buffer 'gdba)))
1997 (defvar gdb-main-file nil "Source file from which program execution begins.")
1999 (defun gdb-view-source-function ()
2000 (interactive)
2001 (if gdb-view-source
2002 (if gud-last-last-frame
2003 (set-window-buffer gdb-source-window
2004 (gud-find-file (car gud-last-last-frame)))
2005 (set-window-buffer gdb-source-window (gud-find-file gdb-main-file))))
2006 (setq gdb-selected-view 'source))
2008 (defun gdb-view-assembler()
2009 (interactive)
2010 (set-window-buffer gdb-source-window
2011 (gdb-get-create-buffer 'gdb-assembler-buffer))
2012 (setq gdb-selected-view 'assembler))
2014 ;(defun gdb-view-both()
2015 ;(interactive)
2016 ;(setq gdb-selected-view 'both))
2018 ;; layout for all the windows
2019 (defun gdb-setup-windows ()
2020 (gdb-display-locals-buffer)
2021 (gdb-display-stack-buffer)
2022 (delete-other-windows)
2023 (gdb-display-breakpoints-buffer)
2024 (gdb-display-display-buffer)
2025 (delete-other-windows)
2026 (switch-to-buffer gud-comint-buffer)
2027 (split-window nil ( / ( * (window-height) 3) 4))
2028 (split-window nil ( / (window-height) 3))
2029 (split-window-horizontally)
2030 (other-window 1)
2031 (switch-to-buffer (gdb-locals-buffer-name))
2032 (other-window 1)
2033 (if (and gdb-view-source
2034 (eq gdb-selected-view 'source))
2035 (switch-to-buffer
2036 (if gud-last-last-frame
2037 (gud-find-file (car gud-last-last-frame))
2038 (gud-find-file gdb-main-file)))
2039 (switch-to-buffer (gdb-get-create-buffer 'gdb-assembler-buffer)))
2040 (setq gdb-source-window (get-buffer-window (current-buffer)))
2041 (split-window-horizontally)
2042 (other-window 1)
2043 (switch-to-buffer (gdb-inferior-io-name))
2044 (other-window 1)
2045 (switch-to-buffer (gdb-stack-buffer-name))
2046 (split-window-horizontally)
2047 (other-window 1)
2048 (switch-to-buffer (gdb-breakpoints-buffer-name))
2049 (other-window 1))
2051 (defcustom gdb-many-windows nil
2052 "Nil means that gdb starts with just two windows : the GUD and
2053 the source buffer."
2054 :type 'boolean
2055 :group 'gud)
2057 (defun gdb-many-windows (arg)
2058 "Toggle the number of windows in the basic arrangement."
2059 (interactive "P")
2060 (setq gdb-many-windows
2061 (if (null arg)
2062 (not gdb-many-windows)
2063 (> (prefix-numeric-value arg) 0)))
2064 (gdb-restore-windows))
2066 (defun gdb-restore-windows ()
2067 "Restore the basic arrangement of windows used by gdba.
2068 This arrangement depends on the value of `gdb-many-windows'."
2069 (interactive)
2070 (if gdb-many-windows
2071 (progn
2072 (switch-to-buffer gud-comint-buffer)
2073 (delete-other-windows)
2074 (gdb-setup-windows))
2075 (switch-to-buffer gud-comint-buffer)
2076 (delete-other-windows)
2077 (split-window)
2078 (other-window 1)
2079 (if (and gdb-view-source
2080 (eq gdb-selected-view 'source))
2081 (switch-to-buffer
2082 (if gud-last-last-frame
2083 (gud-find-file (car gud-last-last-frame))
2084 (gud-find-file gdb-main-file)))
2085 (switch-to-buffer (gdb-get-create-buffer 'gdb-assembler-buffer)))
2086 (setq gdb-source-window (get-buffer-window (current-buffer)))
2087 (other-window 1)))
2089 (defun gdb-reset ()
2090 "Exit a debugging session cleanly by killing the gdb buffers and resetting
2091 the source buffers."
2092 (gdb-delete-frames '())
2093 (dolist (buffer (buffer-list))
2094 (if (not (eq buffer gud-comint-buffer))
2095 (with-current-buffer buffer
2096 (if (eq gud-minor-mode 'gdba)
2097 (if (string-match "^\*.+*$" (buffer-name))
2098 (kill-buffer nil)
2099 (if (display-images-p)
2100 (remove-images (point-min) (point-max))
2101 (gdb-remove-strings (point-min) (point-max)))
2102 (setq left-margin-width 0)
2103 (setq gud-minor-mode nil)
2104 (kill-local-variable 'tool-bar-map)
2105 (setq gud-running nil)
2106 (if (get-buffer-window (current-buffer))
2107 (set-window-margins (get-buffer-window
2108 (current-buffer))
2109 left-margin-width
2110 right-margin-width))))))))
2112 (defun gdb-source-info ()
2113 "Find the source file where the program starts and displays it with related
2114 buffers."
2115 (goto-char (point-min))
2116 (if (search-forward "directory is " nil t)
2117 (progn
2118 (if (looking-at "\\S-*:\\(\\S-*\\)")
2119 (setq gdb-cdir (match-string 1))
2120 (looking-at "\\S-*")
2121 (setq gdb-cdir (match-string 0)))
2122 (search-forward "Located in ")
2123 (looking-at "\\S-*")
2124 (setq gdb-main-file (match-string 0)))
2125 (setq gdb-view-source nil))
2126 (delete-other-windows)
2127 (switch-to-buffer gud-comint-buffer)
2128 (if gdb-many-windows
2129 (gdb-setup-windows)
2130 (gdb-display-breakpoints-buffer)
2131 (gdb-display-display-buffer)
2132 (delete-other-windows)
2133 (split-window)
2134 (other-window 1)
2135 (if gdb-view-source
2136 (switch-to-buffer
2137 (if gud-last-last-frame
2138 (gud-find-file (car gud-last-last-frame))
2139 (gud-find-file gdb-main-file)))
2140 (switch-to-buffer (gdb-get-create-buffer 'gdb-assembler-buffer)))
2141 (setq gdb-source-window (get-buffer-window (current-buffer)))
2142 (other-window 1)))
2144 ;;from put-image
2145 (defun gdb-put-string (putstring pos)
2146 "Put string PUTSTRING in front of POS in the current buffer.
2147 PUTSTRING is displayed by putting an overlay into the current buffer with a
2148 `before-string' STRING that has a `display' property whose value is
2149 PUTSTRING."
2150 (let ((gdb-string "x")
2151 (buffer (current-buffer)))
2152 (let ((overlay (make-overlay pos pos buffer))
2153 (prop (list (list 'margin 'left-margin) putstring)))
2154 (put-text-property 0 (length gdb-string) 'display prop gdb-string)
2155 (overlay-put overlay 'put-break t)
2156 (overlay-put overlay 'before-string gdb-string))))
2158 ;;from remove-images
2159 (defun gdb-remove-strings (start end &optional buffer)
2160 "Remove strings between START and END in BUFFER.
2161 Remove only strings that were put in BUFFER with calls to `put-string'.
2162 BUFFER nil or omitted means use the current buffer."
2163 (unless buffer
2164 (setq buffer (current-buffer)))
2165 (let ((overlays (overlays-in start end)))
2166 (while overlays
2167 (let ((overlay (car overlays)))
2168 (when (overlay-get overlay 'put-break)
2169 (delete-overlay overlay)))
2170 (setq overlays (cdr overlays)))))
2172 (defun gdb-put-arrow (putstring pos)
2173 "Put arrow string PUTSTRING in the left margin in front of POS
2174 in the current buffer. PUTSTRING is displayed by putting an
2175 overlay into the current buffer with a `before-string'
2176 \"gdb-arrow\" that has a `display' property whose value is
2177 PUTSTRING. POS may be an integer or marker."
2178 (let ((gdb-string "gdb-arrow")
2179 (buffer (current-buffer)))
2180 (let ((overlay (make-overlay pos pos buffer))
2181 (prop (list (list 'margin 'left-margin) putstring)))
2182 (put-text-property 0 (length gdb-string) 'display prop gdb-string)
2183 (overlay-put overlay 'put-arrow t)
2184 (overlay-put overlay 'before-string gdb-string))))
2186 (defun gdb-remove-arrow (&optional buffer)
2187 "Remove arrow in BUFFER.
2188 Remove only images that were put in BUFFER with calls to `put-arrow'.
2189 BUFFER nil or omitted means use the current buffer."
2190 (unless buffer
2191 (setq buffer (current-buffer)))
2192 (let ((overlays (overlays-in (point-min) (point-max))))
2193 (while overlays
2194 (let ((overlay (car overlays)))
2195 (when (overlay-get overlay 'put-arrow)
2196 (delete-overlay overlay)))
2197 (setq overlays (cdr overlays)))))
2199 (defun gdb-array-visualise ()
2200 "Visualise arrays and slices using graph program from plotutils."
2201 (interactive)
2202 (when (and (display-graphic-p) gdb-display-string)
2203 (let ((n 0) m)
2204 (catch 'multi-dimensional
2205 (while (eq (aref gdb-array-start n) (aref gdb-array-stop n))
2206 (setq n (+ n 1)))
2207 (setq m (+ n 1))
2208 (while (< m (length gdb-array-start))
2209 (if (not (eq (aref gdb-array-start m) (aref gdb-array-stop m)))
2210 (progn
2211 (x-popup-dialog
2212 t `(,(concat "Only one dimensional data can be visualised.\n"
2213 "Use an array slice to reduce the number of\n"
2214 "dimensions") ("OK" t)))
2215 (throw 'multi-dimensional nil))
2216 (setq m (+ m 1))))
2217 (shell-command (concat "echo" gdb-display-string " | graph -a 1 "
2218 (int-to-string (aref gdb-array-start n))
2219 " -x "
2220 (int-to-string (aref gdb-array-start n))
2222 (int-to-string (aref gdb-array-stop n))
2223 " 1 -T X"))))))
2225 (defun gdb-delete-expression ()
2226 "Delete displayed expression and its frame."
2227 (interactive)
2228 (gdb-enqueue-input
2229 (list (concat "server delete display " gdb-display-number "\n")
2230 'ignore)))
2233 ;; Assembler buffer.
2235 (gdb-set-buffer-rules 'gdb-assembler-buffer
2236 'gdb-assembler-buffer-name
2237 'gdb-assembler-mode)
2239 (def-gdb-auto-updated-buffer gdb-assembler-buffer
2240 gdb-invalidate-assembler
2241 (concat "server disassemble " gdb-current-address "\n")
2242 gdb-assembler-handler
2243 gdb-assembler-custom)
2245 (defun gdb-assembler-custom ()
2246 (let ((buffer (gdb-get-buffer 'gdb-assembler-buffer))
2247 (gdb-arrow-position 1) (address) (flag))
2248 (with-current-buffer buffer
2249 (if (not (equal gdb-current-address "main"))
2250 (progn
2251 (gdb-remove-arrow)
2252 (goto-char (point-min))
2253 (if (re-search-forward gdb-current-address nil t)
2254 (progn
2255 (setq gdb-arrow-position (point))
2256 (gdb-put-arrow "=>" (point))))))
2257 ;; remove all breakpoint-icons in assembler buffer before updating.
2258 (if (display-images-p)
2259 (remove-images (point-min) (point-max))
2260 (gdb-remove-strings (point-min) (point-max))))
2261 (with-current-buffer (gdb-get-buffer 'gdb-breakpoints-buffer)
2262 (goto-char (point-min))
2263 (while (< (point) (- (point-max) 1))
2264 (forward-line 1)
2265 (if (looking-at "[^\t].*breakpoint")
2266 (progn
2267 (looking-at
2268 "[0-9]*\\s-*\\S-*\\s-*\\S-*\\s-*\\(.\\)\\s-*0x\\(\\S-*\\)")
2269 (setq flag (char-after (match-beginning 1)))
2270 (setq address (match-string 2))
2271 ;; remove leading 0s from output of info break.
2272 (if (string-match "^0+\\(.*\\)" address)
2273 (setq address (match-string 1 address)))
2274 (with-current-buffer buffer
2275 (goto-char (point-min))
2276 (if (re-search-forward address nil t)
2277 (let ((start (progn (beginning-of-line) (- (point) 1)))
2278 (end (progn (end-of-line) (+ (point) 1))))
2279 (if (display-images-p)
2280 (progn
2281 (remove-images start end)
2282 (if (eq ?y flag)
2283 (put-image breakpoint-enabled-icon
2284 (+ start 1)
2285 "breakpoint icon enabled"
2286 'left-margin)
2287 (put-image breakpoint-disabled-icon
2288 (+ start 1)
2289 "breakpoint icon disabled"
2290 'left-margin)))
2291 (gdb-remove-strings start end)
2292 (if (eq ?y flag)
2293 (gdb-put-string "B" (+ start 1))
2294 (gdb-put-string "b" (+ start 1)))))))))))
2295 (if (not (equal gdb-current-address "main"))
2296 (set-window-point (get-buffer-window buffer) gdb-arrow-position))))
2298 (defvar gdb-assembler-mode-map
2299 (let ((map (make-sparse-keymap)))
2300 (suppress-keymap map)
2301 map))
2303 (defun gdb-assembler-mode ()
2304 "Major mode for viewing code assembler.
2306 \\{gdb-assembler-mode-map}"
2307 (setq major-mode 'gdb-assembler-mode)
2308 (setq mode-name "Assembler")
2309 (setq left-margin-width 2)
2310 (setq fringes-outside-margins t)
2311 (setq buffer-read-only t)
2312 (use-local-map gdb-assembler-mode-map)
2313 (gdb-invalidate-assembler))
2315 (defun gdb-assembler-buffer-name ()
2316 (with-current-buffer gud-comint-buffer
2317 (concat "*Machine Code " (gdb-get-target-string) "*")))
2319 (defun gdb-display-assembler-buffer ()
2320 (interactive)
2321 (gdb-display-buffer
2322 (gdb-get-create-buffer 'gdb-assembler-buffer)))
2324 (defun gdb-frame-assembler-buffer ()
2325 (interactive)
2326 (switch-to-buffer-other-frame
2327 (gdb-get-create-buffer 'gdb-assembler-buffer)))
2329 ;; modified because if gdb-current-address has changed value a new command
2330 ;; must be enqueued to update the buffer with the new output
2331 (defun gdb-invalidate-assembler (&optional ignored)
2332 (if (gdb-get-buffer 'gdb-assembler-buffer)
2333 (progn
2334 (unless (string-equal gdb-current-frame gdb-previous-frame)
2335 (if (or (not (member 'gdb-invalidate-assembler
2336 (gdb-get-pending-triggers)))
2337 (not (string-equal gdb-current-address
2338 gdb-previous-address)))
2339 (progn
2340 ;; take previous disassemble command off the queue
2341 (with-current-buffer gud-comint-buffer
2342 (let ((queue (gdb-get-input-queue)) (item))
2343 (dolist (item queue)
2344 (if (equal (cdr item) '(gdb-assembler-handler))
2345 (gdb-set-input-queue
2346 (delete item (gdb-get-input-queue)))))))
2347 (gdb-enqueue-input
2348 (list (concat "server disassemble " gdb-current-address "\n")
2349 'gdb-assembler-handler))
2350 (gdb-set-pending-triggers
2351 (cons 'gdb-invalidate-assembler
2352 (gdb-get-pending-triggers)))
2353 (setq gdb-previous-address gdb-current-address)
2354 (setq gdb-previous-frame gdb-current-frame)))))))
2356 (defun gdb-get-current-frame ()
2357 (if (not (member 'gdb-get-current-frame (gdb-get-pending-triggers)))
2358 (progn
2359 (gdb-enqueue-input
2360 (list (concat "server info frame\n") 'gdb-frame-handler))
2361 (gdb-set-pending-triggers
2362 (cons 'gdb-get-current-frame
2363 (gdb-get-pending-triggers))))))
2365 (defun gdb-frame-handler ()
2366 (gdb-set-pending-triggers
2367 (delq 'gdb-get-current-frame (gdb-get-pending-triggers)))
2368 (with-current-buffer (gdb-get-create-buffer 'gdb-partial-output-buffer)
2369 (goto-char (point-min))
2370 (forward-line)
2371 (if (looking-at ".*= 0x\\(\\S-*\\) in \\(\\S-*\\)")
2372 (progn
2373 (setq gdb-current-frame (match-string 2))
2374 (let ((address (match-string 1)))
2375 ;; remove leading 0s from output of info frame command.
2376 (if (string-match "^0+\\(.*\\)" address)
2377 (setq gdb-current-address
2378 (concat "0x" (match-string 1 address)))
2379 (setq gdb-current-address (concat "0x" address))))
2380 (if (or (if (not (looking-at ".*(\\S-*:[0-9]*)"))
2381 (progn (setq gdb-view-source nil) t))
2382 (eq gdb-selected-view 'assembler))
2383 (progn
2384 (set-window-buffer
2385 gdb-source-window
2386 (gdb-get-create-buffer 'gdb-assembler-buffer))
2387 ;;update with new frame for machine code if necessary
2388 (gdb-invalidate-assembler)))))))
2390 (provide 'gdb-ui)
2392 ;;; arch-tag: e9fb00c5-74ef-469f-a088-37384caae352
2393 ;;; gdb-ui.el ends here