* defs.h: Fix cntl-C to read from the Windows message queue.
[deliverable/binutils-gdb.git] / gdb / top.c
CommitLineData
172559ec 1/* Top level stuff for GDB, the GNU debugger.
255181a9 2 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996
172559ec
JK
3 Free Software Foundation, Inc.
4
5This file is part of GDB.
6
7This program is free software; you can redistribute it and/or modify
8it under the terms of the GNU General Public License as published by
9the Free Software Foundation; either version 2 of the License, or
10(at your option) any later version.
11
12This program is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
18along with this program; if not, write to the Free Software
6c9638b4 19Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
172559ec
JK
20
21#include "defs.h"
22#include "gdbcmd.h"
23#include "call-cmds.h"
24#include "symtab.h"
25#include "inferior.h"
26#include "signals.h"
27#include "target.h"
28#include "breakpoint.h"
29#include "gdbtypes.h"
30#include "expression.h"
e52bfe0c 31#include "value.h"
172559ec
JK
32#include "language.h"
33#include "terminal.h" /* For job_control. */
34#include "annotate.h"
35#include <setjmp.h>
36#include "top.h"
37
38/* readline include files */
39#include "readline.h"
40#include "history.h"
41
42/* readline defines this. */
43#undef savestring
44
45#include <sys/types.h>
1a494973 46#ifdef HAVE_UNISTD_H
172559ec
JK
47#include <unistd.h>
48#endif
49
2b576293 50#include "gdb_string.h"
2b576293 51#include "gdb_stat.h"
172559ec
JK
52#include <ctype.h>
53
e3be225e
SS
54extern void initialize_utils PARAMS ((void));
55
172559ec
JK
56/* Prototypes for local functions */
57
b607efe7
FF
58static void dont_repeat_command PARAMS ((char *, int));
59
60static void source_cleanup_lines PARAMS ((PTR));
61
62static void user_defined_command PARAMS ((char *, int));
63
64static void init_signals PARAMS ((void));
65
66#ifdef STOP_SIGNAL
67static void stop_sig PARAMS ((int));
68#endif
69
70static void disconnect PARAMS ((int));
71
9ed8604f
PS
72static char * line_completion_function PARAMS ((char *, int, char *, int));
73
74static char * readline_line_completion_function PARAMS ((char *, int));
172559ec 75
e52bfe0c 76static void command_loop_marker PARAMS ((int));
172559ec 77
e52bfe0c 78static void while_command PARAMS ((char *, int));
172559ec 79
e52bfe0c 80static void if_command PARAMS ((char *, int));
172559ec 81
e52bfe0c
JL
82static struct command_line *
83build_command_line PARAMS ((enum command_control_type, char *));
172559ec 84
e52bfe0c
JL
85static struct command_line *
86get_command_line PARAMS ((enum command_control_type, char *));
172559ec 87
e52bfe0c 88static void realloc_body_list PARAMS ((struct command_line *, int));
172559ec 89
e52bfe0c 90static enum misc_command_type read_next_line PARAMS ((struct command_line **));
172559ec 91
e52bfe0c
JL
92static enum command_control_type
93recurse_read_control_structure PARAMS ((struct command_line *));
172559ec 94
0f8cdd9b
JL
95static struct cleanup * setup_user_args PARAMS ((char *));
96
97static char * locate_arg PARAMS ((char *));
98
99static char * insert_args PARAMS ((char *));
100
101static void arg_cleanup PARAMS ((void));
102
e52bfe0c 103static void init_main PARAMS ((void));
172559ec 104
e52bfe0c 105static void init_cmd_lists PARAMS ((void));
172559ec 106
e52bfe0c 107static void float_handler PARAMS ((int));
172559ec 108
e52bfe0c 109static void init_signals PARAMS ((void));
172559ec 110
e52bfe0c 111static void set_verbose PARAMS ((char *, int, struct cmd_list_element *));
172559ec 112
b8176214
ILT
113#ifdef TARGET_BYTE_ORDER_SELECTABLE
114
115static void set_endian PARAMS ((char *, int));
116
117static void set_endian_big PARAMS ((char *, int));
118
119static void set_endian_little PARAMS ((char *, int));
120
b83ed019
ILT
121static void set_endian_auto PARAMS ((char *, int));
122
b8176214
ILT
123static void show_endian PARAMS ((char *, int));
124
125#endif
126
e52bfe0c 127static void show_history PARAMS ((char *, int));
172559ec 128
e52bfe0c 129static void set_history PARAMS ((char *, int));
172559ec 130
e52bfe0c
JL
131static void set_history_size_command PARAMS ((char *, int,
132 struct cmd_list_element *));
172559ec 133
e52bfe0c 134static void show_commands PARAMS ((char *, int));
172559ec 135
e52bfe0c 136static void echo_command PARAMS ((char *, int));
172559ec 137
e52bfe0c 138static void pwd_command PARAMS ((char *, int));
172559ec 139
e52bfe0c 140static void show_version PARAMS ((char *, int));
172559ec 141
e52bfe0c 142static void document_command PARAMS ((char *, int));
172559ec 143
e52bfe0c 144static void define_command PARAMS ((char *, int));
172559ec 145
e52bfe0c
JL
146static void validate_comname PARAMS ((char *));
147
148static void help_command PARAMS ((char *, int));
149
150static void show_command PARAMS ((char *, int));
151
152static void info_command PARAMS ((char *, int));
153
154static void complete_command PARAMS ((char *, int));
155
156static void do_nothing PARAMS ((int));
157
158static int quit_cover PARAMS ((char *));
159
160static void disconnect PARAMS ((int));
161
162static void source_cleanup PARAMS ((FILE *));
172559ec
JK
163
164/* If this definition isn't overridden by the header files, assume
165 that isatty and fileno exist on this system. */
166#ifndef ISATTY
167#define ISATTY(FP) (isatty (fileno (FP)))
168#endif
169
170/* Initialization file name for gdb. This is overridden in some configs. */
171
172#ifndef GDBINIT_FILENAME
173#define GDBINIT_FILENAME ".gdbinit"
174#endif
175char gdbinit[] = GDBINIT_FILENAME;
f22661ee 176
172559ec
JK
177int inhibit_gdbinit = 0;
178
f22661ee
SS
179/* If nonzero, and GDB has been configured to be able to use windows,
180 attempt to open them upon startup. */
754e5da2 181
f22661ee 182int use_windows = 1;
754e5da2 183
172559ec
JK
184/* Version number of GDB, as a string. */
185
186extern char *version;
187
188/* Canonical host name as a string. */
189
190extern char *host_name;
191
192/* Canonical target name as a string. */
193
194extern char *target_name;
195
196extern char lang_frame_mismatch_warn[]; /* language.c */
197
198/* Flag for whether we want all the "from_tty" gubbish printed. */
199
200int caution = 1; /* Default is yes, sigh. */
201
f22661ee 202/* Define all cmd_list_elements. */
172559ec
JK
203
204/* Chain containing all defined commands. */
205
206struct cmd_list_element *cmdlist;
207
208/* Chain containing all defined info subcommands. */
209
210struct cmd_list_element *infolist;
211
212/* Chain containing all defined enable subcommands. */
213
214struct cmd_list_element *enablelist;
215
216/* Chain containing all defined disable subcommands. */
217
218struct cmd_list_element *disablelist;
219
220/* Chain containing all defined delete subcommands. */
221
222struct cmd_list_element *deletelist;
223
224/* Chain containing all defined "enable breakpoint" subcommands. */
225
226struct cmd_list_element *enablebreaklist;
227
228/* Chain containing all defined set subcommands */
229
230struct cmd_list_element *setlist;
231
232/* Chain containing all defined unset subcommands */
233
234struct cmd_list_element *unsetlist;
235
236/* Chain containing all defined show subcommands. */
237
238struct cmd_list_element *showlist;
239
b8176214
ILT
240#ifdef TARGET_BYTE_ORDER_SELECTABLE
241/* Chain containing the \"set endian\" commands. */
242
243struct cmd_list_element *endianlist;
244#endif
245
172559ec
JK
246/* Chain containing all defined \"set history\". */
247
248struct cmd_list_element *sethistlist;
249
250/* Chain containing all defined \"show history\". */
251
252struct cmd_list_element *showhistlist;
253
254/* Chain containing all defined \"unset history\". */
255
256struct cmd_list_element *unsethistlist;
257
258/* Chain containing all defined maintenance subcommands. */
259
260#if MAINTENANCE_CMDS
261struct cmd_list_element *maintenancelist;
262#endif
263
264/* Chain containing all defined "maintenance info" subcommands. */
265
266#if MAINTENANCE_CMDS
267struct cmd_list_element *maintenanceinfolist;
268#endif
269
270/* Chain containing all defined "maintenance print" subcommands. */
271
272#if MAINTENANCE_CMDS
273struct cmd_list_element *maintenanceprintlist;
274#endif
275
276struct cmd_list_element *setprintlist;
277
278struct cmd_list_element *showprintlist;
279
280struct cmd_list_element *setchecklist;
281
282struct cmd_list_element *showchecklist;
283
284/* stdio stream that command input is being read from. Set to stdin normally.
285 Set by source_command to the file we are sourcing. Set to NULL if we are
41756e56 286 executing a user-defined command or interacting via a GUI. */
172559ec
JK
287
288FILE *instream;
289
290/* Current working directory. */
291
292char *current_directory;
293
294/* The directory name is actually stored here (usually). */
b7ec5b8d 295char gdb_dirbuf[1024];
172559ec
JK
296
297/* Function to call before reading a command, if nonzero.
298 The function receives two args: an input stream,
299 and a prompt string. */
300
301void (*window_hook) PARAMS ((FILE *, char *));
302
303int epoch_interface;
304int xgdb_verbose;
305
306/* gdb prints this when reading a command interactively */
307static char *prompt;
308
309/* Buffer used for reading command lines, and the size
310 allocated for it so far. */
311
312char *line;
313int linesize = 100;
314
315/* Nonzero if the current command is modified by "server ". This
316 affects things like recording into the command history, comamnds
317 repeating on RETURN, etc. This is so a user interface (emacs, GUI,
318 whatever) can issue its own commands and also send along commands
319 from the user, and have the user not notice that the user interface
320 is issuing commands too. */
321int server_command;
322
323/* Baud rate specified for talking to serial target systems. Default
324 is left as -1, so targets can choose their own defaults. */
325/* FIXME: This means that "show remotebaud" and gr_files_info can print -1
326 or (unsigned int)-1. This is a Bad User Interface. */
327
328int baud_rate = -1;
329
cb1709ae
DP
330/* Timeout limit for response from target. */
331
332int remote_timeout = 20; /* Set default to 20 */
333
172559ec
JK
334/* Non-zero tells remote* modules to output debugging info. */
335
336int remote_debug = 0;
337
e52bfe0c
JL
338/* Level of control structure. */
339static int control_level;
340
0f8cdd9b
JL
341/* Structure for arguments to user defined functions. */
342#define MAXUSERARGS 10
343struct user_args
344{
345 struct user_args *next;
346 struct
347 {
348 char *arg;
349 int len;
350 } a[MAXUSERARGS];
351 int count;
352} *user_args;
353
172559ec
JK
354/* Signal to catch ^Z typed while reading a command: SIGTSTP or SIGCONT. */
355
356#ifndef STOP_SIGNAL
357#ifdef SIGTSTP
358#define STOP_SIGNAL SIGTSTP
359static void stop_sig PARAMS ((int));
360#endif
361#endif
362
363/* Some System V have job control but not sigsetmask(). */
364#if !defined (HAVE_SIGSETMASK)
365#if !defined (USG)
366#define HAVE_SIGSETMASK 1
367#else
368#define HAVE_SIGSETMASK 0
369#endif
370#endif
371
372#if 0 == (HAVE_SIGSETMASK)
373#define sigsetmask(n)
374#endif
8164ec2e
SG
375
376/* Hooks for alternate command interfaces. */
377
378/* Called after most modules have been initialized, but before taking users
379 command file. */
380
381void (*init_ui_hook) PARAMS ((void));
382
383/* Called instead of command_loop at top level. Can be invoked via
384 return_to_top_level. */
385
386void (*command_loop_hook) PARAMS ((void));
387
764efb58 388
8164ec2e
SG
389/* Called instead of fputs for all output. */
390
86db943c 391void (*fputs_unfiltered_hook) PARAMS ((const char *linebuffer, FILE *stream));
8164ec2e 392
764efb58
SC
393/* Called when the target says something to the host, which may
394 want to appear in a different window. */
395
327332d8 396void (*target_output_hook) PARAMS ((char *));
764efb58 397
8164ec2e
SG
398/* Called from print_frame_info to list the line we stopped in. */
399
400void (*print_frame_info_listing_hook) PARAMS ((struct symtab *s, int line,
401 int stopline, int noerror));
402/* Replaces most of query. */
403
b607efe7 404int (*query_hook) PARAMS ((const char *, va_list));
8164ec2e
SG
405
406/* Called from gdb_flush to flush output. */
407
408void (*flush_hook) PARAMS ((FILE *stream));
409
41756e56
FF
410/* These three functions support getting lines of text from the user. They
411 are used in sequence. First readline_begin_hook is called with a text
412 string that might be (for example) a message for the user to type in a
413 sequence of commands to be executed at a breakpoint. If this function
414 calls back to a GUI, it might take this opportunity to pop up a text
415 interaction window with this message. Next, readline_hook is called
416 with a prompt that is emitted prior to collecting the user input.
417 It can be called multiple times. Finally, readline_end_hook is called
418 to notify the GUI that we are done with the interaction window and it
419 can close it. */
420
421void (*readline_begin_hook) PARAMS ((char *, ...));
422char * (*readline_hook) PARAMS ((char *));
423void (*readline_end_hook) PARAMS ((void));
424
8164ec2e
SG
425/* Called as appropriate to notify the interface of the specified breakpoint
426 conditions. */
427
637b1661 428void (*create_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
8164ec2e 429void (*delete_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
6131622e 430void (*modify_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
637b1661
SG
431
432/* Called during long calculations to allow GUI to repair window damage, and to
433 check for stop buttons, etc... */
434
435void (*interactive_hook) PARAMS ((void));
436
16041d53
SC
437/* Called when the registers have changed, as a hint to a GUI
438 to minimize window update. */
439
440void (*registers_changed_hook) PARAMS ((void));
441
479f0f18
SG
442/* Called when going to wait for the target. Usually allows the GUI to run
443 while waiting for target events. */
444
445int (*target_wait_hook) PARAMS ((int pid, struct target_waitstatus *status));
446
447/* Used by UI as a wrapper around command execution. May do various things
448 like enabling/disabling buttons, etc... */
449
450void (*call_command_hook) PARAMS ((struct cmd_list_element *c, char *cmd,
451 int from_tty));
45993f61
SC
452
453
454/* Takes control from error (). Typically used to prevent longjmps out of the
455 middle of the GUI. Usually used in conjunction with a catch routine. */
456
b607efe7 457NORETURN void (*error_hook) PARAMS ((void)) ATTR_NORETURN;
45993f61 458
172559ec
JK
459\f
460/* Where to go for return_to_top_level (RETURN_ERROR). */
461jmp_buf error_return;
462/* Where to go for return_to_top_level (RETURN_QUIT). */
463jmp_buf quit_return;
464
465/* Return for reason REASON. This generally gets back to the command
466 loop, but can be caught via catch_errors. */
467
468NORETURN void
469return_to_top_level (reason)
470 enum return_reason reason;
471{
472 quit_flag = 0;
473 immediate_quit = 0;
474
475 /* Perhaps it would be cleaner to do this via the cleanup chain (not sure
476 I can think of a reason why that is vital, though). */
477 bpstat_clear_actions(stop_bpstat); /* Clear queued breakpoint commands */
478
479 disable_current_display ();
480 do_cleanups (ALL_CLEANUPS);
481
482 if (annotation_level > 1)
483 switch (reason)
484 {
485 case RETURN_QUIT:
486 annotate_quit ();
487 break;
488 case RETURN_ERROR:
489 annotate_error ();
490 break;
491 }
492
493 (NORETURN void) longjmp
494 (reason == RETURN_ERROR ? error_return : quit_return, 1);
495}
496
497/* Call FUNC with arg ARGS, catching any errors. If there is no
498 error, return the value returned by FUNC. If there is an error,
499 print ERRSTRING, print the specific error message, then return
500 zero.
501
502 Must not be called with immediate_quit in effect (bad things might
503 happen, say we got a signal in the middle of a memcpy to quit_return).
504 This is an OK restriction; with very few exceptions immediate_quit can
505 be replaced by judicious use of QUIT.
506
507 MASK specifies what to catch; it is normally set to
508 RETURN_MASK_ALL, if for no other reason than that the code which
509 calls catch_errors might not be set up to deal with a quit which
510 isn't caught. But if the code can deal with it, it generally
511 should be RETURN_MASK_ERROR, unless for some reason it is more
512 useful to abort only the portion of the operation inside the
513 catch_errors. Note that quit should return to the command line
514 fairly quickly, even if some further processing is being done. */
515
516int
517catch_errors (func, args, errstring, mask)
518 int (*func) PARAMS ((char *));
519 PTR args;
520 char *errstring;
521 return_mask mask;
522{
523 jmp_buf saved_error;
524 jmp_buf saved_quit;
525 jmp_buf tmp_jmp;
526 int val;
527 struct cleanup *saved_cleanup_chain;
528 char *saved_error_pre_print;
dee80384 529 char *saved_quit_pre_print;
172559ec
JK
530
531 saved_cleanup_chain = save_cleanups ();
532 saved_error_pre_print = error_pre_print;
dee80384 533 saved_quit_pre_print = quit_pre_print;
172559ec
JK
534
535 if (mask & RETURN_MASK_ERROR)
dee80384
JK
536 {
537 memcpy ((char *)saved_error, (char *)error_return, sizeof (jmp_buf));
538 error_pre_print = errstring;
539 }
172559ec 540 if (mask & RETURN_MASK_QUIT)
dee80384
JK
541 {
542 memcpy (saved_quit, quit_return, sizeof (jmp_buf));
543 quit_pre_print = errstring;
544 }
172559ec
JK
545
546 if (setjmp (tmp_jmp) == 0)
547 {
548 if (mask & RETURN_MASK_ERROR)
549 memcpy (error_return, tmp_jmp, sizeof (jmp_buf));
550 if (mask & RETURN_MASK_QUIT)
551 memcpy (quit_return, tmp_jmp, sizeof (jmp_buf));
552 val = (*func) (args);
553 }
554 else
555 val = 0;
556
557 restore_cleanups (saved_cleanup_chain);
558
172559ec 559 if (mask & RETURN_MASK_ERROR)
dee80384
JK
560 {
561 memcpy (error_return, saved_error, sizeof (jmp_buf));
562 error_pre_print = saved_error_pre_print;
563 }
172559ec 564 if (mask & RETURN_MASK_QUIT)
dee80384
JK
565 {
566 memcpy (quit_return, saved_quit, sizeof (jmp_buf));
567 quit_pre_print = saved_quit_pre_print;
568 }
172559ec
JK
569 return val;
570}
571
572/* Handler for SIGHUP. */
573
574static void
575disconnect (signo)
576int signo;
577{
578 catch_errors (quit_cover, NULL,
579 "Could not kill the program being debugged", RETURN_MASK_ALL);
580 signal (SIGHUP, SIG_DFL);
581 kill (getpid (), SIGHUP);
582}
583
584/* Just a little helper function for disconnect(). */
585
586static int
587quit_cover (s)
588char *s;
589{
590 caution = 0; /* Throw caution to the wind -- we're exiting.
591 This prevents asking the user dumb questions. */
592 quit_command((char *)0, 0);
593 return 0;
594}
595\f
596/* Line number we are currently in in a file which is being sourced. */
597static int source_line_number;
598
599/* Name of the file we are sourcing. */
600static char *source_file_name;
601
602/* Buffer containing the error_pre_print used by the source stuff.
603 Malloc'd. */
604static char *source_error;
605static int source_error_allocated;
606
607/* Something to glom on to the start of error_pre_print if source_file_name
608 is set. */
609static char *source_pre_error;
610
611/* Clean up on error during a "source" command (or execution of a
612 user-defined command). */
613
614static void
615source_cleanup (stream)
616 FILE *stream;
617{
618 /* Restore the previous input stream. */
619 instream = stream;
620}
621
622/* Read commands from STREAM. */
623void
624read_command_file (stream)
625 FILE *stream;
626{
627 struct cleanup *cleanups;
628
629 cleanups = make_cleanup (source_cleanup, instream);
630 instream = stream;
631 command_loop ();
632 do_cleanups (cleanups);
633}
634\f
b607efe7 635extern void init_proc PARAMS ((void));
172559ec 636
43ab4ba5
SS
637void (*pre_init_ui_hook) PARAMS ((void));
638
172559ec
JK
639void
640gdb_init ()
641{
43ab4ba5
SS
642 if (pre_init_ui_hook)
643 pre_init_ui_hook ();
644
172559ec
JK
645 /* Run the init function of each source file */
646
b7ec5b8d
FF
647 getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
648 current_directory = gdb_dirbuf;
f36b58b1 649
172559ec 650 init_cmd_lists (); /* This needs to be done first */
754e5da2
SG
651 initialize_targets (); /* Setup target_terminal macros for utils.c */
652 initialize_utils (); /* Make errors and warnings possible */
172559ec
JK
653 initialize_all_files ();
654 init_main (); /* But that omits this file! Do it now */
655 init_signals ();
656
657 init_proc ();
658
659 /* We need a default language for parsing expressions, so simple things like
660 "set width 0" won't fail if no language is explicitly set in a config file
661 or implicitly set by reading an executable during startup. */
662 set_language (language_c);
663 expected_language = current_language; /* don't warn about the change. */
754e5da2
SG
664
665 if (init_ui_hook)
666 init_ui_hook ();
172559ec
JK
667}
668
e52bfe0c
JL
669/* Allocate, initialize a new command line structure for one of the
670 control commands (if/while). */
671
672static struct command_line *
673build_command_line (type, args)
674 enum command_control_type type;
675 char *args;
676{
677 struct command_line *cmd;
678
a25ffb08
JL
679 if (args == NULL)
680 error ("if/while commands require arguments.\n");
681
e52bfe0c
JL
682 cmd = (struct command_line *)xmalloc (sizeof (struct command_line));
683 cmd->next = NULL;
684 cmd->control_type = type;
685
686 cmd->body_count = 1;
687 cmd->body_list
688 = (struct command_line **)xmalloc (sizeof (struct command_line *)
689 * cmd->body_count);
690 memset (cmd->body_list, 0, sizeof (struct command_line *) * cmd->body_count);
691 cmd->line = savestring (args, strlen (args));
692 return cmd;
693}
694
695/* Build and return a new command structure for the control commands
696 such as "if" and "while". */
697
698static struct command_line *
699get_command_line (type, arg)
700 enum command_control_type type;
701 char *arg;
702{
703 struct command_line *cmd;
704 struct cleanup *old_chain = NULL;
705
706 /* Allocate and build a new command line structure. */
707 cmd = build_command_line (type, arg);
708
709 old_chain = make_cleanup (free_command_lines, &cmd);
710
711 /* Read in the body of this command. */
712 if (recurse_read_control_structure (cmd) == invalid_control)
713 {
714 warning ("error reading in control structure\n");
715 do_cleanups (old_chain);
716 return NULL;
717 }
718
719 discard_cleanups (old_chain);
720 return cmd;
721}
722
0f8cdd9b
JL
723/* Recursively print a command (including full control structures). */
724void
725print_command_line (cmd, depth)
726 struct command_line *cmd;
727 unsigned int depth;
728{
729 unsigned int i;
730
731 if (depth)
732 {
733 for (i = 0; i < depth; i++)
734 fputs_filtered (" ", gdb_stdout);
735 }
736
737 /* A simple command, print it and return. */
738 if (cmd->control_type == simple_control)
739 {
740 fputs_filtered (cmd->line, gdb_stdout);
741 fputs_filtered ("\n", gdb_stdout);
742 return;
743 }
744
745 /* loop_continue to jump to the start of a while loop, print it
746 and return. */
747 if (cmd->control_type == continue_control)
748 {
749 fputs_filtered ("loop_continue\n", gdb_stdout);
750 return;
751 }
752
753 /* loop_break to break out of a while loop, print it and return. */
754 if (cmd->control_type == break_control)
755 {
756 fputs_filtered ("loop_break\n", gdb_stdout);
757 return;
758 }
759
760 /* A while command. Recursively print its subcommands before returning. */
761 if (cmd->control_type == while_control)
762 {
763 struct command_line *list;
764 fputs_filtered ("while ", gdb_stdout);
765 fputs_filtered (cmd->line, gdb_stdout);
766 fputs_filtered ("\n", gdb_stdout);
767 list = *cmd->body_list;
768 while (list)
769 {
770 print_command_line (list, depth + 1);
771 list = list->next;
772 }
773 }
774
775 /* An if command. Recursively print both arms before returning. */
776 if (cmd->control_type == if_control)
777 {
778 fputs_filtered ("if ", gdb_stdout);
779 fputs_filtered (cmd->line, gdb_stdout);
780 fputs_filtered ("\n", gdb_stdout);
781 /* The true arm. */
782 print_command_line (cmd->body_list[0], depth + 1);
783
784 /* Show the false arm if it exists. */
785 if (cmd->body_count == 2)
786 {
787 if (depth)
788 {
789 for (i = 0; i < depth; i++)
790 fputs_filtered (" ", gdb_stdout);
791 }
792 fputs_filtered ("else\n", gdb_stdout);
793 print_command_line (cmd->body_list[1], depth + 1);
794 }
795 if (depth)
796 {
797 for (i = 0; i < depth; i++)
798 fputs_filtered (" ", gdb_stdout);
799 }
800 fputs_filtered ("end\n", gdb_stdout);
801 }
802}
803
e52bfe0c
JL
804/* Execute the command in CMD. */
805
0f8cdd9b 806enum command_control_type
e52bfe0c
JL
807execute_control_command (cmd)
808 struct command_line *cmd;
809{
810 struct expression *expr;
811 struct command_line *current;
812 struct cleanup *old_chain = 0;
e52bfe0c 813 value_ptr val;
e20c36ba 814 value_ptr val_mark;
e52bfe0c
JL
815 int loop;
816 enum command_control_type ret;
0f8cdd9b 817 char *new_line;
e52bfe0c
JL
818
819 switch (cmd->control_type)
820 {
821 case simple_control:
822 /* A simple command, execute it and return. */
0f8cdd9b
JL
823 new_line = insert_args (cmd->line);
824 if (!new_line)
825 return invalid_control;
826 old_chain = make_cleanup (free_current_contents, &new_line);
827 execute_command (new_line, 0);
828 ret = cmd->control_type;
829 break;
e52bfe0c
JL
830
831 case continue_control:
832 case break_control:
833 /* Return for "continue", and "break" so we can either
834 continue the loop at the top, or break out. */
0f8cdd9b
JL
835 ret = cmd->control_type;
836 break;
e52bfe0c
JL
837
838 case while_control:
839 {
840 /* Parse the loop control expression for the while statement. */
0f8cdd9b
JL
841 new_line = insert_args (cmd->line);
842 if (!new_line)
843 return invalid_control;
844 old_chain = make_cleanup (free_current_contents, &new_line);
845 expr = parse_expression (new_line);
846 make_cleanup (free_current_contents, &expr);
847
e52bfe0c 848 ret = simple_control;
b5776522 849 loop = 1;
e52bfe0c
JL
850
851 /* Keep iterating so long as the expression is true. */
b5776522 852 while (loop == 1)
e52bfe0c 853 {
e20c36ba
JL
854 int cond_result;
855
24ecc17a
JL
856 QUIT;
857
e52bfe0c 858 /* Evaluate the expression. */
e20c36ba 859 val_mark = value_mark ();
e52bfe0c 860 val = evaluate_expression (expr);
e20c36ba
JL
861 cond_result = value_true (val);
862 value_free_to_mark (val_mark);
e52bfe0c
JL
863
864 /* If the value is false, then break out of the loop. */
e20c36ba 865 if (!cond_result)
e52bfe0c
JL
866 break;
867
868 /* Execute the body of the while statement. */
869 current = *cmd->body_list;
870 while (current)
871 {
872 ret = execute_control_command (current);
873
874 /* If we got an error, or a "break" command, then stop
875 looping. */
876 if (ret == invalid_control || ret == break_control)
877 {
b5776522 878 loop = 0;
e52bfe0c
JL
879 break;
880 }
881
882 /* If we got a "continue" command, then restart the loop
883 at this point. */
884 if (ret == continue_control)
885 break;
886
887 /* Get the next statement. */
888 current = current->next;
889 }
890 }
891
892 /* Reset RET so that we don't recurse the break all the way down. */
893 if (ret == break_control)
894 ret = simple_control;
895
896 break;
897 }
898
899 case if_control:
900 {
0f8cdd9b
JL
901 new_line = insert_args (cmd->line);
902 if (!new_line)
903 return invalid_control;
904 old_chain = make_cleanup (free_current_contents, &new_line);
e52bfe0c 905 /* Parse the conditional for the if statement. */
0f8cdd9b
JL
906 expr = parse_expression (new_line);
907 make_cleanup (free_current_contents, &expr);
e52bfe0c
JL
908
909 current = NULL;
910 ret = simple_control;
911
912 /* Evaluate the conditional. */
e20c36ba 913 val_mark = value_mark ();
e52bfe0c
JL
914 val = evaluate_expression (expr);
915
916 /* Choose which arm to take commands from based on the value of the
917 conditional expression. */
918 if (value_true (val))
919 current = *cmd->body_list;
920 else if (cmd->body_count == 2)
921 current = *(cmd->body_list + 1);
e20c36ba 922 value_free_to_mark (val_mark);
e52bfe0c
JL
923
924 /* Execute commands in the given arm. */
925 while (current)
926 {
927 ret = execute_control_command (current);
928
929 /* If we got an error, get out. */
930 if (ret != simple_control)
931 break;
932
933 /* Get the next statement in the body. */
934 current = current->next;
935 }
0f8cdd9b 936
e52bfe0c
JL
937 break;
938 }
939
940 default:
941 warning ("Invalid control type in command structure.");
942 return invalid_control;
943 }
944
945 if (old_chain)
946 do_cleanups (old_chain);
947
948 return ret;
949}
950
951/* "while" command support. Executes a body of statements while the
952 loop condition is nonzero. */
953
954static void
955while_command (arg, from_tty)
956 char *arg;
957 int from_tty;
958{
959 struct command_line *command = NULL;
960
961 control_level = 1;
962 command = get_command_line (while_control, arg);
963
964 if (command == NULL)
965 return;
966
967 execute_control_command (command);
968 free_command_lines (&command);
969}
970
971/* "if" command support. Execute either the true or false arm depending
972 on the value of the if conditional. */
973
974static void
975if_command (arg, from_tty)
976 char *arg;
977 int from_tty;
978{
979 struct command_line *command = NULL;
980
981 control_level = 1;
982 command = get_command_line (if_control, arg);
983
984 if (command == NULL)
985 return;
986
987 execute_control_command (command);
988 free_command_lines (&command);
989}
990
0f8cdd9b
JL
991/* Cleanup */
992static void
993arg_cleanup ()
994{
995 struct user_args *oargs = user_args;
996 if (!user_args)
997 fatal ("Internal error, arg_cleanup called with no user args.\n");
998
999 user_args = user_args->next;
1000 free (oargs);
1001}
1002
1003/* Bind the incomming arguments for a user defined command to
1004 $arg0, $arg1 ... $argMAXUSERARGS. */
1005
1006static struct cleanup *
1007setup_user_args (p)
1008 char *p;
1009{
1010 struct user_args *args;
1011 struct cleanup *old_chain;
1012 unsigned int arg_count = 0;
1013
1014 args = (struct user_args *)xmalloc (sizeof (struct user_args));
1015 memset (args, 0, sizeof (struct user_args));
1016
1017 args->next = user_args;
1018 user_args = args;
1019
1020 old_chain = make_cleanup (arg_cleanup, 0);
1021
1022 if (p == NULL)
1023 return old_chain;
1024
1025 while (*p)
1026 {
1027 char *start_arg;
1028
1029 if (arg_count >= MAXUSERARGS)
1030 {
1031 error ("user defined function may only have %d arguments.\n",
1032 MAXUSERARGS);
1033 return old_chain;
1034 }
1035
1036 /* Strip whitespace. */
1037 while (*p == ' ' || *p == '\t')
1038 p++;
1039
1040 /* P now points to an argument. */
1041 start_arg = p;
1042 user_args->a[arg_count].arg = p;
1043
1044 /* Get to the end of this argument. */
1045 while (*p && *p != ' ' && *p != '\t')
1046 p++;
1047
1048 user_args->a[arg_count].len = p - start_arg;
1049 arg_count++;
1050 user_args->count++;
1051 }
1052 return old_chain;
1053}
1054
1055/* Given character string P, return a point to the first argument ($arg),
1056 or NULL if P contains no arguments. */
1057
1058static char *
1059locate_arg (p)
1060 char *p;
1061{
e3be225e 1062 while ((p = strchr (p, '$')))
0f8cdd9b
JL
1063 {
1064 if (strncmp (p, "$arg", 4) == 0 && isdigit (p[4]))
1065 return p;
1066 p++;
1067 }
1068 return NULL;
1069}
1070
1071/* Insert the user defined arguments stored in user_arg into the $arg
1072 arguments found in line, with the updated copy being placed into nline. */
1073
1074static char *
1075insert_args (line)
1076 char *line;
1077{
1078 char *p, *save_line, *new_line;
1079 unsigned len, i;
1080
1081 /* First we need to know how much memory to allocate for the new line. */
1082 save_line = line;
1083 len = 0;
e3be225e 1084 while ((p = locate_arg (line)))
0f8cdd9b
JL
1085 {
1086 len += p - line;
1087 i = p[4] - '0';
1088
1089 if (i >= user_args->count)
1090 {
1091 error ("Missing argument %d in user function.\n", i);
1092 return NULL;
1093 }
1094 len += user_args->a[i].len;
1095 line = p + 5;
1096 }
1097
1098 /* Don't forget the tail. */
1099 len += strlen (line);
1100
1101 /* Allocate space for the new line and fill it in. */
1102 new_line = (char *)xmalloc (len + 1);
1103 if (new_line == NULL)
1104 return NULL;
1105
1106 /* Restore pointer to beginning of old line. */
1107 line = save_line;
1108
1109 /* Save pointer to beginning of new line. */
1110 save_line = new_line;
1111
e3be225e 1112 while ((p = locate_arg (line)))
0f8cdd9b
JL
1113 {
1114 int i, len;
1115
1116 memcpy (new_line, line, p - line);
1117 new_line += p - line;
1118 i = p[4] - '0';
1119
e3be225e
SS
1120 len = user_args->a[i].len;
1121 if (len)
0f8cdd9b
JL
1122 {
1123 memcpy (new_line, user_args->a[i].arg, len);
1124 new_line += len;
1125 }
1126 line = p + 5;
1127 }
1128 /* Don't forget the tail. */
1129 strcpy (new_line, line);
1130
1131 /* Return a pointer to the beginning of the new line. */
1132 return save_line;
1133}
1134
172559ec
JK
1135void
1136execute_user_command (c, args)
1137 struct cmd_list_element *c;
1138 char *args;
1139{
1140 register struct command_line *cmdlines;
1141 struct cleanup *old_chain;
e52bfe0c
JL
1142 enum command_control_type ret;
1143
0f8cdd9b 1144 old_chain = setup_user_args (args);
172559ec
JK
1145
1146 cmdlines = c->user_commands;
1147 if (cmdlines == 0)
1148 /* Null command */
1149 return;
1150
1151 /* Set the instream to 0, indicating execution of a
1152 user-defined function. */
1153 old_chain = make_cleanup (source_cleanup, instream);
1154 instream = (FILE *) 0;
1155 while (cmdlines)
1156 {
e52bfe0c
JL
1157 ret = execute_control_command (cmdlines);
1158 if (ret != simple_control && ret != break_control)
1159 {
1160 warning ("Error in control structure.\n");
1161 break;
1162 }
172559ec
JK
1163 cmdlines = cmdlines->next;
1164 }
1165 do_cleanups (old_chain);
1166}
1167
1168/* Execute the line P as a command.
1169 Pass FROM_TTY as second argument to the defining function. */
1170
1171void
1172execute_command (p, from_tty)
1173 char *p;
1174 int from_tty;
1175{
1176 register struct cmd_list_element *c;
1177 register enum language flang;
1178 static int warned = 0;
b607efe7 1179 /* FIXME: These should really be in an appropriate header file */
b607efe7 1180 extern void serial_log_command PARAMS ((const char *));
172559ec
JK
1181
1182 free_all_values ();
1183
1184 /* This can happen when command_line_input hits end of file. */
1185 if (p == NULL)
1186 return;
e52bfe0c 1187
d9951af4 1188 serial_log_command (p);
e8f1ad9a 1189
172559ec
JK
1190 while (*p == ' ' || *p == '\t') p++;
1191 if (*p)
1192 {
1193 char *arg;
e52bfe0c 1194
172559ec
JK
1195 c = lookup_cmd (&p, cmdlist, "", 0, 1);
1196 /* Pass null arg rather than an empty one. */
1197 arg = *p ? p : 0;
1198
080868b4
PS
1199 /* Clear off trailing whitespace, except for set and complete command. */
1200 if (arg && c->type != set_cmd && c->function.cfunc != complete_command)
1201 {
1202 p = arg + strlen (arg) - 1;
1203 while (p >= arg && (*p == ' ' || *p == '\t'))
1204 p--;
1205 *(p + 1) = '\0';
1206 }
1207
172559ec
JK
1208 /* If this command has been hooked, run the hook first. */
1209 if (c->hook)
1210 execute_user_command (c->hook, (char *)0);
1211
1212 if (c->class == class_user)
1213 execute_user_command (c, arg);
1214 else if (c->type == set_cmd || c->type == show_cmd)
1215 do_setshow_command (arg, from_tty & caution, c);
1216 else if (c->function.cfunc == NO_FUNCTION)
1217 error ("That is not a command, just a help topic.");
479f0f18
SG
1218 else if (call_command_hook)
1219 call_command_hook (c, arg, from_tty & caution);
172559ec
JK
1220 else
1221 (*c->function.cfunc) (arg, from_tty & caution);
1222 }
1223
1224 /* Tell the user if the language has changed (except first time). */
1225 if (current_language != expected_language)
1226 {
1227 if (language_mode == language_mode_auto) {
1228 language_info (1); /* Print what changed. */
1229 }
1230 warned = 0;
1231 }
1232
1233 /* Warn the user if the working language does not match the
1234 language of the current frame. Only warn the user if we are
1235 actually running the program, i.e. there is a stack. */
1236 /* FIXME: This should be cacheing the frame and only running when
1237 the frame changes. */
43ab4ba5 1238
172559ec 1239 if (target_has_stack)
172559ec 1240 {
43ab4ba5
SS
1241 flang = get_frame_language ();
1242 if (!warned
1243 && flang != language_unknown
1244 && flang != current_language->la_language)
1245 {
1246 printf_filtered ("%s\n", lang_frame_mismatch_warn);
1247 warned = 1;
1248 }
172559ec 1249 }
172559ec
JK
1250}
1251
1252/* ARGSUSED */
1253static void
1254command_loop_marker (foo)
1255 int foo;
1256{
1257}
1258
1259/* Read commands from `instream' and execute them
1260 until end of file or error reading instream. */
43ab4ba5 1261
172559ec
JK
1262void
1263command_loop ()
1264{
1265 struct cleanup *old_chain;
1266 char *command;
1267 int stdin_is_tty = ISATTY (stdin);
43ab4ba5 1268 long time_at_cmd_start;
38d715a4 1269#ifdef HAVE_SBRK
83ebf439 1270 long space_at_cmd_start;
38d715a4 1271#endif
43ab4ba5
SS
1272 extern int display_time;
1273 extern int display_space;
172559ec 1274
41756e56 1275 while (instream && !feof (instream))
172559ec
JK
1276 {
1277 if (window_hook && instream == stdin)
1278 (*window_hook) (instream, prompt);
1279
1280 quit_flag = 0;
1281 if (instream == stdin && stdin_is_tty)
1282 reinitialize_more_filter ();
1283 old_chain = make_cleanup (command_loop_marker, 0);
1284 command = command_line_input (instream == stdin ? prompt : (char *) NULL,
1285 instream == stdin, "prompt");
1286 if (command == 0)
1287 return;
43ab4ba5
SS
1288
1289 time_at_cmd_start = get_run_time ();
1290
83ebf439
SS
1291 if (display_space)
1292 {
38d715a4 1293#ifdef HAVE_SBRK
83ebf439
SS
1294 extern char **environ;
1295 char *lim = (char *) sbrk (0);
1296
1297 space_at_cmd_start = (long) (lim - (char *) &environ);
38d715a4 1298#endif
83ebf439
SS
1299 }
1300
172559ec
JK
1301 execute_command (command, instream == stdin);
1302 /* Do any commands attached to breakpoint we stopped at. */
1303 bpstat_do_actions (&stop_bpstat);
1304 do_cleanups (old_chain);
43ab4ba5
SS
1305
1306 if (display_time)
1307 {
1308 long cmd_time = get_run_time () - time_at_cmd_start;
1309
1310 printf_unfiltered ("Command execution time: %ld.%06ld\n",
1311 cmd_time / 1000000, cmd_time % 1000000);
1312 }
1313
1314 if (display_space)
1315 {
38d715a4 1316#ifdef HAVE_SBRK
43ab4ba5
SS
1317 extern char **environ;
1318 char *lim = (char *) sbrk (0);
83ebf439
SS
1319 long space_now = lim - (char *) &environ;
1320 long space_diff = space_now - space_at_cmd_start;
43ab4ba5 1321
83ebf439
SS
1322 printf_unfiltered ("Space used: %ld (%c%ld for this command)\n",
1323 space_now,
1324 (space_diff >= 0 ? '+' : '-'),
1325 space_diff);
38d715a4 1326#endif
43ab4ba5 1327 }
172559ec
JK
1328 }
1329}
1330\f
1331/* Commands call this if they do not want to be repeated by null lines. */
1332
1333void
1334dont_repeat ()
1335{
1336 if (server_command)
1337 return;
1338
1339 /* If we aren't reading from standard input, we are saving the last
1340 thing read from stdin in line and don't want to delete it. Null lines
1341 won't repeat here in any case. */
1342 if (instream == stdin)
1343 *line = 0;
1344}
1345\f
1346/* Read a line from the stream "instream" without command line editing.
1347
1348 It prints PRROMPT once at the start.
e52bfe0c 1349 Action is compatible with "readline", e.g. space for the result is
172559ec
JK
1350 malloc'd and should be freed by the caller.
1351
1352 A NULL return means end of file. */
1353char *
1354gdb_readline (prrompt)
1355 char *prrompt;
1356{
1357 int c;
1358 char *result;
1359 int input_index = 0;
1360 int result_size = 80;
1361
1362 if (prrompt)
1363 {
1364 /* Don't use a _filtered function here. It causes the assumed
1365 character position to be off, since the newline we read from
1366 the user is not accounted for. */
1367 fputs_unfiltered (prrompt, gdb_stdout);
172559ec
JK
1368#ifdef MPW
1369 /* Move to a new line so the entered line doesn't have a prompt
1370 on the front of it. */
1371 fputs_unfiltered ("\n", gdb_stdout);
1372#endif /* MPW */
172559ec
JK
1373 gdb_flush (gdb_stdout);
1374 }
e52bfe0c 1375
172559ec
JK
1376 result = (char *) xmalloc (result_size);
1377
1378 while (1)
1379 {
1380 /* Read from stdin if we are executing a user defined command.
1381 This is the right thing for prompt_for_continue, at least. */
1382 c = fgetc (instream ? instream : stdin);
1383
1384 if (c == EOF)
1385 {
1386 if (input_index > 0)
1387 /* The last line does not end with a newline. Return it, and
1388 if we are called again fgetc will still return EOF and
1389 we'll return NULL then. */
1390 break;
1391 free (result);
1392 return NULL;
1393 }
1394
1395 if (c == '\n')
1396 break;
1397
1398 result[input_index++] = c;
1399 while (input_index >= result_size)
1400 {
1401 result_size *= 2;
1402 result = (char *) xrealloc (result, result_size);
1403 }
1404 }
1405
1406 result[input_index++] = '\0';
1407 return result;
1408}
1409
1410/* Variables which control command line editing and history
1411 substitution. These variables are given default values at the end
1412 of this file. */
1413static int command_editing_p;
1414static int history_expansion_p;
1415static int write_history_p;
1416static int history_size;
1417static char *history_filename;
1418
1419/* readline uses the word breaks for two things:
1420 (1) In figuring out where to point the TEXT parameter to the
1421 rl_completion_entry_function. Since we don't use TEXT for much,
1422 it doesn't matter a lot what the word breaks are for this purpose, but
1423 it does affect how much stuff M-? lists.
1424 (2) If one of the matches contains a word break character, readline
1425 will quote it. That's why we switch between
1426 gdb_completer_word_break_characters and
1427 gdb_completer_command_word_break_characters. I'm not sure when
1428 we need this behavior (perhaps for funky characters in C++ symbols?). */
1429
1430/* Variables which are necessary for fancy command line editing. */
1431char *gdb_completer_word_break_characters =
1432 " \t\n!@#$%^&*()+=|~`}{[]\"';:?/>.<,-";
1433
1434/* When completing on command names, we remove '-' from the list of
1435 word break characters, since we use it in command names. If the
1436 readline library sees one in any of the current completion strings,
1437 it thinks that the string needs to be quoted and automatically supplies
1438 a leading quote. */
1439char *gdb_completer_command_word_break_characters =
1440 " \t\n!@#$%^&*()+=|~`}{[]\"';:?/>.<,";
1441
1442/* Characters that can be used to quote completion strings. Note that we
1443 can't include '"' because the gdb C parser treats such quoted sequences
1444 as strings. */
1445char *gdb_completer_quote_characters =
1446 "'";
1447
1448/* Functions that are used as part of the fancy command line editing. */
1449
1450/* This can be used for functions which don't want to complete on symbols
1451 but don't want to complete on anything else either. */
1452/* ARGSUSED */
1453char **
1454noop_completer (text, prefix)
1455 char *text;
1456 char *prefix;
1457{
1458 return NULL;
1459}
1460
1461/* Complete on filenames. */
1462char **
1463filename_completer (text, word)
1464 char *text;
1465 char *word;
1466{
1467 /* From readline. */
3f550b59 1468 extern char *filename_completion_function PARAMS ((char *, int));
172559ec
JK
1469 int subsequent_name;
1470 char **return_val;
1471 int return_val_used;
1472 int return_val_alloced;
1473
1474 return_val_used = 0;
1475 /* Small for testing. */
1476 return_val_alloced = 1;
1477 return_val = (char **) xmalloc (return_val_alloced * sizeof (char *));
1478
1479 subsequent_name = 0;
1480 while (1)
1481 {
1482 char *p;
1483 p = filename_completion_function (text, subsequent_name);
1484 if (return_val_used >= return_val_alloced)
1485 {
1486 return_val_alloced *= 2;
1487 return_val =
1488 (char **) xrealloc (return_val,
1489 return_val_alloced * sizeof (char *));
1490 }
1491 if (p == NULL)
1492 {
1493 return_val[return_val_used++] = p;
1494 break;
1495 }
1496 /* Like emacs, don't complete on old versions. Especially useful
1497 in the "source" command. */
1498 if (p[strlen (p) - 1] == '~')
1499 continue;
1500
1501 {
1502 char *q;
1503 if (word == text)
1504 /* Return exactly p. */
1505 return_val[return_val_used++] = p;
1506 else if (word > text)
1507 {
1508 /* Return some portion of p. */
1509 q = xmalloc (strlen (p) + 5);
1510 strcpy (q, p + (word - text));
1511 return_val[return_val_used++] = q;
1512 free (p);
1513 }
1514 else
1515 {
1516 /* Return some of TEXT plus p. */
1517 q = xmalloc (strlen (p) + (text - word) + 5);
1518 strncpy (q, word, text - word);
1519 q[text - word] = '\0';
1520 strcat (q, p);
1521 return_val[return_val_used++] = q;
1522 free (p);
1523 }
1524 }
1525 subsequent_name = 1;
1526 }
1527#if 0
1528 /* There is no way to do this just long enough to affect quote inserting
1529 without also affecting the next completion. This should be fixed in
1530 readline. FIXME. */
1531 /* Insure that readline does the right thing
1532 with respect to inserting quotes. */
1533 rl_completer_word_break_characters = "";
1534#endif
1535 return return_val;
1536}
1537
1538/* Here are some useful test cases for completion. FIXME: These should
1539 be put in the test suite. They should be tested with both M-? and TAB.
1540
1541 "show output-" "radix"
1542 "show output" "-radix"
1543 "p" ambiguous (commands starting with p--path, print, printf, etc.)
1544 "p " ambiguous (all symbols)
1545 "info t foo" no completions
1546 "info t " no completions
1547 "info t" ambiguous ("info target", "info terminal", etc.)
1548 "info ajksdlfk" no completions
1549 "info ajksdlfk " no completions
1550 "info" " "
1551 "info " ambiguous (all info commands)
1552 "p \"a" no completions (string constant)
1553 "p 'a" ambiguous (all symbols starting with a)
1554 "p b-a" ambiguous (all symbols starting with a)
1555 "p b-" ambiguous (all symbols)
1556 "file Make" "file" (word break hard to screw up here)
1557 "file ../gdb.stabs/we" "ird" (needs to not break word at slash)
1558 */
1559
1560/* Generate completions one by one for the completer. Each time we are
9ed8604f
PS
1561 called return another potential completion to the caller.
1562 line_completion just completes on commands or passes the buck to the
1563 command's completer function, the stuff specific to symbol completion
172559ec
JK
1564 is in make_symbol_completion_list.
1565
9ed8604f 1566 TEXT is the caller's idea of the "word" we are looking at.
172559ec
JK
1567
1568 MATCHES is the number of matches that have currently been collected from
1569 calling this completion function. When zero, then we need to initialize,
1570 otherwise the initialization has already taken place and we can just
1571 return the next potential completion string.
1572
9ed8604f
PS
1573 LINE_BUFFER is available to be looked at; it contains the entire text
1574 of the line. POINT is the offset in that line of the cursor. You
1575 should pretend that the line ends at POINT.
172559ec 1576
9ed8604f
PS
1577 Returns NULL if there are no more completions, else a pointer to a string
1578 which is a possible completion, it is the caller's responsibility to
1579 free the string. */
172559ec
JK
1580
1581static char *
9ed8604f 1582line_completion_function (text, matches, line_buffer, point)
172559ec
JK
1583 char *text;
1584 int matches;
9ed8604f
PS
1585 char *line_buffer;
1586 int point;
172559ec
JK
1587{
1588 static char **list = (char **)NULL; /* Cache of completions */
1589 static int index; /* Next cached completion */
1590 char *output = NULL;
1591 char *tmp_command, *p;
1592 /* Pointer within tmp_command which corresponds to text. */
1593 char *word;
1594 struct cmd_list_element *c, *result_list;
1595
1596 if (matches == 0)
1597 {
1598 /* The caller is beginning to accumulate a new set of completions, so
1599 we need to find all of them now, and cache them for returning one at
1600 a time on future calls. */
1601
1602 if (list)
1603 {
1604 /* Free the storage used by LIST, but not by the strings inside.
1605 This is because rl_complete_internal () frees the strings. */
1606 free ((PTR)list);
1607 }
1608 list = 0;
1609 index = 0;
1610
1611 /* Choose the default set of word break characters to break completions.
1612 If we later find out that we are doing completions on command strings
1613 (as opposed to strings supplied by the individual command completer
1614 functions, which can be any string) then we will switch to the
1615 special word break set for command strings, which leaves out the
1616 '-' character used in some commands. */
1617
1618 rl_completer_word_break_characters =
1619 gdb_completer_word_break_characters;
1620
1621 /* Decide whether to complete on a list of gdb commands or on symbols. */
9ed8604f 1622 tmp_command = (char *) alloca (point + 1);
172559ec
JK
1623 p = tmp_command;
1624
9ed8604f
PS
1625 strncpy (tmp_command, line_buffer, point);
1626 tmp_command[point] = '\0';
172559ec 1627 /* Since text always contains some number of characters leading up
9ed8604f 1628 to point, we can find the equivalent position in tmp_command
172559ec 1629 by subtracting that many characters from the end of tmp_command. */
9ed8604f 1630 word = tmp_command + point - strlen (text);
172559ec 1631
9ed8604f 1632 if (point == 0)
172559ec
JK
1633 {
1634 /* An empty line we want to consider ambiguous; that is, it
1635 could be any command. */
1636 c = (struct cmd_list_element *) -1;
1637 result_list = 0;
1638 }
1639 else
1640 {
1641 c = lookup_cmd_1 (&p, cmdlist, &result_list, 1);
1642 }
1643
1644 /* Move p up to the next interesting thing. */
1645 while (*p == ' ' || *p == '\t')
1646 {
1647 p++;
1648 }
1649
1650 if (!c)
1651 {
1652 /* It is an unrecognized command. So there are no
1653 possible completions. */
1654 list = NULL;
1655 }
1656 else if (c == (struct cmd_list_element *) -1)
1657 {
1658 char *q;
1659
1660 /* lookup_cmd_1 advances p up to the first ambiguous thing, but
1661 doesn't advance over that thing itself. Do so now. */
1662 q = p;
1663 while (*q && (isalnum (*q) || *q == '-' || *q == '_'))
1664 ++q;
9ed8604f 1665 if (q != tmp_command + point)
172559ec
JK
1666 {
1667 /* There is something beyond the ambiguous
1668 command, so there are no possible completions. For
1669 example, "info t " or "info t foo" does not complete
1670 to anything, because "info t" can be "info target" or
1671 "info terminal". */
1672 list = NULL;
1673 }
1674 else
1675 {
1676 /* We're trying to complete on the command which was ambiguous.
1677 This we can deal with. */
1678 if (result_list)
1679 {
1680 list = complete_on_cmdlist (*result_list->prefixlist, p,
1681 word);
1682 }
1683 else
1684 {
1685 list = complete_on_cmdlist (cmdlist, p, word);
1686 }
1687 /* Insure that readline does the right thing with respect to
1688 inserting quotes. */
1689 rl_completer_word_break_characters =
1690 gdb_completer_command_word_break_characters;
1691 }
1692 }
1693 else
1694 {
1695 /* We've recognized a full command. */
1696
9ed8604f 1697 if (p == tmp_command + point)
172559ec
JK
1698 {
1699 /* There is no non-whitespace in the line beyond the command. */
1700
1701 if (p[-1] == ' ' || p[-1] == '\t')
1702 {
1703 /* The command is followed by whitespace; we need to complete
1704 on whatever comes after command. */
1705 if (c->prefixlist)
1706 {
1707 /* It is a prefix command; what comes after it is
1708 a subcommand (e.g. "info "). */
1709 list = complete_on_cmdlist (*c->prefixlist, p, word);
1710
1711 /* Insure that readline does the right thing
1712 with respect to inserting quotes. */
1713 rl_completer_word_break_characters =
1714 gdb_completer_command_word_break_characters;
1715 }
09374c98
SG
1716 else if (c->enums)
1717 {
1718 list = complete_on_enum (c->enums, p, word);
1719 rl_completer_word_break_characters =
1720 gdb_completer_command_word_break_characters;
1721 }
172559ec
JK
1722 else
1723 {
1724 /* It is a normal command; what comes after it is
1725 completed by the command's completer function. */
1726 list = (*c->completer) (p, word);
1727 }
1728 }
1729 else
1730 {
1731 /* The command is not followed by whitespace; we need to
1732 complete on the command itself. e.g. "p" which is a
1733 command itself but also can complete to "print", "ptype"
1734 etc. */
1735 char *q;
1736
1737 /* Find the command we are completing on. */
1738 q = p;
1739 while (q > tmp_command)
1740 {
1741 if (isalnum (q[-1]) || q[-1] == '-' || q[-1] == '_')
1742 --q;
1743 else
1744 break;
1745 }
1746
1747 list = complete_on_cmdlist (result_list, q, word);
1748
1749 /* Insure that readline does the right thing
1750 with respect to inserting quotes. */
1751 rl_completer_word_break_characters =
1752 gdb_completer_command_word_break_characters;
1753 }
1754 }
1755 else
1756 {
1757 /* There is non-whitespace beyond the command. */
1758
1759 if (c->prefixlist && !c->allow_unknown)
1760 {
1761 /* It is an unrecognized subcommand of a prefix command,
1762 e.g. "info adsfkdj". */
1763 list = NULL;
1764 }
09374c98
SG
1765 else if (c->enums)
1766 {
1767 list = complete_on_enum (c->enums, p, word);
1768 }
172559ec
JK
1769 else
1770 {
1771 /* It is a normal command. */
1772 list = (*c->completer) (p, word);
1773 }
1774 }
1775 }
1776 }
1777
1778 /* If we found a list of potential completions during initialization then
1779 dole them out one at a time. The vector of completions is NULL
1780 terminated, so after returning the last one, return NULL (and continue
1781 to do so) each time we are called after that, until a new list is
1782 available. */
1783
1784 if (list)
1785 {
1786 output = list[index];
1787 if (output)
1788 {
1789 index++;
1790 }
1791 }
1792
1793#if 0
1794 /* Can't do this because readline hasn't yet checked the word breaks
1795 for figuring out whether to insert a quote. */
1796 if (output == NULL)
1797 /* Make sure the word break characters are set back to normal for the
1798 next time that readline tries to complete something. */
1799 rl_completer_word_break_characters =
1800 gdb_completer_word_break_characters;
1801#endif
1802
1803 return (output);
1804}
1805
9ed8604f
PS
1806/* Line completion interface function for readline. */
1807
1808static char *
1809readline_line_completion_function (text, matches)
1810 char *text;
1811 int matches;
1812{
1813 return line_completion_function (text, matches, rl_line_buffer, rl_point);
1814}
1815
172559ec
JK
1816/* Skip over a possibly quoted word (as defined by the quote characters
1817 and word break characters the completer uses). Returns pointer to the
1818 location after the "word". */
1819
1820char *
1821skip_quoted (str)
1822 char *str;
1823{
1824 char quote_char = '\0';
1825 char *scan;
1826
1827 for (scan = str; *scan != '\0'; scan++)
1828 {
1829 if (quote_char != '\0')
1830 {
1831 /* Ignore everything until the matching close quote char */
1832 if (*scan == quote_char)
1833 {
1834 /* Found matching close quote. */
1835 scan++;
1836 break;
1837 }
1838 }
1839 else if (strchr (gdb_completer_quote_characters, *scan))
1840 {
1841 /* Found start of a quoted string. */
1842 quote_char = *scan;
1843 }
1844 else if (strchr (gdb_completer_word_break_characters, *scan))
1845 {
1846 break;
1847 }
1848 }
1849 return (scan);
1850}
1851
1852\f
1853#ifdef STOP_SIGNAL
1854static void
1855stop_sig (signo)
1856int signo;
1857{
1858#if STOP_SIGNAL == SIGTSTP
1859 signal (SIGTSTP, SIG_DFL);
1860 sigsetmask (0);
1861 kill (getpid (), SIGTSTP);
1862 signal (SIGTSTP, stop_sig);
1863#else
1864 signal (STOP_SIGNAL, stop_sig);
1865#endif
1866 printf_unfiltered ("%s", prompt);
1867 gdb_flush (gdb_stdout);
1868
1869 /* Forget about any previous command -- null line now will do nothing. */
1870 dont_repeat ();
1871}
1872#endif /* STOP_SIGNAL */
1873
1874/* Initialize signal handlers. */
1875static void
1876do_nothing (signo)
1877int signo;
1878{
1879}
1880
1881static void
1882init_signals ()
1883{
1884 signal (SIGINT, request_quit);
1885
255181a9
PS
1886 /* If SIGTRAP was set to SIG_IGN, then the SIG_IGN will get passed
1887 to the inferior and breakpoints will be ignored. */
1888#ifdef SIGTRAP
1889 signal (SIGTRAP, SIG_DFL);
1890#endif
1891
172559ec
JK
1892 /* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
1893 passed to the inferior, which we don't want. It would be
1894 possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
1895 on BSD4.3 systems using vfork, that can affect the
1896 GDB process as well as the inferior (the signal handling tables
1897 might be in memory, shared between the two). Since we establish
1898 a handler for SIGQUIT, when we call exec it will set the signal
1899 to SIG_DFL for us. */
1900 signal (SIGQUIT, do_nothing);
1901 if (signal (SIGHUP, do_nothing) != SIG_IGN)
1902 signal (SIGHUP, disconnect);
1903 signal (SIGFPE, float_handler);
1904
1905#if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
1906 signal (SIGWINCH, SIGWINCH_HANDLER);
1907#endif
1908}
1909\f
1910/* Read one line from the command input stream `instream'
1911 into the local static buffer `linebuffer' (whose current length
1912 is `linelength').
1913 The buffer is made bigger as necessary.
1914 Returns the address of the start of the line.
1915
1916 NULL is returned for end of file.
1917
1918 *If* the instream == stdin & stdin is a terminal, the line read
1919 is copied into the file line saver (global var char *line,
1920 length linesize) so that it can be duplicated.
1921
1922 This routine either uses fancy command line editing or
1923 simple input as the user has requested. */
1924
1925char *
1926command_line_input (prrompt, repeat, annotation_suffix)
1927 char *prrompt;
1928 int repeat;
1929 char *annotation_suffix;
1930{
1931 static char *linebuffer = 0;
1932 static unsigned linelength = 0;
1933 register char *p;
1934 char *p1;
1935 char *rl;
1936 char *local_prompt = prrompt;
172559ec
JK
1937 char *nline;
1938 char got_eof = 0;
1939
dfb14bc8
SS
1940 /* The annotation suffix must be non-NULL. */
1941 if (annotation_suffix == NULL)
1942 annotation_suffix = "";
1943
172559ec
JK
1944 if (annotation_level > 1 && instream == stdin)
1945 {
1946 local_prompt = alloca ((prrompt == NULL ? 0 : strlen (prrompt))
1947 + strlen (annotation_suffix) + 40);
1948 if (prrompt == NULL)
1949 local_prompt[0] = '\0';
1950 else
1951 strcpy (local_prompt, prrompt);
1952 strcat (local_prompt, "\n\032\032");
1953 strcat (local_prompt, annotation_suffix);
1954 strcat (local_prompt, "\n");
1955 }
1956
1957 if (linebuffer == 0)
1958 {
1959 linelength = 80;
1960 linebuffer = (char *) xmalloc (linelength);
1961 }
1962
1963 p = linebuffer;
1964
1965 /* Control-C quits instantly if typed while in this loop
1966 since it should not wait until the user types a newline. */
1967 immediate_quit++;
1968#ifdef STOP_SIGNAL
1969 if (job_control)
1970 signal (STOP_SIGNAL, stop_sig);
1971#endif
1972
1973 while (1)
1974 {
1975 /* Make sure that all output has been output. Some machines may let
1976 you get away with leaving out some of the gdb_flush, but not all. */
1977 wrap_here ("");
1978 gdb_flush (gdb_stdout);
1979 gdb_flush (gdb_stderr);
1980
1981 if (source_file_name != NULL)
1982 {
1983 ++source_line_number;
1984 sprintf (source_error,
1985 "%s%s:%d: Error in sourced command file:\n",
1986 source_pre_error,
1987 source_file_name,
1988 source_line_number);
1989 error_pre_print = source_error;
1990 }
1991
1992 if (annotation_level > 1 && instream == stdin)
1993 {
1994 printf_unfiltered ("\n\032\032pre-");
1995 printf_unfiltered (annotation_suffix);
1996 printf_unfiltered ("\n");
1997 }
1998
1999 /* Don't use fancy stuff if not talking to stdin. */
41756e56
FF
2000 if (readline_hook && instream == NULL)
2001 {
2002 rl = (*readline_hook) (local_prompt);
2003 }
2004 else if (command_editing_p && instream == stdin && ISATTY (instream))
2005 {
2006 rl = readline (local_prompt);
2007 }
172559ec 2008 else
41756e56
FF
2009 {
2010 rl = gdb_readline (local_prompt);
2011 }
172559ec
JK
2012
2013 if (annotation_level > 1 && instream == stdin)
2014 {
2015 printf_unfiltered ("\n\032\032post-");
2016 printf_unfiltered (annotation_suffix);
2017 printf_unfiltered ("\n");
2018 }
2019
2020 if (!rl || rl == (char *) EOF)
2021 {
2022 got_eof = 1;
2023 break;
2024 }
2025 if (strlen(rl) + 1 + (p - linebuffer) > linelength)
2026 {
2027 linelength = strlen(rl) + 1 + (p - linebuffer);
2028 nline = (char *) xrealloc (linebuffer, linelength);
2029 p += nline - linebuffer;
2030 linebuffer = nline;
2031 }
2032 p1 = rl;
2033 /* Copy line. Don't copy null at end. (Leaves line alone
2034 if this was just a newline) */
2035 while (*p1)
2036 *p++ = *p1++;
2037
2038 free (rl); /* Allocated in readline. */
2039
2040 if (p == linebuffer || *(p - 1) != '\\')
2041 break;
2042
2043 p--; /* Put on top of '\'. */
2044 local_prompt = (char *) 0;
2045 }
2046
2047#ifdef STOP_SIGNAL
2048 if (job_control)
2049 signal (STOP_SIGNAL, SIG_DFL);
2050#endif
2051 immediate_quit--;
2052
2053 if (got_eof)
2054 return NULL;
2055
2056#define SERVER_COMMAND_LENGTH 7
2057 server_command =
2058 (p - linebuffer > SERVER_COMMAND_LENGTH)
2059 && STREQN (linebuffer, "server ", SERVER_COMMAND_LENGTH);
2060 if (server_command)
2061 {
2062 /* Note that we don't set `line'. Between this and the check in
2063 dont_repeat, this insures that repeating will still do the
2064 right thing. */
2065 *p = '\0';
2066 return linebuffer + SERVER_COMMAND_LENGTH;
2067 }
2068
2069 /* Do history expansion if that is wished. */
2070 if (history_expansion_p && instream == stdin
2071 && ISATTY (instream))
2072 {
2073 char *history_value;
2074 int expanded;
2075
2076 *p = '\0'; /* Insert null now. */
2077 expanded = history_expand (linebuffer, &history_value);
2078 if (expanded)
2079 {
2080 /* Print the changes. */
2081 printf_unfiltered ("%s\n", history_value);
2082
2083 /* If there was an error, call this function again. */
2084 if (expanded < 0)
2085 {
2086 free (history_value);
2087 return command_line_input (prrompt, repeat, annotation_suffix);
2088 }
2089 if (strlen (history_value) > linelength)
2090 {
2091 linelength = strlen (history_value) + 1;
2092 linebuffer = (char *) xrealloc (linebuffer, linelength);
2093 }
2094 strcpy (linebuffer, history_value);
2095 p = linebuffer + strlen(linebuffer);
2096 free (history_value);
2097 }
2098 }
2099
2100 /* If we just got an empty line, and that is supposed
2101 to repeat the previous command, return the value in the
2102 global buffer. */
f2ed3a80
PB
2103 if (repeat && p == linebuffer)
2104 return line;
2105 for (p1 = linebuffer; *p1 == ' ' || *p1 == '\t'; p1++) ;
2106 if (repeat && !*p1)
2107 return line;
172559ec
JK
2108
2109 *p = 0;
2110
2111 /* Add line to history if appropriate. */
2112 if (instream == stdin
2113 && ISATTY (stdin) && *linebuffer)
2114 add_history (linebuffer);
2115
2116 /* Note: lines consisting solely of comments are added to the command
2117 history. This is useful when you type a command, and then
2118 realize you don't want to execute it quite yet. You can comment
2119 out the command and then later fetch it from the value history
2120 and remove the '#'. The kill ring is probably better, but some
2121 people are in the habit of commenting things out. */
f2ed3a80
PB
2122 if (*p1 == '#')
2123 *p1 = '\0'; /* Found a comment. */
172559ec
JK
2124
2125 /* Save into global buffer if appropriate. */
2126 if (repeat)
2127 {
2128 if (linelength > linesize)
2129 {
2130 line = xrealloc (line, linelength);
2131 linesize = linelength;
2132 }
2133 strcpy (line, linebuffer);
2134 return line;
2135 }
2136
2137 return linebuffer;
2138}
2139\f
e52bfe0c
JL
2140
2141/* Expand the body_list of COMMAND so that it can hold NEW_LENGTH
2142 code bodies. This is typically used when we encounter an "else"
2143 clause for an "if" command. */
2144
2145static void
2146realloc_body_list (command, new_length)
2147 struct command_line *command;
2148 int new_length;
2149{
2150 int n;
2151 struct command_line **body_list;
2152
2153 n = command->body_count;
2154
2155 /* Nothing to do? */
2156 if (new_length <= n)
2157 return;
2158
2159 body_list = (struct command_line **)
2160 xmalloc (sizeof (struct command_line *) * new_length);
2161
2162 memcpy (body_list, command->body_list, sizeof (struct command_line *) * n);
2163
2164 free (command->body_list);
2165 command->body_list = body_list;
2166 command->body_count = new_length;
2167}
2168
2169/* Read one line from the input stream. If the command is an "else" or
2170 "end", return such an indication to the caller. */
2171
2172static enum misc_command_type
2173read_next_line (command)
2174 struct command_line **command;
2175{
2176 char *p, *p1, *prompt_ptr, control_prompt[256];
2177 int i = 0;
2178
2179 if (control_level >= 254)
2180 error ("Control nesting too deep!\n");
2181
2182 /* Set a prompt based on the nesting of the control commands. */
41756e56 2183 if (instream == stdin || (instream == 0 && readline_hook != NULL))
e52bfe0c
JL
2184 {
2185 for (i = 0; i < control_level; i++)
2186 control_prompt[i] = ' ';
2187 control_prompt[i] = '>';
2188 control_prompt[i+1] = '\0';
2189 prompt_ptr = (char *)&control_prompt[0];
2190 }
2191 else
2192 prompt_ptr = NULL;
2193
e04f8901 2194 p = command_line_input (prompt_ptr, instream == stdin, "commands");
e52bfe0c
JL
2195
2196 /* Not sure what to do here. */
2197 if (p == NULL)
2198 return end_command;
2199
2200 /* Strip leading and trailing whitespace. */
2201 while (*p == ' ' || *p == '\t')
2202 p++;
2203
2204 p1 = p + strlen (p);
2205 while (p1 != p && (p1[-1] == ' ' || p1[-1] == '\t'))
2206 p1--;
2207
2208 /* Blanks and comments don't really do anything, but we need to
2209 distinguish them from else, end and other commands which can be
2210 executed. */
2211 if (p1 == p || p[0] == '#')
2212 return nop_command;
2213
2214 /* Is this the end of a simple, while, or if control structure? */
2215 if (p1 - p == 3 && !strncmp (p, "end", 3))
2216 return end_command;
2217
2218 /* Is the else clause of an if control structure? */
2219 if (p1 - p == 4 && !strncmp (p, "else", 4))
2220 return else_command;
2221
2222 /* Check for while, if, break, continue, etc and build a new command
2223 line structure for them. */
2224 if (p1 - p > 5 && !strncmp (p, "while", 5))
2225 *command = build_command_line (while_control, p + 6);
2226 else if (p1 - p > 2 && !strncmp (p, "if", 2))
2227 *command = build_command_line (if_control, p + 3);
ecebd693 2228 else if (p1 - p == 10 && !strncmp (p, "loop_break", 10))
e52bfe0c
JL
2229 {
2230 *command = (struct command_line *)
2231 xmalloc (sizeof (struct command_line));
2232 (*command)->next = NULL;
2233 (*command)->line = NULL;
2234 (*command)->control_type = break_control;
2235 (*command)->body_count = 0;
2236 (*command)->body_list = NULL;
2237 }
ecebd693 2238 else if (p1 - p == 13 && !strncmp (p, "loop_continue", 13))
e52bfe0c
JL
2239 {
2240 *command = (struct command_line *)
2241 xmalloc (sizeof (struct command_line));
2242 (*command)->next = NULL;
2243 (*command)->line = NULL;
2244 (*command)->control_type = continue_control;
2245 (*command)->body_count = 0;
2246 (*command)->body_list = NULL;
2247 }
2248 else
2249 {
2250 /* A normal command. */
2251 *command = (struct command_line *)
2252 xmalloc (sizeof (struct command_line));
2253 (*command)->next = NULL;
2254 (*command)->line = savestring (p, p1 - p);
2255 (*command)->control_type = simple_control;
2256 (*command)->body_count = 0;
2257 (*command)->body_list = NULL;
2258 }
2259
2260 /* Nothing special. */
2261 return ok_command;
2262}
2263
2264/* Recursively read in the control structures and create a command_line
41756e56 2265 structure from them.
e52bfe0c
JL
2266
2267 The parent_control parameter is the control structure in which the
2268 following commands are nested. */
2269
2270static enum command_control_type
2271recurse_read_control_structure (current_cmd)
2272 struct command_line *current_cmd;
2273{
2274 int current_body, i;
2275 enum misc_command_type val;
2276 enum command_control_type ret;
2277 struct command_line **body_ptr, *child_tail, *next;
e52bfe0c 2278
e52bfe0c
JL
2279 child_tail = NULL;
2280 current_body = 1;
2281
2282 /* Sanity checks. */
2283 if (current_cmd->control_type == simple_control)
2284 {
2285 error ("Recursed on a simple control type\n");
2286 return invalid_control;
2287 }
2288
2289 if (current_body > current_cmd->body_count)
2290 {
2291 error ("Allocated body is smaller than this command type needs\n");
2292 return invalid_control;
2293 }
2294
2295 /* Read lines from the input stream and build control structures. */
2296 while (1)
2297 {
2298 dont_repeat ();
2299
2300 next = NULL;
2301 val = read_next_line (&next);
2302
2303 /* Just skip blanks and comments. */
2304 if (val == nop_command)
2305 continue;
2306
2307 if (val == end_command)
2308 {
2309 if (current_cmd->control_type == while_control
2310 || current_cmd->control_type == if_control)
2311 {
2312 /* Success reading an entire control structure. */
2313 ret = simple_control;
2314 break;
2315 }
2316 else
2317 {
2318 ret = invalid_control;
2319 break;
2320 }
2321 }
2322
2323 /* Not the end of a control structure. */
2324 if (val == else_command)
2325 {
2326 if (current_cmd->control_type == if_control
2327 && current_body == 1)
2328 {
2329 realloc_body_list (current_cmd, 2);
2330 current_body = 2;
2331 child_tail = NULL;
2332 continue;
2333 }
2334 else
2335 {
2336 ret = invalid_control;
2337 break;
2338 }
2339 }
2340
2341 if (child_tail)
2342 {
2343 child_tail->next = next;
2344 }
2345 else
2346 {
e52bfe0c
JL
2347 body_ptr = current_cmd->body_list;
2348 for (i = 1; i < current_body; i++)
2349 body_ptr++;
2350
2351 *body_ptr = next;
2352
e52bfe0c
JL
2353 }
2354
2355 child_tail = next;
2356
2357 /* If the latest line is another control structure, then recurse
2358 on it. */
2359 if (next->control_type == while_control
2360 || next->control_type == if_control)
2361 {
2362 control_level++;
2363 ret = recurse_read_control_structure (next);
2364 control_level--;
2365
2366 if (ret != simple_control)
2367 break;
2368 }
2369 }
2370
2371 dont_repeat ();
e52bfe0c
JL
2372
2373 return ret;
2374}
2375
41756e56
FF
2376/* Read lines from the input stream and accumulate them in a chain of
2377 struct command_line's, which is then returned. For input from a
2378 terminal, the special command "end" is used to mark the end of the
2379 input, and is not included in the returned chain of commands. */
e52bfe0c 2380
41756e56 2381#define END_MESSAGE "End with a line saying just \"end\"."
172559ec
JK
2382
2383struct command_line *
41756e56
FF
2384read_command_lines (prompt, from_tty)
2385char *prompt;
2386int from_tty;
172559ec 2387{
e52bfe0c
JL
2388 struct command_line *head, *tail, *next;
2389 struct cleanup *old_chain;
2390 enum command_control_type ret;
2391 enum misc_command_type val;
2392
41756e56
FF
2393 if (readline_begin_hook)
2394 {
2395 /* Note - intentional to merge messages with no newline */
2396 (*readline_begin_hook) ("%s %s\n", prompt, END_MESSAGE);
2397 }
2398 else if (from_tty && input_from_terminal_p ())
2399 {
2400 printf_unfiltered ("%s\n%s\n", prompt, END_MESSAGE);
2401 gdb_flush (gdb_stdout);
2402 }
2403
e52bfe0c
JL
2404 head = tail = NULL;
2405 old_chain = NULL;
172559ec
JK
2406
2407 while (1)
2408 {
e52bfe0c 2409 val = read_next_line (&next);
172559ec 2410
e52bfe0c
JL
2411 /* Ignore blank lines or comments. */
2412 if (val == nop_command)
2413 continue;
2414
2415 if (val == end_command)
2416 {
2417 ret = simple_control;
2418 break;
2419 }
2420
2421 if (val != ok_command)
2422 {
2423 ret = invalid_control;
2424 break;
2425 }
2426
2427 if (next->control_type == while_control
2428 || next->control_type == if_control)
2429 {
2430 control_level++;
2431 ret = recurse_read_control_structure (next);
2432 control_level--;
172559ec 2433
e52bfe0c
JL
2434 if (ret == invalid_control)
2435 break;
2436 }
2437
172559ec
JK
2438 if (tail)
2439 {
2440 tail->next = next;
2441 }
2442 else
2443 {
e52bfe0c
JL
2444 head = next;
2445 old_chain = make_cleanup (free_command_lines, &head);
172559ec
JK
2446 }
2447 tail = next;
2448 }
2449
2450 dont_repeat ();
2451
e52bfe0c
JL
2452 if (head)
2453 {
2454 if (ret != invalid_control)
2455 {
2456 discard_cleanups (old_chain);
e52bfe0c
JL
2457 }
2458 else
2459 do_cleanups (old_chain);
2460 }
2461
41756e56
FF
2462 if (readline_end_hook)
2463 {
2464 (*readline_end_hook) ();
2465 }
2466 return (head);
172559ec
JK
2467}
2468
2469/* Free a chain of struct command_line's. */
2470
2471void
2472free_command_lines (lptr)
2473 struct command_line **lptr;
2474{
2475 register struct command_line *l = *lptr;
2476 register struct command_line *next;
e52bfe0c
JL
2477 struct command_line **blist;
2478 int i;
172559ec
JK
2479
2480 while (l)
2481 {
e52bfe0c
JL
2482 if (l->body_count > 0)
2483 {
2484 blist = l->body_list;
2485 for (i = 0; i < l->body_count; i++, blist++)
2486 free_command_lines (blist);
2487 }
172559ec
JK
2488 next = l->next;
2489 free (l->line);
2490 free ((PTR)l);
2491 l = next;
2492 }
2493}
2494\f
2495/* Add an element to the list of info subcommands. */
2496
2497void
2498add_info (name, fun, doc)
2499 char *name;
2500 void (*fun) PARAMS ((char *, int));
2501 char *doc;
2502{
2503 add_cmd (name, no_class, fun, doc, &infolist);
2504}
2505
2506/* Add an alias to the list of info subcommands. */
2507
2508void
2509add_info_alias (name, oldname, abbrev_flag)
2510 char *name;
2511 char *oldname;
2512 int abbrev_flag;
2513{
2514 add_alias_cmd (name, oldname, 0, abbrev_flag, &infolist);
2515}
2516
2517/* The "info" command is defined as a prefix, with allow_unknown = 0.
2518 Therefore, its own definition is called only for "info" with no args. */
2519
2520/* ARGSUSED */
2521static void
2522info_command (arg, from_tty)
2523 char *arg;
2524 int from_tty;
2525{
2526 printf_unfiltered ("\"info\" must be followed by the name of an info command.\n");
2527 help_list (infolist, "info ", -1, gdb_stdout);
2528}
2529
2530/* The "complete" command is used by Emacs to implement completion. */
2531
2532/* ARGSUSED */
2533static void
2534complete_command (arg, from_tty)
2535 char *arg;
2536 int from_tty;
2537{
2538 int i;
9ed8604f 2539 int argpoint;
172559ec
JK
2540 char *completion;
2541
2542 dont_repeat ();
2543
2544 if (arg == NULL)
9ed8604f
PS
2545 arg = "";
2546 argpoint = strlen (arg);
172559ec 2547
9ed8604f 2548 for (completion = line_completion_function (arg, i = 0, arg, argpoint);
172559ec 2549 completion;
9ed8604f
PS
2550 completion = line_completion_function (arg, ++i, arg, argpoint))
2551 {
2552 printf_unfiltered ("%s\n", completion);
2553 free (completion);
2554 }
172559ec
JK
2555}
2556
2557/* The "show" command with no arguments shows all the settings. */
2558
2559/* ARGSUSED */
2560static void
2561show_command (arg, from_tty)
2562 char *arg;
2563 int from_tty;
2564{
2565 cmd_show_list (showlist, from_tty, "");
2566}
2567\f
2568/* Add an element to the list of commands. */
2569
2570void
2571add_com (name, class, fun, doc)
2572 char *name;
2573 enum command_class class;
2574 void (*fun) PARAMS ((char *, int));
2575 char *doc;
2576{
2577 add_cmd (name, class, fun, doc, &cmdlist);
2578}
2579
2580/* Add an alias or abbreviation command to the list of commands. */
2581
2582void
2583add_com_alias (name, oldname, class, abbrev_flag)
2584 char *name;
2585 char *oldname;
2586 enum command_class class;
2587 int abbrev_flag;
2588{
2589 add_alias_cmd (name, oldname, class, abbrev_flag, &cmdlist);
2590}
2591
2592void
2593error_no_arg (why)
2594 char *why;
2595{
2596 error ("Argument required (%s).", why);
2597}
2598
2599/* ARGSUSED */
2600static void
2601help_command (command, from_tty)
2602 char *command;
2603 int from_tty; /* Ignored */
2604{
2605 help_cmd (command, gdb_stdout);
2606}
2607\f
2608static void
2609validate_comname (comname)
2610 char *comname;
2611{
2612 register char *p;
2613
2614 if (comname == 0)
2615 error_no_arg ("name of command to define");
2616
2617 p = comname;
2618 while (*p)
2619 {
080868b4 2620 if (!isalnum(*p) && *p != '-' && *p != '_')
172559ec
JK
2621 error ("Junk in argument list: \"%s\"", p);
2622 p++;
2623 }
2624}
2625
2626/* This is just a placeholder in the command data structures. */
2627static void
2628user_defined_command (ignore, from_tty)
2629 char *ignore;
2630 int from_tty;
2631{
2632}
2633
2634static void
2635define_command (comname, from_tty)
2636 char *comname;
2637 int from_tty;
2638{
2639 register struct command_line *cmds;
2640 register struct cmd_list_element *c, *newc, *hookc = 0;
2641 char *tem = comname;
41756e56 2642 char tmpbuf[128];
172559ec
JK
2643#define HOOK_STRING "hook-"
2644#define HOOK_LEN 5
2645
2646 validate_comname (comname);
2647
2648 /* Look it up, and verify that we got an exact match. */
2649 c = lookup_cmd (&tem, cmdlist, "", -1, 1);
2650 if (c && !STREQ (comname, c->name))
2651 c = 0;
e52bfe0c 2652
172559ec
JK
2653 if (c)
2654 {
2655 if (c->class == class_user || c->class == class_alias)
2656 tem = "Redefine command \"%s\"? ";
2657 else
2658 tem = "Really redefine built-in command \"%s\"? ";
2659 if (!query (tem, c->name))
2660 error ("Command \"%s\" not redefined.", c->name);
2661 }
2662
2663 /* If this new command is a hook, then mark the command which it
2664 is hooking. Note that we allow hooking `help' commands, so that
2665 we can hook the `stop' pseudo-command. */
2666
2667 if (!strncmp (comname, HOOK_STRING, HOOK_LEN))
2668 {
2669 /* Look up cmd it hooks, and verify that we got an exact match. */
2670 tem = comname+HOOK_LEN;
2671 hookc = lookup_cmd (&tem, cmdlist, "", -1, 0);
2672 if (hookc && !STREQ (comname+HOOK_LEN, hookc->name))
2673 hookc = 0;
2674 if (!hookc)
2675 {
2676 warning ("Your new `%s' command does not hook any existing command.",
2677 comname);
e3033bb0 2678 if (!query ("Proceed? "))
172559ec
JK
2679 error ("Not confirmed.");
2680 }
2681 }
2682
2683 comname = savestring (comname, strlen (comname));
2684
e52bfe0c 2685 /* If the rest of the commands will be case insensitive, this one
172559ec
JK
2686 should behave in the same manner. */
2687 for (tem = comname; *tem; tem++)
2688 if (isupper(*tem)) *tem = tolower(*tem);
2689
e52bfe0c 2690 control_level = 0;
41756e56
FF
2691 sprintf (tmpbuf, "Type commands for definition of \"%s\".", comname);
2692 cmds = read_command_lines (tmpbuf, from_tty);
172559ec
JK
2693
2694 if (c && c->class == class_user)
2695 free_command_lines (&c->user_commands);
2696
2697 newc = add_cmd (comname, class_user, user_defined_command,
2698 (c && c->class == class_user)
2699 ? c->doc : savestring ("User-defined.", 13), &cmdlist);
2700 newc->user_commands = cmds;
2701
2702 /* If this new command is a hook, then mark both commands as being
2703 tied. */
2704 if (hookc)
2705 {
2706 hookc->hook = newc; /* Target gets hooked. */
2707 newc->hookee = hookc; /* We are marked as hooking target cmd. */
2708 }
2709}
2710
2711static void
2712document_command (comname, from_tty)
2713 char *comname;
2714 int from_tty;
2715{
2716 struct command_line *doclines;
2717 register struct cmd_list_element *c;
2718 char *tem = comname;
41756e56 2719 char tmpbuf[128];
172559ec
JK
2720
2721 validate_comname (comname);
2722
2723 c = lookup_cmd (&tem, cmdlist, "", 0, 1);
2724
2725 if (c->class != class_user)
2726 error ("Command \"%s\" is built-in.", comname);
2727
41756e56
FF
2728 sprintf (tmpbuf, "Type documentation for \"%s\".", comname);
2729 doclines = read_command_lines (tmpbuf, from_tty);
172559ec
JK
2730
2731 if (c->doc) free (c->doc);
2732
2733 {
2734 register struct command_line *cl1;
2735 register int len = 0;
2736
2737 for (cl1 = doclines; cl1; cl1 = cl1->next)
2738 len += strlen (cl1->line) + 1;
2739
2740 c->doc = (char *) xmalloc (len + 1);
2741 *c->doc = 0;
2742
2743 for (cl1 = doclines; cl1; cl1 = cl1->next)
2744 {
2745 strcat (c->doc, cl1->line);
2746 if (cl1->next)
2747 strcat (c->doc, "\n");
2748 }
2749 }
2750
2751 free_command_lines (&doclines);
2752}
2753\f
172559ec
JK
2754void
2755print_gdb_version (stream)
2756 GDB_FILE *stream;
2757{
50140ab2
FF
2758 /* From GNU coding standards, first line is meant to be easy for a
2759 program to parse, and is just canonical program name and version
2760 number, which starts after last space. */
2761
2762 fprintf_filtered (stream, "GNU gdb %s\n", version);
2763
2764 /* Second line is a copyright notice. */
2765
2766 fprintf_filtered (stream, "Copyright 1996 Free Software Foundation, Inc.\n");
2767
2768 /* Following the copyright is a brief statement that the program is
2769 free software, that users are free to copy and change it on
2770 certain conditions, that it is covered by the GNU GPL, and that
2771 there is no warranty. */
2772
172559ec 2773 fprintf_filtered (stream, "\
50140ab2
FF
2774GDB is free software, covered by the GNU General Public License, and you are\n\
2775welcome to change it and/or distribute copies of it under certain conditions.\n\
2776Type \"show copying\" to see the conditions.\n\
2777There is absolutely no warranty for GDB. Type \"show warranty\" for details.\n");
172559ec 2778
50140ab2 2779 /* After the required info we print the configuration information. */
172559ec 2780
50140ab2
FF
2781 fprintf_filtered (stream, "This GDB was configured as \"");
2782 if (!STREQ (host_name, target_name))
2783 {
2784 fprintf_filtered (stream, "--host=%s --target=%s", host_name, target_name);
2785 }
2786 else
2787 {
2788 fprintf_filtered (stream, "%s", host_name);
2789 }
2790 fprintf_filtered (stream, "\".");
172559ec
JK
2791}
2792
2793/* ARGSUSED */
2794static void
2795show_version (args, from_tty)
2796 char *args;
2797 int from_tty;
2798{
2799 immediate_quit++;
172559ec
JK
2800 print_gdb_version (gdb_stdout);
2801 printf_filtered ("\n");
2802 immediate_quit--;
2803}
2804\f
2805/* xgdb calls this to reprint the usual GDB prompt. Obsolete now that xgdb
2806 is obsolete. */
2807
2808void
2809print_prompt ()
2810{
2811 printf_unfiltered ("%s", prompt);
2812 gdb_flush (gdb_stdout);
2813}
2814\f
2815void
2816quit_command (args, from_tty)
2817 char *args;
2818 int from_tty;
2819{
641c7fdf
SS
2820 int exit_code = 0;
2821
2822 /* An optional expression may be used to cause gdb to terminate with the
2823 value of that expression. */
2824 if (args)
2825 {
2826 value_ptr val = parse_and_eval (args);
2827
2828 exit_code = (int) value_as_long (val);
2829 }
2830
172559ec
JK
2831 if (inferior_pid != 0 && target_has_execution)
2832 {
2833 if (attach_flag)
2834 {
2835 if (query ("The program is running. Quit anyway (and detach it)? "))
2836 target_detach (args, from_tty);
2837 else
2838 error ("Not confirmed.");
2839 }
2840 else
2841 {
2842 if (query ("The program is running. Quit anyway (and kill it)? "))
2843 target_kill ();
2844 else
2845 error ("Not confirmed.");
2846 }
2847 }
2848 /* UDI wants this, to kill the TIP. */
2849 target_close (1);
2850
2851 /* Save the history information if it is appropriate to do so. */
2852 if (write_history_p && history_filename)
2853 write_history (history_filename);
2854
16a43bf4
DP
2855 do_final_cleanups(ALL_CLEANUPS); /* Do any final cleanups before exiting */
2856
641c7fdf 2857 exit (exit_code);
172559ec
JK
2858}
2859
2860/* Returns whether GDB is running on a terminal and whether the user
2861 desires that questions be asked of them on that terminal. */
2862
2863int
2864input_from_terminal_p ()
2865{
2866 return gdb_has_a_terminal () && (instream == stdin) & caution;
2867}
2868\f
2869/* ARGSUSED */
2870static void
2871pwd_command (args, from_tty)
2872 char *args;
2873 int from_tty;
2874{
2875 if (args) error ("The \"pwd\" command does not take an argument: %s", args);
b7ec5b8d 2876 getcwd (gdb_dirbuf, sizeof (gdb_dirbuf));
172559ec 2877
b7ec5b8d 2878 if (!STREQ (gdb_dirbuf, current_directory))
172559ec 2879 printf_unfiltered ("Working directory %s\n (canonically %s).\n",
b7ec5b8d 2880 current_directory, gdb_dirbuf);
172559ec
JK
2881 else
2882 printf_unfiltered ("Working directory %s.\n", current_directory);
2883}
2884
2885void
2886cd_command (dir, from_tty)
2887 char *dir;
2888 int from_tty;
2889{
2890 int len;
2891 /* Found something other than leading repetitions of "/..". */
2892 int found_real_path;
2893 char *p;
2894
2895 /* If the new directory is absolute, repeat is a no-op; if relative,
2896 repeat might be useful but is more likely to be a mistake. */
2897 dont_repeat ();
2898
2899 if (dir == 0)
2900 error_no_arg ("new working directory");
2901
2902 dir = tilde_expand (dir);
2903 make_cleanup (free, dir);
2904
2905 if (chdir (dir) < 0)
2906 perror_with_name (dir);
2907
2908 len = strlen (dir);
2e1cc801
SS
2909 dir = savestring (dir, len - (len > 1 && SLASH_P(dir[len-1])));
2910 if (ROOTED_P(dir))
172559ec
JK
2911 current_directory = dir;
2912 else
2913 {
2e1cc801 2914 if (SLASH_P (current_directory[0]) && current_directory[1] == '\0')
172559ec
JK
2915 current_directory = concat (current_directory, dir, NULL);
2916 else
2e1cc801 2917 current_directory = concat (current_directory, SLASH_STRING, dir, NULL);
172559ec
JK
2918 free (dir);
2919 }
2920
2921 /* Now simplify any occurrences of `.' and `..' in the pathname. */
2922
2923 found_real_path = 0;
2924 for (p = current_directory; *p;)
2925 {
2e1cc801 2926 if (SLASH_P (p[0]) && p[1] == '.' && (p[2] == 0 || SLASH_P (p[2])))
172559ec 2927 strcpy (p, p + 2);
2e1cc801
SS
2928 else if (SLASH_P (p[0]) && p[1] == '.' && p[2] == '.'
2929 && (p[3] == 0 || SLASH_P (p[3])))
172559ec
JK
2930 {
2931 if (found_real_path)
2932 {
2933 /* Search backwards for the directory just before the "/.."
2934 and obliterate it and the "/..". */
2935 char *q = p;
2e1cc801 2936 while (q != current_directory && ! SLASH_P (q[-1]))
172559ec
JK
2937 --q;
2938
2939 if (q == current_directory)
2940 /* current_directory is
2941 a relative pathname ("can't happen"--leave it alone). */
2942 ++p;
2943 else
2944 {
2945 strcpy (q - 1, p + 3);
2946 p = q - 1;
2947 }
2948 }
2949 else
2950 /* We are dealing with leading repetitions of "/..", for example
2951 "/../..", which is the Mach super-root. */
2952 p += 3;
2953 }
2954 else
2955 {
2956 found_real_path = 1;
2957 ++p;
2958 }
2959 }
2960
2961 forget_cached_source_info ();
2962
2963 if (from_tty)
2964 pwd_command ((char *) 0, 1);
2965}
2966\f
2967struct source_cleanup_lines_args {
2968 int old_line;
2969 char *old_file;
2970 char *old_pre_error;
2971 char *old_error_pre_print;
2972};
2973
2974static void
2975source_cleanup_lines (args)
2976 PTR args;
2977{
2978 struct source_cleanup_lines_args *p =
2979 (struct source_cleanup_lines_args *)args;
2980 source_line_number = p->old_line;
2981 source_file_name = p->old_file;
2982 source_pre_error = p->old_pre_error;
2983 error_pre_print = p->old_error_pre_print;
2984}
2985
2986/* ARGSUSED */
2987void
2988source_command (args, from_tty)
2989 char *args;
2990 int from_tty;
2991{
2992 FILE *stream;
2993 struct cleanup *old_cleanups;
2994 char *file = args;
2995 struct source_cleanup_lines_args old_lines;
2996 int needed_length;
2997
2998 if (file == NULL)
2999 {
3000 error ("source command requires pathname of file to source.");
3001 }
3002
3003 file = tilde_expand (file);
3004 old_cleanups = make_cleanup (free, file);
3005
3006 stream = fopen (file, FOPEN_RT);
9e77e83d
SG
3007 if (!stream)
3008 if (from_tty)
3009 perror_with_name (file);
3010 else
3011 return;
172559ec
JK
3012
3013 make_cleanup (fclose, stream);
3014
3015 old_lines.old_line = source_line_number;
3016 old_lines.old_file = source_file_name;
3017 old_lines.old_pre_error = source_pre_error;
3018 old_lines.old_error_pre_print = error_pre_print;
3019 make_cleanup (source_cleanup_lines, &old_lines);
3020 source_line_number = 0;
3021 source_file_name = file;
3022 source_pre_error = error_pre_print == NULL ? "" : error_pre_print;
3023 source_pre_error = savestring (source_pre_error, strlen (source_pre_error));
3024 make_cleanup (free, source_pre_error);
3025 /* This will get set every time we read a line. So it won't stay "" for
3026 long. */
3027 error_pre_print = "";
3028
3029 needed_length = strlen (source_file_name) + strlen (source_pre_error) + 80;
3030 if (source_error_allocated < needed_length)
3031 {
3032 source_error_allocated *= 2;
3033 if (source_error_allocated < needed_length)
3034 source_error_allocated = needed_length;
3035 if (source_error == NULL)
3036 source_error = xmalloc (source_error_allocated);
3037 else
3038 source_error = xrealloc (source_error, source_error_allocated);
3039 }
3040
3041 read_command_file (stream);
3042
3043 do_cleanups (old_cleanups);
3044}
3045
3046/* ARGSUSED */
3047static void
3048echo_command (text, from_tty)
3049 char *text;
3050 int from_tty;
3051{
3052 char *p = text;
3053 register int c;
3054
3055 if (text)
3056 while ((c = *p++) != '\0')
3057 {
3058 if (c == '\\')
3059 {
3060 /* \ at end of argument is used after spaces
3061 so they won't be lost. */
3062 if (*p == 0)
3063 return;
3064
3065 c = parse_escape (&p);
3066 if (c >= 0)
3067 printf_filtered ("%c", c);
3068 }
3069 else
3070 printf_filtered ("%c", c);
3071 }
3072
3073 /* Force this output to appear now. */
3074 wrap_here ("");
3075 gdb_flush (gdb_stdout);
3076}
3077
cd10c7e3
SG
3078/* ARGSUSED */
3079static void
3080dont_repeat_command (ignored, from_tty)
3081 char *ignored;
3082 int from_tty;
3083{
3084 *line = 0; /* Can't call dont_repeat here because we're not
3085 necessarily reading from stdin. */
3086}
b8176214
ILT
3087\f
3088#ifdef TARGET_BYTE_ORDER_SELECTABLE
3089
3090/* Functions to manipulate the endianness of the target. */
3091
3092#ifndef TARGET_BYTE_ORDER_DEFAULT
3093#define TARGET_BYTE_ORDER_DEFAULT BIG_ENDIAN
3094#endif
3095
3096int target_byte_order = TARGET_BYTE_ORDER_DEFAULT;
3097
b83ed019
ILT
3098static int target_byte_order_auto = 1;
3099
b8176214
ILT
3100/* Called if the user enters ``set endian'' without an argument. */
3101static void
3102set_endian (args, from_tty)
3103 char *args;
3104 int from_tty;
3105{
b83ed019 3106 printf_unfiltered ("\"set endian\" must be followed by \"auto\", \"big\" or \"little\".\n");
b8176214
ILT
3107 show_endian (args, from_tty);
3108}
3109
3110/* Called by ``set endian big''. */
3111static void
3112set_endian_big (args, from_tty)
3113 char *args;
3114 int from_tty;
3115{
3116 target_byte_order = BIG_ENDIAN;
b83ed019 3117 target_byte_order_auto = 0;
b8176214
ILT
3118}
3119
3120/* Called by ``set endian little''. */
3121static void
3122set_endian_little (args, from_tty)
3123 char *args;
3124 int from_tty;
3125{
3126 target_byte_order = LITTLE_ENDIAN;
b83ed019
ILT
3127 target_byte_order_auto = 0;
3128}
3129
3130/* Called by ``set endian auto''. */
3131static void
3132set_endian_auto (args, from_tty)
3133 char *args;
3134 int from_tty;
3135{
3136 target_byte_order_auto = 1;
b8176214
ILT
3137}
3138
3139/* Called by ``show endian''. */
3140static void
3141show_endian (args, from_tty)
3142 char *args;
3143 int from_tty;
3144{
b83ed019
ILT
3145 const char *msg =
3146 (target_byte_order_auto
3147 ? "The target endianness is set automatically (currently %s endian)\n"
3148 : "The target is assumed to be %s endian\n");
032f80d8 3149 printf_unfiltered ((char *) msg, TARGET_BYTE_ORDER == BIG_ENDIAN ? "big" : "little");
b8176214
ILT
3150}
3151
3152#endif /* defined (TARGET_BYTE_ORDER_SELECTABLE) */
b83ed019
ILT
3153
3154/* Set the endianness from a BFD. */
3155void
3156set_endian_from_file (abfd)
3157 bfd *abfd;
3158{
3159#ifdef TARGET_BYTE_ORDER_SELECTABLE
3160 int want;
3161
3ecd62ca 3162 if (bfd_big_endian (abfd))
b83ed019
ILT
3163 want = BIG_ENDIAN;
3164 else
3165 want = LITTLE_ENDIAN;
3166 if (target_byte_order_auto)
3167 target_byte_order = want;
3168 else if (target_byte_order != want)
3169 warning ("%s endian file does not match %s endian target.",
3170 want == BIG_ENDIAN ? "big" : "little",
3171 TARGET_BYTE_ORDER == BIG_ENDIAN ? "big" : "little");
3172
3173#else /* ! defined (TARGET_BYTE_ORDER_SELECTABLE) */
3174
3ecd62ca 3175 if (bfd_big_endian (abfd)
b83ed019
ILT
3176 ? TARGET_BYTE_ORDER != BIG_ENDIAN
3177 : TARGET_BYTE_ORDER == BIG_ENDIAN)
3178 warning ("%s endian file does not match %s endian target.",
3ecd62ca 3179 bfd_big_endian (abfd) ? "big" : "little",
b83ed019
ILT
3180 TARGET_BYTE_ORDER == BIG_ENDIAN ? "big" : "little");
3181
3182#endif /* ! defined (TARGET_BYTE_ORDER_SELECTABLE) */
3183}
172559ec
JK
3184\f
3185/* Functions to manipulate command line editing control variables. */
3186
3187/* Number of commands to print in each call to show_commands. */
3188#define Hist_print 10
3189static void
3190show_commands (args, from_tty)
3191 char *args;
3192 int from_tty;
3193{
3194 /* Index for history commands. Relative to history_base. */
3195 int offset;
3196
3197 /* Number of the history entry which we are planning to display next.
3198 Relative to history_base. */
3199 static int num = 0;
3200
3201 /* The first command in the history which doesn't exist (i.e. one more
3202 than the number of the last command). Relative to history_base. */
3203 int hist_len;
3204
3205 extern HIST_ENTRY *history_get PARAMS ((int));
3206
3207 /* Print out some of the commands from the command history. */
3208 /* First determine the length of the history list. */
3209 hist_len = history_size;
3210 for (offset = 0; offset < history_size; offset++)
3211 {
3212 if (!history_get (history_base + offset))
3213 {
3214 hist_len = offset;
3215 break;
3216 }
3217 }
3218
3219 if (args)
3220 {
3221 if (args[0] == '+' && args[1] == '\0')
3222 /* "info editing +" should print from the stored position. */
3223 ;
3224 else
3225 /* "info editing <exp>" should print around command number <exp>. */
3226 num = (parse_and_eval_address (args) - history_base) - Hist_print / 2;
3227 }
3228 /* "show commands" means print the last Hist_print commands. */
3229 else
3230 {
3231 num = hist_len - Hist_print;
3232 }
3233
3234 if (num < 0)
3235 num = 0;
3236
3237 /* If there are at least Hist_print commands, we want to display the last
3238 Hist_print rather than, say, the last 6. */
3239 if (hist_len - num < Hist_print)
3240 {
3241 num = hist_len - Hist_print;
3242 if (num < 0)
3243 num = 0;
3244 }
3245
3246 for (offset = num; offset < num + Hist_print && offset < hist_len; offset++)
3247 {
3248 printf_filtered ("%5d %s\n", history_base + offset,
3249 (history_get (history_base + offset))->line);
3250 }
3251
3252 /* The next command we want to display is the next one that we haven't
3253 displayed yet. */
3254 num += Hist_print;
e52bfe0c 3255
172559ec
JK
3256 /* If the user repeats this command with return, it should do what
3257 "show commands +" does. This is unnecessary if arg is null,
3258 because "show commands +" is not useful after "show commands". */
3259 if (from_tty && args)
3260 {
3261 args[0] = '+';
3262 args[1] = '\0';
3263 }
3264}
3265
3266/* Called by do_setshow_command. */
3267/* ARGSUSED */
3268static void
3269set_history_size_command (args, from_tty, c)
3270 char *args;
3271 int from_tty;
3272 struct cmd_list_element *c;
3273{
3274 if (history_size == INT_MAX)
3275 unstifle_history ();
3276 else if (history_size >= 0)
3277 stifle_history (history_size);
3278 else
3279 {
3280 history_size = INT_MAX;
3281 error ("History size must be non-negative");
3282 }
3283}
3284
3285/* ARGSUSED */
3286static void
3287set_history (args, from_tty)
3288 char *args;
3289 int from_tty;
3290{
3291 printf_unfiltered ("\"set history\" must be followed by the name of a history subcommand.\n");
3292 help_list (sethistlist, "set history ", -1, gdb_stdout);
3293}
3294
3295/* ARGSUSED */
3296static void
3297show_history (args, from_tty)
3298 char *args;
3299 int from_tty;
3300{
3301 cmd_show_list (showhistlist, from_tty, "");
3302}
3303
3304int info_verbose = 0; /* Default verbose msgs off */
3305
3306/* Called by do_setshow_command. An elaborate joke. */
3307/* ARGSUSED */
e52bfe0c 3308static void
172559ec
JK
3309set_verbose (args, from_tty, c)
3310 char *args;
3311 int from_tty;
3312 struct cmd_list_element *c;
3313{
3314 char *cmdname = "verbose";
3315 struct cmd_list_element *showcmd;
e52bfe0c 3316
172559ec
JK
3317 showcmd = lookup_cmd_1 (&cmdname, showlist, NULL, 1);
3318
3319 if (info_verbose)
3320 {
3321 c->doc = "Set verbose printing of informational messages.";
3322 showcmd->doc = "Show verbose printing of informational messages.";
3323 }
3324 else
3325 {
3326 c->doc = "Set verbosity.";
3327 showcmd->doc = "Show verbosity.";
3328 }
3329}
3330
3331static void
3332float_handler (signo)
3333int signo;
3334{
3335 /* This message is based on ANSI C, section 4.7. Note that integer
3336 divide by zero causes this, so "float" is a misnomer. */
3337 signal (SIGFPE, float_handler);
3338 error ("Erroneous arithmetic operation.");
3339}
3340
172559ec
JK
3341\f
3342static void
3343init_cmd_lists ()
3344{
3345 cmdlist = NULL;
3346 infolist = NULL;
3347 enablelist = NULL;
3348 disablelist = NULL;
3349 deletelist = NULL;
3350 enablebreaklist = NULL;
3351 setlist = NULL;
3352 unsetlist = NULL;
3353 showlist = NULL;
b8176214
ILT
3354#ifdef TARGET_BYTE_ORDER_SELECTABLE
3355 endianlist = NULL;
3356#endif
172559ec
JK
3357 sethistlist = NULL;
3358 showhistlist = NULL;
3359 unsethistlist = NULL;
3360#if MAINTENANCE_CMDS
3361 maintenancelist = NULL;
3362 maintenanceinfolist = NULL;
3363 maintenanceprintlist = NULL;
3364#endif
3365 setprintlist = NULL;
3366 showprintlist = NULL;
3367 setchecklist = NULL;
3368 showchecklist = NULL;
3369}
3370
3371/* Init the history buffer. Note that we are called after the init file(s)
3372 * have been read so that the user can change the history file via his
3373 * .gdbinit file (for instance). The GDBHISTFILE environment variable
3374 * overrides all of this.
3375 */
3376
3377void
3378init_history()
3379{
3380 char *tmpenv;
3381
3382 tmpenv = getenv ("HISTSIZE");
3383 if (tmpenv)
3384 history_size = atoi (tmpenv);
3385 else if (!history_size)
3386 history_size = 256;
3387
3388 stifle_history (history_size);
3389
3390 tmpenv = getenv ("GDBHISTFILE");
3391 if (tmpenv)
3392 history_filename = savestring (tmpenv, strlen(tmpenv));
3393 else if (!history_filename) {
3394 /* We include the current directory so that if the user changes
3395 directories the file written will be the same as the one
3396 that was read. */
3397 history_filename = concat (current_directory, "/.gdb_history", NULL);
3398 }
3399 read_history (history_filename);
3400}
3401
3402static void
3403init_main ()
3404{
3405 struct cmd_list_element *c;
e52bfe0c 3406
b8176214
ILT
3407#ifdef TARGET_BYTE_ORDER_SELECTABLE
3408
3409 add_prefix_cmd ("endian", class_support, set_endian,
3410 "Set endianness of target.",
3411 &endianlist, "set endian ", 0, &setlist);
3412 add_cmd ("big", class_support, set_endian_big,
3413 "Set target as being big endian.", &endianlist);
3414 add_cmd ("little", class_support, set_endian_little,
3415 "Set target as being little endian.", &endianlist);
b83ed019
ILT
3416 add_cmd ("auto", class_support, set_endian_auto,
3417 "Select target endianness automatically.", &endianlist);
b8176214
ILT
3418 add_cmd ("endian", class_support, show_endian,
3419 "Show endianness of target.", &showlist);
3420
3421#endif /* defined (TARGET_BYTE_ORDER_SELECTABLE) */
3422
172559ec
JK
3423#ifdef DEFAULT_PROMPT
3424 prompt = savestring (DEFAULT_PROMPT, strlen(DEFAULT_PROMPT));
3425#else
3426 prompt = savestring ("(gdb) ", 6);
3427#endif
3428
3429 /* Set the important stuff up for command editing. */
3430 command_editing_p = 1;
3431 history_expansion_p = 0;
3432 write_history_p = 0;
e52bfe0c 3433
172559ec 3434 /* Setup important stuff for command line editing. */
9ed8604f 3435 rl_completion_entry_function = (int (*)()) readline_line_completion_function;
172559ec
JK
3436 rl_completer_word_break_characters = gdb_completer_word_break_characters;
3437 rl_completer_quote_characters = gdb_completer_quote_characters;
3438 rl_readline_name = "gdb";
3439
3440 /* Define the classes of commands.
3441 They will appear in the help list in the reverse of this order. */
3442
3443 add_cmd ("internals", class_maintenance, NO_FUNCTION,
3444 "Maintenance commands.\n\
3445Some gdb commands are provided just for use by gdb maintainers.\n\
3446These commands are subject to frequent change, and may not be as\n\
3447well documented as user commands.",
3448 &cmdlist);
3449 add_cmd ("obscure", class_obscure, NO_FUNCTION, "Obscure features.", &cmdlist);
3450 add_cmd ("aliases", class_alias, NO_FUNCTION, "Aliases of other commands.", &cmdlist);
3451 add_cmd ("user-defined", class_user, NO_FUNCTION, "User-defined commands.\n\
3452The commands in this class are those defined by the user.\n\
3453Use the \"define\" command to define a command.", &cmdlist);
3454 add_cmd ("support", class_support, NO_FUNCTION, "Support facilities.", &cmdlist);
3455 add_cmd ("status", class_info, NO_FUNCTION, "Status inquiries.", &cmdlist);
3456 add_cmd ("files", class_files, NO_FUNCTION, "Specifying and examining files.", &cmdlist);
3457 add_cmd ("breakpoints", class_breakpoint, NO_FUNCTION, "Making program stop at certain points.", &cmdlist);
3458 add_cmd ("data", class_vars, NO_FUNCTION, "Examining data.", &cmdlist);
3459 add_cmd ("stack", class_stack, NO_FUNCTION, "Examining the stack.\n\
3460The stack is made up of stack frames. Gdb assigns numbers to stack frames\n\
3461counting from zero for the innermost (currently executing) frame.\n\n\
3462At any time gdb identifies one frame as the \"selected\" frame.\n\
3463Variable lookups are done with respect to the selected frame.\n\
3464When the program being debugged stops, gdb selects the innermost frame.\n\
3465The commands below can be used to select other frames by number or address.",
3466 &cmdlist);
3467 add_cmd ("running", class_run, NO_FUNCTION, "Running the program.", &cmdlist);
3468
3469 add_com ("pwd", class_files, pwd_command,
3470 "Print working directory. This is used for your program as well.");
3471 c = add_cmd ("cd", class_files, cd_command,
3472 "Set working directory to DIR for debugger and program being debugged.\n\
3473The change does not take effect for the program being debugged\n\
3474until the next time it is started.", &cmdlist);
3475 c->completer = filename_completer;
3476
3477 add_show_from_set
3478 (add_set_cmd ("prompt", class_support, var_string, (char *)&prompt,
3479 "Set gdb's prompt",
3480 &setlist),
3481 &showlist);
e52bfe0c 3482
172559ec
JK
3483 add_com ("echo", class_support, echo_command,
3484 "Print a constant string. Give string as argument.\n\
3485C escape sequences may be used in the argument.\n\
3486No newline is added at the end of the argument;\n\
3487use \"\\n\" if you want a newline to be printed.\n\
3488Since leading and trailing whitespace are ignored in command arguments,\n\
3489if you want to print some you must use \"\\\" before leading whitespace\n\
3490to be printed or after trailing whitespace.");
3491 add_com ("document", class_support, document_command,
3492 "Document a user-defined command.\n\
3493Give command name as argument. Give documentation on following lines.\n\
3494End with a line of just \"end\".");
3495 add_com ("define", class_support, define_command,
3496 "Define a new command name. Command name is argument.\n\
3497Definition appears on following lines, one command per line.\n\
3498End with a line of just \"end\".\n\
3499Use the \"document\" command to give documentation for the new command.\n\
59528079 3500Commands defined in this way may have up to ten arguments.");
172559ec
JK
3501
3502#ifdef __STDC__
3503 c = add_cmd ("source", class_support, source_command,
3504 "Read commands from a file named FILE.\n\
3505Note that the file \"" GDBINIT_FILENAME "\" is read automatically in this way\n\
3506when gdb is started.", &cmdlist);
3507#else
3508 /* Punt file name, we can't help it easily. */
3509 c = add_cmd ("source", class_support, source_command,
3510 "Read commands from a file named FILE.\n\
3511Note that the file \".gdbinit\" is read automatically in this way\n\
3512when gdb is started.", &cmdlist);
3513#endif
3514 c->completer = filename_completer;
3515
3516 add_com ("quit", class_support, quit_command, "Exit gdb.");
3517 add_com ("help", class_support, help_command, "Print list of commands.");
3518 add_com_alias ("q", "quit", class_support, 1);
3519 add_com_alias ("h", "help", class_support, 1);
3520
cd10c7e3
SG
3521 add_com ("dont-repeat", class_support, dont_repeat_command, "Don't repeat this command.\n\
3522Primarily used inside of user-defined commands that should not be repeated when\n\
3523hitting return.");
172559ec
JK
3524
3525 c = add_set_cmd ("verbose", class_support, var_boolean, (char *)&info_verbose,
3526 "Set ",
3527 &setlist),
3528 add_show_from_set (c, &showlist);
3529 c->function.sfunc = set_verbose;
3530 set_verbose (NULL, 0, c);
e52bfe0c 3531
172559ec
JK
3532 add_show_from_set
3533 (add_set_cmd ("editing", class_support, var_boolean, (char *)&command_editing_p,
3534 "Set editing of command lines as they are typed.\n\
3535Use \"on\" to enable to enable the editing, and \"off\" to disable it.\n\
3536Without an argument, command line editing is enabled. To edit, use\n\
3537EMACS-like or VI-like commands like control-P or ESC.", &setlist),
3538 &showlist);
3539
3540 add_prefix_cmd ("history", class_support, set_history,
3541 "Generic command for setting command history parameters.",
3542 &sethistlist, "set history ", 0, &setlist);
3543 add_prefix_cmd ("history", class_support, show_history,
3544 "Generic command for showing command history parameters.",
3545 &showhistlist, "show history ", 0, &showlist);
3546
3547 add_show_from_set
3548 (add_set_cmd ("expansion", no_class, var_boolean, (char *)&history_expansion_p,
3549 "Set history expansion on command input.\n\
3550Without an argument, history expansion is enabled.", &sethistlist),
3551 &showhistlist);
3552
3553 add_show_from_set
3554 (add_set_cmd ("save", no_class, var_boolean, (char *)&write_history_p,
3555 "Set saving of the history record on exit.\n\
3556Use \"on\" to enable to enable the saving, and \"off\" to disable it.\n\
3557Without an argument, saving is enabled.", &sethistlist),
3558 &showhistlist);
3559
3560 c = add_set_cmd ("size", no_class, var_integer, (char *)&history_size,
3561 "Set the size of the command history, \n\
3562ie. the number of previous commands to keep a record of.", &sethistlist);
3563 add_show_from_set (c, &showhistlist);
3564 c->function.sfunc = set_history_size_command;
3565
3566 add_show_from_set
3567 (add_set_cmd ("filename", no_class, var_filename, (char *)&history_filename,
3568 "Set the filename in which to record the command history\n\
3569 (the list of previous commands of which a record is kept).", &sethistlist),
3570 &showhistlist);
3571
3572 add_show_from_set
3573 (add_set_cmd ("confirm", class_support, var_boolean,
3574 (char *)&caution,
3575 "Set whether to confirm potentially dangerous operations.",
3576 &setlist),
3577 &showlist);
3578
3579 add_prefix_cmd ("info", class_info, info_command,
3580 "Generic command for showing things about the program being debugged.",
3581 &infolist, "info ", 0, &cmdlist);
3582 add_com_alias ("i", "info", class_info, 1);
3583
3584 add_com ("complete", class_obscure, complete_command,
3585 "List the completions for the rest of the line as a command.");
3586
3587 add_prefix_cmd ("show", class_info, show_command,
3588 "Generic command for showing things about the debugger.",
3589 &showlist, "show ", 0, &cmdlist);
3590 /* Another way to get at the same thing. */
3591 add_info ("set", show_command, "Show all GDB settings.");
3592
3593 add_cmd ("commands", no_class, show_commands,
943b7032 3594 "Show the history of commands you typed.\n\
172559ec
JK
3595You can supply a command number to start with, or a `+' to start after\n\
3596the previous command number shown.",
3597 &showlist);
3598
3599 add_cmd ("version", no_class, show_version,
3600 "Show what version of GDB this is.", &showlist);
3601
e52bfe0c
JL
3602 add_com ("while", class_support, while_command,
3603"Execute nested commands WHILE the conditional expression is non zero.\n\
943b7032
PS
3604The conditional expression must follow the word `while' and must in turn be\n\
3605followed by a new line. The nested commands must be entered one per line,\n\
e52bfe0c
JL
3606and should be terminated by the word `end'.");
3607
3608 add_com ("if", class_support, if_command,
3609"Execute nested commands once IF the conditional expression is non zero.\n\
943b7032
PS
3610The conditional expression must follow the word `if' and must in turn be\n\
3611followed by a new line. The nested commands must be entered one per line,\n\
3612and should be terminated by the word 'else' or `end'. If an else clause\n\
e52bfe0c
JL
3613is used, the same rules apply to its nested commands as to the first ones.");
3614
172559ec
JK
3615 /* If target is open when baud changes, it doesn't take effect until the
3616 next open (I think, not sure). */
3617 add_show_from_set (add_set_cmd ("remotebaud", no_class,
3618 var_zinteger, (char *)&baud_rate,
3619 "Set baud rate for remote serial I/O.\n\
3620This value is used to set the speed of the serial port when debugging\n\
3621using remote targets.", &setlist),
3622 &showlist);
3623
3624 add_show_from_set (
3625 add_set_cmd ("remotedebug", no_class, var_zinteger, (char *)&remote_debug,
3626 "Set debugging of remote protocol.\n\
3627When enabled, each packet sent or received with the remote target\n\
3628is displayed.", &setlist),
3629 &showlist);
cb1709ae
DP
3630
3631 add_show_from_set (
3632 add_set_cmd ("remotetimeout", no_class, var_integer, (char *)&remote_timeout,
3633 "Set timeout limit to wait for target to respond.\n\
3634This value is used to set the time limit for gdb to wait for a response\n\
3635from he target.", &setlist),
3636 &showlist);
62dd860e
MS
3637
3638 c = add_set_cmd ("annotate", class_obscure, var_zinteger,
3639 (char *)&annotation_level, "Set annotation_level.\n\
36400 == normal; 1 == fullname (for use when running under emacs)\n\
36412 == output annotated suitably for use by programs that control GDB.",
3642 &setlist);
3643 c = add_show_from_set (c, &showlist);
172559ec 3644}
This page took 0.298238 seconds and 4 git commands to generate.