/* Top level `main' program for GDB, the GNU debugger.
Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992
Free Software Foundation, Inc.
This file is part of GDB.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
/* readline include files */
/* readline defines these. */
#ifdef SET_STACK_LIMIT_HUGE
#include <sys/resource.h>
int original_stack_limit
;
/* Prototypes for local functions */
symbol_completion_function
PARAMS ((char *, int));
command_loop
PARAMS ((void));
command_loop_marker
PARAMS ((int));
print_gdb_version
PARAMS ((void));
quit_command
PARAMS ((char *, int));
initialize_main
PARAMS ((void));
initialize_history
PARAMS ((void));
initialize_cmd_lists
PARAMS ((void));
float_handler
PARAMS ((int));
source_command
PARAMS ((char *, int));
cd_command
PARAMS ((char *, int));
print_gnu_advertisement
PARAMS ((void));
init_signals
PARAMS ((void));
read_command_file
PARAMS ((FILE *));
set_verbose
PARAMS ((char *, int, struct cmd_list_element
*));
show_history
PARAMS ((char *, int));
set_history
PARAMS ((char *, int));
set_history_size_command
PARAMS ((char *, int, struct cmd_list_element
*));
show_commands
PARAMS ((char *, int));
echo_command
PARAMS ((char *, int));
pwd_command
PARAMS ((char *, int));
show_version
PARAMS ((char *, int));
document_command
PARAMS ((char *, int));
define_command
PARAMS ((char *, int));
validate_comname
PARAMS ((char *));
help_command
PARAMS ((char *, int));
show_command
PARAMS ((char *, int));
info_command
PARAMS ((char *, int));
do_nothing
PARAMS ((int));
quit_cover
PARAMS ((char *));
disconnect
PARAMS ((int));
source_cleanup
PARAMS ((FILE *));
/* If this definition isn't overridden by the header files, assume
that isatty and fileno exist on this system. */
#define ISATTY(FP) (isatty (fileno (FP)))
/* Initialization file name for gdb. This is overridden in some configs. */
#define GDBINIT_FILENAME ".gdbinit"
char gdbinit
[] = GDBINIT_FILENAME
;
#define ALL_CLEANUPS ((struct cleanup *)0)
/* Version number of GDB, as a string. */
/* Message to be printed before the error message, when an error occurs. */
extern char *error_pre_print
;
/* Message to be printed before the warning message, when a warning occurs. */
extern char *warning_pre_print
;
extern char lang_frame_mismatch_warn
[]; /* language.c */
/* Whether GDB's stdin is on a terminal. */
extern int gdb_has_a_terminal
; /* inflow.c */
/* Flag for whether we want all the "from_tty" gubbish printed. */
int caution
= 1; /* Default is yes, sigh. */
* Define all cmd_list_element's
/* Chain containing all defined commands. */
struct cmd_list_element
*cmdlist
;
/* Chain containing all defined info subcommands. */
struct cmd_list_element
*infolist
;
/* Chain containing all defined enable subcommands. */
struct cmd_list_element
*enablelist
;
/* Chain containing all defined disable subcommands. */
struct cmd_list_element
*disablelist
;
/* Chain containing all defined delete subcommands. */
struct cmd_list_element
*deletelist
;
/* Chain containing all defined "enable breakpoint" subcommands. */
struct cmd_list_element
*enablebreaklist
;
/* Chain containing all defined set subcommands */
struct cmd_list_element
*setlist
;
/* Chain containing all defined unset subcommands */
struct cmd_list_element
*unsetlist
;
/* Chain containing all defined show subcommands. */
struct cmd_list_element
*showlist
;
/* Chain containing all defined \"set history\". */
struct cmd_list_element
*sethistlist
;
/* Chain containing all defined \"show history\". */
struct cmd_list_element
*showhistlist
;
/* Chain containing all defined \"unset history\". */
struct cmd_list_element
*unsethistlist
;
/* Chain containing all defined maintenance subcommands. */
struct cmd_list_element
*maintenancelist
;
/* Chain containing all defined "maintenance info" subcommands. */
struct cmd_list_element
*maintenanceinfolist
;
/* Chain containing all defined "maintenance print" subcommands. */
struct cmd_list_element
*maintenanceprintlist
;
struct cmd_list_element
*setprintlist
;
struct cmd_list_element
*showprintlist
;
struct cmd_list_element
*setchecklist
;
struct cmd_list_element
*showchecklist
;
/* stdio stream that command input is being read from. */
/* Current working directory. */
/* The directory name is actually stored here (usually). */
static char dirbuf
[MAXPATHLEN
];
/* Nonzero if we're debugging /dev/kmem or a kernel crash dump */
/* Function to call before reading a command, if nonzero.
The function receives two args: an input stream,
void (*window_hook
) PARAMS ((FILE *, char *));
extern int frame_file_full_name
;
extern int mapped_symbol_files
;
extern int readnow_symbol_files
;
/* Nonzero to inhibit confirmation of quitting or restarting
/* The number of lines on a page */
/* Nonzero if we should refrain from using an X window. */
extern int frame_file_full_name
;
/* Buffer used for reading command lines, and the size
allocated for it so far. */
/* gdb prints this when reading a command interactively */
static char *masterprompt
;
/* Baud rate specified for talking to serial target systems. Default
is left as a zero pointer, so targets can choose their own defaults. */
/* Signal to catch ^Z typed while reading a command: SIGTSTP or SIGCONT. */
#define STOP_SIGNAL SIGTSTP
static void stop_sig
PARAMS ((int));
/* Some System V have job control but not sigsetmask(). */
#if !defined (HAVE_SIGSETMASK)
#define HAVE_SIGSETMASK !defined (USG)
#if 0 == (HAVE_SIGSETMASK)
/* This is how `error' returns to command level. */
bpstat_clear_actions(stop_bpstat
); /* Clear queued breakpoint commands */
disable_current_display ();
do_cleanups (ALL_CLEANUPS
);
(NORETURN
void) longjmp (to_top_level
, 1);
/* Call FUNC with arg ARGS, catching any errors.
If there is no error, return the value returned by FUNC.
If there is an error, print ERRSTRING, print the specific error message,
catch_errors (func
, args
, errstring
)
int (*func
) PARAMS ((char *));
struct cleanup
*saved_cleanup_chain
;
char *saved_error_pre_print
;
saved_cleanup_chain
= save_cleanups ();
saved_error_pre_print
= error_pre_print
;
memcpy ((char *)saved
, (char *)to_top_level
, sizeof (jmp_buf));
error_pre_print
= errstring
;
if (setjmp (to_top_level
) == 0)
restore_cleanups (saved_cleanup_chain
);
error_pre_print
= saved_error_pre_print
;
memcpy ((char *)to_top_level
, (char *)saved
, sizeof (jmp_buf));
/* Handler for SIGHUP. */
catch_errors (quit_cover
, NULL
, "Could not kill inferior process");
signal (SIGHUP
, SIG_DFL
);
kill (getpid (), SIGHUP
);
/* Just a little helper function for disconnect(). */
caution
= 0; /* Throw caution to the wind -- we're exiting.
This prevents asking the user dumb questions. */
quit_command((char *)0, 0);
* Source an init file if it exists.
if (access (file
, R_OK
) == 0)
if (!setjmp (to_top_level
))
source_command (file
, 0);
do_cleanups(ALL_CLEANUPS
);
* Source $HOME/.gdbinit and $cwd/.gdbinit.
* If X is enabled, also $HOME/.xgdbinit and $cwd/.xgdbinit.source
char *homedir
, initfile
[256];
/* Read init file, if it exists in home directory */
homedir
= getenv ("HOME");
struct stat homebuf
, cwdbuf
;
sprintf(initfile
, "%s/%s", homedir
, gdbinit
);
sprintf(initfile
, "%s/.xgdbinit", homedir
);
sprintf(initfile
, "%s/.kgdbinit", homedir
);
/* Determine if current directory is the same as the home
directory, so we don't source the same file twice. */
bzero (&homebuf
, sizeof (struct stat
));
bzero (&cwdbuf
, sizeof (struct stat
));
samedir
= bcmp(&homebuf
, &cwdbuf
, sizeof(struct stat
)) == 0;
/* Read the input file in the current directory, *if* it isn't
the same file (it should exist, also). */
/* Clean up on error during a "source" command (or execution of a
user-defined command). */
/* Restore the previous input stream. */
/* Read commands from STREAM. */
read_command_file (stream
)
struct cleanup
*cleanups
;
cleanups
= make_cleanup (source_cleanup
, instream
);
* Process the core file argument.
* We infer (lexically) from the name and (semantically) from the
* corresponding file type what the target is. It's one of a live
* user process (pid), a user process core dump (core), a kernel
* crash dump (vmcore), a live kernel (/dev/mem), a remote kernel (/dev/ttya)
* or a remote internet host (@127.0.0.1).
do_core_arg(corefile
, batch
)
if (setjmp(to_top_level
))
/* Internet host -- we're remote debugging. */
remote_open(corefile
, 0);
else if (stat(corefile
, &stb
) == 0) {
if (S_ISCHR(stb
.st_mode
)) {
* character device -- either we're debugging a live
* kernel (/dev/mem, /dev/kmem) or a remote kernel
* over a serial link. Use the heuristic that
* /dev/mem has a "small" major device number.
if (major(stb
.st_rdev
) <= 4)
kernel_core_open(corefile
, !batch
);
remote_open(corefile
, !batch
);
} else if (kernel_debugging
)
/* a kernel crash dump */
kernel_core_open(corefile
, !batch
);
core_file_command(corefile
, !batch
);
} else if (isdigit(corefile
[0]))
attach_command(corefile
, !batch
);
* stat() failed and arg isn't a pid
static int inhibit_gdbinit
= 0;
/* Pointers to various arguments from command line. */
/* Pointers to all arguments of +command option. */
/* Allocated size of cmdarg. */
/* Number of elements of cmdarg used. */
/* Indices of all arguments of +directory option. */
/* Number of elements used. */
/* XXX Windows only for xgdb. */
if (cp
= strrchr(argv
[0], '/'))
/* This needs to happen before the first use of malloc. */
init_malloc ((PTR
) NULL
);
#if defined (ALIGN_STACK_ON_STARTUP)
/* If error() is called from initialization code, just exit */
if (setjmp (to_top_level
)) {
cmdarg
= (char **) xmalloc (cmdsize
* sizeof (*cmdarg
));
dirarg
= (char **) xmalloc (dirsize
* sizeof (*dirarg
));
getcwd (dirbuf
, sizeof (dirbuf
));
current_directory
= dirbuf
;
#ifdef SET_STACK_LIMIT_HUGE
/* Set the stack limit huge so that alloca (particularly stringtab
* in dbxread.c) does not fail. */
getrlimit (RLIMIT_STACK
, &rlim
);
original_stack_limit
= rlim
.rlim_cur
;
rlim
.rlim_cur
= rlim
.rlim_max
;
setrlimit (RLIMIT_STACK
, &rlim
);
#endif /* SET_STACK_LIMIT_HUGE */
/* Parse arguments and options. */
/* When var field is 0, use flag field to record the equivalent
short option (or arbitrary numbers starting at 10 for those
static struct option long_options
[] =
{"readnow", no_argument
, &readnow_symbol_files
, 1},
{"r", no_argument
, &readnow_symbol_files
, 1},
{"mapped", no_argument
, &mapped_symbol_files
, 1},
{"m", no_argument
, &mapped_symbol_files
, 1},
{"quiet", no_argument
, &quiet
, 1},
{"q", no_argument
, &quiet
, 1},
{"version", no_argument
, &quiet
, 0},
{"nc", no_argument
, &inhibit_confirm
, 1},
{"nx", no_argument
, &inhibit_gdbinit
, 1},
{"nw", no_argument
, &inhibit_windows
, 1},
{"n", no_argument
, &inhibit_gdbinit
, 1},
{"batch", no_argument
, &batch
, 1},
{"epoch", no_argument
, &epoch_interface
, 1},
{"fullname", no_argument
, &frame_file_full_name
, 1},
{"f", no_argument
, &frame_file_full_name
, 1},
{"help", no_argument
, &print_help
, 1},
{"se", required_argument
, 0, 10},
{"symbols", required_argument
, 0, 's'},
{"s", required_argument
, 0, 's'},
{"exec", required_argument
, 0, 'e'},
{"e", required_argument
, 0, 'e'},
{"core", required_argument
, 0, 'c'},
{"c", required_argument
, 0, 'c'},
{"command", required_argument
, 0, 'x'},
{"x", required_argument
, 0, 'x'},
{"directory", required_argument
, 0, 'd'},
{"cd", required_argument
, 0, 11},
{"tty", required_argument
, 0, 't'},
{"baud", required_argument
, 0, 'b'},
{"b", required_argument
, 0, 'b'},
{"w", no_argument
, &write_files
, 1},
{"k", no_argument
, &kernel_debugging
, 1},
/* Allow machine descriptions to add more options... */
#ifdef ADDITIONAL_OPTIONS
c
= getopt_long_only (argc
, argv
, "",
long_options
, &option_index
);
/* Long option that takes an argument. */
if (c
== 0 && long_options
[option_index
].flag
== 0)
c
= long_options
[option_index
].val
;
/* Long option that just sets a flag. */
cmdarg
= (char **) xrealloc ((char *)cmdarg
,
cmdsize
* sizeof (*cmdarg
));
dirarg
= (char **) xrealloc ((char *)dirarg
,
dirsize
* sizeof (*dirarg
));
#ifdef ADDITIONAL_OPTION_CASES
"Use `%s +help' for a complete list of options.\n",
This is GDB, the GNU debugger. Use the command\n\
gdb [options] [executable [core-file]]\n\
to enter the debugger.\n\
Options available are:\n\
-help Print this message.\n\
-quiet Do not print version number on startup.\n\
-fullname Output information used by emacs-GDB interface.\n\
-epoch Output information used by epoch emacs-GDB interface.\n\
-batch Exit after processing options.\n\
-nx Do not read .gdbinit file.\n\
-tty=TTY Use TTY for input/output by the program being debugged.\n\
-cd=DIR Change current directory to DIR.\n\
-directory=DIR Search for source files in DIR.\n\
-command=FILE Execute GDB commands from FILE.\n\
-symbols=SYMFILE Read symbols from SYMFILE.\n\
-exec=EXECFILE Use EXECFILE as the executable.\n\
-se=FILE Use FILE as symbol file and executable file.\n\
-core=COREFILE Analyze the core dump COREFILE.\n\
-b BAUDRATE Set serial port baud rate used for remote debugging.\n\
-mapped Use mapped symbol files if supported on this system.\n\
-readnow Fully read symbol files on first access.\n\
-version Print GNU message and version number on startup.\n\
-nc Don't confirm quit or run commands.\n\
#ifdef ADDITIONAL_OPTION_HELP
fputs (ADDITIONAL_OPTION_HELP
, stderr
);
For more information, type \"help\" from within GDB, or consult the\n\
GDB manual (available as on-line info or a printed manual).\n", stderr
);
/* Exiting after printing this message seems like
the most useful thing to do. */
/* OK, that's all the options. The other arguments are filenames. */
for (; optind
< argc
; optind
++)
"Excess command line arguments ignored. (%s%s)\n",
argv
[optind
], (optind
== argc
- 1) ? "" : " ...");
/* Run the init function of each source file */
initialize_cmd_lists (); /* This needs to be done first */
initialize_main (); /* But that omits this file! Do it now */
/* Print all the junk at the top, with trailing "..." if we are about
to read a symbol file (possibly slowly). */
print_gnu_advertisement ();
fflush (stdout
); /* Force to screen during slow operations */
error_pre_print
= "\n\n";
/* We may get more than one warning, don't double space all of them... */
warning_pre_print
= "\nwarning: ";
/* We need a default language for parsing expressions, so simple things like
"set width 0" won't fail if no language is explicitly set in a config file
or implicitly set by reading an executable during startup. */
set_language (language_c
);
expected_language
= current_language
; /* don't warn about the change. */
/* Now perform all the actions indicated by the arguments. */
if (!setjmp (to_top_level
))
do_cleanups (ALL_CLEANUPS
);
for (i
= 0; i
< ndir
; i
++)
if (!setjmp (to_top_level
))
directory_command (dirarg
[i
], 0);
do_cleanups (ALL_CLEANUPS
);
&& strcmp (execarg
, symarg
) == 0)
/* The exec file and the symbol-file are the same. If we can't open
it, better only print one error message. */
if (!setjmp (to_top_level
))
exec_file_command (execarg
, !batch
);
symbol_file_command (symarg
, 0);
if (!setjmp (to_top_level
))
exec_file_command (execarg
, !batch
);
if (!setjmp (to_top_level
))
symbol_file_command (symarg
, 0);
do_cleanups (ALL_CLEANUPS
);
/* After the symbol file has been read, print a newline to get us
beyond the copyright line... But errors should still set off
the error message with a (single) blank line. */
warning_pre_print
= "\nwarning: ";
do_core_arg(corearg
, batch
);
do_cleanups (ALL_CLEANUPS
);
if (!setjmp (to_top_level
))
tty_command (ttyarg
, !batch
);
do_cleanups (ALL_CLEANUPS
);
#ifdef ADDITIONAL_OPTION_HANDLER
ADDITIONAL_OPTION_HANDLER
;
/* Error messages should no longer be distinguished with extra output. */
warning_pre_print
= "warning: ";
for (i
= 0; i
< ncmd
; i
++)
if (!setjmp (to_top_level
))
if (cmdarg
[i
][0] == '-' && cmdarg
[i
][1] == '\0')
read_command_file (stdin
);
source_command (cmdarg
[i
], !batch
);
do_cleanups (ALL_CLEANUPS
);
/* Read in the old history after all the command files have been read. */
/* We have hit the end of the batch file. */
/* Do any host- or target-specific hacks. This is used for i960 targets
to force the user to set a nindy target and spec its parameters. */
#ifdef BEFORE_MAIN_LOOP_HOOK
if (!setjmp (to_top_level
))
do_cleanups (ALL_CLEANUPS
); /* Do complete cleanup */
quit_command ((char *)0, instream
== stdin
);
/* No exit -- exit is through quit_command. */
execute_user_command (c
, args
)
struct cmd_list_element
*c
;
register struct command_line
*cmdlines
;
struct cleanup
*old_chain
;
error ("User-defined commands cannot take arguments.");
cmdlines
= c
->user_commands
;
/* Set the instream to 0, indicating execution of a
user-defined function. */
old_chain
= make_cleanup (source_cleanup
, instream
);
execute_command (cmdlines
->line
, 0);
cmdlines
= cmdlines
->next
;
command_loop_marker (foo
)
/* Read commands from `instream' and execute them
until end of file or error reading instream. */
struct cleanup
*old_chain
;
register int toplevel
= (instream
== stdin
);
register int interactive
= (toplevel
&& ISATTY(stdin
));
reinitialize_more_filter ();
old_chain
= make_cleanup (command_loop_marker
, 0);
cmd_line
= command_line_input (toplevel
? masterprompt
: 0, toplevel
);
execute_command (cmd_line
, toplevel
);
/* Do any commands attached to breakpoint we stopped at. */
bpstat_do_actions (&stop_bpstat
);
/* Read a line from the stream "instream" without command line editing.
It prints PROMPT once at the start.
Action is compatible with "readline", e.g. space for the result is
malloc'd and should be freed by the caller.
A NULL return means end of file. */
/* Don't use a _filtered function here. It causes the assumed
character position to be off, since the newline we read from
the user is not accounted for. */
result
= (char *) xmalloc (result_size
);
/* Read from stdin if we are executing a user defined command.
This is the right thing for prompt_for_continue, at least. */
c
= fgetc (instream
? instream
: stdin
);
result
[input_index
++] = c
;
while (input_index
>= result_size
)
result
= (char *) xrealloc (result
, result_size
);
result
[input_index
++] = '\0';
/* Variables which control command line editing and history
substitution. These variables are given default values at the end
static int write_history_p
;
static unsigned int history_size
;
static char *history_filename
;
/* Variables which are necessary for fancy command line editing. */
char *gdb_completer_word_break_characters
=
" \t\n!@#$%^&*()+=|~`}{[]\"';?/>.<,-";
/* When completing on command names, we remove '-' from the list of
word break characters, since we use it in command names. If the
readline library sees one in any of the current completion strings,
it thinks that the string needs to be quoted and automatically supplies
char *gdb_completer_command_word_break_characters
=
" \t\n!@#$%^&*()+=|~`}{[]\"';?/>.<,";
/* Characters that can be used to quote completion strings. Note that we
can't include '"' because the gdb C parser treats such quoted sequences
char *gdb_completer_quote_characters
=
/* Functions that are used as part of the fancy command line editing. */
/* This can be used for functions which don't want to complete on symbols
but don't want to complete on anything else either. */
/* Generate symbol names one by one for the completer. Each time we are
called return another potential completion to the caller.
TEXT is what we expect the symbol to start with.
MATCHES is the number of matches that have currently been collected from
calling this completion function. When zero, then we need to initialize,
otherwise the initialization has already taken place and we can just
return the next potential completion string.
Returns NULL if there are no more completions, else a pointer to a string
which is a possible completion.
RL_LINE_BUFFER is available to be looked at; it contains the entire text
of the line. RL_POINT is the offset in that line of the cursor. You
should pretend that the line ends at RL_POINT. */
symbol_completion_function (text
, matches
)
static char **list
= (char **)NULL
; /* Cache of completions */
static int index
; /* Next cached completion */
struct cmd_list_element
*c
, *result_list
;
extern char *rl_line_buffer
;
/* The caller is beginning to accumulate a new set of completions, so
we need to find all of them now, and cache them for returning one at
a time on future calls. */
/* Free the storage used by LIST, but not by the strings inside.
This is because rl_complete_internal () frees the strings. */
/* Choose the default set of word break characters to break completions.
If we later find out that we are doing completions on command strings
(as opposed to strings supplied by the individual command completer
functions, which can be any string) then we will switch to the
special word break set for command strings, which leaves out the
'-' character used in some commands. */
rl_completer_word_break_characters
=
gdb_completer_word_break_characters
;
/* Decide whether to complete on a list of gdb commands or on symbols. */
tmp_command
= (char *) alloca (rl_point
+ 1);
strncpy (tmp_command
, rl_line_buffer
, rl_point
);
tmp_command
[rl_point
] = '\0';
/* An empty line we want to consider ambiguous; that is, it
c
= (struct cmd_list_element
*) -1;
c
= lookup_cmd_1 (&p
, cmdlist
, &result_list
, 1);
/* Move p up to the next interesting thing. */
while (*p
== ' ' || *p
== '\t')
/* He's typed something unrecognizable. Sigh. */
else if (c
== (struct cmd_list_element
*) -1)
/* If we didn't recognize everything up to the thing that
needs completing, and we don't know what command it is
yet, we are in trouble. */
if (p
+ strlen(text
) != tmp_command
+ rl_point
)
/* This really should not produce an error. Better would
be to pretend to hit RETURN here; this would produce a
response like "Ambiguous command: foo, foobar, etc",
and leave the line available for re-entry with ^P.
Instead, this error blows away the user's typed input
without any way to get it back. */
error (" Unrecognized command.");
/* He's typed something ambiguous. This is easier. */
list
= complete_on_cmdlist (*result_list
->prefixlist
, text
);
list
= complete_on_cmdlist (cmdlist
, text
);
rl_completer_word_break_characters
=
gdb_completer_command_word_break_characters
;
/* If we've gotten this far, gdb has recognized a full
command. There are several possibilities:
1) We need to complete on the command.
2) We need to complete on the possibilities coming after
2) We need to complete the text of what comes after the
/* Always (might be longer versions of thie command). */
list
= complete_on_cmdlist (result_list
, text
);
rl_completer_word_break_characters
=
gdb_completer_command_word_break_characters
;
list
= complete_on_cmdlist (*c
->prefixlist
, "");
rl_completer_word_break_characters
=
gdb_completer_command_word_break_characters
;
list
= (*c
->completer
) ("");
if (c
->prefixlist
&& !c
->allow_unknown
)
/* Something like "info adsfkdj". But error() is not the
proper response; just return no completions instead. */
list
= (*c
->completer
) (text
);
/* If we found a list of potential completions during initialization then
dole them out one at a time. The vector of completions is NULL
terminated, so after returning the last one, return NULL (and continue
to do so) each time we are called after that, until a new list is
/* Skip over a possibly quoted word (as defined by the quote characters
and word break characters the completer uses). Returns pointer to the
location after the "word". */
for (scan
= str
; *scan
!= '\0'; scan
++)
/* Ignore everything until the matching close quote char */
/* Found matching close quote. */
else if (strchr (gdb_completer_quote_characters
, *scan
))
/* Found start of a quoted string. */
else if (strchr (gdb_completer_word_break_characters
, *scan
))
#if STOP_SIGNAL == SIGTSTP
signal (SIGTSTP
, SIG_DFL
);
kill (getpid (), SIGTSTP
);
signal (SIGTSTP
, stop_sig
);
signal (STOP_SIGNAL
, stop_sig
);
printf ("%s", masterprompt
);
/* Forget about any previous command -- null line now will do nothing. */
/* Initialize signal handlers. */
static void suspend_sig ();
signal (SIGINT
, request_quit
);
/* If we initialize SIGQUIT to SIG_IGN, then the SIG_IGN will get
passed to the inferior, which we don't want. It would be
possible to do a "signal (SIGQUIT, SIG_DFL)" after we fork, but
on BSD4.3 systems using vfork, that will (apparently) affect the
GDB process as well as the inferior (the signal handling tables
being shared between the two, apparently). Since we establish
a handler for SIGQUIT, when we call exec it will set the signal
signal (SIGQUIT
, do_nothing
);
if (signal (SIGHUP
, do_nothing
) != SIG_IGN
)
signal (SIGHUP
, disconnect
);
signal (SIGFPE
, float_handler
);
#if defined(SIGWINCH) && defined(SIGWINCH_HANDLER)
signal (SIGWINCH
, SIGWINCH_HANDLER
);
init_term(fileno(stdin
));
signal(SIGTSTP
, suspend_sig
);
/* Execute the line P as a command.
Pass FROM_TTY as second argument to the defining function. */
execute_command (p
, from_tty
)
register struct cmd_list_element
*c
;
register struct command_line
*cmdlines
;
register enum language flang
;
static const struct language_defn
*saved_language
= 0;
/* This can happen when command_line_input hits end of file. */
while (*p
== ' ' || *p
== '\t') p
++;
c
= lookup_cmd(&p
, cmdlist
, "", 0, 1);
/* Pass null arg rather than an empty one. */
if (c
->function
.cfunc
== 0)
error("That is not a command, just a help topic.");
else if (c
->class == (int) class_user
) {
extern struct cleanup
*setup_user_args();
struct cleanup
*old_chain
= setup_user_args(p
);
if (c
->user_commands
!= 0)
(void)execute_command_lines(c
->user_commands
);
} else if (c
->type
== set_cmd
|| c
->type
== show_cmd
)
do_setshow_command (arg
, from_tty
& caution
, c
);
else if (c
->function
.cfunc
== NO_FUNCTION
)
error ("That is not a command, just a help topic.");
(*c
->function
.cfunc
) (arg
, from_tty
& caution
);
/* Tell the user if the language has changed (except first time). */
if (current_language
!= saved_language
)
if (language_mode
== language_mode_auto
) {
saved_language
= current_language
;
/* Warn the user if the working language does not match the
language of the current frame. Only warn the user if we are
actually running the program, i.e. there is a stack. */
/* FIXME: This should be cacheing the frame and only running when
flang
= get_frame_language ();
&& flang
!= language_unknown
&& flang
!= current_language
->la_language
)
printf_filtered ("%s\n", lang_frame_mismatch_warn
);
/* Add an element to the list of info subcommands. */
add_info (name
, fun
, doc
)
void (*fun
) PARAMS ((char *, int));
add_cmd (name
, no_class
, fun
, doc
, &infolist
);
/* Add an alias to the list of info subcommands. */
add_info_alias (name
, oldname
, abbrev_flag
)
add_alias_cmd (name
, oldname
, 0, abbrev_flag
, &infolist
);
/* The "info" command is defined as a prefix, with allow_unknown = 0.
Therefore, its own definition is called only for "info" with no args. */
info_command (arg
, from_tty
)
printf ("\"info\" must be followed by the name of an info command.\n");
help_list (infolist
, "info ", -1, stdout
);
/* The "show" command with no arguments shows all the settings. */
show_command (arg
, from_tty
)
cmd_show_list (showlist
, from_tty
, "");
/* Add an element to the list of commands. */
add_com (name
, class, fun
, doc
)
enum command_class
class;
void (*fun
) PARAMS ((char *, int));
add_cmd (name
, class, fun
, doc
, &cmdlist
);
/* Add an alias or abbreviation command to the list of commands. */
add_com_alias (name
, oldname
, class, abbrev_flag
)
enum command_class
class;
add_alias_cmd (name
, oldname
, class, abbrev_flag
, &cmdlist
);
error ("Argument required (%s).", why
);
help_command (command
, from_tty
)
int from_tty
; /* Ignored */
help_cmd (command
, stdout
);
validate_comname (comname
)
error_no_arg ("name of command to define");
if (!isalnum(*p
) && *p
!= '-')
error ("Junk in argument list: \"%s\"", p
);
/* This is just a placeholder in the command data structures. */
user_defined_command (ignore
, from_tty
)
define_command (comname
, from_tty
)
register struct command_line
*cmds
;
register struct cmd_list_element
*c
, *newc
, *hookc
= 0;
#define HOOK_STRING "hook-"
validate_comname (comname
);
/* Look it up, and verify that we got an exact match. */
c
= lookup_cmd (&tem
, cmdlist
, "", -1, 1);
if (c
&& 0 != strcmp (comname
, c
->name
))
if (c
->class == class_user
|| c
->class == class_alias
)
tem
= "Redefine command \"%s\"? ";
tem
= "Really redefine built-in command \"%s\"? ";
if (!query (tem
, c
->name
))
error ("Command \"%s\" not redefined.", c
->name
);
/* If this new command is a hook, then mark the command which it
is hooking. Note that we allow hooking `help' commands, so that
we can hook the `stop' pseudo-command. */
if (!strncmp (comname
, HOOK_STRING
, HOOK_LEN
))
/* Look up cmd it hooks, and verify that we got an exact match. */
hookc
= lookup_cmd (&tem
, cmdlist
, "", -1, 0);
if (hookc
&& 0 != strcmp (comname
+HOOK_LEN
, hookc
->name
))
warning ("Your new `%s' command does not hook any existing command.",
if (!query ("Proceed? ", (char *)0))
error ("Not confirmed.");
comname
= savestring (comname
, strlen (comname
));
/* If the rest of the commands will be case insensitive, this one
should behave in the same manner. */
for (tem
= comname
; *tem
; tem
++)
if (isupper(*tem
)) *tem
= tolower(*tem
);
printf ("Type commands for definition of \"%s\".\n\
End with a line saying just \"end\".\n", comname
);
cmds
= read_command_lines (from_tty
);
if (c
&& c
->class == class_user
)
free_command_lines (c
->user_commands
);
newc
= add_cmd (comname
, class_user
, user_defined_command
,
(c
&& c
->class == class_user
)
? c
->doc
: savestring ("User-defined.", 13), &cmdlist
);
newc
->user_commands
= cmds
;
/* If this new command is a hook, then mark both commands as being
hookc
->hook
= newc
; /* Target gets hooked. */
newc
->hookee
= hookc
; /* We are marked as hooking target cmd. */
document_command (comname
, from_tty
)
struct command_line
*doclines
;
register struct cmd_list_element
*c
;
validate_comname (comname
);
c
= lookup_cmd (&tem
, cmdlist
, "", 0, 1);
if (c
->class != class_user
)
error ("Command \"%s\" is built-in.", comname
);
printf ("Type documentation for \"%s\".\n\
End with a line saying just \"end\".\n", comname
);
doclines
= read_command_lines (from_tty
);
if (c
->doc
) free (c
->doc
);
register struct command_line
*cl1
;
for (cl1
= doclines
; cl1
; cl1
= cl1
->next
)
len
+= strlen (cl1
->line
) + 1;
c
->doc
= (char *) xmalloc (len
+ 1);
for (cl1
= doclines
; cl1
; cl1
= cl1
->next
)
strcat (c
->doc
, cl1
->line
);
free_command_lines (doclines
);
print_gnu_advertisement()
GDB is free software and you are welcome to distribute copies of it\n\
under certain conditions; type \"show copying\" to see the conditions.\n\
There is absolutely no warranty for GDB; type \"show warranty\" for details.\n\
GDB %s, Copyright 1992 Free Software Foundation, Inc.",
show_version (args
, from_tty
)
print_gnu_advertisement ();
/* xgdb calls this to reprint the usual GDB prompt. */
printf ("%s", masterprompt
);
static struct termio norm_tty
;
ioctl(tty
, TCGETA
, &norm_tty
);
ioctl(tty
, TCGETA
, &cur_tty
);
ioctl(tty
, TCSETAW
, &norm_tty
);
signal(SIGTSTP
, SIG_DFL
);
* we've just been resumed -- current tty params become new
* 'normal' params (in case tset/stty was done while we were
* suspended). Merge values that readline might have changed
* into new params, then restore term mode.
ioctl(tty
, TCGETA
, &norm_tty
);
cur_tty
.c_lflag
= (cur_tty
.c_lflag
& (ICANON
|ECHO
|ISIG
)) |
(norm_tty
.c_lflag
&~ (ICANON
|ECHO
|ISIG
));
cur_tty
.c_iflag
= (cur_tty
.c_iflag
& (IXON
|ISTRIP
|INPCK
)) |
(norm_tty
.c_iflag
&~ (IXON
|ISTRIP
|INPCK
));
ioctl(tty
, TCSETAW
, &cur_tty
);
signal(SIGTSTP
, suspend_sig
);
* Forget about any previous command -- null line now will do
#include <sys/ioctl.h> /* XXX BSD: must follow sgtty.h for compat to kick in */
static struct sgttyb norm_tty
;
static struct tchars norm_tchars
;
static struct ltchars norm_ltchars
;
#define RL_TFLAGS (RAW|CRMOD|ECHO|CBREAK|PASS8)
#define RL_TFLAGS (RAW|CRMOD|ECHO|CBREAK)
ioctl(tty
, TIOCGETP
, &norm_tty
);
ioctl(tty
, TIOCLGET
, &norm_lflags
);
ioctl(tty
, TIOCGETC
, &norm_tchars
);
ioctl(tty
, TIOCGLTC
, &norm_ltchars
);
struct tchars cur_tchars
;
struct ltchars cur_ltchars
;
ioctl(tty
, TIOCGETP
, &cur_tty
);
ioctl(tty
, TIOCGETC
, &cur_tchars
);
ioctl(tty
, TIOCLGET
, &cur_lflags
);
ioctl(tty
, TIOCGLTC
, &cur_ltchars
);
ioctl(tty
, TIOCSETP
, &norm_tty
);
ioctl(tty
, TIOCSETC
, &norm_tchars
);
ioctl(tty
, TIOCLSET
, &norm_lflags
);
ioctl(tty
, TIOCSLTC
, &norm_ltchars
);
signal(SIGTSTP
, SIG_DFL
);
* we've just been resumed -- current tty params become new
* 'normal' params (in case tset/stty was done while we were
* suspended). Merge values that readline might have changed
* into new params, then restore term mode.
ioctl(tty
, TIOCGETP
, &norm_tty
);
cur_flags
= cur_tty
.sg_flags
;
cur_tty
.sg_flags
= (cur_tty
.sg_flags
&~ RL_TFLAGS
)
| (cur_flags
& RL_TFLAGS
);
ioctl(tty
, TIOCLGET
, &norm_lflags
);
cur_lflags
= (cur_lflags
&~ LPASS8
) | (cur_flags
& LPASS8
);
ioctl(tty
, TIOCGETC
, &norm_tchars
);
ioctl(tty
, TIOCGLTC
, &norm_ltchars
);
ioctl(tty
, TIOCSETP
, &cur_tty
);
ioctl(tty
, TIOCSETC
, &cur_tchars
);
ioctl(tty
, TIOCLSET
, &cur_lflags
);
ioctl(tty
, TIOCSLTC
, &cur_ltchars
);
signal(SIGTSTP
, suspend_sig
);
* Forget about any previous command -- null line now will do
quit_command (args
, from_tty
)
* Don't bother checking if the inferior_pid is 0 because the remote
* module doesn't muck with it (for pid 0, target_kill should be a nop
* in the ptrace case anyway -- moreover, inferior_pid should be private
if (target_has_execution
)
if (inhibit_confirm
|| query ("The program is running. Quit anyway? "))
target_detach (args
, from_tty
);
error ("Not confirmed.");
/* Save the history information if it is appropriate to do so. */
if (write_history_p
&& history_filename
)
write_history (history_filename
);
/* Returns whether GDB is running on a terminal and whether the user
desires that questions be asked of them on that terminal. */
return gdb_has_a_terminal
&& (instream
== stdin
) & caution
;
pwd_command (args
, from_tty
)
if (args
) error ("The \"pwd\" command does not take an argument: %s", args
);
getcwd (dirbuf
, sizeof (dirbuf
));
if (strcmp (dirbuf
, current_directory
))
printf ("Working directory %s\n (canonically %s).\n",
current_directory
, dirbuf
);
printf ("Working directory %s.\n", current_directory
);
cd_command (dir
, from_tty
)
/* If the new directory is absolute, repeat is a no-op; if relative,
repeat might be useful but is more likely to be a mistake. */
error_no_arg ("new working directory");
dir
= tilde_expand (dir
);
make_cleanup (free
, dir
);
dir
= savestring (dir
, len
- (len
> 1 && dir
[len
-1] == '/'));
current_directory
= concat (current_directory
, "/", dir
, NULL
);
/* Now simplify any occurrences of `.' and `..' in the pathname. */
for (p
= current_directory
; *p
;)
if (!strncmp (p
, "/./", 2)
&& (p
[2] == 0 || p
[2] == '/'))
else if (!strncmp (p
, "/..", 3)
&& (p
[3] == 0 || p
[3] == '/')
&& p
!= current_directory
)
while (q
!= current_directory
&& q
[-1] != '/') q
--;
if (q
!= current_directory
)
forget_cached_source_info ();
pwd_command ((char *) 0, 1);
source_command (args
, from_tty
)
struct cleanup
*cleanups
;
/* Let source without arguments read .gdbinit. */
file
= tilde_expand (file
);
make_cleanup (free
, file
);
stream
= fopen (file
, "r");
char *cp
= xmalloc(strlen(file
) + 5);
sprintf(cp
, "%s.gdb", file
);
cleanups
= make_cleanup (fclose
, stream
);
read_command_file (stream
);
echo_command (text
, from_tty
)
/* \ at end of argument is used after spaces
so they won't be lost. */
printf_filtered ("%c", c
);
printf_filtered ("%c", c
);
/* Force this output to appear now. */
/* Functions to manipulate command line editing control variables. */
/* Number of commands to print in each call to show_commands. */
show_commands (args
, from_tty
)
/* Index for history commands. Relative to history_base. */
/* Number of the history entry which we are planning to display next.
Relative to history_base. */
/* The first command in the history which doesn't exist (i.e. one more
than the number of the last command). Relative to history_base. */
extern struct _hist_entry
*history_get
PARAMS ((int));
/* Print out some of the commands from the command history. */
/* First determine the length of the history list. */
for (offset
= 0; offset
< history_size
; offset
++)
if (!history_get (history_base
+ offset
))
if (args
[0] == '+' && args
[1] == '\0')
/* "info editing +" should print from the stored position. */
/* "info editing <exp>" should print around command number <exp>. */
num
= (parse_and_eval_address (args
) - history_base
) - Hist_print
/ 2;
/* "show commands" means print the last Hist_print commands. */
num
= hist_len
- Hist_print
;
/* If there are at least Hist_print commands, we want to display the last
Hist_print rather than, say, the last 6. */
if (hist_len
- num
< Hist_print
)
num
= hist_len
- Hist_print
;
for (offset
= num
; offset
< num
+ Hist_print
&& offset
< hist_len
; offset
++)
printf_filtered ("%5d %s\n", history_base
+ offset
,
(history_get (history_base
+ offset
))->line
);
/* The next command we want to display is the next one that we haven't
/* If the user repeats this command with return, it should do what
"show commands +" does. This is unnecessary if arg is null,
because "show commands +" is not useful after "show commands". */
/* Called by do_setshow_command. */
set_history_size_command (args
, from_tty
, c
)
struct cmd_list_element
*c
;
if (history_size
== UINT_MAX
)
else if (history_size
>= 0)
stifle_history (history_size
);
error ("History size must be non-negative");
set_history (args
, from_tty
)
printf ("\"set history\" must be followed by the name of a history subcommand.\n");
help_list (sethistlist
, "set history ", -1, stdout
);
show_history (args
, from_tty
)
cmd_show_list (showhistlist
, from_tty
, "");
int info_verbose
= 0; /* Default verbose msgs off */
/* Called by do_setshow_command. An elaborate joke. */
set_verbose (args
, from_tty
, c
)
struct cmd_list_element
*c
;
char *cmdname
= "verbose";
struct cmd_list_element
*showcmd
;
showcmd
= lookup_cmd_1 (&cmdname
, showlist
, NULL
, 1);
c
->doc
= "Set verbose printing of informational messages.";
showcmd
->doc
= "Show verbose printing of informational messages.";
c
->doc
= "Set verbosity.";
showcmd
->doc
= "Show verbosity.";
/* This message is based on ANSI C, section 4.7. Note that integer
divide by zero causes this, so "float" is a misnomer. */
error ("Erroneous arithmetic operation.");
/* Return whether we are running a batch file or from terminal. */
return !(instream
== stdin
&& ISATTY (stdin
));
maintenanceinfolist
= NULL
;
maintenanceprintlist
= NULL
;
/* Init the history buffer. Note that we are called after the init file(s)
* have been read so that the user can change the history file via his
* .gdbinit file (for instance). The GDBHISTFILE environment variable
tmpenv
= getenv ("HISTSIZE");
history_size
= atoi (tmpenv
);
stifle_history (history_size
);
tmpenv
= getenv ("GDBHISTFILE");
history_filename
= savestring (tmpenv
, strlen(tmpenv
));
else if (!history_filename
) {
/* We include the current directory so that if the user changes
directories the file written will be the same as the one
history_filename
= concat (current_directory
, "/.gdb_history", NULL
);
read_history (history_filename
);
masterprompt
= strsave (s
);
struct cmd_list_element
*c
;
set_prompt(DEFAULT_PROMPT
);
if (kernel_debugging
) set_prompt ("(kgdb) "); else
/* Set the important stuff up for command editing. */
/* Setup important stuff for command line editing. */
rl_completion_entry_function
= (int (*)()) symbol_completion_function
;
rl_completer_word_break_characters
= gdb_completer_word_break_characters
;
rl_completer_quote_characters
= gdb_completer_quote_characters
;
rl_readline_name
= "gdb";
/* Define the classes of commands.
They will appear in the help list in the reverse of this order. */
add_cmd ("internals", class_maintenance
, NO_FUNCTION
,
"Maintenance commands.\n\
Some gdb commands are provided just for use by gdb maintainers.\n\
These commands are subject to frequent change, and may not be as\n\
well documented as user commands.",
add_cmd ("obscure", class_obscure
, NO_FUNCTION
, "Obscure features.", &cmdlist
);
add_cmd ("aliases", class_alias
, NO_FUNCTION
, "Aliases of other commands.", &cmdlist
);
add_cmd ("user-defined", class_user
, NO_FUNCTION
, "User-defined commands.\n\
The commands in this class are those defined by the user.\n\
Use the \"define\" command to define a command.", &cmdlist
);
add_cmd ("support", class_support
, NO_FUNCTION
, "Support facilities.", &cmdlist
);
add_cmd ("status", class_info
, NO_FUNCTION
, "Status inquiries.", &cmdlist
);
add_cmd ("files", class_files
, NO_FUNCTION
, "Specifying and examining files.", &cmdlist
);
add_cmd ("breakpoints", class_breakpoint
, NO_FUNCTION
, "Making program stop at certain points.", &cmdlist
);
add_cmd ("data", class_vars
, NO_FUNCTION
, "Examining data.", &cmdlist
);
add_cmd ("stack", class_stack
, NO_FUNCTION
, "Examining the stack.\n\
The stack is made up of stack frames. Gdb assigns numbers to stack frames\n\
counting from zero for the innermost (currently executing) frame.\n\n\
At any time gdb identifies one frame as the \"selected\" frame.\n\
Variable lookups are done with respect to the selected frame.\n\
When the program being debugged stops, gdb selects the innermost frame.\n\
The commands below can be used to select other frames by number or address.",
add_cmd ("running", class_run
, NO_FUNCTION
, "Running the program.", &cmdlist
);
add_com ("pwd", class_files
, pwd_command
,
"Print working directory. This is used for your program as well.");
add_com ("cd", class_files
, cd_command
,
"Set working directory to DIR for debugger and program being debugged.\n\
The change does not take effect for the program being debugged\n\
until the next time it is started.");
(add_set_cmd ("prompt", class_support
, var_string
, (char *)&masterprompt
,
add_com ("echo", class_support
, echo_command
,
"Print a constant string. Give string as argument.\n\
C escape sequences may be used in the argument.\n\
No newline is added at the end of the argument;\n\
use \"\\n\" if you want a newline to be printed.\n\
Since leading and trailing whitespace are ignored in command arguments,\n\
if you want to print some you must use \"\\\" before leading whitespace\n\
to be printed or after trailing whitespace.");
add_com ("document", class_support
, document_command
,
"Document a user-defined command.\n\
Give command name as argument. Give documentation on following lines.\n\
End with a line of just \"end\".");
add_com ("define", class_support
, define_command
,
"Define a new command name. Command name is argument.\n\
Definition appears on following lines, one command per line.\n\
End with a line of just \"end\".\n\
Use the \"document\" command to give documentation for the new command.\n\
Commands defined in this way do not take arguments.");
add_com ("source", class_support
, source_command
,
"Read commands from a file named FILE.\n\
Note that the file \"" GDBINIT_FILENAME
"\" is read automatically in this way\n\
/* Punt file name, we can't help it easily. */
add_com ("source", class_support
, source_command
,
"Read commands from a file named FILE.\n\
Note that the file \".gdbinit\" is read automatically in this way\n\
add_com ("quit", class_support
, quit_command
, "Exit gdb.");
add_com ("help", class_support
, help_command
, "Print list of commands.");
add_com_alias ("q", "quit", class_support
, 1);
add_com_alias ("h", "help", class_support
, 1);
c
= add_set_cmd ("verbose", class_support
, var_boolean
, (char *)&info_verbose
,
add_show_from_set (c
, &showlist
);
c
->function
.sfunc
= set_verbose
;
set_verbose (NULL
, 0, c
);
add_prefix_cmd ("history", class_support
, set_history
,
"Generic command for setting command history parameters.",
&sethistlist
, "set history ", 0, &setlist
);
add_prefix_cmd ("history", class_support
, show_history
,
"Generic command for showing command history parameters.",
&showhistlist
, "show history ", 0, &showlist
);
(add_set_cmd ("save", no_class
, var_boolean
, (char *)&write_history_p
,
"Set saving of the history record on exit.\n\
Use \"on\" to enable to enable the saving, and \"off\" to disable it.\n\
Without an argument, saving is enabled.", &sethistlist
),
c
= add_set_cmd ("size", no_class
, var_uinteger
, (char *)&history_size
,
"Set the size of the command history, \n\
ie. the number of previous commands to keep a record of.", &sethistlist
);
add_show_from_set (c
, &showhistlist
);
c
->function
.sfunc
= set_history_size_command
;
(add_set_cmd ("filename", no_class
, var_filename
, (char *)&history_filename
,
"Set the filename in which to record the command history\n\
(the list of previous commands of which a record is kept).", &sethistlist
),
(add_set_cmd ("confirm", class_support
, var_boolean
,
"Set whether to confirm potentially dangerous operations.",
add_prefix_cmd ("info", class_info
, info_command
,
"Generic command for showing things about the program being debugged.",
&infolist
, "info ", 0, &cmdlist
);
add_com_alias ("i", "info", class_info
, 1);
add_prefix_cmd ("show", class_info
, show_command
,
"Generic command for showing things about the debugger.",
&showlist
, "show ", 0, &cmdlist
);
/* Another way to get at the same thing. */
add_info ("set", show_command
, "Show all GDB settings.");
add_cmd ("commands", no_class
, show_commands
,
"Show the the history of commands you typed.\n\
You can supply a command number to start with, or a `+' to start after\n\
the previous command number shown.",
add_cmd ("version", no_class
, show_version
,
"Show what version of GDB this is.", &showlist
);