Make gdb_in_secondary_prompt_p() be per UI
[deliverable/binutils-gdb.git] / gdb / main.c
CommitLineData
c906108c 1/* Top level stuff for GDB, the GNU debugger.
4389a95a 2
618f726f 3 Copyright (C) 1986-2016 Free Software Foundation, Inc.
c906108c 4
c5aa993b 5 This file is part of GDB.
c906108c 6
c5aa993b
JM
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
a9762ec7 9 the Free Software Foundation; either version 3 of the License, or
c5aa993b 10 (at your option) any later version.
c906108c 11
c5aa993b
JM
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
c906108c 16
c5aa993b 17 You should have received a copy of the GNU General Public License
a9762ec7 18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
c906108c
SS
19
20#include "defs.h"
c906108c
SS
21#include "top.h"
22#include "target.h"
23#include "inferior.h"
1adeb98a
FN
24#include "symfile.h"
25#include "gdbcore.h"
c906108c
SS
26#include "getopt.h"
27
28#include <sys/types.h>
53ce3c39 29#include <sys/stat.h>
c906108c 30#include <ctype.h>
9e0b60a8 31#include "event-loop.h"
8b93c638 32#include "ui-out.h"
6457bd47 33
4389a95a 34#include "interps.h"
f15ab4a7 35#include "main.h"
29b0e8a2 36#include "source.h"
4cc23ede 37#include "cli/cli-cmds.h"
7f6130ff 38#include "objfiles.h"
e2207b9a 39#include "auto-load.h"
bd712aed 40#include "maint.h"
29b0e8a2 41
b5981e5a 42#include "filenames.h"
614c279d 43#include "filestuff.h"
992c7d70 44#include <signal.h>
94696ad3 45#include "event-top.h"
98880d46 46#include "infrun.h"
b5981e5a 47
4389a95a
AC
48/* The selected interpreter. This will be used as a set command
49 variable, so it should always be malloc'ed - since
371d5dec 50 do_setshow_command will free it. */
fb40c209 51char *interpreter_p;
fb40c209 52
371d5dec 53/* Whether dbx commands will be handled. */
c906108c
SS
54int dbx_commands = 0;
55
030292b7
DJ
56/* System root path, used to find libraries etc. */
57char *gdb_sysroot = 0;
58
b14b1491
TT
59/* GDB datadir, used to store data files. */
60char *gdb_datadir = 0;
61
e64e0392
DE
62/* Non-zero if GDB_DATADIR was provided on the command line.
63 This doesn't track whether data-directory is set later from the
64 command line, but we don't reread system.gdbinit when that happens. */
65static int gdb_datadir_provided = 0;
66
0c4a4063
DE
67/* If gdb was configured with --with-python=/path,
68 the possibly relocated path to python's lib directory. */
69char *python_libdir = 0;
70
371d5dec 71/* Target IO streams. */
449092f6 72struct ui_file *gdb_stdtargin;
22e8e3c7 73struct ui_file *gdb_stdtarg;
449092f6 74struct ui_file *gdb_stdtargerr;
c906108c 75
7c953934
TT
76/* True if --batch or --batch-silent was seen. */
77int batch_flag = 0;
78
1a088d06
AS
79/* Support for the --batch-silent option. */
80int batch_silent = 0;
81
4b0ad762
AS
82/* Support for --return-child-result option.
83 Set the default to -1 to return error in the case
84 that the program does not run or does not complete. */
85int return_child_result = 0;
86int return_child_result_value = -1;
87
c906108c 88
16e7150e
JG
89/* GDB as it has been invoked from the command line (i.e. argv[0]). */
90static char *gdb_program_name;
91
c88a1531
AB
92/* Return read only pointer to GDB_PROGRAM_NAME. */
93const char *
94get_gdb_program_name (void)
95{
96 return gdb_program_name;
97}
98
d9fcf2fb 99static void print_gdb_help (struct ui_file *);
c906108c 100
8d551b02
DE
101/* Set the data-directory parameter to NEW_DATADIR.
102 If NEW_DATADIR is not a directory then a warning is printed.
103 We don't signal an error for backward compatibility. */
104
105void
106set_gdb_data_directory (const char *new_datadir)
107{
108 struct stat st;
109
110 if (stat (new_datadir, &st) < 0)
111 {
112 int save_errno = errno;
113
114 fprintf_unfiltered (gdb_stderr, "Warning: ");
115 print_sys_errmsg (new_datadir, save_errno);
116 }
117 else if (!S_ISDIR (st.st_mode))
118 warning (_("%s is not a directory."), new_datadir);
119
120 xfree (gdb_datadir);
121 gdb_datadir = gdb_realpath (new_datadir);
122
123 /* gdb_realpath won't return an absolute path if the path doesn't exist,
124 but we still want to record an absolute path here. If the user entered
125 "../foo" and "../foo" doesn't exist then we'll record $(pwd)/../foo which
126 isn't canonical, but that's ok. */
127 if (!IS_ABSOLUTE_PATH (gdb_datadir))
128 {
129 char *abs_datadir = gdb_abspath (gdb_datadir);
130
131 xfree (gdb_datadir);
132 gdb_datadir = abs_datadir;
133 }
134}
135
b14b1491
TT
136/* Relocate a file or directory. PROGNAME is the name by which gdb
137 was invoked (i.e., argv[0]). INITIAL is the default value for the
138 file or directory. FLAG is true if the value is relocatable, false
139 otherwise. Returns a newly allocated string; this may return NULL
140 under the same conditions as make_relative_prefix. */
478aac75 141
b14b1491
TT
142static char *
143relocate_path (const char *progname, const char *initial, int flag)
144{
145 if (flag)
146 return make_relative_prefix (progname, BINDIR, initial);
147 return xstrdup (initial);
148}
149
150/* Like relocate_path, but specifically checks for a directory.
151 INITIAL is relocated according to the rules of relocate_path. If
152 the result is a directory, it is used; otherwise, INITIAL is used.
153 The chosen directory is then canonicalized using lrealpath. This
154 function always returns a newly-allocated string. */
478aac75
DE
155
156char *
157relocate_gdb_directory (const char *initial, int flag)
b14b1491
TT
158{
159 char *dir;
160
478aac75 161 dir = relocate_path (gdb_program_name, initial, flag);
b14b1491
TT
162 if (dir)
163 {
164 struct stat s;
165
78a8b30e 166 if (*dir == '\0' || stat (dir, &s) != 0 || !S_ISDIR (s.st_mode))
b14b1491
TT
167 {
168 xfree (dir);
169 dir = NULL;
170 }
171 }
172 if (!dir)
173 dir = xstrdup (initial);
174
175 /* Canonicalize the directory. */
176 if (*dir)
177 {
178 char *canon_sysroot = lrealpath (dir);
b8d56208 179
b14b1491
TT
180 if (canon_sysroot)
181 {
182 xfree (dir);
183 dir = canon_sysroot;
184 }
185 }
186
187 return dir;
188}
189
371d5dec
MS
190/* Compute the locations of init files that GDB should source and
191 return them in SYSTEM_GDBINIT, HOME_GDBINIT, LOCAL_GDBINIT. If
192 there is no system gdbinit (resp. home gdbinit and local gdbinit)
193 to be loaded, then SYSTEM_GDBINIT (resp. HOME_GDBINIT and
194 LOCAL_GDBINIT) is set to NULL. */
16e7150e 195static void
50dd9793
PA
196get_init_files (const char **system_gdbinit,
197 const char **home_gdbinit,
198 const char **local_gdbinit)
16e7150e 199{
50dd9793 200 static const char *sysgdbinit = NULL;
16e7150e 201 static char *homeinit = NULL;
50dd9793 202 static const char *localinit = NULL;
16e7150e
JG
203 static int initialized = 0;
204
205 if (!initialized)
206 {
207 struct stat homebuf, cwdbuf, s;
e64e0392 208 char *homedir;
16e7150e 209
b14b1491 210 if (SYSTEM_GDBINIT[0])
16e7150e 211 {
e64e0392
DE
212 int datadir_len = strlen (GDB_DATADIR);
213 int sys_gdbinit_len = strlen (SYSTEM_GDBINIT);
214 char *relocated_sysgdbinit;
215
216 /* If SYSTEM_GDBINIT lives in data-directory, and data-directory
217 has been provided, search for SYSTEM_GDBINIT there. */
218 if (gdb_datadir_provided
219 && datadir_len < sys_gdbinit_len
b5981e5a
EZ
220 && filename_ncmp (SYSTEM_GDBINIT, GDB_DATADIR, datadir_len) == 0
221 && IS_DIR_SEPARATOR (SYSTEM_GDBINIT[datadir_len]))
e64e0392
DE
222 {
223 /* Append the part of SYSTEM_GDBINIT that follows GDB_DATADIR
224 to gdb_datadir. */
225 char *tmp_sys_gdbinit = xstrdup (SYSTEM_GDBINIT + datadir_len);
226 char *p;
227
b5981e5a 228 for (p = tmp_sys_gdbinit; IS_DIR_SEPARATOR (*p); ++p)
e64e0392
DE
229 continue;
230 relocated_sysgdbinit = concat (gdb_datadir, SLASH_STRING, p,
b36cec19 231 (char *) NULL);
e64e0392
DE
232 xfree (tmp_sys_gdbinit);
233 }
234 else
235 {
236 relocated_sysgdbinit = relocate_path (gdb_program_name,
237 SYSTEM_GDBINIT,
238 SYSTEM_GDBINIT_RELOCATABLE);
239 }
b14b1491 240 if (relocated_sysgdbinit && stat (relocated_sysgdbinit, &s) == 0)
16e7150e
JG
241 sysgdbinit = relocated_sysgdbinit;
242 else
243 xfree (relocated_sysgdbinit);
244 }
16e7150e
JG
245
246 homedir = getenv ("HOME");
247
248 /* If the .gdbinit file in the current directory is the same as
249 the $HOME/.gdbinit file, it should not be sourced. homebuf
025bb325 250 and cwdbuf are used in that purpose. Make sure that the stats
16e7150e
JG
251 are zero in case one of them fails (this guarantees that they
252 won't match if either exists). */
253
254 memset (&homebuf, 0, sizeof (struct stat));
255 memset (&cwdbuf, 0, sizeof (struct stat));
256
257 if (homedir)
258 {
259 homeinit = xstrprintf ("%s/%s", homedir, gdbinit);
260 if (stat (homeinit, &homebuf) != 0)
261 {
262 xfree (homeinit);
263 homeinit = NULL;
264 }
265 }
266
267 if (stat (gdbinit, &cwdbuf) == 0)
268 {
269 if (!homeinit
270 || memcmp ((char *) &homebuf, (char *) &cwdbuf,
271 sizeof (struct stat)))
272 localinit = gdbinit;
273 }
274
275 initialized = 1;
276 }
277
278 *system_gdbinit = sysgdbinit;
279 *home_gdbinit = homeinit;
280 *local_gdbinit = localinit;
281}
282
992c7d70
GB
283/* Try to set up an alternate signal stack for SIGSEGV handlers.
284 This allows us to handle SIGSEGV signals generated when the
285 normal process stack is exhausted. If this stack is not set
286 up (sigaltstack is unavailable or fails) and a SIGSEGV is
287 generated when the normal stack is exhausted then the program
288 will behave as though no SIGSEGV handler was installed. */
289
290static void
291setup_alternate_signal_stack (void)
292{
293#ifdef HAVE_SIGALTSTACK
294 stack_t ss;
295
f39c07ac
JB
296 /* FreeBSD versions older than 11.0 use char * for ss_sp instead of
297 void *. This cast works with both types. */
298 ss.ss_sp = (char *) xmalloc (SIGSTKSZ);
992c7d70
GB
299 ss.ss_size = SIGSTKSZ;
300 ss.ss_flags = 0;
301
302 sigaltstack(&ss, NULL);
303#endif
304}
305
11cf8741 306/* Call command_loop. If it happens to return, pass that through as a
371d5dec 307 non-zero return status. */
11cf8741
JM
308
309static int
310captured_command_loop (void *data)
c906108c 311{
f38d3ad1
PA
312 struct ui *ui = current_ui;
313
bb5291d0 314 /* Top-level execution commands can be run in the background from
b4a14fd0 315 here on. */
cb814510 316 current_ui->async = 1;
b4a14fd0 317
b2d86570
PA
318 /* Give the interpreter a chance to print a prompt. */
319 interp_pre_command_loop (top_level_interpreter ());
320
321 /* Now it's time to start the event loop. */
322 start_event_loop ();
323
11cf8741
JM
324 /* FIXME: cagney/1999-11-05: A correct command_loop() implementaton
325 would clean things up (restoring the cleanup chain) to the state
326 they were just prior to the call. Technically, this means that
e26cc349 327 the do_cleanups() below is redundant. Unfortunately, many FUNCs
11cf8741
JM
328 are not that well behaved. do_cleanups should either be replaced
329 with a do_cleanups call (to cover the problem) or an assertion
371d5dec 330 check to detect bad FUNCs code. */
6328eb38 331 do_cleanups (all_cleanups ());
11cf8741 332 /* If the command_loop returned, normally (rather than threw an
025bb325 333 error) we try to quit. If the quit is aborted, catch_errors()
11cf8741 334 which called this catch the signal and restart the command
371d5dec 335 loop. */
f38d3ad1 336 quit_command (NULL, ui->instream == stdin);
11cf8741
JM
337 return 1;
338}
339
94696ad3
PA
340/* Handle command errors thrown from within
341 catch_command_errors/catch_command_errors_const. */
342
343static int
284e6217 344handle_command_errors (struct gdb_exception e)
94696ad3
PA
345{
346 if (e.reason < 0)
347 {
348 exception_print (gdb_stderr, e);
349
350 /* If any exception escaped to here, we better enable stdin.
351 Otherwise, any command that calls async_disable_stdin, and
352 then throws, will leave stdin inoperable. */
353 async_enable_stdin ();
354 return 0;
355 }
356 return 1;
357}
358
9d1e69a2
PA
359/* Type of the command callback passed to catch_command_errors. */
360
361typedef void (catch_command_errors_ftype) (char *, int);
362
363/* Wrap calls to commands run before the event loop is started. */
364
365static int
366catch_command_errors (catch_command_errors_ftype *command,
97c18565 367 char *arg, int from_tty)
9d1e69a2 368{
492d29ea 369 TRY
9d1e69a2 370 {
98880d46
PA
371 int was_sync = sync_execution;
372
9d1e69a2 373 command (arg, from_tty);
98880d46
PA
374
375 maybe_wait_sync_command_done (was_sync);
9d1e69a2 376 }
492d29ea
PA
377 CATCH (e, RETURN_MASK_ALL)
378 {
379 return handle_command_errors (e);
380 }
381 END_CATCH
382
383 return 1;
9d1e69a2
PA
384}
385
386/* Type of the command callback passed to catch_command_errors_const. */
387
388typedef void (catch_command_errors_const_ftype) (const char *, int);
389
390/* Like catch_command_errors, but works with const command and args. */
391
392static int
393catch_command_errors_const (catch_command_errors_const_ftype *command,
97c18565 394 const char *arg, int from_tty)
9d1e69a2 395{
492d29ea 396 TRY
9d1e69a2 397 {
98880d46
PA
398 int was_sync = sync_execution;
399
9d1e69a2 400 command (arg, from_tty);
98880d46
PA
401
402 maybe_wait_sync_command_done (was_sync);
9d1e69a2 403 }
492d29ea
PA
404 CATCH (e, RETURN_MASK_ALL)
405 {
406 return handle_command_errors (e);
407 }
408 END_CATCH
409
410 return 1;
9d1e69a2
PA
411}
412
52059ffd
TT
413/* Type of this option. */
414enum cmdarg_kind
415{
416 /* Option type -x. */
417 CMDARG_FILE,
26743505 418
52059ffd
TT
419 /* Option type -ex. */
420 CMDARG_COMMAND,
8320cc4f 421
52059ffd
TT
422 /* Option type -ix. */
423 CMDARG_INIT_FILE,
8320cc4f 424
52059ffd
TT
425 /* Option type -iex. */
426 CMDARG_INIT_COMMAND
427};
428
429/* Arguments of --command option and its counterpart. */
430typedef struct cmdarg {
431 /* Type of this option. */
432 enum cmdarg_kind type;
26743505
JK
433
434 /* Value of this option - filename or the GDB command itself. String memory
435 is not owned by this structure despite it is 'const'. */
436 char *string;
437} cmdarg_s;
438
439/* Define type VEC (cmdarg_s). */
440DEF_VEC_O (cmdarg_s);
441
11cf8741
JM
442static int
443captured_main (void *data)
444{
f38d3ad1 445 struct ui *ui = current_ui;
19ba03f4 446 struct captured_main_args *context = (struct captured_main_args *) data;
11cf8741
JM
447 int argc = context->argc;
448 char **argv = context->argv;
c906108c 449 static int quiet = 0;
552c04a7 450 static int set_args = 0;
07540c15 451 static int inhibit_home_gdbinit = 0;
c906108c
SS
452
453 /* Pointers to various arguments from command line. */
454 char *symarg = NULL;
455 char *execarg = NULL;
a4d9b460 456 char *pidarg = NULL;
c906108c 457 char *corearg = NULL;
a4d9b460 458 char *pid_or_core_arg = NULL;
c906108c
SS
459 char *cdarg = NULL;
460 char *ttyarg = NULL;
461
371d5dec
MS
462 /* These are static so that we can take their address in an
463 initializer. */
c906108c
SS
464 static int print_help;
465 static int print_version;
6eaaf48b 466 static int print_configuration;
c906108c
SS
467
468 /* Pointers to all arguments of --command option. */
26743505
JK
469 VEC (cmdarg_s) *cmdarg_vec = NULL;
470 struct cmdarg *cmdarg_p;
c906108c
SS
471
472 /* Indices of all arguments of --directory option. */
473 char **dirarg;
474 /* Allocated size. */
475 int dirsize;
476 /* Number of elements used. */
477 int ndir;
c5aa993b 478
16e7150e 479 /* gdb init files. */
50dd9793
PA
480 const char *system_gdbinit;
481 const char *home_gdbinit;
482 const char *local_gdbinit;
c906108c 483
52f0bd74 484 int i;
88a1906b 485 int save_auto_load;
7f6130ff 486 struct objfile *objfile;
c906108c 487
e565b837
DE
488 struct cleanup *pre_stat_chain;
489
490#ifdef HAVE_SBRK
491 /* Set this before calling make_command_stats_cleanup. */
492 lim_at_start = (char *) sbrk (0);
493#endif
494
495 pre_stat_chain = make_command_stats_cleanup (0);
c906108c 496
0fbb3da7
TT
497#if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
498 setlocale (LC_MESSAGES, "");
499#endif
500#if defined (HAVE_SETLOCALE)
501 setlocale (LC_CTYPE, "");
502#endif
503 bindtextdomain (PACKAGE, LOCALEDIR);
504 textdomain (PACKAGE);
505
5484b13a 506 bfd_init ();
614c279d 507 notice_open_fds ();
5484b13a 508
26743505 509 make_cleanup (VEC_cleanup (cmdarg_s), &cmdarg_vec);
c906108c
SS
510 dirsize = 1;
511 dirarg = (char **) xmalloc (dirsize * sizeof (*dirarg));
512 ndir = 0;
513
2669cade 514 saved_command_line = (char *) xstrdup ("");
694ec099 515
f38d3ad1 516 ui->instream = stdin;
694ec099
PA
517 ui->outstream = stdout;
518 ui->errstream = stderr;
519
41fd2b0f 520 ui->input_fd = fileno (stdin);
c906108c 521
ffa4ac95
YQ
522#ifdef __MINGW32__
523 /* Ensure stderr is unbuffered. A Cygwin pty or pipe is implemented
524 as a Windows pipe, and Windows buffers on pipes. */
525 setvbuf (stderr, NULL, _IONBF, BUFSIZ);
526#endif
527
da59e081 528 gdb_stdout = stdio_fileopen (stdout);
694ec099 529 gdb_stderr = stderr_fileopen (stderr);
ffa4ac95 530
da59e081
JM
531 gdb_stdlog = gdb_stderr; /* for moment */
532 gdb_stdtarg = gdb_stderr; /* for moment */
449092f6
CV
533 gdb_stdin = stdio_fileopen (stdin);
534 gdb_stdtargerr = gdb_stderr; /* for moment */
535 gdb_stdtargin = gdb_stdin; /* for moment */
c906108c 536
b5981e5a
EZ
537#ifdef __MINGW32__
538 /* On Windows, argv[0] is not necessarily set to absolute form when
539 GDB is found along PATH, without which relocation doesn't work. */
540 gdb_program_name = windows_get_absolute_argv0 (argv[0]);
541#else
16e7150e 542 gdb_program_name = xstrdup (argv[0]);
b5981e5a 543#endif
16e7150e 544
075c7033
GB
545 /* Prefix warning messages with the command name. */
546 warning_pre_print = xstrprintf ("%s: warning: ", gdb_program_name);
547
bf1d7d9c 548 if (! getcwd (gdb_dirbuf, sizeof (gdb_dirbuf)))
075c7033
GB
549 perror_warning_with_name (_("error finding working directory"));
550
bf1d7d9c
JB
551 current_directory = gdb_dirbuf;
552
030292b7 553 /* Set the sysroot path. */
478aac75
DE
554 gdb_sysroot = relocate_gdb_directory (TARGET_SYSTEM_ROOT,
555 TARGET_SYSTEM_ROOT_RELOCATABLE);
030292b7 556
fed040c6
GB
557 if (gdb_sysroot == NULL || *gdb_sysroot == '\0')
558 {
559 xfree (gdb_sysroot);
560 gdb_sysroot = xstrdup (TARGET_SYSROOT_PREFIX);
561 }
562
478aac75
DE
563 debug_file_directory = relocate_gdb_directory (DEBUGDIR,
564 DEBUGDIR_RELOCATABLE);
030292b7 565
478aac75
DE
566 gdb_datadir = relocate_gdb_directory (GDB_DATADIR,
567 GDB_DATADIR_RELOCATABLE);
aa28a74e 568
0c4a4063 569#ifdef WITH_PYTHON_PATH
e6040cbd
MS
570 {
571 /* For later use in helping Python find itself. */
b36cec19 572 char *tmp = concat (WITH_PYTHON_PATH, SLASH_STRING, "lib", (char *) NULL);
e6040cbd 573
478aac75 574 python_libdir = relocate_gdb_directory (tmp, PYTHON_PATH_RELOCATABLE);
e6040cbd
MS
575 xfree (tmp);
576 }
0c4a4063
DE
577#endif
578
29b0e8a2
JM
579#ifdef RELOC_SRCDIR
580 add_substitute_path_rule (RELOC_SRCDIR,
b5981e5a 581 make_relative_prefix (gdb_program_name, BINDIR,
29b0e8a2
JM
582 RELOC_SRCDIR));
583#endif
584
4389a95a 585 /* There will always be an interpreter. Either the one passed into
e46e5ccd
KS
586 this captured main, or one specified by the user at start up, or
587 the console. Initialize the interpreter to the one requested by
588 the application. */
11bf1490 589 interpreter_p = xstrdup (context->interpreter_p);
4389a95a 590
c906108c
SS
591 /* Parse arguments and options. */
592 {
593 int c;
594 /* When var field is 0, use flag field to record the equivalent
595 short option (or arbitrary numbers starting at 10 for those
596 with no equivalent). */
49c7e338
AC
597 enum {
598 OPT_SE = 10,
599 OPT_CD,
600 OPT_ANNOTATE,
601 OPT_STATISTICS,
42fa7c0f
AC
602 OPT_TUI,
603 OPT_NOWINDOWS,
8320cc4f
JK
604 OPT_WINDOWS,
605 OPT_IX,
606 OPT_IEX
49c7e338 607 };
c906108c 608 static struct option long_options[] =
c5aa993b 609 {
49c7e338 610 {"tui", no_argument, 0, OPT_TUI},
c5aa993b
JM
611 {"dbx", no_argument, &dbx_commands, 1},
612 {"readnow", no_argument, &readnow_symbol_files, 1},
613 {"r", no_argument, &readnow_symbol_files, 1},
c5aa993b
JM
614 {"quiet", no_argument, &quiet, 1},
615 {"q", no_argument, &quiet, 1},
616 {"silent", no_argument, &quiet, 1},
07540c15 617 {"nh", no_argument, &inhibit_home_gdbinit, 1},
c5aa993b
JM
618 {"nx", no_argument, &inhibit_gdbinit, 1},
619 {"n", no_argument, &inhibit_gdbinit, 1},
1a088d06 620 {"batch-silent", no_argument, 0, 'B'},
7c953934 621 {"batch", no_argument, &batch_flag, 1},
c5aa993b 622
371d5dec
MS
623 /* This is a synonym for "--annotate=1". --annotate is now
624 preferred, but keep this here for a long time because people
625 will be running emacses which use --fullname. */
c5aa993b
JM
626 {"fullname", no_argument, 0, 'f'},
627 {"f", no_argument, 0, 'f'},
628
49c7e338 629 {"annotate", required_argument, 0, OPT_ANNOTATE},
c5aa993b 630 {"help", no_argument, &print_help, 1},
49c7e338 631 {"se", required_argument, 0, OPT_SE},
c5aa993b
JM
632 {"symbols", required_argument, 0, 's'},
633 {"s", required_argument, 0, 's'},
634 {"exec", required_argument, 0, 'e'},
635 {"e", required_argument, 0, 'e'},
636 {"core", required_argument, 0, 'c'},
637 {"c", required_argument, 0, 'c'},
00546b04
MS
638 {"pid", required_argument, 0, 'p'},
639 {"p", required_argument, 0, 'p'},
c5aa993b 640 {"command", required_argument, 0, 'x'},
8a5a3c82 641 {"eval-command", required_argument, 0, 'X'},
c5aa993b 642 {"version", no_argument, &print_version, 1},
6eaaf48b 643 {"configuration", no_argument, &print_configuration, 1},
c5aa993b 644 {"x", required_argument, 0, 'x'},
8a5a3c82 645 {"ex", required_argument, 0, 'X'},
8320cc4f
JK
646 {"init-command", required_argument, 0, OPT_IX},
647 {"init-eval-command", required_argument, 0, OPT_IEX},
648 {"ix", required_argument, 0, OPT_IX},
649 {"iex", required_argument, 0, OPT_IEX},
3fc11d3e
JM
650#ifdef GDBTK
651 {"tclcommand", required_argument, 0, 'z'},
652 {"enable-external-editor", no_argument, 0, 'y'},
653 {"editor-command", required_argument, 0, 'w'},
654#endif
8b93c638
JM
655 {"ui", required_argument, 0, 'i'},
656 {"interpreter", required_argument, 0, 'i'},
657 {"i", required_argument, 0, 'i'},
c5aa993b 658 {"directory", required_argument, 0, 'd'},
c4093a6a 659 {"d", required_argument, 0, 'd'},
aae1c79a 660 {"data-directory", required_argument, 0, 'D'},
8d551b02 661 {"D", required_argument, 0, 'D'},
49c7e338 662 {"cd", required_argument, 0, OPT_CD},
c5aa993b
JM
663 {"tty", required_argument, 0, 't'},
664 {"baud", required_argument, 0, 'b'},
665 {"b", required_argument, 0, 'b'},
42fa7c0f
AC
666 {"nw", no_argument, NULL, OPT_NOWINDOWS},
667 {"nowindows", no_argument, NULL, OPT_NOWINDOWS},
668 {"w", no_argument, NULL, OPT_WINDOWS},
669 {"windows", no_argument, NULL, OPT_WINDOWS},
49c7e338 670 {"statistics", no_argument, 0, OPT_STATISTICS},
c5aa993b 671 {"write", no_argument, &write_files, 1},
552c04a7 672 {"args", no_argument, &set_args, 1},
39c76ca3 673 {"l", required_argument, 0, 'l'},
4b0ad762 674 {"return-child-result", no_argument, &return_child_result, 1},
c5aa993b
JM
675 {0, no_argument, 0, 0}
676 };
c906108c
SS
677
678 while (1)
679 {
680 int option_index;
681
682 c = getopt_long_only (argc, argv, "",
683 long_options, &option_index);
552c04a7 684 if (c == EOF || set_args)
c906108c
SS
685 break;
686
687 /* Long option that takes an argument. */
688 if (c == 0 && long_options[option_index].flag == 0)
689 c = long_options[option_index].val;
690
691 switch (c)
692 {
693 case 0:
694 /* Long option that just sets a flag. */
695 break;
49c7e338 696 case OPT_SE:
c906108c
SS
697 symarg = optarg;
698 execarg = optarg;
699 break;
49c7e338 700 case OPT_CD:
c906108c
SS
701 cdarg = optarg;
702 break;
49c7e338 703 case OPT_ANNOTATE:
c906108c
SS
704 /* FIXME: what if the syntax is wrong (e.g. not digits)? */
705 annotation_level = atoi (optarg);
706 break;
49c7e338 707 case OPT_STATISTICS:
c906108c 708 /* Enable the display of both time and space usage. */
bd712aed
DE
709 set_per_command_time (1);
710 set_per_command_space (1);
c906108c 711 break;
49c7e338 712 case OPT_TUI:
021e7609 713 /* --tui is equivalent to -i=tui. */
b0da54f1 714#ifdef TUI
021e7609 715 xfree (interpreter_p);
cc4349ed 716 interpreter_p = xstrdup (INTERP_TUI);
b0da54f1 717#else
91b35fd0 718 error (_("%s: TUI mode is not supported"), gdb_program_name);
b0da54f1 719#endif
021e7609 720 break;
42fa7c0f
AC
721 case OPT_WINDOWS:
722 /* FIXME: cagney/2003-03-01: Not sure if this option is
723 actually useful, and if it is, what it should do. */
cc4349ed
AS
724#ifdef GDBTK
725 /* --windows is equivalent to -i=insight. */
726 xfree (interpreter_p);
727 interpreter_p = xstrdup (INTERP_INSIGHT);
728#endif
42fa7c0f
AC
729 break;
730 case OPT_NOWINDOWS:
731 /* -nw is equivalent to -i=console. */
732 xfree (interpreter_p);
733 interpreter_p = xstrdup (INTERP_CONSOLE);
42fa7c0f 734 break;
c906108c
SS
735 case 'f':
736 annotation_level = 1;
c906108c
SS
737 break;
738 case 's':
739 symarg = optarg;
740 break;
741 case 'e':
742 execarg = optarg;
743 break;
744 case 'c':
745 corearg = optarg;
746 break;
00546b04 747 case 'p':
a4d9b460 748 pidarg = optarg;
00546b04 749 break;
c906108c 750 case 'x':
26743505
JK
751 {
752 struct cmdarg cmdarg = { CMDARG_FILE, optarg };
753
754 VEC_safe_push (cmdarg_s, cmdarg_vec, &cmdarg);
755 }
8a5a3c82
AS
756 break;
757 case 'X':
26743505
JK
758 {
759 struct cmdarg cmdarg = { CMDARG_COMMAND, optarg };
760
761 VEC_safe_push (cmdarg_s, cmdarg_vec, &cmdarg);
762 }
763 break;
8320cc4f
JK
764 case OPT_IX:
765 {
766 struct cmdarg cmdarg = { CMDARG_INIT_FILE, optarg };
767
768 VEC_safe_push (cmdarg_s, cmdarg_vec, &cmdarg);
769 }
770 break;
771 case OPT_IEX:
772 {
773 struct cmdarg cmdarg = { CMDARG_INIT_COMMAND, optarg };
774
775 VEC_safe_push (cmdarg_s, cmdarg_vec, &cmdarg);
776 }
c906108c 777 break;
1a088d06 778 case 'B':
7c953934 779 batch_flag = batch_silent = 1;
1a088d06
AS
780 gdb_stdout = ui_file_new();
781 break;
aae1c79a 782 case 'D':
8d551b02 783 if (optarg[0] == '\0')
91b35fd0
GB
784 error (_("%s: empty path for `--data-directory'"),
785 gdb_program_name);
8d551b02 786 set_gdb_data_directory (optarg);
e64e0392 787 gdb_datadir_provided = 1;
aae1c79a 788 break;
3fc11d3e
JM
789#ifdef GDBTK
790 case 'z':
791 {
371d5dec
MS
792 extern int gdbtk_test (char *);
793
3fc11d3e 794 if (!gdbtk_test (optarg))
91b35fd0
GB
795 error (_("%s: unable to load tclcommand file \"%s\""),
796 gdb_program_name, optarg);
3fc11d3e
JM
797 break;
798 }
799 case 'y':
78f49586
TT
800 /* Backwards compatibility only. */
801 break;
3fc11d3e
JM
802 case 'w':
803 {
3a9b40b6
JK
804 /* Set the external editor commands when gdb is farming out files
805 to be edited by another program. */
806 extern char *external_editor_command;
807
3fc11d3e
JM
808 external_editor_command = xstrdup (optarg);
809 break;
810 }
811#endif /* GDBTK */
fb40c209 812 case 'i':
4389a95a
AC
813 xfree (interpreter_p);
814 interpreter_p = xstrdup (optarg);
fb40c209 815 break;
c906108c
SS
816 case 'd':
817 dirarg[ndir++] = optarg;
818 if (ndir >= dirsize)
819 {
820 dirsize *= 2;
c5aa993b 821 dirarg = (char **) xrealloc ((char *) dirarg,
c906108c
SS
822 dirsize * sizeof (*dirarg));
823 }
824 break;
825 case 't':
826 ttyarg = optarg;
827 break;
828 case 'q':
829 quiet = 1;
830 break;
831 case 'b':
832 {
833 int i;
834 char *p;
835
836 i = strtol (optarg, &p, 0);
837 if (i == 0 && p == optarg)
075c7033
GB
838 warning (_("could not set baud rate to `%s'."),
839 optarg);
c906108c
SS
840 else
841 baud_rate = i;
842 }
046ca86a 843 break;
c906108c
SS
844 case 'l':
845 {
846 int i;
847 char *p;
848
849 i = strtol (optarg, &p, 0);
850 if (i == 0 && p == optarg)
075c7033
GB
851 warning (_("could not set timeout limit to `%s'."),
852 optarg);
c906108c
SS
853 else
854 remote_timeout = i;
855 }
856 break;
857
c906108c 858 case '?':
91b35fd0
GB
859 error (_("Use `%s --help' for a complete list of options."),
860 gdb_program_name);
c906108c
SS
861 }
862 }
863
7c953934 864 if (batch_flag)
c906108c
SS
865 quiet = 1;
866 }
867
992c7d70
GB
868 /* Try to set up an alternate signal stack for SIGSEGV handlers. */
869 setup_alternate_signal_stack ();
870
f218b647 871 /* Initialize all files. */
b5981e5a 872 gdb_init (gdb_program_name);
c906108c 873
371d5dec
MS
874 /* Now that gdb_init has created the initial inferior, we're in
875 position to set args for that inferior. */
3f81c18a
VP
876 if (set_args)
877 {
878 /* The remaining options are the command-line options for the
879 inferior. The first one is the sym/exec file, and the rest
880 are arguments. */
881 if (optind >= argc)
91b35fd0
GB
882 error (_("%s: `--args' specified but no program specified"),
883 gdb_program_name);
884
3f81c18a
VP
885 symarg = argv[optind];
886 execarg = argv[optind];
887 ++optind;
888 set_inferior_args_vector (argc - optind, &argv[optind]);
889 }
890 else
891 {
892 /* OK, that's all the options. */
893
894 /* The first argument, if specified, is the name of the
895 executable. */
896 if (optind < argc)
897 {
898 symarg = argv[optind];
899 execarg = argv[optind];
900 optind++;
901 }
902
903 /* If the user hasn't already specified a PID or the name of a
904 core file, then a second optional argument is allowed. If
905 present, this argument should be interpreted as either a
906 PID or a core file, whichever works. */
907 if (pidarg == NULL && corearg == NULL && optind < argc)
908 {
909 pid_or_core_arg = argv[optind];
910 optind++;
911 }
912
913 /* Any argument left on the command line is unexpected and
914 will be ignored. Inform the user. */
915 if (optind < argc)
3e43a32a
MS
916 fprintf_unfiltered (gdb_stderr,
917 _("Excess command line "
918 "arguments ignored. (%s%s)\n"),
3f81c18a
VP
919 argv[optind],
920 (optind == argc - 1) ? "" : " ...");
921 }
922
025bb325 923 /* Lookup gdbinit files. Note that the gdbinit file name may be
371d5dec
MS
924 overriden during file initialization, so get_init_files should be
925 called after gdb_init. */
57a46001
JG
926 get_init_files (&system_gdbinit, &home_gdbinit, &local_gdbinit);
927
c906108c 928 /* Do these (and anything which might call wrap_here or *_filtered)
4389a95a
AC
929 after initialize_all_files() but before the interpreter has been
930 installed. Otherwize the help/version messages will be eaten by
931 the interpreter's output handler. */
932
c906108c
SS
933 if (print_version)
934 {
935 print_gdb_version (gdb_stdout);
936 wrap_here ("");
937 printf_filtered ("\n");
938 exit (0);
939 }
940
941 if (print_help)
942 {
943 print_gdb_help (gdb_stdout);
944 fputs_unfiltered ("\n", gdb_stdout);
945 exit (0);
946 }
947
6eaaf48b
EZ
948 if (print_configuration)
949 {
950 print_gdb_configuration (gdb_stdout);
951 wrap_here ("");
952 printf_filtered ("\n");
953 exit (0);
954 }
955
4389a95a
AC
956 /* FIXME: cagney/2003-02-03: The big hack (part 1 of 2) that lets
957 GDB retain the old MI1 interpreter startup behavior. Output the
958 copyright message before the interpreter is installed. That way
959 it isn't encapsulated in MI output. */
960 if (!quiet && strcmp (interpreter_p, INTERP_MI1) == 0)
961 {
371d5dec
MS
962 /* Print all the junk at the top, with trailing "..." if we are
963 about to read a symbol file (possibly slowly). */
4389a95a
AC
964 print_gdb_version (gdb_stdout);
965 if (symarg)
966 printf_filtered ("..");
967 wrap_here ("");
e896d70e 968 printf_filtered ("\n");
371d5dec
MS
969 gdb_flush (gdb_stdout); /* Force to screen during slow
970 operations. */
4389a95a
AC
971 }
972
4389a95a 973 /* Install the default UI. All the interpreters should have had a
371d5dec 974 look at things by now. Initialize the default interpreter. */
4389a95a
AC
975
976 {
977 /* Find it. */
8322445e 978 struct interp *interp = interp_lookup (current_ui, interpreter_p);
b8d56208 979
4389a95a 980 if (interp == NULL)
8a3fe4f8 981 error (_("Interpreter `%s' unrecognized"), interpreter_p);
4389a95a 982 /* Install it. */
683f2885 983 if (!interp_set (interp, 1))
fd0ef3dd 984 error (_("Interpreter `%s' failed to initialize."), interpreter_p);
4389a95a
AC
985 }
986
987 /* FIXME: cagney/2003-02-03: The big hack (part 2 of 2) that lets
988 GDB retain the old MI1 interpreter startup behavior. Output the
989 copyright message after the interpreter is installed when it is
990 any sane interpreter. */
991 if (!quiet && !current_interp_named_p (INTERP_MI1))
c906108c 992 {
371d5dec
MS
993 /* Print all the junk at the top, with trailing "..." if we are
994 about to read a symbol file (possibly slowly). */
c906108c
SS
995 print_gdb_version (gdb_stdout);
996 if (symarg)
997 printf_filtered ("..");
c5aa993b 998 wrap_here ("");
e896d70e 999 printf_filtered ("\n");
371d5dec
MS
1000 gdb_flush (gdb_stdout); /* Force to screen during slow
1001 operations. */
c906108c
SS
1002 }
1003
e896d70e 1004 /* Set off error and warning messages with a blank line. */
075c7033 1005 xfree (warning_pre_print);
defc6f8c 1006 warning_pre_print = _("\nwarning: ");
c906108c 1007
16e7150e
JG
1008 /* Read and execute the system-wide gdbinit file, if it exists.
1009 This is done *before* all the command line arguments are
1010 processed; it sets global parameters, which are independent of
1011 what file you are debugging or what directory you are in. */
1012 if (system_gdbinit && !inhibit_gdbinit)
97c18565 1013 catch_command_errors_const (source_script, system_gdbinit, 0);
16e7150e 1014
c906108c
SS
1015 /* Read and execute $HOME/.gdbinit file, if it exists. This is done
1016 *before* all the command line arguments are processed; it sets
1017 global parameters, which are independent of what file you are
1018 debugging or what directory you are in. */
c906108c 1019
07540c15 1020 if (home_gdbinit && !inhibit_gdbinit && !inhibit_home_gdbinit)
97c18565 1021 catch_command_errors_const (source_script, home_gdbinit, 0);
c906108c 1022
2d7b58e8
JK
1023 /* Process '-ix' and '-iex' options early. */
1024 for (i = 0; VEC_iterate (cmdarg_s, cmdarg_vec, i, cmdarg_p); i++)
1025 switch (cmdarg_p->type)
1026 {
1027 case CMDARG_INIT_FILE:
50dd9793 1028 catch_command_errors_const (source_script, cmdarg_p->string,
97c18565 1029 !batch_flag);
2d7b58e8
JK
1030 break;
1031 case CMDARG_INIT_COMMAND:
1032 catch_command_errors (execute_command, cmdarg_p->string,
97c18565 1033 !batch_flag);
2d7b58e8
JK
1034 break;
1035 }
1036
c906108c
SS
1037 /* Now perform all the actions indicated by the arguments. */
1038 if (cdarg != NULL)
1039 {
97c18565 1040 catch_command_errors (cd_command, cdarg, 0);
c906108c 1041 }
c906108c
SS
1042
1043 for (i = 0; i < ndir; i++)
97c18565 1044 catch_command_errors (directory_switch, dirarg[i], 0);
b8c9b27d 1045 xfree (dirarg);
c906108c 1046
88a1906b 1047 /* Skip auto-loading section-specified scripts until we've sourced
371d5dec
MS
1048 local_gdbinit (which is often used to augment the source search
1049 path). */
bf88dd68
JK
1050 save_auto_load = global_auto_load;
1051 global_auto_load = 0;
88a1906b 1052
c906108c
SS
1053 if (execarg != NULL
1054 && symarg != NULL
5cb316ef 1055 && strcmp (execarg, symarg) == 0)
c906108c 1056 {
11cf8741
JM
1057 /* The exec file and the symbol-file are the same. If we can't
1058 open it, better only print one error message.
371d5dec 1059 catch_command_errors returns non-zero on success! */
5f08566b 1060 if (catch_command_errors_const (exec_file_attach, execarg,
97c18565 1061 !batch_flag))
69150c3d 1062 catch_command_errors_const (symbol_file_add_main, symarg,
97c18565 1063 !batch_flag);
c906108c
SS
1064 }
1065 else
1066 {
1067 if (execarg != NULL)
5f08566b 1068 catch_command_errors_const (exec_file_attach, execarg,
97c18565 1069 !batch_flag);
c906108c 1070 if (symarg != NULL)
69150c3d 1071 catch_command_errors_const (symbol_file_add_main, symarg,
97c18565 1072 !batch_flag);
c906108c 1073 }
c906108c 1074
a4d9b460 1075 if (corearg && pidarg)
3e43a32a
MS
1076 error (_("Can't attach to process and specify "
1077 "a core file at the same time."));
a4d9b460 1078
c906108c 1079 if (corearg != NULL)
97c18565 1080 catch_command_errors (core_file_command, corearg, !batch_flag);
a4d9b460 1081 else if (pidarg != NULL)
97c18565 1082 catch_command_errors (attach_command, pidarg, !batch_flag);
a4d9b460 1083 else if (pid_or_core_arg)
c906108c 1084 {
a4d9b460
PA
1085 /* The user specified 'gdb program pid' or gdb program core'.
1086 If pid_or_core_arg's first character is a digit, try attach
1087 first and then corefile. Otherwise try just corefile. */
00546b04 1088
a4d9b460 1089 if (isdigit (pid_or_core_arg[0]))
11cf8741 1090 {
a4d9b460 1091 if (catch_command_errors (attach_command, pid_or_core_arg,
97c18565 1092 !batch_flag) == 0)
a4d9b460 1093 catch_command_errors (core_file_command, pid_or_core_arg,
97c18565 1094 !batch_flag);
11cf8741 1095 }
a4d9b460
PA
1096 else /* Can't be a pid, better be a corefile. */
1097 catch_command_errors (core_file_command, pid_or_core_arg,
97c18565 1098 !batch_flag);
c906108c 1099 }
c906108c
SS
1100
1101 if (ttyarg != NULL)
3f81c18a 1102 set_inferior_io_terminal (ttyarg);
c906108c 1103
371d5dec 1104 /* Error messages should no longer be distinguished with extra output. */
defc6f8c 1105 warning_pre_print = _("warning: ");
c906108c
SS
1106
1107 /* Read the .gdbinit file in the current directory, *if* it isn't
1108 the same as the $HOME/.gdbinit file (it should exist, also). */
bf88dd68
JK
1109 if (local_gdbinit)
1110 {
1111 auto_load_local_gdbinit_pathname = gdb_realpath (local_gdbinit);
1112
bccbefd2 1113 if (!inhibit_gdbinit && auto_load_local_gdbinit
4dc84fd1
JK
1114 && file_is_auto_load_safe (local_gdbinit,
1115 _("auto-load: Loading .gdbinit "
1116 "file \"%s\".\n"),
1117 local_gdbinit))
bf88dd68
JK
1118 {
1119 auto_load_local_gdbinit_loaded = 1;
1120
97c18565 1121 catch_command_errors_const (source_script, local_gdbinit, 0);
bf88dd68
JK
1122 }
1123 }
c906108c 1124
88a1906b
DE
1125 /* Now that all .gdbinit's have been read and all -d options have been
1126 processed, we can read any scripts mentioned in SYMARG.
1127 We wait until now because it is common to add to the source search
1128 path in local_gdbinit. */
bf88dd68 1129 global_auto_load = save_auto_load;
7f6130ff
JK
1130 ALL_OBJFILES (objfile)
1131 load_auto_scripts_for_objfile (objfile);
88a1906b 1132
8320cc4f 1133 /* Process '-x' and '-ex' options. */
26743505
JK
1134 for (i = 0; VEC_iterate (cmdarg_s, cmdarg_vec, i, cmdarg_p); i++)
1135 switch (cmdarg_p->type)
c906108c 1136 {
26743505 1137 case CMDARG_FILE:
50dd9793 1138 catch_command_errors_const (source_script, cmdarg_p->string,
97c18565 1139 !batch_flag);
26743505
JK
1140 break;
1141 case CMDARG_COMMAND:
1142 catch_command_errors (execute_command, cmdarg_p->string,
97c18565 1143 !batch_flag);
26743505 1144 break;
c906108c 1145 }
c906108c 1146
371d5dec
MS
1147 /* Read in the old history after all the command files have been
1148 read. */
c5aa993b 1149 init_history ();
c906108c 1150
7c953934 1151 if (batch_flag)
c906108c
SS
1152 {
1153 /* We have hit the end of the batch file. */
4b0ad762 1154 quit_force (NULL, 0);
c906108c
SS
1155 }
1156
c906108c 1157 /* Show time and/or space usage. */
0f3bb72e 1158 do_cleanups (pre_stat_chain);
c906108c 1159
11cf8741
JM
1160 /* NOTE: cagney/1999-11-07: There is probably no reason for not
1161 moving this loop and the code found in captured_command_loop()
1162 into the command_loop() proper. The main thing holding back that
371d5dec 1163 change - SET_TOP_LEVEL() - has been eliminated. */
11cf8741
JM
1164 while (1)
1165 {
1166 catch_errors (captured_command_loop, 0, "", RETURN_MASK_ALL);
1167 }
11cf8741
JM
1168 /* No exit -- exit is through quit_command. */
1169}
c906108c 1170
11cf8741 1171int
f15ab4a7 1172gdb_main (struct captured_main_args *args)
11cf8741 1173{
f15ab4a7 1174 catch_errors (captured_main, args, "", RETURN_MASK_ALL);
864dbc90
AC
1175 /* The only way to end up here is by an error (normal exit is
1176 handled by quit_force()), hence always return an error status. */
1177 return 1;
c906108c
SS
1178}
1179
11cf8741 1180
c906108c
SS
1181/* Don't use *_filtered for printing help. We don't want to prompt
1182 for continue no matter how small the screen or how much we're going
1183 to print. */
1184
1185static void
d9fcf2fb 1186print_gdb_help (struct ui_file *stream)
c906108c 1187{
50dd9793
PA
1188 const char *system_gdbinit;
1189 const char *home_gdbinit;
1190 const char *local_gdbinit;
16e7150e
JG
1191
1192 get_init_files (&system_gdbinit, &home_gdbinit, &local_gdbinit);
1193
b187bec1
EZ
1194 /* Note: The options in the list below are only approximately sorted
1195 in the alphabetical order, so as to group closely related options
1196 together. */
defc6f8c 1197 fputs_unfiltered (_("\
c906108c 1198This is the GNU debugger. Usage:\n\n\
552c04a7
TT
1199 gdb [options] [executable-file [core-file or process-id]]\n\
1200 gdb [options] --args executable-file [inferior-arguments ...]\n\n\
defc6f8c
TT
1201"), stream);
1202 fputs_unfiltered (_("\
b187bec1 1203Selection of debuggee and its files:\n\n\
552c04a7 1204 --args Arguments after executable-file are passed to inferior\n\
b187bec1
EZ
1205 --core=COREFILE Analyze the core dump COREFILE.\n\
1206 --exec=EXECFILE Use EXECFILE as the executable.\n\
1207 --pid=PID Attach to running process PID.\n\
1208 --directory=DIR Search for source files in DIR.\n\
1209 --se=FILE Use FILE as symbol file and executable file.\n\
1210 --symbols=SYMFILE Read symbols from SYMFILE.\n\
1211 --readnow Fully read symbol files on first access.\n\
1212 --write Set writing into executable and core files.\n\n\
defc6f8c
TT
1213"), stream);
1214 fputs_unfiltered (_("\
b187bec1 1215Initial commands and command files:\n\n\
8a5a3c82 1216 --command=FILE, -x Execute GDB commands from FILE.\n\
b187bec1
EZ
1217 --init-command=FILE, -ix\n\
1218 Like -x but execute commands before loading inferior.\n\
8a5a3c82
AS
1219 --eval-command=COMMAND, -ex\n\
1220 Execute a single GDB command.\n\
1221 May be used multiple times and in conjunction\n\
1222 with --command.\n\
b187bec1
EZ
1223 --init-eval-command=COMMAND, -iex\n\
1224 Like -ex but before loading inferior.\n\
1225 --nh Do not read ~/.gdbinit.\n\
1226 --nx Do not read any .gdbinit files in any directory.\n\n\
defc6f8c
TT
1227"), stream);
1228 fputs_unfiltered (_("\
b187bec1 1229Output and user interface control:\n\n\
c906108c 1230 --fullname Output information used by emacs-GDB interface.\n\
8b93c638
JM
1231 --interpreter=INTERP\n\
1232 Select a specific interpreter / user interface\n\
c906108c 1233 --tty=TTY Use TTY for input/output by the program being debugged.\n\
b187bec1
EZ
1234 -w Use the GUI interface.\n\
1235 --nw Do not use the GUI interface.\n\
defc6f8c 1236"), stream);
c906108c 1237#if defined(TUI)
defc6f8c 1238 fputs_unfiltered (_("\
c906108c 1239 --tui Use a terminal user interface.\n\
defc6f8c 1240"), stream);
c906108c 1241#endif
481860b3 1242 fputs_unfiltered (_("\
b187bec1 1243 --dbx DBX compatibility mode.\n\
adcc0a31 1244 -q, --quiet, --silent\n\
1245 Do not print version number on startup.\n\n\
b187bec1
EZ
1246"), stream);
1247 fputs_unfiltered (_("\
1248Operating modes:\n\n\
1249 --batch Exit after processing options.\n\
1250 --batch-silent Like --batch, but suppress all gdb stdout output.\n\
1251 --return-child-result\n\
1252 GDB exit code will be the child's exit code.\n\
1253 --configuration Print details about GDB configuration and then exit.\n\
1254 --help Print this message and then exit.\n\
1255 --version Print version information and then exit.\n\n\
1256Remote debugging options:\n\n\
1257 -b BAUDRATE Set serial port baud rate used for remote debugging.\n\
1258 -l TIMEOUT Set timeout in seconds for remote debugging.\n\n\
1259Other options:\n\n\
1260 --cd=DIR Change current directory to DIR.\n\
8d551b02
DE
1261 --data-directory=DIR, -D\n\
1262 Set GDB's data-directory to DIR.\n\
defc6f8c 1263"), stream);
defc6f8c 1264 fputs_unfiltered (_("\n\
16e7150e
JG
1265At startup, GDB reads the following init files and executes their commands:\n\
1266"), stream);
1267 if (system_gdbinit)
1268 fprintf_unfiltered (stream, _("\
1269 * system-wide init file: %s\n\
1270"), system_gdbinit);
1271 if (home_gdbinit)
1272 fprintf_unfiltered (stream, _("\
1273 * user-specific init file: %s\n\
1274"), home_gdbinit);
1275 if (local_gdbinit)
1276 fprintf_unfiltered (stream, _("\
bf88dd68 1277 * local init file (see also 'set auto-load local-gdbinit'): ./%s\n\
16e7150e
JG
1278"), local_gdbinit);
1279 fputs_unfiltered (_("\n\
c906108c
SS
1280For more information, type \"help\" from within GDB, or consult the\n\
1281GDB manual (available as on-line info or a printed manual).\n\
defc6f8c 1282"), stream);
c16158bc
JM
1283 if (REPORT_BUGS_TO[0] && stream == gdb_stdout)
1284 fprintf_unfiltered (stream, _("\
1285Report bugs to \"%s\".\n\
1286"), REPORT_BUGS_TO);
c906108c 1287}
This page took 1.488436 seconds and 4 git commands to generate.