1 /* List lines of source files for GDB, the GNU debugger.
2 Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
3 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008,
4 2009, 2010 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include "arch-utils.h"
24 #include "expression.h"
31 #include "gdb_assert.h"
33 #include <sys/types.h>
34 #include "gdb_string.h"
38 #include "gdb_regex.h"
44 #include "filenames.h" /* for DOSish file names */
45 #include "completer.h"
47 #include "readline/readline.h"
52 #define OPEN_MODE (O_RDONLY | O_BINARY)
53 #define FDOPEN_MODE FOPEN_RB
55 /* Prototypes for exported functions. */
57 void _initialize_source (void);
59 /* Prototypes for local functions. */
61 static int get_filename_and_charpos (struct symtab
*, char **);
63 static void reverse_search_command (char *, int);
65 static void forward_search_command (char *, int);
67 static void line_info (char *, int);
69 static void source_info (char *, int);
71 static void show_directories (char *, int);
73 /* Path of directories to search for source files.
74 Same format as the PATH environment variable's value. */
78 /* Support for source path substitution commands. */
80 struct substitute_path_rule
84 struct substitute_path_rule
*next
;
87 static struct substitute_path_rule
*substitute_path_rules
= NULL
;
89 /* Symtab of default file for listing lines of. */
91 static struct symtab
*current_source_symtab
;
93 /* Default next line to list. */
95 static int current_source_line
;
97 static struct program_space
*current_source_pspace
;
99 /* Default number of lines to print with commands like "list".
100 This is based on guessing how many long (i.e. more than chars_per_line
101 characters) lines there will be. To be completely correct, "list"
102 and friends should be rewritten to count characters and see where
103 things are wrapping, but that would be a fair amount of work. */
105 int lines_to_list
= 10;
107 show_lines_to_list (struct ui_file
*file
, int from_tty
,
108 struct cmd_list_element
*c
, const char *value
)
110 fprintf_filtered (file
, _("\
111 Number of source lines gdb will list by default is %s.\n"),
115 /* Line number of last line printed. Default for various commands.
116 current_source_line is usually, but not always, the same as this. */
118 static int last_line_listed
;
120 /* First line number listed by last listing command. */
122 static int first_line_listed
;
124 /* Saves the name of the last source file visited and a possible error code.
125 Used to prevent repeating annoying "No such file or directories" msgs */
127 static struct symtab
*last_source_visited
= NULL
;
128 static int last_source_error
= 0;
130 /* Return the first line listed by print_source_lines.
131 Used by command interpreters to request listing from
135 get_first_line_listed (void)
137 return first_line_listed
;
140 /* Return the default number of lines to print with commands like the
141 cli "list". The caller of print_source_lines must use this to
142 calculate the end line and use it in the call to print_source_lines
143 as it does not automatically use this value. */
146 get_lines_to_list (void)
148 return lines_to_list
;
151 /* Return the current source file for listing and next line to list.
152 NOTE: The returned sal pc and end fields are not valid. */
154 struct symtab_and_line
155 get_current_source_symtab_and_line (void)
157 struct symtab_and_line cursal
= { 0 };
159 cursal
.pspace
= current_source_pspace
;
160 cursal
.symtab
= current_source_symtab
;
161 cursal
.line
= current_source_line
;
168 /* If the current source file for listing is not set, try and get a default.
169 Usually called before get_current_source_symtab_and_line() is called.
170 It may err out if a default cannot be determined.
171 We must be cautious about where it is called, as it can recurse as the
172 process of determining a new default may call the caller!
173 Use get_current_source_symtab_and_line only to get whatever
174 we have without erroring out or trying to get a default. */
177 set_default_source_symtab_and_line (void)
179 struct symtab_and_line cursal
;
181 if (!have_full_symbols () && !have_partial_symbols ())
182 error (_("No symbol table is loaded. Use the \"file\" command."));
184 /* Pull in a current source symtab if necessary */
185 if (current_source_symtab
== 0)
186 select_source_symtab (0);
189 /* Return the current default file for listing and next line to list
190 (the returned sal pc and end fields are not valid.)
191 and set the current default to whatever is in SAL.
192 NOTE: The returned sal pc and end fields are not valid. */
194 struct symtab_and_line
195 set_current_source_symtab_and_line (const struct symtab_and_line
*sal
)
197 struct symtab_and_line cursal
= { 0 };
199 cursal
.pspace
= current_source_pspace
;
200 cursal
.symtab
= current_source_symtab
;
201 cursal
.line
= current_source_line
;
205 current_source_pspace
= sal
->pspace
;
206 current_source_symtab
= sal
->symtab
;
207 current_source_line
= sal
->line
;
212 /* Reset any information stored about a default file and line to print. */
215 clear_current_source_symtab_and_line (void)
217 current_source_symtab
= 0;
218 current_source_line
= 0;
221 /* Set the source file default for the "list" command to be S.
223 If S is NULL, and we don't have a default, find one. This
224 should only be called when the user actually tries to use the
225 default, since we produce an error if we can't find a reasonable
226 default. Also, since this can cause symbols to be read, doing it
227 before we need to would make things slower than necessary. */
230 select_source_symtab (struct symtab
*s
)
232 struct symtabs_and_lines sals
;
233 struct symtab_and_line sal
;
238 current_source_symtab
= s
;
239 current_source_line
= 1;
240 current_source_pspace
= SYMTAB_PSPACE (s
);
244 if (current_source_symtab
)
247 /* Make the default place to list be the function `main'
249 if (lookup_symbol (main_name (), 0, VAR_DOMAIN
, 0))
251 sals
= decode_line_spec (main_name (), 1);
254 current_source_pspace
= sal
.pspace
;
255 current_source_symtab
= sal
.symtab
;
256 current_source_line
= max (sal
.line
- (lines_to_list
- 1), 1);
257 if (current_source_symtab
)
261 /* Alright; find the last file in the symtab list (ignoring .h's
262 and namespace symtabs). */
264 current_source_line
= 1;
268 for (s
= ofp
->symtabs
; s
; s
= s
->next
)
270 const char *name
= s
->filename
;
271 int len
= strlen (name
);
272 if (!(len
> 2 && (strcmp (&name
[len
- 2], ".h") == 0
273 || strcmp (name
, "<<C++-namespaces>>") == 0)))
275 current_source_pspace
= current_program_space
;
276 current_source_symtab
= s
;
281 if (current_source_symtab
)
287 s
= ofp
->sf
->qf
->find_last_source_symtab (ofp
);
289 current_source_symtab
= s
;
291 if (current_source_symtab
)
294 error (_("Can't find a default source file"));
298 show_directories (char *ignore
, int from_tty
)
300 puts_filtered ("Source directories searched: ");
301 puts_filtered (source_path
);
302 puts_filtered ("\n");
305 /* Forget what we learned about line positions in source files, and
306 which directories contain them; must check again now since files
307 may be found in a different directory now. */
310 forget_cached_source_info (void)
312 struct program_space
*pspace
;
314 struct objfile
*objfile
;
317 ALL_PSPACE_OBJFILES (pspace
, objfile
)
319 for (s
= objfile
->symtabs
; s
!= NULL
; s
= s
->next
)
321 if (s
->line_charpos
!= NULL
)
323 xfree (s
->line_charpos
);
324 s
->line_charpos
= NULL
;
326 if (s
->fullname
!= NULL
)
334 objfile
->sf
->qf
->forget_cached_source_info (objfile
);
337 last_source_visited
= NULL
;
341 init_source_path (void)
345 sprintf (buf
, "$cdir%c$cwd", DIRNAME_SEPARATOR
);
346 source_path
= xstrdup (buf
);
347 forget_cached_source_info ();
350 /* Add zero or more directories to the front of the source path. */
353 directory_command (char *dirname
, int from_tty
)
356 /* FIXME, this goes to "delete dir"... */
359 if (!from_tty
|| query (_("Reinitialize source path to empty? ")))
367 mod_path (dirname
, &source_path
);
368 forget_cached_source_info ();
371 show_directories ((char *) 0, from_tty
);
374 /* Add a path given with the -d command line switch.
375 This will not be quoted so we must not treat spaces as separators. */
378 directory_switch (char *dirname
, int from_tty
)
380 add_path (dirname
, &source_path
, 0);
383 /* Add zero or more directories to the front of an arbitrary path. */
386 mod_path (char *dirname
, char **which_path
)
388 add_path (dirname
, which_path
, 1);
391 /* Workhorse of mod_path. Takes an extra argument to determine
392 if dirname should be parsed for separators that indicate multiple
393 directories. This allows for interfaces that pre-parse the dirname
394 and allow specification of traditional separator characters such
398 add_path (char *dirname
, char **which_path
, int parse_separators
)
400 char *old
= *which_path
;
409 if (parse_separators
)
411 /* This will properly parse the space and tab separators
412 and any quotes that may exist. DIRNAME_SEPARATOR will
413 be dealt with later. */
414 argv
= gdb_buildargv (dirname
);
415 make_cleanup_freeargv (argv
);
421 arg
= xstrdup (dirname
);
422 make_cleanup (xfree
, arg
);
432 char *separator
= NULL
;
434 /* Spaces and tabs will have been removed by buildargv().
435 The directories will there be split into a list but
436 each entry may still contain DIRNAME_SEPARATOR. */
437 if (parse_separators
)
438 separator
= strchr (name
, DIRNAME_SEPARATOR
);
441 p
= arg
= name
+ strlen (name
);
446 while (*arg
== DIRNAME_SEPARATOR
)
450 /* If there are no more directories in this argument then start
451 on the next argument next time round the loop (if any). */
453 arg
= parse_separators
? argv
[++argv_index
] : NULL
;
456 /* name is the start of the directory.
457 p is the separator (or null) following the end. */
459 while (!(IS_DIR_SEPARATOR (*name
) && p
<= name
+ 1) /* "/" */
460 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
461 /* On MS-DOS and MS-Windows, h:\ is different from h: */
462 && !(p
== name
+ 3 && name
[1] == ':') /* "d:/" */
464 && IS_DIR_SEPARATOR (p
[-1]))
465 /* Sigh. "foo/" => "foo" */
469 while (p
> name
&& p
[-1] == '.')
473 /* "." => getwd (). */
474 name
= current_directory
;
477 else if (p
> name
+ 1 && IS_DIR_SEPARATOR (p
[-2]))
487 /* "...foo/." => "...foo". */
498 name
= tilde_expand (name
);
499 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
500 else if (IS_ABSOLUTE_PATH (name
) && p
== name
+ 2) /* "d:" => "d:." */
501 name
= concat (name
, ".", (char *)NULL
);
503 else if (!IS_ABSOLUTE_PATH (name
) && name
[0] != '$')
504 name
= concat (current_directory
, SLASH_STRING
, name
, (char *)NULL
);
506 name
= savestring (name
, p
- name
);
507 make_cleanup (xfree
, name
);
509 /* Unless it's a variable, check existence. */
512 /* These are warnings, not errors, since we don't want a
513 non-existent directory in a .gdbinit file to stop processing
514 of the .gdbinit file.
516 Whether they get added to the path is more debatable. Current
517 answer is yes, in case the user wants to go make the directory
518 or whatever. If the directory continues to not exist/not be
519 a directory/etc, then having them in the path should be
521 if (stat (name
, &st
) < 0)
523 int save_errno
= errno
;
524 fprintf_unfiltered (gdb_stderr
, "Warning: ");
525 print_sys_errmsg (name
, save_errno
);
527 else if ((st
.st_mode
& S_IFMT
) != S_IFDIR
)
528 warning (_("%s is not a directory."), name
);
533 unsigned int len
= strlen (name
);
538 /* FIXME: strncmp loses in interesting ways on MS-DOS and
539 MS-Windows because of case-insensitivity and two different
540 but functionally identical slash characters. We need a
541 special filesystem-dependent file-name comparison function.
543 Actually, even on Unix I would use realpath() or its work-
544 alike before comparing. Then all the code above which
545 removes excess slashes and dots could simply go away. */
546 if (!strncmp (p
, name
, len
)
547 && (p
[len
] == '\0' || p
[len
] == DIRNAME_SEPARATOR
))
549 /* Found it in the search path, remove old copy */
551 p
--; /* Back over leading separator */
552 if (prefix
> p
- *which_path
)
553 goto skip_dup
; /* Same dir twice in one cmd */
554 strcpy (p
, &p
[len
+ 1]); /* Copy from next \0 or : */
556 p
= strchr (p
, DIRNAME_SEPARATOR
);
566 tinybuf
[0] = DIRNAME_SEPARATOR
;
569 /* If we have already tacked on a name(s) in this command, be sure they stay
570 on the front as we tack on some more. */
577 temp
= concat (old
, tinybuf
, name
, (char *)NULL
);
579 *which_path
= concat (temp
, "", &old
[prefix
], (char *)NULL
);
580 prefix
= strlen (temp
);
585 *which_path
= concat (name
, (old
[0] ? tinybuf
: old
),
587 prefix
= strlen (name
);
600 source_info (char *ignore
, int from_tty
)
602 struct symtab
*s
= current_source_symtab
;
606 printf_filtered (_("No current source file.\n"));
609 printf_filtered (_("Current source file is %s\n"), s
->filename
);
611 printf_filtered (_("Compilation directory is %s\n"), s
->dirname
);
613 printf_filtered (_("Located in %s\n"), s
->fullname
);
615 printf_filtered (_("Contains %d line%s.\n"), s
->nlines
,
616 s
->nlines
== 1 ? "" : "s");
618 printf_filtered (_("Source language is %s.\n"), language_str (s
->language
));
619 printf_filtered (_("Compiled with %s debugging format.\n"), s
->debugformat
);
620 printf_filtered (_("%s preprocessor macro info.\n"),
621 s
->macro_table
? "Includes" : "Does not include");
625 /* Return True if the file NAME exists and is a regular file */
627 is_regular_file (const char *name
)
630 const int status
= stat (name
, &st
);
632 /* Stat should never fail except when the file does not exist.
633 If stat fails, analyze the source of error and return True
634 unless the file does not exist, to avoid returning false results
635 on obscure systems where stat does not work as expected.
638 return (errno
!= ENOENT
);
640 return S_ISREG (st
.st_mode
);
643 /* Open a file named STRING, searching path PATH (dir names sep by some char)
644 using mode MODE in the calls to open. You cannot use this function to
645 create files (O_CREAT).
647 OPTS specifies the function behaviour in specific cases.
649 If OPF_TRY_CWD_FIRST, try to open ./STRING before searching PATH.
650 (ie pretend the first element of PATH is "."). This also indicates
651 that a slash in STRING disables searching of the path (this is
652 so that "exec-file ./foo" or "symbol-file ./foo" insures that you
653 get that particular version of foo or an error message).
655 If OPTS has OPF_SEARCH_IN_PATH set, absolute names will also be
656 searched in path (we usually want this for source files but not for
659 If FILENAME_OPENED is non-null, set it to a newly allocated string naming
660 the actual file opened (this string will always start with a "/"). We
661 have to take special pains to avoid doubling the "/" between the directory
662 and the file, sigh! Emacs gets confuzzed by this when we print the
665 If a file is found, return the descriptor.
666 Otherwise, return -1, with errno set for the last name we tried to open. */
668 /* >>>> This should only allow files of certain types,
669 >>>> eg executable, non-directory */
671 openp (const char *path
, int opts
, const char *string
,
672 int mode
, char **filename_opened
)
681 /* The open syscall MODE parameter is not specified. */
682 gdb_assert ((mode
& O_CREAT
) == 0);
683 gdb_assert (string
!= NULL
);
685 /* A file with an empty name cannot possibly exist. Report a failure
686 without further checking.
688 This is an optimization which also defends us against buggy
689 implementations of the "stat" function. For instance, we have
690 noticed that a MinGW debugger built on Windows XP 32bits crashes
691 when the debugger is started with an empty argument. */
692 if (string
[0] == '\0')
703 if ((opts
& OPF_TRY_CWD_FIRST
) || IS_ABSOLUTE_PATH (string
))
707 if (is_regular_file (string
))
709 filename
= alloca (strlen (string
) + 1);
710 strcpy (filename
, string
);
711 fd
= open (filename
, mode
);
721 if (!(opts
& OPF_SEARCH_IN_PATH
))
722 for (i
= 0; string
[i
]; i
++)
723 if (IS_DIR_SEPARATOR (string
[i
]))
727 /* For dos paths, d:/foo -> /foo, and d:foo -> foo. */
728 if (HAS_DRIVE_SPEC (string
))
729 string
= STRIP_DRIVE_SPEC (string
);
731 /* /foo => foo, to avoid multiple slashes that Emacs doesn't like. */
732 while (IS_DIR_SEPARATOR(string
[0]))
736 while (string
[0] == '.' && IS_DIR_SEPARATOR (string
[1]))
739 alloclen
= strlen (path
) + strlen (string
) + 2;
740 filename
= alloca (alloclen
);
742 for (p
= path
; p
; p
= p1
? p1
+ 1 : 0)
744 p1
= strchr (p
, DIRNAME_SEPARATOR
);
750 if (len
== 4 && p
[0] == '$' && p
[1] == 'c'
751 && p
[2] == 'w' && p
[3] == 'd')
753 /* Name is $cwd -- insert current directory name instead. */
756 /* First, realloc the filename buffer if too short. */
757 len
= strlen (current_directory
);
758 newlen
= len
+ strlen (string
) + 2;
759 if (newlen
> alloclen
)
762 filename
= alloca (alloclen
);
764 strcpy (filename
, current_directory
);
768 /* Normal file name in path -- just use it. */
769 strncpy (filename
, p
, len
);
772 /* Don't search $cdir. It's also a magic path like $cwd, but we
773 don't have enough information to expand it. The user *could*
774 have an actual directory named '$cdir' but handling that would
775 be confusing, it would mean different things in different
776 contexts. If the user really has '$cdir' one can use './$cdir'.
777 We can get $cdir when loading scripts. When loading source files
778 $cdir must have already been expanded to the correct value. */
779 if (strcmp (filename
, "$cdir") == 0)
783 /* Remove trailing slashes */
784 while (len
> 0 && IS_DIR_SEPARATOR (filename
[len
- 1]))
787 strcat (filename
+ len
, SLASH_STRING
);
788 strcat (filename
, string
);
790 if (is_regular_file (filename
))
792 fd
= open (filename
, mode
);
801 /* If a file was opened, canonicalize its filename. Use xfullpath
802 rather than gdb_realpath to avoid resolving the basename part
803 of filenames when the associated file is a symbolic link. This
804 fixes a potential inconsistency between the filenames known to
805 GDB and the filenames it prints in the annotations. */
807 *filename_opened
= NULL
;
808 else if (IS_ABSOLUTE_PATH (filename
))
809 *filename_opened
= xfullpath (filename
);
812 /* Beware the // my son, the Emacs barfs, the botch that catch... */
814 char *f
= concat (current_directory
,
815 IS_DIR_SEPARATOR (current_directory
[strlen (current_directory
) - 1])
817 filename
, (char *)NULL
);
818 *filename_opened
= xfullpath (f
);
827 /* This is essentially a convenience, for clients that want the behaviour
828 of openp, using source_path, but that really don't want the file to be
829 opened but want instead just to know what the full pathname is (as
830 qualified against source_path).
832 The current working directory is searched first.
834 If the file was found, this function returns 1, and FULL_PATHNAME is
835 set to the fully-qualified pathname.
837 Else, this functions returns 0, and FULL_PATHNAME is set to NULL. */
839 source_full_path_of (const char *filename
, char **full_pathname
)
843 fd
= openp (source_path
, OPF_TRY_CWD_FIRST
| OPF_SEARCH_IN_PATH
, filename
,
844 O_RDONLY
, full_pathname
);
847 *full_pathname
= NULL
;
855 /* Return non-zero if RULE matches PATH, that is if the rule can be
859 substitute_path_rule_matches (const struct substitute_path_rule
*rule
,
862 const int from_len
= strlen (rule
->from
);
863 const int path_len
= strlen (path
);
866 if (path_len
< from_len
)
869 /* The substitution rules are anchored at the start of the path,
870 so the path should start with rule->from. There is no filename
871 comparison routine, so we need to extract the first FROM_LEN
872 characters from PATH first and use that to do the comparison. */
874 path_start
= alloca (from_len
+ 1);
875 strncpy (path_start
, path
, from_len
);
876 path_start
[from_len
] = '\0';
878 if (FILENAME_CMP (path_start
, rule
->from
) != 0)
881 /* Make sure that the region in the path that matches the substitution
882 rule is immediately followed by a directory separator (or the end of
883 string character). */
885 if (path
[from_len
] != '\0' && !IS_DIR_SEPARATOR (path
[from_len
]))
891 /* Find the substitute-path rule that applies to PATH and return it.
892 Return NULL if no rule applies. */
894 static struct substitute_path_rule
*
895 get_substitute_path_rule (const char *path
)
897 struct substitute_path_rule
*rule
= substitute_path_rules
;
899 while (rule
!= NULL
&& !substitute_path_rule_matches (rule
, path
))
905 /* If the user specified a source path substitution rule that applies
906 to PATH, then apply it and return the new path. This new path must
907 be deallocated afterwards.
909 Return NULL if no substitution rule was specified by the user,
910 or if no rule applied to the given PATH. */
913 rewrite_source_path (const char *path
)
915 const struct substitute_path_rule
*rule
= get_substitute_path_rule (path
);
922 from_len
= strlen (rule
->from
);
924 /* Compute the rewritten path and return it. */
927 (char *) xmalloc (strlen (path
) + 1 + strlen (rule
->to
) - from_len
);
928 strcpy (new_path
, rule
->to
);
929 strcat (new_path
, path
+ from_len
);
934 /* This function is capable of finding the absolute path to a
935 source file, and opening it, provided you give it a FILENAME. Both the
936 DIRNAME and FULLNAME are only added suggestions on where to find the file.
938 FILENAME should be the filename to open.
939 DIRNAME is the compilation directory of a particular source file.
940 Only some debug formats provide this info.
941 FULLNAME can be the last known absolute path to the file in question.
942 Space for the path must have been malloc'd. If a path substitution
943 is applied we free the old value and set a new one.
946 A valid file descriptor is returned. ( the return value is positive )
947 FULLNAME is set to the absolute path to the file just opened.
948 The caller is responsible for freeing FULLNAME.
951 An invalid file descriptor is returned. ( the return value is negative )
952 FULLNAME is set to NULL. */
955 find_and_open_source (const char *filename
,
959 char *path
= source_path
;
963 /* Quick way out if we already know its full name */
967 /* The user may have requested that source paths be rewritten
968 according to substitution rules he provided. If a substitution
969 rule applies to this path, then apply it. */
970 char *rewritten_fullname
= rewrite_source_path (*fullname
);
972 if (rewritten_fullname
!= NULL
)
975 *fullname
= rewritten_fullname
;
978 result
= open (*fullname
, OPEN_MODE
);
981 /* Didn't work -- free old one, try again. */
988 /* If necessary, rewrite the compilation directory name according
989 to the source path substitution rules specified by the user. */
991 char *rewritten_dirname
= rewrite_source_path (dirname
);
993 if (rewritten_dirname
!= NULL
)
995 make_cleanup (xfree
, rewritten_dirname
);
996 dirname
= rewritten_dirname
;
999 /* Replace a path entry of $cdir with the compilation directory name */
1001 /* We cast strstr's result in case an ANSIhole has made it const,
1002 which produces a "required warning" when assigned to a nonconst. */
1003 p
= (char *) strstr (source_path
, "$cdir");
1004 if (p
&& (p
== path
|| p
[-1] == DIRNAME_SEPARATOR
)
1005 && (p
[cdir_len
] == DIRNAME_SEPARATOR
|| p
[cdir_len
] == '\0'))
1010 alloca (strlen (source_path
) + 1 + strlen (dirname
) + 1);
1011 len
= p
- source_path
;
1012 strncpy (path
, source_path
, len
); /* Before $cdir */
1013 strcpy (path
+ len
, dirname
); /* new stuff */
1014 strcat (path
+ len
, source_path
+ len
+ cdir_len
); /* After $cdir */
1018 if (IS_ABSOLUTE_PATH (filename
))
1020 /* If filename is absolute path, try the source path
1021 substitution on it. */
1022 char *rewritten_filename
= rewrite_source_path (filename
);
1024 if (rewritten_filename
!= NULL
)
1026 make_cleanup (xfree
, rewritten_filename
);
1027 filename
= rewritten_filename
;
1031 result
= openp (path
, OPF_SEARCH_IN_PATH
, filename
, OPEN_MODE
, fullname
);
1034 /* Didn't work. Try using just the basename. */
1035 p
= lbasename (filename
);
1037 result
= openp (path
, OPF_SEARCH_IN_PATH
, p
, OPEN_MODE
, fullname
);
1043 /* Open a source file given a symtab S. Returns a file descriptor or
1044 negative number for error.
1046 This function is a convience function to find_and_open_source. */
1049 open_source_file (struct symtab
*s
)
1054 return find_and_open_source (s
->filename
, s
->dirname
, &s
->fullname
);
1057 /* Finds the fullname that a symtab represents.
1059 If this functions finds the fullname, it will save it in s->fullname
1060 and it will also return the value.
1062 If this function fails to find the file that this symtab represents,
1063 NULL will be returned and s->fullname will be set to NULL. */
1065 symtab_to_fullname (struct symtab
*s
)
1072 /* Don't check s->fullname here, the file could have been
1073 deleted/moved/..., look for it again */
1074 r
= find_and_open_source (s
->filename
, s
->dirname
, &s
->fullname
);
1085 /* Create and initialize the table S->line_charpos that records
1086 the positions of the lines in the source file, which is assumed
1087 to be open on descriptor DESC.
1088 All set S->nlines to the number of such lines. */
1091 find_source_lines (struct symtab
*s
, int desc
)
1094 char *data
, *p
, *end
;
1096 int lines_allocated
= 1000;
1102 line_charpos
= (int *) xmalloc (lines_allocated
* sizeof (int));
1103 if (fstat (desc
, &st
) < 0)
1104 perror_with_name (s
->filename
);
1106 if (s
->objfile
&& s
->objfile
->obfd
)
1107 mtime
= s
->objfile
->mtime
;
1109 mtime
= exec_bfd_mtime
;
1111 if (mtime
&& mtime
< st
.st_mtime
)
1112 warning (_("Source file is more recent than executable."));
1114 #ifdef LSEEK_NOT_LINEAR
1118 /* Have to read it byte by byte to find out where the chars live */
1120 line_charpos
[0] = lseek (desc
, 0, SEEK_CUR
);
1122 while (myread (desc
, &c
, 1) > 0)
1126 if (nlines
== lines_allocated
)
1128 lines_allocated
*= 2;
1130 (int *) xrealloc ((char *) line_charpos
,
1131 sizeof (int) * lines_allocated
);
1133 line_charpos
[nlines
++] = lseek (desc
, 0, SEEK_CUR
);
1137 #else /* lseek linear. */
1139 struct cleanup
*old_cleanups
;
1141 /* st_size might be a large type, but we only support source files whose
1142 size fits in an int. */
1143 size
= (int) st
.st_size
;
1145 /* Use malloc, not alloca, because this may be pretty large, and we may
1146 run into various kinds of limits on stack size. */
1147 data
= (char *) xmalloc (size
);
1148 old_cleanups
= make_cleanup (xfree
, data
);
1150 /* Reassign `size' to result of read for systems where \r\n -> \n. */
1151 size
= myread (desc
, data
, size
);
1153 perror_with_name (s
->filename
);
1156 line_charpos
[0] = 0;
1161 /* A newline at the end does not start a new line. */
1164 if (nlines
== lines_allocated
)
1166 lines_allocated
*= 2;
1168 (int *) xrealloc ((char *) line_charpos
,
1169 sizeof (int) * lines_allocated
);
1171 line_charpos
[nlines
++] = p
- data
;
1174 do_cleanups (old_cleanups
);
1176 #endif /* lseek linear. */
1179 (int *) xrealloc ((char *) line_charpos
, nlines
* sizeof (int));
1183 /* Return the character position of a line LINE in symtab S.
1184 Return 0 if anything is invalid. */
1186 #if 0 /* Currently unused */
1189 source_line_charpos (struct symtab
*s
, int line
)
1193 if (!s
->line_charpos
|| line
<= 0)
1195 if (line
> s
->nlines
)
1197 return s
->line_charpos
[line
- 1];
1200 /* Return the line number of character position POS in symtab S. */
1203 source_charpos_line (struct symtab
*s
, int chr
)
1208 if (s
== 0 || s
->line_charpos
== 0)
1210 lnp
= s
->line_charpos
;
1211 /* Files are usually short, so sequential search is Ok */
1212 while (line
< s
->nlines
&& *lnp
<= chr
)
1217 if (line
>= s
->nlines
)
1225 /* Get full pathname and line number positions for a symtab.
1226 Return nonzero if line numbers may have changed.
1227 Set *FULLNAME to actual name of the file as found by `openp',
1228 or to 0 if the file is not found. */
1231 get_filename_and_charpos (struct symtab
*s
, char **fullname
)
1233 int desc
, linenums_changed
= 0;
1234 struct cleanup
*cleanups
;
1236 desc
= open_source_file (s
);
1243 cleanups
= make_cleanup_close (desc
);
1245 *fullname
= s
->fullname
;
1246 if (s
->line_charpos
== 0)
1247 linenums_changed
= 1;
1248 if (linenums_changed
)
1249 find_source_lines (s
, desc
);
1250 do_cleanups (cleanups
);
1251 return linenums_changed
;
1254 /* Print text describing the full name of the source file S
1255 and the line number LINE and its corresponding character position.
1256 The text starts with two Ctrl-z so that the Emacs-GDB interface
1259 MID_STATEMENT is nonzero if the PC is not at the beginning of that line.
1261 Return 1 if successful, 0 if could not find the file. */
1264 identify_source_line (struct symtab
*s
, int line
, int mid_statement
,
1267 if (s
->line_charpos
== 0)
1268 get_filename_and_charpos (s
, (char **) NULL
);
1269 if (s
->fullname
== 0)
1271 if (line
> s
->nlines
)
1272 /* Don't index off the end of the line_charpos array. */
1274 annotate_source (s
->fullname
, line
, s
->line_charpos
[line
- 1],
1275 mid_statement
, get_objfile_arch (s
->objfile
), pc
);
1277 current_source_line
= line
;
1278 first_line_listed
= line
;
1279 last_line_listed
= line
;
1280 current_source_symtab
= s
;
1285 /* Print source lines from the file of symtab S,
1286 starting with line number LINE and stopping before line number STOPLINE. */
1288 static void print_source_lines_base (struct symtab
*s
, int line
, int stopline
,
1291 print_source_lines_base (struct symtab
*s
, int line
, int stopline
, int noerror
)
1296 int nlines
= stopline
- line
;
1297 struct cleanup
*cleanup
;
1299 /* Regardless of whether we can open the file, set current_source_symtab. */
1300 current_source_symtab
= s
;
1301 current_source_line
= line
;
1302 first_line_listed
= line
;
1304 /* If printing of source lines is disabled, just print file and line number */
1305 if (ui_out_test_flags (uiout
, ui_source_list
))
1307 /* Only prints "No such file or directory" once */
1308 if ((s
!= last_source_visited
) || (!last_source_error
))
1310 last_source_visited
= s
;
1311 desc
= open_source_file (s
);
1315 desc
= last_source_error
;
1327 last_source_error
= desc
;
1331 char *name
= alloca (strlen (s
->filename
) + 100);
1332 sprintf (name
, "%d\t%s", line
, s
->filename
);
1333 print_sys_errmsg (name
, errno
);
1336 ui_out_field_int (uiout
, "line", line
);
1337 ui_out_text (uiout
, "\tin ");
1338 ui_out_field_string (uiout
, "file", s
->filename
);
1339 ui_out_text (uiout
, "\n");
1344 last_source_error
= 0;
1346 if (s
->line_charpos
== 0)
1347 find_source_lines (s
, desc
);
1349 if (line
< 1 || line
> s
->nlines
)
1352 error (_("Line number %d out of range; %s has %d lines."),
1353 line
, s
->filename
, s
->nlines
);
1356 if (lseek (desc
, s
->line_charpos
[line
- 1], 0) < 0)
1359 perror_with_name (s
->filename
);
1362 stream
= fdopen (desc
, FDOPEN_MODE
);
1364 cleanup
= make_cleanup_fclose (stream
);
1366 while (nlines
-- > 0)
1373 last_line_listed
= current_source_line
;
1374 sprintf (buf
, "%d\t", current_source_line
++);
1375 ui_out_text (uiout
, buf
);
1378 if (c
< 040 && c
!= '\t' && c
!= '\n' && c
!= '\r')
1380 sprintf (buf
, "^%c", c
+ 0100);
1381 ui_out_text (uiout
, buf
);
1384 ui_out_text (uiout
, "^?");
1387 /* Skip a \r character, but only before a \n. */
1388 int c1
= fgetc (stream
);
1391 printf_filtered ("^%c", c
+ 0100);
1393 ungetc (c1
, stream
);
1397 sprintf (buf
, "%c", c
);
1398 ui_out_text (uiout
, buf
);
1401 while (c
!= '\n' && (c
= fgetc (stream
)) >= 0);
1404 do_cleanups (cleanup
);
1407 /* Show source lines from the file of symtab S, starting with line
1408 number LINE and stopping before line number STOPLINE. If this is
1409 not the command line version, then the source is shown in the source
1410 window otherwise it is simply printed */
1413 print_source_lines (struct symtab
*s
, int line
, int stopline
, int noerror
)
1415 print_source_lines_base (s
, line
, stopline
, noerror
);
1418 /* Print info on range of pc's in a specified line. */
1421 line_info (char *arg
, int from_tty
)
1423 struct symtabs_and_lines sals
;
1424 struct symtab_and_line sal
;
1425 CORE_ADDR start_pc
, end_pc
;
1428 init_sal (&sal
); /* initialize to zeroes */
1432 sal
.symtab
= current_source_symtab
;
1433 sal
.line
= last_line_listed
;
1435 sals
.sals
= (struct symtab_and_line
*)
1436 xmalloc (sizeof (struct symtab_and_line
));
1441 sals
= decode_line_spec_1 (arg
, 0);
1446 /* C++ More than one line may have been specified, as when the user
1447 specifies an overloaded function name. Print info on them all. */
1448 for (i
= 0; i
< sals
.nelts
; i
++)
1452 if (sal
.symtab
== 0)
1454 struct gdbarch
*gdbarch
= get_current_arch ();
1456 printf_filtered (_("No line number information available"));
1459 /* This is useful for "info line *0x7f34". If we can't tell the
1460 user about a source line, at least let them have the symbolic
1462 printf_filtered (" for address ");
1464 print_address (gdbarch
, sal
.pc
, gdb_stdout
);
1467 printf_filtered (".");
1468 printf_filtered ("\n");
1470 else if (sal
.line
> 0
1471 && find_line_pc_range (sal
, &start_pc
, &end_pc
))
1473 struct gdbarch
*gdbarch
= get_objfile_arch (sal
.symtab
->objfile
);
1475 if (start_pc
== end_pc
)
1477 printf_filtered ("Line %d of \"%s\"",
1478 sal
.line
, sal
.symtab
->filename
);
1480 printf_filtered (" is at address ");
1481 print_address (gdbarch
, start_pc
, gdb_stdout
);
1483 printf_filtered (" but contains no code.\n");
1487 printf_filtered ("Line %d of \"%s\"",
1488 sal
.line
, sal
.symtab
->filename
);
1490 printf_filtered (" starts at address ");
1491 print_address (gdbarch
, start_pc
, gdb_stdout
);
1493 printf_filtered (" and ends at ");
1494 print_address (gdbarch
, end_pc
, gdb_stdout
);
1495 printf_filtered (".\n");
1498 /* x/i should display this line's code. */
1499 set_next_address (gdbarch
, start_pc
);
1501 /* Repeating "info line" should do the following line. */
1502 last_line_listed
= sal
.line
+ 1;
1504 /* If this is the only line, show the source code. If it could
1505 not find the file, don't do anything special. */
1506 if (annotation_level
&& sals
.nelts
== 1)
1507 identify_source_line (sal
.symtab
, sal
.line
, 0, start_pc
);
1510 /* Is there any case in which we get here, and have an address
1511 which the user would want to see? If we have debugging symbols
1512 and no line numbers? */
1513 printf_filtered (_("Line number %d is out of range for \"%s\".\n"),
1514 sal
.line
, sal
.symtab
->filename
);
1519 /* Commands to search the source file for a regexp. */
1522 forward_search_command (char *regex
, int from_tty
)
1529 struct cleanup
*cleanups
;
1531 line
= last_line_listed
+ 1;
1533 msg
= (char *) re_comp (regex
);
1535 error (("%s"), msg
);
1537 if (current_source_symtab
== 0)
1538 select_source_symtab (0);
1540 desc
= open_source_file (current_source_symtab
);
1542 perror_with_name (current_source_symtab
->filename
);
1543 cleanups
= make_cleanup_close (desc
);
1545 if (current_source_symtab
->line_charpos
== 0)
1546 find_source_lines (current_source_symtab
, desc
);
1548 if (line
< 1 || line
> current_source_symtab
->nlines
)
1549 error (_("Expression not found"));
1551 if (lseek (desc
, current_source_symtab
->line_charpos
[line
- 1], 0) < 0)
1552 perror_with_name (current_source_symtab
->filename
);
1554 discard_cleanups (cleanups
);
1555 stream
= fdopen (desc
, FDOPEN_MODE
);
1557 cleanups
= make_cleanup_fclose (stream
);
1560 static char *buf
= NULL
;
1562 int cursize
, newsize
;
1565 buf
= xmalloc (cursize
);
1574 if (p
- buf
== cursize
)
1576 newsize
= cursize
+ cursize
/ 2;
1577 buf
= xrealloc (buf
, newsize
);
1582 while (c
!= '\n' && (c
= getc (stream
)) >= 0);
1584 /* Remove the \r, if any, at the end of the line, otherwise
1585 regular expressions that end with $ or \n won't work. */
1586 if (p
- buf
> 1 && p
[-2] == '\r')
1592 /* we now have a source line in buf, null terminate and match */
1594 if (re_exec (buf
) > 0)
1597 do_cleanups (cleanups
);
1598 print_source_lines (current_source_symtab
, line
, line
+ 1, 0);
1599 set_internalvar_integer (lookup_internalvar ("_"), line
);
1600 current_source_line
= max (line
- lines_to_list
/ 2, 1);
1606 printf_filtered (_("Expression not found\n"));
1607 do_cleanups (cleanups
);
1611 reverse_search_command (char *regex
, int from_tty
)
1618 struct cleanup
*cleanups
;
1620 line
= last_line_listed
- 1;
1622 msg
= (char *) re_comp (regex
);
1624 error (("%s"), msg
);
1626 if (current_source_symtab
== 0)
1627 select_source_symtab (0);
1629 desc
= open_source_file (current_source_symtab
);
1631 perror_with_name (current_source_symtab
->filename
);
1632 cleanups
= make_cleanup_close (desc
);
1634 if (current_source_symtab
->line_charpos
== 0)
1635 find_source_lines (current_source_symtab
, desc
);
1637 if (line
< 1 || line
> current_source_symtab
->nlines
)
1638 error (_("Expression not found"));
1640 if (lseek (desc
, current_source_symtab
->line_charpos
[line
- 1], 0) < 0)
1641 perror_with_name (current_source_symtab
->filename
);
1643 discard_cleanups (cleanups
);
1644 stream
= fdopen (desc
, FDOPEN_MODE
);
1646 cleanups
= make_cleanup_fclose (stream
);
1649 /* FIXME!!! We walk right off the end of buf if we get a long line!!! */
1650 char buf
[4096]; /* Should be reasonable??? */
1660 while (c
!= '\n' && (c
= getc (stream
)) >= 0);
1662 /* Remove the \r, if any, at the end of the line, otherwise
1663 regular expressions that end with $ or \n won't work. */
1664 if (p
- buf
> 1 && p
[-2] == '\r')
1670 /* We now have a source line in buf; null terminate and match. */
1672 if (re_exec (buf
) > 0)
1675 do_cleanups (cleanups
);
1676 print_source_lines (current_source_symtab
, line
, line
+ 1, 0);
1677 set_internalvar_integer (lookup_internalvar ("_"), line
);
1678 current_source_line
= max (line
- lines_to_list
/ 2, 1);
1682 if (fseek (stream
, current_source_symtab
->line_charpos
[line
- 1], 0) < 0)
1684 do_cleanups (cleanups
);
1685 perror_with_name (current_source_symtab
->filename
);
1689 printf_filtered (_("Expression not found\n"));
1690 do_cleanups (cleanups
);
1694 /* If the last character of PATH is a directory separator, then strip it. */
1697 strip_trailing_directory_separator (char *path
)
1699 const int last
= strlen (path
) - 1;
1702 return; /* No stripping is needed if PATH is the empty string. */
1704 if (IS_DIR_SEPARATOR (path
[last
]))
1708 /* Return the path substitution rule that matches FROM.
1709 Return NULL if no rule matches. */
1711 static struct substitute_path_rule
*
1712 find_substitute_path_rule (const char *from
)
1714 struct substitute_path_rule
*rule
= substitute_path_rules
;
1716 while (rule
!= NULL
)
1718 if (FILENAME_CMP (rule
->from
, from
) == 0)
1726 /* Add a new substitute-path rule at the end of the current list of rules.
1727 The new rule will replace FROM into TO. */
1730 add_substitute_path_rule (char *from
, char *to
)
1732 struct substitute_path_rule
*rule
;
1733 struct substitute_path_rule
*new_rule
;
1735 new_rule
= xmalloc (sizeof (struct substitute_path_rule
));
1736 new_rule
->from
= xstrdup (from
);
1737 new_rule
->to
= xstrdup (to
);
1738 new_rule
->next
= NULL
;
1740 /* If the list of rules are empty, then insert the new rule
1741 at the head of the list. */
1743 if (substitute_path_rules
== NULL
)
1745 substitute_path_rules
= new_rule
;
1749 /* Otherwise, skip to the last rule in our list and then append
1752 rule
= substitute_path_rules
;
1753 while (rule
->next
!= NULL
)
1756 rule
->next
= new_rule
;
1759 /* Remove the given source path substitution rule from the current list
1760 of rules. The memory allocated for that rule is also deallocated. */
1763 delete_substitute_path_rule (struct substitute_path_rule
*rule
)
1765 if (rule
== substitute_path_rules
)
1766 substitute_path_rules
= rule
->next
;
1769 struct substitute_path_rule
*prev
= substitute_path_rules
;
1771 while (prev
!= NULL
&& prev
->next
!= rule
)
1774 gdb_assert (prev
!= NULL
);
1776 prev
->next
= rule
->next
;
1784 /* Implement the "show substitute-path" command. */
1787 show_substitute_path_command (char *args
, int from_tty
)
1789 struct substitute_path_rule
*rule
= substitute_path_rules
;
1793 argv
= gdb_buildargv (args
);
1794 make_cleanup_freeargv (argv
);
1796 /* We expect zero or one argument. */
1798 if (argv
!= NULL
&& argv
[0] != NULL
&& argv
[1] != NULL
)
1799 error (_("Too many arguments in command"));
1801 if (argv
!= NULL
&& argv
[0] != NULL
)
1804 /* Print the substitution rules. */
1808 (_("Source path substitution rule matching `%s':\n"), from
);
1810 printf_filtered (_("List of all source path substitution rules:\n"));
1812 while (rule
!= NULL
)
1814 if (from
== NULL
|| FILENAME_CMP (rule
->from
, from
) == 0)
1815 printf_filtered (" `%s' -> `%s'.\n", rule
->from
, rule
->to
);
1820 /* Implement the "unset substitute-path" command. */
1823 unset_substitute_path_command (char *args
, int from_tty
)
1825 struct substitute_path_rule
*rule
= substitute_path_rules
;
1826 char **argv
= gdb_buildargv (args
);
1830 /* This function takes either 0 or 1 argument. */
1832 make_cleanup_freeargv (argv
);
1833 if (argv
!= NULL
&& argv
[0] != NULL
&& argv
[1] != NULL
)
1834 error (_("Incorrect usage, too many arguments in command"));
1836 if (argv
!= NULL
&& argv
[0] != NULL
)
1839 /* If the user asked for all the rules to be deleted, ask him
1840 to confirm and give him a chance to abort before the action
1844 && !query (_("Delete all source path substitution rules? ")))
1845 error (_("Canceled"));
1847 /* Delete the rule matching the argument. No argument means that
1848 all rules should be deleted. */
1850 while (rule
!= NULL
)
1852 struct substitute_path_rule
*next
= rule
->next
;
1854 if (from
== NULL
|| FILENAME_CMP (from
, rule
->from
) == 0)
1856 delete_substitute_path_rule (rule
);
1863 /* If the user asked for a specific rule to be deleted but
1864 we could not find it, then report an error. */
1866 if (from
!= NULL
&& !rule_found
)
1867 error (_("No substitution rule defined for `%s'"), from
);
1869 forget_cached_source_info ();
1872 /* Add a new source path substitution rule. */
1875 set_substitute_path_command (char *args
, int from_tty
)
1877 char *from_path
, *to_path
;
1879 struct substitute_path_rule
*rule
;
1881 argv
= gdb_buildargv (args
);
1882 make_cleanup_freeargv (argv
);
1884 if (argv
== NULL
|| argv
[0] == NULL
|| argv
[1] == NULL
)
1885 error (_("Incorrect usage, too few arguments in command"));
1887 if (argv
[2] != NULL
)
1888 error (_("Incorrect usage, too many arguments in command"));
1890 if (*(argv
[0]) == '\0')
1891 error (_("First argument must be at least one character long"));
1893 /* Strip any trailing directory separator character in either FROM
1894 or TO. The substitution rule already implicitly contains them. */
1895 strip_trailing_directory_separator (argv
[0]);
1896 strip_trailing_directory_separator (argv
[1]);
1898 /* If a rule with the same "from" was previously defined, then
1899 delete it. This new rule replaces it. */
1901 rule
= find_substitute_path_rule (argv
[0]);
1903 delete_substitute_path_rule (rule
);
1905 /* Insert the new substitution rule. */
1907 add_substitute_path_rule (argv
[0], argv
[1]);
1908 forget_cached_source_info ();
1913 _initialize_source (void)
1915 struct cmd_list_element
*c
;
1916 current_source_symtab
= 0;
1917 init_source_path ();
1919 /* The intention is to use POSIX Basic Regular Expressions.
1920 Always use the GNU regex routine for consistency across all hosts.
1921 Our current GNU regex.c does not have all the POSIX features, so this is
1922 just an approximation. */
1923 re_set_syntax (RE_SYNTAX_GREP
);
1925 c
= add_cmd ("directory", class_files
, directory_command
, _("\
1926 Add directory DIR to beginning of search path for source files.\n\
1927 Forget cached info on source file locations and line positions.\n\
1928 DIR can also be $cwd for the current working directory, or $cdir for the\n\
1929 directory in which the source file was compiled into object code.\n\
1930 With no argument, reset the search path to $cdir:$cwd, the default."),
1934 add_com_alias ("use", "directory", class_files
, 0);
1936 set_cmd_completer (c
, filename_completer
);
1938 add_cmd ("directories", no_class
, show_directories
, _("\
1939 Current search path for finding source files.\n\
1940 $cwd in the path means the current working directory.\n\
1941 $cdir in the path means the compilation directory of the source file."),
1946 add_com_alias ("D", "directory", class_files
, 0);
1947 add_cmd ("ld", no_class
, show_directories
, _("\
1948 Current search path for finding source files.\n\
1949 $cwd in the path means the current working directory.\n\
1950 $cdir in the path means the compilation directory of the source file."),
1954 add_info ("source", source_info
,
1955 _("Information about the current source file."));
1957 add_info ("line", line_info
, _("\
1958 Core addresses of the code for a source line.\n\
1959 Line can be specified as\n\
1960 LINENUM, to list around that line in current file,\n\
1961 FILE:LINENUM, to list around that line in that file,\n\
1962 FUNCTION, to list around beginning of that function,\n\
1963 FILE:FUNCTION, to distinguish among like-named static functions.\n\
1964 Default is to describe the last source line that was listed.\n\n\
1965 This sets the default address for \"x\" to the line's first instruction\n\
1966 so that \"x/i\" suffices to start examining the machine code.\n\
1967 The address is also stored as the value of \"$_\"."));
1969 add_com ("forward-search", class_files
, forward_search_command
, _("\
1970 Search for regular expression (see regex(3)) from last line listed.\n\
1971 The matching line number is also stored as the value of \"$_\"."));
1972 add_com_alias ("search", "forward-search", class_files
, 0);
1974 add_com ("reverse-search", class_files
, reverse_search_command
, _("\
1975 Search backward for regular expression (see regex(3)) from last line listed.\n\
1976 The matching line number is also stored as the value of \"$_\"."));
1980 add_com_alias ("/", "forward-search", class_files
, 0);
1981 add_com_alias ("?", "reverse-search", class_files
, 0);
1984 add_setshow_integer_cmd ("listsize", class_support
, &lines_to_list
, _("\
1985 Set number of source lines gdb will list by default."), _("\
1986 Show number of source lines gdb will list by default."), NULL
,
1989 &setlist
, &showlist
);
1991 add_cmd ("substitute-path", class_files
, set_substitute_path_command
,
1993 Usage: set substitute-path FROM TO\n\
1994 Add a substitution rule replacing FROM into TO in source file names.\n\
1995 If a substitution rule was previously set for FROM, the old rule\n\
1996 is replaced by the new one."),
1999 add_cmd ("substitute-path", class_files
, unset_substitute_path_command
,
2001 Usage: unset substitute-path [FROM]\n\
2002 Delete the rule for substituting FROM in source file names. If FROM\n\
2003 is not specified, all substituting rules are deleted.\n\
2004 If the debugger cannot find a rule for FROM, it will display a warning."),
2007 add_cmd ("substitute-path", class_files
, show_substitute_path_command
,
2009 Usage: show substitute-path [FROM]\n\
2010 Print the rule for substituting FROM in source file names. If FROM\n\
2011 is not specified, print all substitution rules."),