1 /* MI Interpreter Definitions and Commands for GDB, the GNU debugger.
3 Copyright (C) 2002, 2003, 2004, 2005, 2007, 2008, 2009, 2010
4 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include "gdb_string.h"
24 #include "event-top.h"
25 #include "event-loop.h"
29 #include "exceptions.h"
33 #include "mi-console.h"
34 #include "mi-common.h"
36 #include "gdbthread.h"
39 /* These are the interpreter setup, etc. functions for the MI interpreter */
40 static void mi_execute_command_wrapper (char *cmd
);
41 static void mi_command_loop (int mi_version
);
43 /* These are hooks that we put in place while doing interpreter_exec
44 so we can report interesting things that happened "behind the mi's
45 back" in this command */
46 static int mi_interp_query_hook (const char *ctlstr
, va_list ap
)
47 ATTRIBUTE_PRINTF (1, 0);
49 static void mi3_command_loop (void);
50 static void mi2_command_loop (void);
51 static void mi1_command_loop (void);
53 static void mi_insert_notify_hooks (void);
54 static void mi_remove_notify_hooks (void);
55 static void mi_on_normal_stop (struct bpstats
*bs
, int print_frame
);
57 static void mi_new_thread (struct thread_info
*t
);
58 static void mi_thread_exit (struct thread_info
*t
, int silent
);
59 static void mi_inferior_added (struct inferior
*inf
);
60 static void mi_inferior_appeared (struct inferior
*inf
);
61 static void mi_inferior_exit (struct inferior
*inf
);
62 static void mi_inferior_removed (struct inferior
*inf
);
63 static void mi_on_resume (ptid_t ptid
);
64 static void mi_solib_loaded (struct so_list
*solib
);
65 static void mi_solib_unloaded (struct so_list
*solib
);
66 static void mi_about_to_proceed (void);
68 static int report_initial_inferior (struct inferior
*inf
, void *closure
);
71 mi_interpreter_init (int top_level
)
73 struct mi_interp
*mi
= XMALLOC (struct mi_interp
);
75 /* HACK: We need to force stdout/stderr to point at the console. This avoids
76 any potential side effects caused by legacy code that is still
77 using the TUI / fputs_unfiltered_hook. So we set up output channels for
78 this now, and swap them in when we are run. */
80 raw_stdout
= stdio_fileopen (stdout
);
82 /* Create MI channels */
83 mi
->out
= mi_console_file_new (raw_stdout
, "~", '"');
84 mi
->err
= mi_console_file_new (raw_stdout
, "&", '"');
86 mi
->targ
= mi_console_file_new (raw_stdout
, "@", '"');
87 mi
->event_channel
= mi_console_file_new (raw_stdout
, "=", 0);
91 observer_attach_new_thread (mi_new_thread
);
92 observer_attach_thread_exit (mi_thread_exit
);
93 observer_attach_inferior_added (mi_inferior_added
);
94 observer_attach_inferior_appeared (mi_inferior_appeared
);
95 observer_attach_inferior_exit (mi_inferior_exit
);
96 observer_attach_inferior_removed (mi_inferior_removed
);
97 observer_attach_normal_stop (mi_on_normal_stop
);
98 observer_attach_target_resumed (mi_on_resume
);
99 observer_attach_solib_loaded (mi_solib_loaded
);
100 observer_attach_solib_unloaded (mi_solib_unloaded
);
101 observer_attach_about_to_proceed (mi_about_to_proceed
);
103 /* The initial inferior is created before this function is called, so we
104 need to report it explicitly. Use iteration in case future version
105 of GDB creates more than one inferior up-front. */
106 iterate_over_inferiors (report_initial_inferior
, mi
);
113 mi_interpreter_resume (void *data
)
115 struct mi_interp
*mi
= data
;
117 /* As per hack note in mi_interpreter_init, swap in the output channels... */
118 gdb_setup_readline ();
120 /* These overwrite some of the initialization done in
121 _intialize_event_loop. */
122 call_readline
= gdb_readline2
;
123 input_handler
= mi_execute_command_wrapper
;
124 add_file_handler (input_fd
, stdin_event_handler
, 0);
125 async_command_editing_p
= 0;
126 /* FIXME: This is a total hack for now. PB's use of the MI
127 implicitly relies on a bug in the async support which allows
128 asynchronous commands to leak through the commmand loop. The bug
129 involves (but is not limited to) the fact that sync_execution was
130 erroneously initialized to 0. Duplicate by initializing it thus
134 gdb_stdout
= mi
->out
;
135 /* Route error and log output through the MI */
136 gdb_stderr
= mi
->err
;
137 gdb_stdlog
= mi
->log
;
138 /* Route target output through the MI. */
139 gdb_stdtarg
= mi
->targ
;
140 /* Route target error through the MI as well. */
141 gdb_stdtargerr
= mi
->targ
;
143 /* Replace all the hooks that we know about. There really needs to
144 be a better way of doing this... */
145 clear_interpreter_hooks ();
147 deprecated_show_load_progress
= mi_load_progress
;
149 /* If we're _the_ interpreter, take control. */
150 if (current_interp_named_p (INTERP_MI1
))
151 deprecated_command_loop_hook
= mi1_command_loop
;
152 else if (current_interp_named_p (INTERP_MI2
))
153 deprecated_command_loop_hook
= mi2_command_loop
;
154 else if (current_interp_named_p (INTERP_MI3
))
155 deprecated_command_loop_hook
= mi3_command_loop
;
157 deprecated_command_loop_hook
= mi2_command_loop
;
163 mi_interpreter_suspend (void *data
)
165 gdb_disable_readline ();
169 static struct gdb_exception
170 mi_interpreter_exec (void *data
, const char *command
)
172 char *tmp
= alloca (strlen (command
) + 1);
174 strcpy (tmp
, command
);
175 mi_execute_command_wrapper (tmp
);
176 return exception_none
;
179 /* Never display the default gdb prompt in mi case. */
181 mi_interpreter_prompt_p (void *data
)
187 mi_cmd_interpreter_exec (char *command
, char **argv
, int argc
)
189 struct interp
*interp_to_use
;
191 char *mi_error_message
= NULL
;
192 struct cleanup
*old_chain
;
195 error ("mi_cmd_interpreter_exec: Usage: -interpreter-exec interp command");
197 interp_to_use
= interp_lookup (argv
[0]);
198 if (interp_to_use
== NULL
)
199 error ("mi_cmd_interpreter_exec: could not find interpreter \"%s\"", argv
[0]);
201 if (!interp_exec_p (interp_to_use
))
202 error ("mi_cmd_interpreter_exec: interpreter \"%s\" does not support command execution",
205 /* Insert the MI out hooks, making sure to also call the interpreter's hooks
207 /* KRS: We shouldn't need this... Events should be installed and they should
208 just ALWAYS fire something out down the MI channel... */
209 mi_insert_notify_hooks ();
211 /* Now run the code... */
213 old_chain
= make_cleanup (null_cleanup
, 0);
214 for (i
= 1; i
< argc
; i
++)
216 struct gdb_exception e
= interp_exec (interp_to_use
, argv
[i
]);
220 mi_error_message
= xstrdup (e
.message
);
221 make_cleanup (xfree
, mi_error_message
);
226 mi_remove_notify_hooks ();
228 if (mi_error_message
!= NULL
)
229 error ("%s", mi_error_message
);
230 do_cleanups (old_chain
);
234 * mi_insert_notify_hooks - This inserts a number of hooks that are meant to produce
235 * async-notify ("=") MI messages while running commands in another interpreter
236 * using mi_interpreter_exec. The canonical use for this is to allow access to
237 * the gdb CLI interpreter from within the MI, while still producing MI style output
238 * when actions in the CLI command change gdb's state.
242 mi_insert_notify_hooks (void)
244 deprecated_query_hook
= mi_interp_query_hook
;
248 mi_remove_notify_hooks (void)
250 deprecated_query_hook
= NULL
;
254 mi_interp_query_hook (const char *ctlstr
, va_list ap
)
260 mi_execute_command_wrapper (char *cmd
)
262 mi_execute_command (cmd
, stdin
== instream
);
266 mi1_command_loop (void)
272 mi2_command_loop (void)
278 mi3_command_loop (void)
284 mi_command_loop (int mi_version
)
286 /* Turn off 8 bit strings in quoted output. Any character with the
287 high bit set is printed using C's octal format. */
288 sevenbit_strings
= 1;
289 /* Tell the world that we're alive */
290 fputs_unfiltered ("(gdb) \n", raw_stdout
);
291 gdb_flush (raw_stdout
);
296 mi_new_thread (struct thread_info
*t
)
298 struct mi_interp
*mi
= top_level_interpreter_data ();
299 struct inferior
*inf
= find_inferior_pid (ptid_get_pid (t
->ptid
));
303 fprintf_unfiltered (mi
->event_channel
,
304 "thread-created,id=\"%d\",group-id=\"i%d\"",
306 gdb_flush (mi
->event_channel
);
310 mi_thread_exit (struct thread_info
*t
, int silent
)
312 struct mi_interp
*mi
;
313 struct inferior
*inf
;
318 inf
= find_inferior_pid (ptid_get_pid (t
->ptid
));
320 mi
= top_level_interpreter_data ();
321 target_terminal_ours ();
322 fprintf_unfiltered (mi
->event_channel
,
323 "thread-exited,id=\"%d\",group-id=\"i%d\"",
325 gdb_flush (mi
->event_channel
);
329 mi_inferior_added (struct inferior
*inf
)
331 struct mi_interp
*mi
= top_level_interpreter_data ();
333 target_terminal_ours ();
334 fprintf_unfiltered (mi
->event_channel
,
335 "thread-group-added,id=\"i%d\"",
337 gdb_flush (mi
->event_channel
);
341 mi_inferior_appeared (struct inferior
*inf
)
343 struct mi_interp
*mi
= top_level_interpreter_data ();
345 target_terminal_ours ();
346 fprintf_unfiltered (mi
->event_channel
,
347 "thread-group-started,id=\"i%d\",pid=\"%d\"",
349 gdb_flush (mi
->event_channel
);
353 mi_inferior_exit (struct inferior
*inf
)
355 struct mi_interp
*mi
= top_level_interpreter_data ();
357 target_terminal_ours ();
358 fprintf_unfiltered (mi
->event_channel
, "thread-group-exited,id=\"i%d\"",
360 gdb_flush (mi
->event_channel
);
364 mi_inferior_removed (struct inferior
*inf
)
366 struct mi_interp
*mi
= top_level_interpreter_data ();
368 target_terminal_ours ();
369 fprintf_unfiltered (mi
->event_channel
,
370 "thread-group-removed,id=\"i%d\"",
372 gdb_flush (mi
->event_channel
);
376 mi_on_normal_stop (struct bpstats
*bs
, int print_frame
)
378 /* Since this can be called when CLI command is executing,
379 using cli interpreter, be sure to use MI uiout for output,
380 not the current one. */
381 struct ui_out
*mi_uiout
= interp_ui_out (top_level_interpreter ());
387 if (uiout
!= mi_uiout
)
389 /* The normal_stop function has printed frame information into
390 CLI uiout, or some other non-MI uiout. There's no way we
391 can extract proper fields from random uiout object, so we print
392 the frame again. In practice, this can only happen when running
393 a CLI command in MI. */
394 struct ui_out
*saved_uiout
= uiout
;
397 print_stack_frame (get_selected_frame (NULL
), 0, SRC_AND_LOC
);
401 ui_out_field_int (mi_uiout
, "thread-id",
402 pid_to_thread_id (inferior_ptid
));
405 struct cleanup
*back_to
= make_cleanup_ui_out_list_begin_end
406 (mi_uiout
, "stopped-threads");
408 ui_out_field_int (mi_uiout
, NULL
,
409 pid_to_thread_id (inferior_ptid
));
410 do_cleanups (back_to
);
413 ui_out_field_string (mi_uiout
, "stopped-threads", "all");
415 core
= target_core_of_thread (inferior_ptid
);
417 ui_out_field_int (mi_uiout
, "core", core
);
420 fputs_unfiltered ("*stopped", raw_stdout
);
421 mi_out_put (mi_uiout
, raw_stdout
);
422 mi_out_rewind (mi_uiout
);
423 mi_print_timing_maybe ();
424 fputs_unfiltered ("\n", raw_stdout
);
425 gdb_flush (raw_stdout
);
429 mi_about_to_proceed (void)
431 /* Suppress output while calling an inferior function. */
433 if (!ptid_equal (inferior_ptid
, null_ptid
))
435 struct thread_info
*tp
= inferior_thread ();
437 if (tp
->control
.in_infcall
)
445 mi_output_running_pid (struct thread_info
*info
, void *arg
)
449 if (ptid_get_pid (*ptid
) == ptid_get_pid (info
->ptid
))
450 fprintf_unfiltered (raw_stdout
,
451 "*running,thread-id=\"%d\"\n",
458 mi_inferior_count (struct inferior
*inf
, void *arg
)
470 mi_on_resume (ptid_t ptid
)
472 struct thread_info
*tp
= NULL
;
474 if (ptid_equal (ptid
, minus_one_ptid
) || ptid_is_pid (ptid
))
475 tp
= inferior_thread ();
477 tp
= find_thread_ptid (ptid
);
479 /* Suppress output while calling an inferior function. */
480 if (tp
->control
.in_infcall
)
483 /* To cater for older frontends, emit ^running, but do it only once
484 per each command. We do it here, since at this point we know
485 that the target was successfully resumed, and in non-async mode,
486 we won't return back to MI interpreter code until the target
487 is done running, so delaying the output of "^running" until then
488 will make it impossible for frontend to know what's going on.
490 In future (MI3), we'll be outputting "^done" here. */
491 if (!running_result_record_printed
&& mi_proceeded
)
493 fprintf_unfiltered (raw_stdout
, "%s^running\n",
494 current_token
? current_token
: "");
497 if (PIDGET (ptid
) == -1)
498 fprintf_unfiltered (raw_stdout
, "*running,thread-id=\"all\"\n");
499 else if (ptid_is_pid (ptid
))
503 /* Backwards compatibility. If there's only one inferior,
504 output "all", otherwise, output each resumed thread
506 iterate_over_inferiors (mi_inferior_count
, &count
);
509 fprintf_unfiltered (raw_stdout
, "*running,thread-id=\"all\"\n");
511 iterate_over_threads (mi_output_running_pid
, &ptid
);
515 struct thread_info
*ti
= find_thread_ptid (ptid
);
518 fprintf_unfiltered (raw_stdout
, "*running,thread-id=\"%d\"\n", ti
->num
);
521 if (!running_result_record_printed
&& mi_proceeded
)
523 running_result_record_printed
= 1;
524 /* This is what gdb used to do historically -- printing prompt even if
525 it cannot actually accept any input. This will be surely removed
526 for MI3, and may be removed even earler. */
527 /* FIXME: review the use of target_is_async_p here -- is that
529 if (!target_is_async_p ())
530 fputs_unfiltered ("(gdb) \n", raw_stdout
);
532 gdb_flush (raw_stdout
);
536 mi_solib_loaded (struct so_list
*solib
)
538 struct mi_interp
*mi
= top_level_interpreter_data ();
540 target_terminal_ours ();
541 if (gdbarch_has_global_solist (target_gdbarch
))
542 fprintf_unfiltered (mi
->event_channel
,
543 "library-loaded,id=\"%s\",target-name=\"%s\","
544 "host-name=\"%s\",symbols-loaded=\"%d\"",
545 solib
->so_original_name
, solib
->so_original_name
,
546 solib
->so_name
, solib
->symbols_loaded
);
548 fprintf_unfiltered (mi
->event_channel
,
549 "library-loaded,id=\"%s\",target-name=\"%s\","
550 "host-name=\"%s\",symbols-loaded=\"%d\","
551 "thread-group=\"i%d\"",
552 solib
->so_original_name
, solib
->so_original_name
,
553 solib
->so_name
, solib
->symbols_loaded
,
554 current_inferior ()->num
);
556 gdb_flush (mi
->event_channel
);
560 mi_solib_unloaded (struct so_list
*solib
)
562 struct mi_interp
*mi
= top_level_interpreter_data ();
564 target_terminal_ours ();
565 if (gdbarch_has_global_solist (target_gdbarch
))
566 fprintf_unfiltered (mi
->event_channel
,
567 "library-unloaded,id=\"%s\",target-name=\"%s\","
569 solib
->so_original_name
, solib
->so_original_name
,
572 fprintf_unfiltered (mi
->event_channel
,
573 "library-unloaded,id=\"%s\",target-name=\"%s\","
574 "host-name=\"%s\",thread-group=\"i%d\"",
575 solib
->so_original_name
, solib
->so_original_name
,
576 solib
->so_name
, current_inferior ()->num
);
578 gdb_flush (mi
->event_channel
);
582 report_initial_inferior (struct inferior
*inf
, void *closure
)
584 /* This function is called from mi_intepreter_init, and since
585 mi_inferior_added assumes that inferior is fully initialized
586 and top_level_interpreter_data is set, we cannot call
588 struct mi_interp
*mi
= closure
;
590 target_terminal_ours ();
591 fprintf_unfiltered (mi
->event_channel
,
592 "thread-group-added,id=\"i%d\"",
594 gdb_flush (mi
->event_channel
);
598 extern initialize_file_ftype _initialize_mi_interp
; /* -Wmissing-prototypes */
601 _initialize_mi_interp (void)
603 static const struct interp_procs procs
=
605 mi_interpreter_init
, /* init_proc */
606 mi_interpreter_resume
, /* resume_proc */
607 mi_interpreter_suspend
, /* suspend_proc */
608 mi_interpreter_exec
, /* exec_proc */
609 mi_interpreter_prompt_p
/* prompt_proc_p */
612 /* The various interpreter levels. */
613 interp_add (interp_new (INTERP_MI1
, NULL
, mi_out_new (1), &procs
));
614 interp_add (interp_new (INTERP_MI2
, NULL
, mi_out_new (2), &procs
));
615 interp_add (interp_new (INTERP_MI3
, NULL
, mi_out_new (3), &procs
));
617 /* "mi" selects the most recent released version. "mi2" was
618 released as part of GDB 6.0. */
619 interp_add (interp_new (INTERP_MI
, NULL
, mi_out_new (2), &procs
));