1 /* Top level stuff for GDB, the GNU debugger.
2 Copyright 1999, 2000, 2001, 2002, 2004 Free Software Foundation, Inc.
3 Written by Elena Zannoni <ezannoni@cygnus.com> of Cygnus Solutions.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
26 #include "terminal.h" /* for job_control */
27 #include "event-loop.h"
28 #include "event-top.h"
32 /* For dont_repeat() */
35 /* readline include files */
36 #include "readline/readline.h"
38 /* readline defines this. */
41 static void rl_callback_read_char_wrapper (gdb_client_data client_data);
42 static void command_line_handler (char *rl);
43 static void command_line_handler_continuation (struct continuation_arg *arg);
44 static void change_line_handler (void);
45 static void change_annotation_level (void);
46 static void command_handler (char *command);
47 static void async_do_nothing (gdb_client_data arg);
48 static void async_disconnect (gdb_client_data arg);
49 static void async_stop_sig (gdb_client_data arg);
50 static void async_float_handler (gdb_client_data arg);
52 /* Signal handlers. */
53 static void handle_sigquit (int sig);
54 static void handle_sighup (int sig);
55 static void handle_sigfpe (int sig);
56 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
57 static void handle_sigwinch (int sig);
60 /* Functions to be invoked by the event loop in response to
62 static void async_do_nothing (gdb_client_data);
63 static void async_disconnect (gdb_client_data);
64 static void async_float_handler (gdb_client_data);
65 static void async_stop_sig (gdb_client_data);
67 /* Readline offers an alternate interface, via callback
68 functions. These are all included in the file callback.c in the
69 readline distribution. This file provides (mainly) a function, which
70 the event loop uses as callback (i.e. event handler) whenever an event
71 is detected on the standard input file descriptor.
72 readline_callback_read_char is called (by the GDB event loop) whenever
73 there is a new character ready on the input stream. This function
74 incrementally builds a buffer internal to readline where it
75 accumulates the line read up to the point of invocation. In the
76 special case in which the character read is newline, the function
77 invokes a GDB supplied callback routine, which does the processing of
78 a full command line. This latter routine is the asynchronous analog
79 of the old command_line_input in gdb. Instead of invoking (and waiting
80 for) readline to read the command line and pass it back to
81 command_loop for processing, the new command_line_handler function has
82 the command line already available as its parameter. INPUT_HANDLER is
83 to be set to the function that readline will invoke when a complete
84 line of input is ready. CALL_READLINE is to be set to the function
85 that readline offers as callback to the event_loop. */
87 void (*input_handler) (char *);
88 void (*call_readline) (gdb_client_data);
90 /* Important variables for the event loop. */
92 /* This is used to determine if GDB is using the readline library or
93 its own simplified form of readline. It is used by the asynchronous
94 form of the set editing command.
95 ezannoni: as of 1999-04-29 I expect that this
96 variable will not be used after gdb is changed to use the event
97 loop as default engine, and event-top.c is merged into top.c. */
98 int async_command_editing_p;
100 /* This variable contains the new prompt that the user sets with the
101 set prompt command. */
102 char *new_async_prompt;
104 /* This is the annotation suffix that will be used when the
105 annotation_level is 2. */
106 char *async_annotation_suffix;
108 /* This is used to display the notification of the completion of an
109 asynchronous execution command. */
110 int exec_done_display_p = 0;
112 /* This is the file descriptor for the input stream that GDB uses to
113 read commands from. */
116 /* This is the prompt stack. Prompts will be pushed on the stack as
117 needed by the different 'kinds' of user inputs GDB is asking
118 for. See event-loop.h. */
119 struct prompts the_prompts;
121 /* signal handling variables */
122 /* Each of these is a pointer to a function that the event loop will
123 invoke if the corresponding signal has received. The real signal
124 handlers mark these functions as ready to be executed and the event
125 loop, in a later iteration, calls them. See the function
126 invoke_async_signal_handler. */
133 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
134 void *sigwinch_token;
140 /* Structure to save a partially entered command. This is used when
141 the user types '\' at the end of a command line. This is necessary
142 because each line of input is handled by a different call to
143 command_line_handler, and normally there is no state retained
144 between different calls. */
145 int more_to_come = 0;
147 struct readline_input_state
150 char *linebuffer_ptr;
152 readline_input_state;
154 /* This hook is called by rl_callback_read_char_wrapper after each
155 character is processed. */
156 void (*after_char_processing_hook) ();
159 /* Wrapper function for calling into the readline library. The event
160 loop expects the callback function to have a paramter, while readline
163 rl_callback_read_char_wrapper (gdb_client_data client_data)
165 rl_callback_read_char ();
166 if (after_char_processing_hook)
167 (*after_char_processing_hook) ();
170 /* Initialize all the necessary variables, start the event loop,
171 register readline, and stdin, start the loop. */
173 cli_command_loop (void)
177 char *gdb_prompt = get_prompt ();
179 /* If we are using readline, set things up and display the first
180 prompt, otherwise just print the prompt. */
181 if (async_command_editing_p)
183 /* Tell readline what the prompt to display is and what function it
184 will need to call after a whole line is read. This also displays
186 length = strlen (PREFIX (0)) + strlen (gdb_prompt) + strlen (SUFFIX (0)) + 1;
187 a_prompt = (char *) xmalloc (length);
188 strcpy (a_prompt, PREFIX (0));
189 strcat (a_prompt, gdb_prompt);
190 strcat (a_prompt, SUFFIX (0));
191 rl_callback_handler_install (a_prompt, input_handler);
194 display_gdb_prompt (0);
196 /* Now it's time to start the event loop. */
200 /* Change the function to be invoked every time there is a character
201 ready on stdin. This is used when the user sets the editing off,
202 therefore bypassing readline, and letting gdb handle the input
203 itself, via gdb_readline2. Also it is used in the opposite case in
204 which the user sets editing on again, by restoring readline
205 handling of the input. */
207 change_line_handler (void)
209 /* NOTE: this operates on input_fd, not instream. If we are reading
210 commands from a file, instream will point to the file. However in
211 async mode, we always read commands from a file with editing
212 off. This means that the 'set editing on/off' will have effect
213 only on the interactive session. */
215 if (async_command_editing_p)
217 /* Turn on editing by using readline. */
218 call_readline = rl_callback_read_char_wrapper;
219 input_handler = command_line_handler;
223 /* Turn off editing by using gdb_readline2. */
224 rl_callback_handler_remove ();
225 call_readline = gdb_readline2;
227 /* Set up the command handler as well, in case we are called as
228 first thing from .gdbinit. */
229 input_handler = command_line_handler;
233 /* Displays the prompt. The prompt that is displayed is the current
234 top of the prompt stack, if the argument NEW_PROMPT is
235 0. Otherwise, it displays whatever NEW_PROMPT is. This is used
236 after each gdb command has completed, and in the following cases:
237 1. when the user enters a command line which is ended by '\'
238 indicating that the command will continue on the next line.
239 In that case the prompt that is displayed is the empty string.
240 2. When the user is entering 'commands' for a breakpoint, or
241 actions for a tracepoint. In this case the prompt will be '>'
243 FIXME: 2. & 3. not implemented yet for async. */
245 display_gdb_prompt (char *new_prompt)
247 int prompt_length = 0;
248 char *gdb_prompt = get_prompt ();
250 /* Each interpreter has its own rules on displaying the command
252 if (!current_interp_display_prompt_p ())
255 if (target_executing && sync_execution)
257 /* This is to trick readline into not trying to display the
258 prompt. Even though we display the prompt using this
259 function, readline still tries to do its own display if we
260 don't call rl_callback_handler_install and
261 rl_callback_handler_remove (which readline detects because a
262 global variable is not set). If readline did that, it could
263 mess up gdb signal handlers for SIGINT. Readline assumes
264 that between calls to rl_set_signals and rl_clear_signals gdb
265 doesn't do anything with the signal handlers. Well, that's
266 not the case, because when the target executes we change the
267 SIGINT signal handler. If we allowed readline to display the
268 prompt, the signal handler change would happen exactly
269 between the calls to the above two functions.
270 Calling rl_callback_handler_remove(), does the job. */
272 rl_callback_handler_remove ();
278 /* Just use the top of the prompt stack. */
279 prompt_length = strlen (PREFIX (0)) +
280 strlen (SUFFIX (0)) +
281 strlen (gdb_prompt) + 1;
283 new_prompt = (char *) alloca (prompt_length);
285 /* Prefix needs to have new line at end. */
286 strcpy (new_prompt, PREFIX (0));
287 strcat (new_prompt, gdb_prompt);
288 /* Suffix needs to have a new line at end and \032 \032 at
290 strcat (new_prompt, SUFFIX (0));
293 if (async_command_editing_p)
295 rl_callback_handler_remove ();
296 rl_callback_handler_install (new_prompt, input_handler);
298 /* new_prompt at this point can be the top of the stack or the one passed in */
301 /* Don't use a _filtered function here. It causes the assumed
302 character position to be off, since the newline we read from
303 the user is not accounted for. */
304 fputs_unfiltered (new_prompt, gdb_stdout);
305 gdb_flush (gdb_stdout);
309 /* Used when the user requests a different annotation level, with
310 'set annotate'. It pushes a new prompt (with prefix and suffix) on top
311 of the prompt stack, if the annotation level desired is 2, otherwise
312 it pops the top of the prompt stack when we want the annotation level
313 to be the normal ones (1 or 0). */
315 change_annotation_level (void)
317 char *prefix, *suffix;
319 if (!PREFIX (0) || !PROMPT (0) || !SUFFIX (0))
321 /* The prompt stack has not been initialized to "", we are
322 using gdb w/o the --async switch */
323 warning ("Command has same effect as set annotate");
327 if (annotation_level > 1)
329 if (!strcmp (PREFIX (0), "") && !strcmp (SUFFIX (0), ""))
331 /* Push a new prompt if the previous annotation_level was not >1. */
332 prefix = (char *) alloca (strlen (async_annotation_suffix) + 10);
333 strcpy (prefix, "\n\032\032pre-");
334 strcat (prefix, async_annotation_suffix);
335 strcat (prefix, "\n");
337 suffix = (char *) alloca (strlen (async_annotation_suffix) + 6);
338 strcpy (suffix, "\n\032\032");
339 strcat (suffix, async_annotation_suffix);
340 strcat (suffix, "\n");
342 push_prompt (prefix, (char *) 0, suffix);
347 if (strcmp (PREFIX (0), "") && strcmp (SUFFIX (0), ""))
349 /* Pop the top of the stack, we are going back to annotation < 1. */
355 /* Pushes a new prompt on the prompt stack. Each prompt has three
356 parts: prefix, prompt, suffix. Usually prefix and suffix are empty
357 strings, except when the annotation level is 2. Memory is allocated
358 within savestring for the new prompt. */
360 push_prompt (char *prefix, char *prompt, char *suffix)
363 PREFIX (0) = savestring (prefix, strlen (prefix));
365 /* Note that this function is used by the set annotate 2
366 command. This is why we take care of saving the old prompt
367 in case a new one is not specified. */
369 PROMPT (0) = savestring (prompt, strlen (prompt));
371 PROMPT (0) = savestring (PROMPT (-1), strlen (PROMPT (-1)));
373 SUFFIX (0) = savestring (suffix, strlen (suffix));
376 /* Pops the top of the prompt stack, and frees the memory allocated for it. */
380 /* If we are not during a 'synchronous' execution command, in which
381 case, the top prompt would be empty. */
382 if (strcmp (PROMPT (0), ""))
383 /* This is for the case in which the prompt is set while the
384 annotation level is 2. The top prompt will be changed, but when
385 we return to annotation level < 2, we want that new prompt to be
386 in effect, until the user does another 'set prompt'. */
387 if (strcmp (PROMPT (0), PROMPT (-1)))
390 PROMPT (-1) = savestring (PROMPT (0), strlen (PROMPT (0)));
399 /* When there is an event ready on the stdin file desriptor, instead
400 of calling readline directly throught the callback function, or
401 instead of calling gdb_readline2, give gdb a chance to detect
402 errors and do something. */
404 stdin_event_handler (int error, gdb_client_data client_data)
408 printf_unfiltered ("error detected on stdin\n");
409 delete_file_handler (input_fd);
410 discard_all_continuations ();
411 /* If stdin died, we may as well kill gdb. */
412 quit_command ((char *) 0, stdin == instream);
415 (*call_readline) (client_data);
418 /* Re-enable stdin after the end of an execution command in
419 synchronous mode, or after an error from the target, and we aborted
420 the exec operation. */
423 async_enable_stdin (void *dummy)
425 /* See NOTE in async_disable_stdin() */
426 /* FIXME: cagney/1999-09-27: Call this before clearing
427 sync_execution. Current target_terminal_ours() implementations
428 check for sync_execution before switching the terminal. */
429 target_terminal_ours ();
434 /* Disable reads from stdin (the console) marking the command as
438 async_disable_stdin (void)
441 push_prompt ("", "", "");
442 /* FIXME: cagney/1999-09-27: At present this call is technically
443 redundant since infcmd.c and infrun.c both already call
444 target_terminal_inferior(). As the terminal handling (in
445 sync/async mode) is refined, the duplicate calls can be
446 eliminated (Here or in infcmd.c/infrun.c). */
447 target_terminal_inferior ();
448 /* Add the reinstate of stdin to the list of cleanups to be done
449 in case the target errors out and dies. These cleanups are also
450 done in case of normal successful termination of the execution
451 command, by complete_execution(). */
452 make_exec_error_cleanup (async_enable_stdin, NULL);
456 /* Handles a gdb command. This function is called by
457 command_line_handler, which has processed one or more input lines
459 /* NOTE: 1999-04-30 This is the asynchronous version of the command_loop
460 function. The command_loop function will be obsolete when we
461 switch to use the event loop at every execution of gdb. */
463 command_handler (char *command)
465 struct cleanup *old_chain;
466 int stdin_is_tty = ISATTY (stdin);
467 struct continuation_arg *arg1;
468 struct continuation_arg *arg2;
469 long time_at_cmd_start;
471 long space_at_cmd_start = 0;
473 extern int display_time;
474 extern int display_space;
477 if (instream == stdin && stdin_is_tty)
478 reinitialize_more_filter ();
479 old_chain = make_cleanup (null_cleanup, 0);
481 /* If readline returned a NULL command, it means that the
482 connection with the terminal is gone. This happens at the
483 end of a testsuite run, after Expect has hung up
484 but GDB is still alive. In such a case, we just quit gdb
485 killing the inferior program too. */
487 quit_command ((char *) 0, stdin == instream);
489 time_at_cmd_start = get_run_time ();
494 char *lim = (char *) sbrk (0);
495 space_at_cmd_start = lim - lim_at_start;
499 execute_command (command, instream == stdin);
501 /* Set things up for this function to be compete later, once the
502 execution has completed, if we are doing an execution command,
503 otherwise, just go ahead and finish. */
504 if (target_can_async_p () && target_executing)
507 (struct continuation_arg *) xmalloc (sizeof (struct continuation_arg));
509 (struct continuation_arg *) xmalloc (sizeof (struct continuation_arg));
512 arg1->data.longint = time_at_cmd_start;
514 arg2->data.longint = space_at_cmd_start;
516 add_continuation (command_line_handler_continuation, arg1);
519 /* Do any commands attached to breakpoint we stopped at. Only if we
520 are always running synchronously. Or if we have just executed a
521 command that doesn't start the target. */
522 if (!target_can_async_p () || !target_executing)
524 bpstat_do_actions (&stop_bpstat);
525 do_cleanups (old_chain);
529 long cmd_time = get_run_time () - time_at_cmd_start;
531 printf_unfiltered ("Command execution time: %ld.%06ld\n",
532 cmd_time / 1000000, cmd_time % 1000000);
538 char *lim = (char *) sbrk (0);
539 long space_now = lim - lim_at_start;
540 long space_diff = space_now - space_at_cmd_start;
542 printf_unfiltered ("Space used: %ld (%c%ld for this command)\n",
544 (space_diff >= 0 ? '+' : '-'),
551 /* Do any commands attached to breakpoint we stopped at. Only if we
552 are always running synchronously. Or if we have just executed a
553 command that doesn't start the target. */
555 command_line_handler_continuation (struct continuation_arg *arg)
557 extern int display_time;
558 extern int display_space;
560 long time_at_cmd_start = arg->data.longint;
561 long space_at_cmd_start = arg->next->data.longint;
563 bpstat_do_actions (&stop_bpstat);
564 /*do_cleanups (old_chain); *//*?????FIXME????? */
568 long cmd_time = get_run_time () - time_at_cmd_start;
570 printf_unfiltered ("Command execution time: %ld.%06ld\n",
571 cmd_time / 1000000, cmd_time % 1000000);
576 char *lim = (char *) sbrk (0);
577 long space_now = lim - lim_at_start;
578 long space_diff = space_now - space_at_cmd_start;
580 printf_unfiltered ("Space used: %ld (%c%ld for this command)\n",
582 (space_diff >= 0 ? '+' : '-'),
588 /* Handle a complete line of input. This is called by the callback
589 mechanism within the readline library. Deal with incomplete commands
590 as well, by saving the partial input in a global buffer. */
592 /* NOTE: 1999-04-30 This is the asynchronous version of the
593 command_line_input function. command_line_input will become
594 obsolete once we use the event loop as the default mechanism in
597 command_line_handler (char *rl)
599 static char *linebuffer = 0;
600 static unsigned linelength = 0;
609 int repeat = (instream == stdin);
611 if (annotation_level > 1 && instream == stdin)
613 printf_unfiltered ("\n\032\032post-");
614 puts_unfiltered (async_annotation_suffix);
615 printf_unfiltered ("\n");
621 linebuffer = (char *) xmalloc (linelength);
628 strcpy (linebuffer, readline_input_state.linebuffer);
629 p = readline_input_state.linebuffer_ptr;
630 xfree (readline_input_state.linebuffer);
637 signal (STOP_SIGNAL, handle_stop_sig);
640 /* Make sure that all output has been output. Some machines may let
641 you get away with leaving out some of the gdb_flush, but not all. */
643 gdb_flush (gdb_stdout);
644 gdb_flush (gdb_stderr);
646 if (source_file_name != NULL)
648 ++source_line_number;
649 sprintf (source_error,
650 "%s%s:%d: Error in sourced command file:\n",
654 error_pre_print = source_error;
657 /* If we are in this case, then command_handler will call quit
658 and exit from gdb. */
659 if (!rl || rl == (char *) EOF)
664 if (strlen (rl) + 1 + (p - linebuffer) > linelength)
666 linelength = strlen (rl) + 1 + (p - linebuffer);
667 nline = (char *) xrealloc (linebuffer, linelength);
668 p += nline - linebuffer;
672 /* Copy line. Don't copy null at end. (Leaves line alone
673 if this was just a newline) */
677 xfree (rl); /* Allocated in readline. */
679 if (p > linebuffer && *(p - 1) == '\\')
681 p--; /* Put on top of '\'. */
683 readline_input_state.linebuffer = savestring (linebuffer,
684 strlen (linebuffer));
685 readline_input_state.linebuffer_ptr = p;
687 /* We will not invoke a execute_command if there is more
688 input expected to complete the command. So, we need to
689 print an empty prompt here. */
691 push_prompt ("", "", "");
692 display_gdb_prompt (0);
698 signal (STOP_SIGNAL, SIG_DFL);
701 #define SERVER_COMMAND_LENGTH 7
703 (p - linebuffer > SERVER_COMMAND_LENGTH)
704 && strncmp (linebuffer, "server ", SERVER_COMMAND_LENGTH) == 0;
707 /* Note that we don't set `line'. Between this and the check in
708 dont_repeat, this insures that repeating will still do the
711 command_handler (linebuffer + SERVER_COMMAND_LENGTH);
712 display_gdb_prompt (0);
716 /* Do history expansion if that is wished. */
717 if (history_expansion_p && instream == stdin
718 && ISATTY (instream))
723 *p = '\0'; /* Insert null now. */
724 expanded = history_expand (linebuffer, &history_value);
727 /* Print the changes. */
728 printf_unfiltered ("%s\n", history_value);
730 /* If there was an error, call this function again. */
733 xfree (history_value);
736 if (strlen (history_value) > linelength)
738 linelength = strlen (history_value) + 1;
739 linebuffer = (char *) xrealloc (linebuffer, linelength);
741 strcpy (linebuffer, history_value);
742 p = linebuffer + strlen (linebuffer);
743 xfree (history_value);
747 /* If we just got an empty line, and that is supposed
748 to repeat the previous command, return the value in the
750 if (repeat && p == linebuffer && *p != '\\')
752 command_handler (line);
753 display_gdb_prompt (0);
757 for (p1 = linebuffer; *p1 == ' ' || *p1 == '\t'; p1++);
760 command_handler (line);
761 display_gdb_prompt (0);
767 /* Add line to history if appropriate. */
768 if (instream == stdin
769 && ISATTY (stdin) && *linebuffer)
770 add_history (linebuffer);
772 /* Note: lines consisting solely of comments are added to the command
773 history. This is useful when you type a command, and then
774 realize you don't want to execute it quite yet. You can comment
775 out the command and then later fetch it from the value history
776 and remove the '#'. The kill ring is probably better, but some
777 people are in the habit of commenting things out. */
779 *p1 = '\0'; /* Found a comment. */
781 /* Save into global buffer if appropriate. */
784 if (linelength > linesize)
786 line = xrealloc (line, linelength);
787 linesize = linelength;
789 strcpy (line, linebuffer);
792 command_handler (line);
793 display_gdb_prompt (0);
798 command_handler (linebuffer);
799 display_gdb_prompt (0);
803 /* Does reading of input from terminal w/o the editing features
804 provided by the readline library. */
806 /* NOTE: 1999-04-30 Asynchronous version of gdb_readline. gdb_readline
807 will become obsolete when the event loop is made the default
808 execution for gdb. */
810 gdb_readline2 (gdb_client_data client_data)
815 int result_size = 80;
816 static int done_once = 0;
818 /* Unbuffer the input stream, so that, later on, the calls to fgetc
819 fetch only one char at the time from the stream. The fgetc's will
820 get up to the first newline, but there may be more chars in the
821 stream after '\n'. If we buffer the input and fgetc drains the
822 stream, getting stuff beyond the newline as well, a select, done
823 afterwards will not trigger. */
824 if (!done_once && !ISATTY (instream))
826 setbuf (instream, NULL);
830 result = (char *) xmalloc (result_size);
832 /* We still need the while loop here, even though it would seem
833 obvious to invoke gdb_readline2 at every character entered. If
834 not using the readline library, the terminal is in cooked mode,
835 which sends the characters all at once. Poll will notice that the
836 input fd has changed state only after enter is pressed. At this
837 point we still need to fetch all the chars entered. */
841 /* Read from stdin if we are executing a user defined command.
842 This is the right thing for prompt_for_continue, at least. */
843 c = fgetc (instream ? instream : stdin);
848 /* The last line does not end with a newline. Return it, and
849 if we are called again fgetc will still return EOF and
850 we'll return NULL then. */
853 (*input_handler) (0);
857 #ifndef CRLF_SOURCE_FILES
861 if (input_index > 0 && result[input_index - 1] == '\r')
867 result[input_index++] = c;
868 while (input_index >= result_size)
871 result = (char *) xrealloc (result, result_size);
875 result[input_index++] = '\0';
876 (*input_handler) (result);
880 /* Initialization of signal handlers and tokens. There is a function
881 handle_sig* for each of the signals GDB cares about. Specifically:
882 SIGINT, SIGFPE, SIGQUIT, SIGTSTP, SIGHUP, SIGWINCH. These
883 functions are the actual signal handlers associated to the signals
884 via calls to signal(). The only job for these functions is to
885 enqueue the appropriate event/procedure with the event loop. Such
886 procedures are the old signal handlers. The event loop will take
887 care of invoking the queued procedures to perform the usual tasks
888 associated with the reception of the signal. */
889 /* NOTE: 1999-04-30 This is the asynchronous version of init_signals.
890 init_signals will become obsolete as we move to have to event loop
891 as the default for gdb. */
893 async_init_signals (void)
895 signal (SIGINT, handle_sigint);
897 create_async_signal_handler (async_request_quit, NULL);
899 /* If SIGTRAP was set to SIG_IGN, then the SIG_IGN will get passed
900 to the inferior and breakpoints will be ignored. */
902 signal (SIGTRAP, SIG_DFL);
905 /* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
906 passed to the inferior, which we don't want. It would be
907 possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
908 on BSD4.3 systems using vfork, that can affect the
909 GDB process as well as the inferior (the signal handling tables
910 might be in memory, shared between the two). Since we establish
911 a handler for SIGQUIT, when we call exec it will set the signal
912 to SIG_DFL for us. */
913 signal (SIGQUIT, handle_sigquit);
915 create_async_signal_handler (async_do_nothing, NULL);
917 if (signal (SIGHUP, handle_sighup) != SIG_IGN)
919 create_async_signal_handler (async_disconnect, NULL);
922 create_async_signal_handler (async_do_nothing, NULL);
924 signal (SIGFPE, handle_sigfpe);
926 create_async_signal_handler (async_float_handler, NULL);
928 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
929 signal (SIGWINCH, handle_sigwinch);
931 create_async_signal_handler (SIGWINCH_HANDLER, NULL);
935 create_async_signal_handler (async_stop_sig, NULL);
941 mark_async_signal_handler_wrapper (void *token)
943 mark_async_signal_handler ((struct async_signal_handler *) token);
946 /* Tell the event loop what to do if SIGINT is received.
947 See event-signal.c. */
949 handle_sigint (int sig)
951 signal (sig, handle_sigint);
953 /* If immediate_quit is set, we go ahead and process the SIGINT right
954 away, even if we usually would defer this to the event loop. The
955 assumption here is that it is safe to process ^C immediately if
956 immediate_quit is set. If we didn't, SIGINT would be really
957 processed only the next time through the event loop. To get to
958 that point, though, the command that we want to interrupt needs to
959 finish first, which is unacceptable. */
961 async_request_quit (0);
963 /* If immediate quit is not set, we process SIGINT the next time
964 through the loop, which is fine. */
965 mark_async_signal_handler_wrapper (sigint_token);
968 /* Do the quit. All the checks have been done by the caller. */
970 async_request_quit (gdb_client_data arg)
976 /* Tell the event loop what to do if SIGQUIT is received.
977 See event-signal.c. */
979 handle_sigquit (int sig)
981 mark_async_signal_handler_wrapper (sigquit_token);
982 signal (sig, handle_sigquit);
985 /* Called by the event loop in response to a SIGQUIT. */
987 async_do_nothing (gdb_client_data arg)
989 /* Empty function body. */
993 /* Tell the event loop what to do if SIGHUP is received.
994 See event-signal.c. */
996 handle_sighup (int sig)
998 mark_async_signal_handler_wrapper (sighup_token);
999 signal (sig, handle_sighup);
1002 /* Called by the event loop to process a SIGHUP */
1004 async_disconnect (gdb_client_data arg)
1006 catch_errors (quit_cover, NULL,
1007 "Could not kill the program being debugged",
1009 signal (SIGHUP, SIG_DFL); /*FIXME: ??????????? */
1010 kill (getpid (), SIGHUP);
1016 handle_stop_sig (int sig)
1018 mark_async_signal_handler_wrapper (sigtstp_token);
1019 signal (sig, handle_stop_sig);
1023 async_stop_sig (gdb_client_data arg)
1025 char *prompt = get_prompt ();
1026 #if STOP_SIGNAL == SIGTSTP
1027 signal (SIGTSTP, SIG_DFL);
1028 #if HAVE_SIGPROCMASK
1032 sigemptyset (&zero);
1033 sigprocmask (SIG_SETMASK, &zero, 0);
1035 #elif HAVE_SIGSETMASK
1038 kill (getpid (), SIGTSTP);
1039 signal (SIGTSTP, handle_stop_sig);
1041 signal (STOP_SIGNAL, handle_stop_sig);
1043 printf_unfiltered ("%s", prompt);
1044 gdb_flush (gdb_stdout);
1046 /* Forget about any previous command -- null line now will do nothing. */
1049 #endif /* STOP_SIGNAL */
1051 /* Tell the event loop what to do if SIGFPE is received.
1052 See event-signal.c. */
1054 handle_sigfpe (int sig)
1056 mark_async_signal_handler_wrapper (sigfpe_token);
1057 signal (sig, handle_sigfpe);
1060 /* Event loop will call this functin to process a SIGFPE. */
1062 async_float_handler (gdb_client_data arg)
1064 /* This message is based on ANSI C, section 4.7. Note that integer
1065 divide by zero causes this, so "float" is a misnomer. */
1066 error ("Erroneous arithmetic operation.");
1069 /* Tell the event loop what to do if SIGWINCH is received.
1070 See event-signal.c. */
1071 #if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1073 handle_sigwinch (int sig)
1075 mark_async_signal_handler_wrapper (sigwinch_token);
1076 signal (sig, handle_sigwinch);
1081 /* Called by do_setshow_command. */
1083 set_async_editing_command (char *args, int from_tty, struct cmd_list_element *c)
1085 change_line_handler ();
1088 /* Called by do_setshow_command. */
1090 set_async_annotation_level (char *args, int from_tty, struct cmd_list_element *c)
1092 change_annotation_level ();
1095 /* Called by do_setshow_command. */
1097 set_async_prompt (char *args, int from_tty, struct cmd_list_element *c)
1099 PROMPT (0) = savestring (new_async_prompt, strlen (new_async_prompt));
1102 /* Set things up for readline to be invoked via the alternate
1103 interface, i.e. via a callback function (rl_callback_read_char),
1104 and hook up instream to the event loop. */
1106 gdb_setup_readline (void)
1108 /* This function is a noop for the sync case. The assumption is that
1109 the sync setup is ALL done in gdb_init, and we would only mess it up
1110 here. The sync stuff should really go away over time. */
1114 gdb_stdout = stdio_fileopen (stdout);
1115 gdb_stderr = stdio_fileopen (stderr);
1116 gdb_stdlog = gdb_stderr; /* for moment */
1117 gdb_stdtarg = gdb_stderr; /* for moment */
1119 /* If the input stream is connected to a terminal, turn on
1121 if (ISATTY (instream))
1123 /* Tell gdb that we will be using the readline library. This
1124 could be overwritten by a command in .gdbinit like 'set
1125 editing on' or 'off'. */
1126 async_command_editing_p = 1;
1128 /* When a character is detected on instream by select or
1129 poll, readline will be invoked via this callback
1131 call_readline = rl_callback_read_char_wrapper;
1135 async_command_editing_p = 0;
1136 call_readline = gdb_readline2;
1139 /* When readline has read an end-of-line character, it passes
1140 the complete line to gdb for processing. command_line_handler
1141 is the function that does this. */
1142 input_handler = command_line_handler;
1144 /* Tell readline to use the same input stream that gdb uses. */
1145 rl_instream = instream;
1147 /* Get a file descriptor for the input stream, so that we can
1148 register it with the event loop. */
1149 input_fd = fileno (instream);
1151 /* Now we need to create the event sources for the input file
1153 /* At this point in time, this is the only event source that we
1154 register with the even loop. Another source is going to be
1155 the target program (inferior), but that must be registered
1156 only when it actually exists (I.e. after we say 'run' or
1157 after we connect to a remote target. */
1158 add_file_handler (input_fd, stdin_event_handler, 0);
1162 /* Disable command input through the standard CLI channels. Used in
1163 the suspend proc for interpreters that use the standard gdb readline
1164 interface, like the cli & the mi. */
1166 gdb_disable_readline (void)
1170 /* FIXME - It is too heavyweight to delete and remake these
1171 every time you run an interpreter that needs readline.
1172 It is probably better to have the interpreters cache these,
1173 which in turn means that this needs to be moved into interpreter
1177 ui_file_delete (gdb_stdout);
1178 ui_file_delete (gdb_stderr);
1183 rl_callback_handler_remove ();
1184 delete_file_handler (input_fd);