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 if (!have_full_symbols () && !have_partial_symbols ())
180 error (_("No symbol table is loaded. Use the \"file\" command."));
182 /* Pull in a current source symtab if necessary */
183 if (current_source_symtab
== 0)
184 select_source_symtab (0);
187 /* Return the current default file for listing and next line to list
188 (the returned sal pc and end fields are not valid.)
189 and set the current default to whatever is in SAL.
190 NOTE: The returned sal pc and end fields are not valid. */
192 struct symtab_and_line
193 set_current_source_symtab_and_line (const struct symtab_and_line
*sal
)
195 struct symtab_and_line cursal
= { 0 };
197 cursal
.pspace
= current_source_pspace
;
198 cursal
.symtab
= current_source_symtab
;
199 cursal
.line
= current_source_line
;
203 current_source_pspace
= sal
->pspace
;
204 current_source_symtab
= sal
->symtab
;
205 current_source_line
= sal
->line
;
210 /* Reset any information stored about a default file and line to print. */
213 clear_current_source_symtab_and_line (void)
215 current_source_symtab
= 0;
216 current_source_line
= 0;
219 /* Set the source file default for the "list" command to be S.
221 If S is NULL, and we don't have a default, find one. This
222 should only be called when the user actually tries to use the
223 default, since we produce an error if we can't find a reasonable
224 default. Also, since this can cause symbols to be read, doing it
225 before we need to would make things slower than necessary. */
228 select_source_symtab (struct symtab
*s
)
230 struct symtabs_and_lines sals
;
231 struct symtab_and_line sal
;
236 current_source_symtab
= s
;
237 current_source_line
= 1;
238 current_source_pspace
= SYMTAB_PSPACE (s
);
242 if (current_source_symtab
)
245 /* Make the default place to list be the function `main'
247 if (lookup_symbol (main_name (), 0, VAR_DOMAIN
, 0))
249 sals
= decode_line_spec (main_name (), 1);
252 current_source_pspace
= sal
.pspace
;
253 current_source_symtab
= sal
.symtab
;
254 current_source_line
= max (sal
.line
- (lines_to_list
- 1), 1);
255 if (current_source_symtab
)
259 /* Alright; find the last file in the symtab list (ignoring .h's
260 and namespace symtabs). */
262 current_source_line
= 1;
266 for (s
= ofp
->symtabs
; s
; s
= s
->next
)
268 const char *name
= s
->filename
;
269 int len
= strlen (name
);
271 if (!(len
> 2 && (strcmp (&name
[len
- 2], ".h") == 0
272 || strcmp (name
, "<<C++-namespaces>>") == 0)))
274 current_source_pspace
= current_program_space
;
275 current_source_symtab
= s
;
280 if (current_source_symtab
)
286 s
= ofp
->sf
->qf
->find_last_source_symtab (ofp
);
288 current_source_symtab
= s
;
290 if (current_source_symtab
)
293 error (_("Can't find a default source file"));
297 show_directories (char *ignore
, int from_tty
)
299 puts_filtered ("Source directories searched: ");
300 puts_filtered (source_path
);
301 puts_filtered ("\n");
304 /* Forget what we learned about line positions in source files, and
305 which directories contain them; must check again now since files
306 may be found in a different directory now. */
309 forget_cached_source_info (void)
311 struct program_space
*pspace
;
313 struct objfile
*objfile
;
316 ALL_PSPACE_OBJFILES (pspace
, objfile
)
318 for (s
= objfile
->symtabs
; s
!= NULL
; s
= s
->next
)
320 if (s
->line_charpos
!= NULL
)
322 xfree (s
->line_charpos
);
323 s
->line_charpos
= NULL
;
325 if (s
->fullname
!= NULL
)
333 objfile
->sf
->qf
->forget_cached_source_info (objfile
);
336 last_source_visited
= NULL
;
340 init_source_path (void)
344 sprintf (buf
, "$cdir%c$cwd", DIRNAME_SEPARATOR
);
345 source_path
= xstrdup (buf
);
346 forget_cached_source_info ();
349 /* Add zero or more directories to the front of the source path. */
352 directory_command (char *dirname
, int from_tty
)
355 /* FIXME, this goes to "delete dir"... */
358 if (!from_tty
|| query (_("Reinitialize source path to empty? ")))
366 mod_path (dirname
, &source_path
);
367 forget_cached_source_info ();
370 show_directories ((char *) 0, from_tty
);
373 /* Add a path given with the -d command line switch.
374 This will not be quoted so we must not treat spaces as separators. */
377 directory_switch (char *dirname
, int from_tty
)
379 add_path (dirname
, &source_path
, 0);
382 /* Add zero or more directories to the front of an arbitrary path. */
385 mod_path (char *dirname
, char **which_path
)
387 add_path (dirname
, which_path
, 1);
390 /* Workhorse of mod_path. Takes an extra argument to determine
391 if dirname should be parsed for separators that indicate multiple
392 directories. This allows for interfaces that pre-parse the dirname
393 and allow specification of traditional separator characters such
397 add_path (char *dirname
, char **which_path
, int parse_separators
)
399 char *old
= *which_path
;
408 if (parse_separators
)
410 /* This will properly parse the space and tab separators
411 and any quotes that may exist. DIRNAME_SEPARATOR will
412 be dealt with later. */
413 argv
= gdb_buildargv (dirname
);
414 make_cleanup_freeargv (argv
);
420 arg
= xstrdup (dirname
);
421 make_cleanup (xfree
, arg
);
431 char *separator
= NULL
;
433 /* Spaces and tabs will have been removed by buildargv().
434 The directories will there be split into a list but
435 each entry may still contain DIRNAME_SEPARATOR. */
436 if (parse_separators
)
437 separator
= strchr (name
, DIRNAME_SEPARATOR
);
440 p
= arg
= name
+ strlen (name
);
445 while (*arg
== DIRNAME_SEPARATOR
)
449 /* If there are no more directories in this argument then start
450 on the next argument next time round the loop (if any). */
452 arg
= parse_separators
? argv
[++argv_index
] : NULL
;
455 /* name is the start of the directory.
456 p is the separator (or null) following the end. */
458 while (!(IS_DIR_SEPARATOR (*name
) && p
<= name
+ 1) /* "/" */
459 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
460 /* On MS-DOS and MS-Windows, h:\ is different from h: */
461 && !(p
== name
+ 3 && name
[1] == ':') /* "d:/" */
463 && IS_DIR_SEPARATOR (p
[-1]))
464 /* Sigh. "foo/" => "foo" */
468 while (p
> name
&& p
[-1] == '.')
472 /* "." => getwd (). */
473 name
= current_directory
;
476 else if (p
> name
+ 1 && IS_DIR_SEPARATOR (p
[-2]))
486 /* "...foo/." => "...foo". */
497 name
= tilde_expand (name
);
498 #ifdef HAVE_DOS_BASED_FILE_SYSTEM
499 else if (IS_ABSOLUTE_PATH (name
) && p
== name
+ 2) /* "d:" => "d:." */
500 name
= concat (name
, ".", (char *)NULL
);
502 else if (!IS_ABSOLUTE_PATH (name
) && name
[0] != '$')
503 name
= concat (current_directory
, SLASH_STRING
, name
, (char *)NULL
);
505 name
= savestring (name
, p
- name
);
506 make_cleanup (xfree
, name
);
508 /* Unless it's a variable, check existence. */
511 /* These are warnings, not errors, since we don't want a
512 non-existent directory in a .gdbinit file to stop processing
513 of the .gdbinit file.
515 Whether they get added to the path is more debatable. Current
516 answer is yes, in case the user wants to go make the directory
517 or whatever. If the directory continues to not exist/not be
518 a directory/etc, then having them in the path should be
520 if (stat (name
, &st
) < 0)
522 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
);
819 *filename_opened
= xfullpath (f
);
828 /* This is essentially a convenience, for clients that want the behaviour
829 of openp, using source_path, but that really don't want the file to be
830 opened but want instead just to know what the full pathname is (as
831 qualified against source_path).
833 The current working directory is searched first.
835 If the file was found, this function returns 1, and FULL_PATHNAME is
836 set to the fully-qualified pathname.
838 Else, this functions returns 0, and FULL_PATHNAME is set to NULL. */
840 source_full_path_of (const char *filename
, char **full_pathname
)
844 fd
= openp (source_path
, OPF_TRY_CWD_FIRST
| OPF_SEARCH_IN_PATH
, filename
,
845 O_RDONLY
, full_pathname
);
848 *full_pathname
= NULL
;
856 /* Return non-zero if RULE matches PATH, that is if the rule can be
860 substitute_path_rule_matches (const struct substitute_path_rule
*rule
,
863 const int from_len
= strlen (rule
->from
);
864 const int path_len
= strlen (path
);
867 if (path_len
< from_len
)
870 /* The substitution rules are anchored at the start of the path,
871 so the path should start with rule->from. There is no filename
872 comparison routine, so we need to extract the first FROM_LEN
873 characters from PATH first and use that to do the comparison. */
875 path_start
= alloca (from_len
+ 1);
876 strncpy (path_start
, path
, from_len
);
877 path_start
[from_len
] = '\0';
879 if (FILENAME_CMP (path_start
, rule
->from
) != 0)
882 /* Make sure that the region in the path that matches the substitution
883 rule is immediately followed by a directory separator (or the end of
884 string character). */
886 if (path
[from_len
] != '\0' && !IS_DIR_SEPARATOR (path
[from_len
]))
892 /* Find the substitute-path rule that applies to PATH and return it.
893 Return NULL if no rule applies. */
895 static struct substitute_path_rule
*
896 get_substitute_path_rule (const char *path
)
898 struct substitute_path_rule
*rule
= substitute_path_rules
;
900 while (rule
!= NULL
&& !substitute_path_rule_matches (rule
, path
))
906 /* If the user specified a source path substitution rule that applies
907 to PATH, then apply it and return the new path. This new path must
908 be deallocated afterwards.
910 Return NULL if no substitution rule was specified by the user,
911 or if no rule applied to the given PATH. */
914 rewrite_source_path (const char *path
)
916 const struct substitute_path_rule
*rule
= get_substitute_path_rule (path
);
923 from_len
= strlen (rule
->from
);
925 /* Compute the rewritten path and return it. */
928 (char *) xmalloc (strlen (path
) + 1 + strlen (rule
->to
) - from_len
);
929 strcpy (new_path
, rule
->to
);
930 strcat (new_path
, path
+ from_len
);
935 /* This function is capable of finding the absolute path to a
936 source file, and opening it, provided you give it a FILENAME. Both the
937 DIRNAME and FULLNAME are only added suggestions on where to find the file.
939 FILENAME should be the filename to open.
940 DIRNAME is the compilation directory of a particular source file.
941 Only some debug formats provide this info.
942 FULLNAME can be the last known absolute path to the file in question.
943 Space for the path must have been malloc'd. If a path substitution
944 is applied we free the old value and set a new one.
947 A valid file descriptor is returned. ( the return value is positive )
948 FULLNAME is set to the absolute path to the file just opened.
949 The caller is responsible for freeing FULLNAME.
952 An invalid file descriptor is returned. ( the return value is negative )
953 FULLNAME is set to NULL. */
956 find_and_open_source (const char *filename
,
960 char *path
= source_path
;
964 /* Quick way out if we already know its full name */
968 /* The user may have requested that source paths be rewritten
969 according to substitution rules he provided. If a substitution
970 rule applies to this path, then apply it. */
971 char *rewritten_fullname
= rewrite_source_path (*fullname
);
973 if (rewritten_fullname
!= NULL
)
976 *fullname
= rewritten_fullname
;
979 result
= open (*fullname
, OPEN_MODE
);
982 /* Didn't work -- free old one, try again. */
989 /* If necessary, rewrite the compilation directory name according
990 to the source path substitution rules specified by the user. */
992 char *rewritten_dirname
= rewrite_source_path (dirname
);
994 if (rewritten_dirname
!= NULL
)
996 make_cleanup (xfree
, rewritten_dirname
);
997 dirname
= rewritten_dirname
;
1000 /* Replace a path entry of $cdir with the compilation directory name */
1002 /* We cast strstr's result in case an ANSIhole has made it const,
1003 which produces a "required warning" when assigned to a nonconst. */
1004 p
= (char *) strstr (source_path
, "$cdir");
1005 if (p
&& (p
== path
|| p
[-1] == DIRNAME_SEPARATOR
)
1006 && (p
[cdir_len
] == DIRNAME_SEPARATOR
|| p
[cdir_len
] == '\0'))
1011 alloca (strlen (source_path
) + 1 + strlen (dirname
) + 1);
1012 len
= p
- source_path
;
1013 strncpy (path
, source_path
, len
); /* Before $cdir */
1014 strcpy (path
+ len
, dirname
); /* new stuff */
1015 strcat (path
+ len
, source_path
+ len
+ cdir_len
); /* After $cdir */
1019 if (IS_ABSOLUTE_PATH (filename
))
1021 /* If filename is absolute path, try the source path
1022 substitution on it. */
1023 char *rewritten_filename
= rewrite_source_path (filename
);
1025 if (rewritten_filename
!= NULL
)
1027 make_cleanup (xfree
, rewritten_filename
);
1028 filename
= rewritten_filename
;
1032 result
= openp (path
, OPF_SEARCH_IN_PATH
, filename
, OPEN_MODE
, fullname
);
1035 /* Didn't work. Try using just the basename. */
1036 p
= lbasename (filename
);
1038 result
= openp (path
, OPF_SEARCH_IN_PATH
, p
, OPEN_MODE
, fullname
);
1044 /* Open a source file given a symtab S. Returns a file descriptor or
1045 negative number for error.
1047 This function is a convience function to find_and_open_source. */
1050 open_source_file (struct symtab
*s
)
1055 return find_and_open_source (s
->filename
, s
->dirname
, &s
->fullname
);
1058 /* Finds the fullname that a symtab represents.
1060 If this functions finds the fullname, it will save it in s->fullname
1061 and it will also return the value.
1063 If this function fails to find the file that this symtab represents,
1064 NULL will be returned and s->fullname will be set to NULL. */
1066 symtab_to_fullname (struct symtab
*s
)
1073 /* Don't check s->fullname here, the file could have been
1074 deleted/moved/..., look for it again */
1075 r
= find_and_open_source (s
->filename
, s
->dirname
, &s
->fullname
);
1086 /* Create and initialize the table S->line_charpos that records
1087 the positions of the lines in the source file, which is assumed
1088 to be open on descriptor DESC.
1089 All set S->nlines to the number of such lines. */
1092 find_source_lines (struct symtab
*s
, int desc
)
1095 char *data
, *p
, *end
;
1097 int lines_allocated
= 1000;
1103 line_charpos
= (int *) xmalloc (lines_allocated
* sizeof (int));
1104 if (fstat (desc
, &st
) < 0)
1105 perror_with_name (s
->filename
);
1107 if (s
->objfile
&& s
->objfile
->obfd
)
1108 mtime
= s
->objfile
->mtime
;
1110 mtime
= exec_bfd_mtime
;
1112 if (mtime
&& mtime
< st
.st_mtime
)
1113 warning (_("Source file is more recent than executable."));
1115 #ifdef LSEEK_NOT_LINEAR
1119 /* Have to read it byte by byte to find out where the chars live */
1121 line_charpos
[0] = lseek (desc
, 0, SEEK_CUR
);
1123 while (myread (desc
, &c
, 1) > 0)
1127 if (nlines
== lines_allocated
)
1129 lines_allocated
*= 2;
1131 (int *) xrealloc ((char *) line_charpos
,
1132 sizeof (int) * lines_allocated
);
1134 line_charpos
[nlines
++] = lseek (desc
, 0, SEEK_CUR
);
1138 #else /* lseek linear. */
1140 struct cleanup
*old_cleanups
;
1142 /* st_size might be a large type, but we only support source files whose
1143 size fits in an int. */
1144 size
= (int) st
.st_size
;
1146 /* Use malloc, not alloca, because this may be pretty large, and we may
1147 run into various kinds of limits on stack size. */
1148 data
= (char *) xmalloc (size
);
1149 old_cleanups
= make_cleanup (xfree
, data
);
1151 /* Reassign `size' to result of read for systems where \r\n -> \n. */
1152 size
= myread (desc
, data
, size
);
1154 perror_with_name (s
->filename
);
1157 line_charpos
[0] = 0;
1162 /* A newline at the end does not start a new line. */
1165 if (nlines
== lines_allocated
)
1167 lines_allocated
*= 2;
1169 (int *) xrealloc ((char *) line_charpos
,
1170 sizeof (int) * lines_allocated
);
1172 line_charpos
[nlines
++] = p
- data
;
1175 do_cleanups (old_cleanups
);
1177 #endif /* lseek linear. */
1180 (int *) xrealloc ((char *) line_charpos
, nlines
* sizeof (int));
1184 /* Return the character position of a line LINE in symtab S.
1185 Return 0 if anything is invalid. */
1187 #if 0 /* Currently unused */
1190 source_line_charpos (struct symtab
*s
, int line
)
1194 if (!s
->line_charpos
|| line
<= 0)
1196 if (line
> s
->nlines
)
1198 return s
->line_charpos
[line
- 1];
1201 /* Return the line number of character position POS in symtab S. */
1204 source_charpos_line (struct symtab
*s
, int chr
)
1209 if (s
== 0 || s
->line_charpos
== 0)
1211 lnp
= s
->line_charpos
;
1212 /* Files are usually short, so sequential search is Ok */
1213 while (line
< s
->nlines
&& *lnp
<= chr
)
1218 if (line
>= s
->nlines
)
1226 /* Get full pathname and line number positions for a symtab.
1227 Return nonzero if line numbers may have changed.
1228 Set *FULLNAME to actual name of the file as found by `openp',
1229 or to 0 if the file is not found. */
1232 get_filename_and_charpos (struct symtab
*s
, char **fullname
)
1234 int desc
, linenums_changed
= 0;
1235 struct cleanup
*cleanups
;
1237 desc
= open_source_file (s
);
1244 cleanups
= make_cleanup_close (desc
);
1246 *fullname
= s
->fullname
;
1247 if (s
->line_charpos
== 0)
1248 linenums_changed
= 1;
1249 if (linenums_changed
)
1250 find_source_lines (s
, desc
);
1251 do_cleanups (cleanups
);
1252 return linenums_changed
;
1255 /* Print text describing the full name of the source file S
1256 and the line number LINE and its corresponding character position.
1257 The text starts with two Ctrl-z so that the Emacs-GDB interface
1260 MID_STATEMENT is nonzero if the PC is not at the beginning of that line.
1262 Return 1 if successful, 0 if could not find the file. */
1265 identify_source_line (struct symtab
*s
, int line
, int mid_statement
,
1268 if (s
->line_charpos
== 0)
1269 get_filename_and_charpos (s
, (char **) NULL
);
1270 if (s
->fullname
== 0)
1272 if (line
> s
->nlines
)
1273 /* Don't index off the end of the line_charpos array. */
1275 annotate_source (s
->fullname
, line
, s
->line_charpos
[line
- 1],
1276 mid_statement
, get_objfile_arch (s
->objfile
), pc
);
1278 current_source_line
= line
;
1279 first_line_listed
= line
;
1280 last_line_listed
= line
;
1281 current_source_symtab
= s
;
1286 /* Print source lines from the file of symtab S,
1287 starting with line number LINE and stopping before line number STOPLINE. */
1289 static void print_source_lines_base (struct symtab
*s
, int line
, int stopline
,
1292 print_source_lines_base (struct symtab
*s
, int line
, int stopline
, int noerror
)
1298 int nlines
= stopline
- line
;
1299 struct cleanup
*cleanup
;
1301 /* Regardless of whether we can open the file, set current_source_symtab. */
1302 current_source_symtab
= s
;
1303 current_source_line
= line
;
1304 first_line_listed
= line
;
1306 /* If printing of source lines is disabled, just print file and line number */
1307 if (ui_out_test_flags (uiout
, ui_source_list
))
1309 /* Only prints "No such file or directory" once */
1310 if ((s
!= last_source_visited
) || (!last_source_error
))
1312 last_source_visited
= s
;
1313 desc
= open_source_file (s
);
1317 desc
= last_source_error
;
1323 desc
= last_source_error
;
1328 if (desc
< 0 || noprint
)
1330 last_source_error
= desc
;
1334 char *name
= alloca (strlen (s
->filename
) + 100);
1335 sprintf (name
, "%d\t%s", line
, s
->filename
);
1336 print_sys_errmsg (name
, errno
);
1339 ui_out_field_int (uiout
, "line", line
);
1340 ui_out_text (uiout
, "\tin ");
1341 ui_out_field_string (uiout
, "file", s
->filename
);
1342 ui_out_text (uiout
, "\n");
1347 last_source_error
= 0;
1349 if (s
->line_charpos
== 0)
1350 find_source_lines (s
, desc
);
1352 if (line
< 1 || line
> s
->nlines
)
1355 error (_("Line number %d out of range; %s has %d lines."),
1356 line
, s
->filename
, s
->nlines
);
1359 if (lseek (desc
, s
->line_charpos
[line
- 1], 0) < 0)
1362 perror_with_name (s
->filename
);
1365 stream
= fdopen (desc
, FDOPEN_MODE
);
1367 cleanup
= make_cleanup_fclose (stream
);
1369 while (nlines
-- > 0)
1376 last_line_listed
= current_source_line
;
1377 sprintf (buf
, "%d\t", current_source_line
++);
1378 ui_out_text (uiout
, buf
);
1381 if (c
< 040 && c
!= '\t' && c
!= '\n' && c
!= '\r')
1383 sprintf (buf
, "^%c", c
+ 0100);
1384 ui_out_text (uiout
, buf
);
1387 ui_out_text (uiout
, "^?");
1390 /* Skip a \r character, but only before a \n. */
1391 int c1
= fgetc (stream
);
1394 printf_filtered ("^%c", c
+ 0100);
1396 ungetc (c1
, stream
);
1400 sprintf (buf
, "%c", c
);
1401 ui_out_text (uiout
, buf
);
1404 while (c
!= '\n' && (c
= fgetc (stream
)) >= 0);
1407 do_cleanups (cleanup
);
1410 /* Show source lines from the file of symtab S, starting with line
1411 number LINE and stopping before line number STOPLINE. If this is
1412 not the command line version, then the source is shown in the source
1413 window otherwise it is simply printed */
1416 print_source_lines (struct symtab
*s
, int line
, int stopline
, int noerror
)
1418 print_source_lines_base (s
, line
, stopline
, noerror
);
1421 /* Print info on range of pc's in a specified line. */
1424 line_info (char *arg
, int from_tty
)
1426 struct symtabs_and_lines sals
;
1427 struct symtab_and_line sal
;
1428 CORE_ADDR start_pc
, end_pc
;
1431 init_sal (&sal
); /* initialize to zeroes */
1435 sal
.symtab
= current_source_symtab
;
1436 sal
.line
= last_line_listed
;
1438 sals
.sals
= (struct symtab_and_line
*)
1439 xmalloc (sizeof (struct symtab_and_line
));
1444 sals
= decode_line_spec_1 (arg
, 0);
1449 /* C++ More than one line may have been specified, as when the user
1450 specifies an overloaded function name. Print info on them all. */
1451 for (i
= 0; i
< sals
.nelts
; i
++)
1455 if (sal
.symtab
== 0)
1457 struct gdbarch
*gdbarch
= get_current_arch ();
1459 printf_filtered (_("No line number information available"));
1462 /* This is useful for "info line *0x7f34". If we can't tell the
1463 user about a source line, at least let them have the symbolic
1465 printf_filtered (" for address ");
1467 print_address (gdbarch
, sal
.pc
, gdb_stdout
);
1470 printf_filtered (".");
1471 printf_filtered ("\n");
1473 else if (sal
.line
> 0
1474 && find_line_pc_range (sal
, &start_pc
, &end_pc
))
1476 struct gdbarch
*gdbarch
= get_objfile_arch (sal
.symtab
->objfile
);
1478 if (start_pc
== end_pc
)
1480 printf_filtered ("Line %d of \"%s\"",
1481 sal
.line
, sal
.symtab
->filename
);
1483 printf_filtered (" is at address ");
1484 print_address (gdbarch
, start_pc
, gdb_stdout
);
1486 printf_filtered (" but contains no code.\n");
1490 printf_filtered ("Line %d of \"%s\"",
1491 sal
.line
, sal
.symtab
->filename
);
1493 printf_filtered (" starts at address ");
1494 print_address (gdbarch
, start_pc
, gdb_stdout
);
1496 printf_filtered (" and ends at ");
1497 print_address (gdbarch
, end_pc
, gdb_stdout
);
1498 printf_filtered (".\n");
1501 /* x/i should display this line's code. */
1502 set_next_address (gdbarch
, start_pc
);
1504 /* Repeating "info line" should do the following line. */
1505 last_line_listed
= sal
.line
+ 1;
1507 /* If this is the only line, show the source code. If it could
1508 not find the file, don't do anything special. */
1509 if (annotation_level
&& sals
.nelts
== 1)
1510 identify_source_line (sal
.symtab
, sal
.line
, 0, start_pc
);
1513 /* Is there any case in which we get here, and have an address
1514 which the user would want to see? If we have debugging symbols
1515 and no line numbers? */
1516 printf_filtered (_("Line number %d is out of range for \"%s\".\n"),
1517 sal
.line
, sal
.symtab
->filename
);
1522 /* Commands to search the source file for a regexp. */
1525 forward_search_command (char *regex
, int from_tty
)
1532 struct cleanup
*cleanups
;
1534 line
= last_line_listed
+ 1;
1536 msg
= (char *) re_comp (regex
);
1538 error (("%s"), msg
);
1540 if (current_source_symtab
== 0)
1541 select_source_symtab (0);
1543 desc
= open_source_file (current_source_symtab
);
1545 perror_with_name (current_source_symtab
->filename
);
1546 cleanups
= make_cleanup_close (desc
);
1548 if (current_source_symtab
->line_charpos
== 0)
1549 find_source_lines (current_source_symtab
, desc
);
1551 if (line
< 1 || line
> current_source_symtab
->nlines
)
1552 error (_("Expression not found"));
1554 if (lseek (desc
, current_source_symtab
->line_charpos
[line
- 1], 0) < 0)
1555 perror_with_name (current_source_symtab
->filename
);
1557 discard_cleanups (cleanups
);
1558 stream
= fdopen (desc
, FDOPEN_MODE
);
1560 cleanups
= make_cleanup_fclose (stream
);
1563 static char *buf
= NULL
;
1565 int cursize
, newsize
;
1568 buf
= xmalloc (cursize
);
1577 if (p
- buf
== cursize
)
1579 newsize
= cursize
+ cursize
/ 2;
1580 buf
= xrealloc (buf
, newsize
);
1585 while (c
!= '\n' && (c
= getc (stream
)) >= 0);
1587 /* Remove the \r, if any, at the end of the line, otherwise
1588 regular expressions that end with $ or \n won't work. */
1589 if (p
- buf
> 1 && p
[-2] == '\r')
1595 /* we now have a source line in buf, null terminate and match */
1597 if (re_exec (buf
) > 0)
1600 do_cleanups (cleanups
);
1601 print_source_lines (current_source_symtab
, line
, line
+ 1, 0);
1602 set_internalvar_integer (lookup_internalvar ("_"), line
);
1603 current_source_line
= max (line
- lines_to_list
/ 2, 1);
1609 printf_filtered (_("Expression not found\n"));
1610 do_cleanups (cleanups
);
1614 reverse_search_command (char *regex
, int from_tty
)
1621 struct cleanup
*cleanups
;
1623 line
= last_line_listed
- 1;
1625 msg
= (char *) re_comp (regex
);
1627 error (("%s"), msg
);
1629 if (current_source_symtab
== 0)
1630 select_source_symtab (0);
1632 desc
= open_source_file (current_source_symtab
);
1634 perror_with_name (current_source_symtab
->filename
);
1635 cleanups
= make_cleanup_close (desc
);
1637 if (current_source_symtab
->line_charpos
== 0)
1638 find_source_lines (current_source_symtab
, desc
);
1640 if (line
< 1 || line
> current_source_symtab
->nlines
)
1641 error (_("Expression not found"));
1643 if (lseek (desc
, current_source_symtab
->line_charpos
[line
- 1], 0) < 0)
1644 perror_with_name (current_source_symtab
->filename
);
1646 discard_cleanups (cleanups
);
1647 stream
= fdopen (desc
, FDOPEN_MODE
);
1649 cleanups
= make_cleanup_fclose (stream
);
1652 /* FIXME!!! We walk right off the end of buf if we get a long line!!! */
1653 char buf
[4096]; /* Should be reasonable??? */
1663 while (c
!= '\n' && (c
= getc (stream
)) >= 0);
1665 /* Remove the \r, if any, at the end of the line, otherwise
1666 regular expressions that end with $ or \n won't work. */
1667 if (p
- buf
> 1 && p
[-2] == '\r')
1673 /* We now have a source line in buf; null terminate and match. */
1675 if (re_exec (buf
) > 0)
1678 do_cleanups (cleanups
);
1679 print_source_lines (current_source_symtab
, line
, line
+ 1, 0);
1680 set_internalvar_integer (lookup_internalvar ("_"), line
);
1681 current_source_line
= max (line
- lines_to_list
/ 2, 1);
1685 if (fseek (stream
, current_source_symtab
->line_charpos
[line
- 1], 0) < 0)
1687 do_cleanups (cleanups
);
1688 perror_with_name (current_source_symtab
->filename
);
1692 printf_filtered (_("Expression not found\n"));
1693 do_cleanups (cleanups
);
1697 /* If the last character of PATH is a directory separator, then strip it. */
1700 strip_trailing_directory_separator (char *path
)
1702 const int last
= strlen (path
) - 1;
1705 return; /* No stripping is needed if PATH is the empty string. */
1707 if (IS_DIR_SEPARATOR (path
[last
]))
1711 /* Return the path substitution rule that matches FROM.
1712 Return NULL if no rule matches. */
1714 static struct substitute_path_rule
*
1715 find_substitute_path_rule (const char *from
)
1717 struct substitute_path_rule
*rule
= substitute_path_rules
;
1719 while (rule
!= NULL
)
1721 if (FILENAME_CMP (rule
->from
, from
) == 0)
1729 /* Add a new substitute-path rule at the end of the current list of rules.
1730 The new rule will replace FROM into TO. */
1733 add_substitute_path_rule (char *from
, char *to
)
1735 struct substitute_path_rule
*rule
;
1736 struct substitute_path_rule
*new_rule
;
1738 new_rule
= xmalloc (sizeof (struct substitute_path_rule
));
1739 new_rule
->from
= xstrdup (from
);
1740 new_rule
->to
= xstrdup (to
);
1741 new_rule
->next
= NULL
;
1743 /* If the list of rules are empty, then insert the new rule
1744 at the head of the list. */
1746 if (substitute_path_rules
== NULL
)
1748 substitute_path_rules
= new_rule
;
1752 /* Otherwise, skip to the last rule in our list and then append
1755 rule
= substitute_path_rules
;
1756 while (rule
->next
!= NULL
)
1759 rule
->next
= new_rule
;
1762 /* Remove the given source path substitution rule from the current list
1763 of rules. The memory allocated for that rule is also deallocated. */
1766 delete_substitute_path_rule (struct substitute_path_rule
*rule
)
1768 if (rule
== substitute_path_rules
)
1769 substitute_path_rules
= rule
->next
;
1772 struct substitute_path_rule
*prev
= substitute_path_rules
;
1774 while (prev
!= NULL
&& prev
->next
!= rule
)
1777 gdb_assert (prev
!= NULL
);
1779 prev
->next
= rule
->next
;
1787 /* Implement the "show substitute-path" command. */
1790 show_substitute_path_command (char *args
, int from_tty
)
1792 struct substitute_path_rule
*rule
= substitute_path_rules
;
1796 argv
= gdb_buildargv (args
);
1797 make_cleanup_freeargv (argv
);
1799 /* We expect zero or one argument. */
1801 if (argv
!= NULL
&& argv
[0] != NULL
&& argv
[1] != NULL
)
1802 error (_("Too many arguments in command"));
1804 if (argv
!= NULL
&& argv
[0] != NULL
)
1807 /* Print the substitution rules. */
1811 (_("Source path substitution rule matching `%s':\n"), from
);
1813 printf_filtered (_("List of all source path substitution rules:\n"));
1815 while (rule
!= NULL
)
1817 if (from
== NULL
|| FILENAME_CMP (rule
->from
, from
) == 0)
1818 printf_filtered (" `%s' -> `%s'.\n", rule
->from
, rule
->to
);
1823 /* Implement the "unset substitute-path" command. */
1826 unset_substitute_path_command (char *args
, int from_tty
)
1828 struct substitute_path_rule
*rule
= substitute_path_rules
;
1829 char **argv
= gdb_buildargv (args
);
1833 /* This function takes either 0 or 1 argument. */
1835 make_cleanup_freeargv (argv
);
1836 if (argv
!= NULL
&& argv
[0] != NULL
&& argv
[1] != NULL
)
1837 error (_("Incorrect usage, too many arguments in command"));
1839 if (argv
!= NULL
&& argv
[0] != NULL
)
1842 /* If the user asked for all the rules to be deleted, ask him
1843 to confirm and give him a chance to abort before the action
1847 && !query (_("Delete all source path substitution rules? ")))
1848 error (_("Canceled"));
1850 /* Delete the rule matching the argument. No argument means that
1851 all rules should be deleted. */
1853 while (rule
!= NULL
)
1855 struct substitute_path_rule
*next
= rule
->next
;
1857 if (from
== NULL
|| FILENAME_CMP (from
, rule
->from
) == 0)
1859 delete_substitute_path_rule (rule
);
1866 /* If the user asked for a specific rule to be deleted but
1867 we could not find it, then report an error. */
1869 if (from
!= NULL
&& !rule_found
)
1870 error (_("No substitution rule defined for `%s'"), from
);
1872 forget_cached_source_info ();
1875 /* Add a new source path substitution rule. */
1878 set_substitute_path_command (char *args
, int from_tty
)
1881 struct substitute_path_rule
*rule
;
1883 argv
= gdb_buildargv (args
);
1884 make_cleanup_freeargv (argv
);
1886 if (argv
== NULL
|| argv
[0] == NULL
|| argv
[1] == NULL
)
1887 error (_("Incorrect usage, too few arguments in command"));
1889 if (argv
[2] != NULL
)
1890 error (_("Incorrect usage, too many arguments in command"));
1892 if (*(argv
[0]) == '\0')
1893 error (_("First argument must be at least one character long"));
1895 /* Strip any trailing directory separator character in either FROM
1896 or TO. The substitution rule already implicitly contains them. */
1897 strip_trailing_directory_separator (argv
[0]);
1898 strip_trailing_directory_separator (argv
[1]);
1900 /* If a rule with the same "from" was previously defined, then
1901 delete it. This new rule replaces it. */
1903 rule
= find_substitute_path_rule (argv
[0]);
1905 delete_substitute_path_rule (rule
);
1907 /* Insert the new substitution rule. */
1909 add_substitute_path_rule (argv
[0], argv
[1]);
1910 forget_cached_source_info ();
1915 _initialize_source (void)
1917 struct cmd_list_element
*c
;
1919 current_source_symtab
= 0;
1920 init_source_path ();
1922 /* The intention is to use POSIX Basic Regular Expressions.
1923 Always use the GNU regex routine for consistency across all hosts.
1924 Our current GNU regex.c does not have all the POSIX features, so this is
1925 just an approximation. */
1926 re_set_syntax (RE_SYNTAX_GREP
);
1928 c
= add_cmd ("directory", class_files
, directory_command
, _("\
1929 Add directory DIR to beginning of search path for source files.\n\
1930 Forget cached info on source file locations and line positions.\n\
1931 DIR can also be $cwd for the current working directory, or $cdir for the\n\
1932 directory in which the source file was compiled into object code.\n\
1933 With no argument, reset the search path to $cdir:$cwd, the default."),
1937 add_com_alias ("use", "directory", class_files
, 0);
1939 set_cmd_completer (c
, filename_completer
);
1941 add_cmd ("directories", no_class
, show_directories
, _("\
1942 Current search path for finding source files.\n\
1943 $cwd in the path means the current working directory.\n\
1944 $cdir in the path means the compilation directory of the source file."),
1949 add_com_alias ("D", "directory", class_files
, 0);
1950 add_cmd ("ld", no_class
, show_directories
, _("\
1951 Current search path for finding source files.\n\
1952 $cwd in the path means the current working directory.\n\
1953 $cdir in the path means the compilation directory of the source file."),
1957 add_info ("source", source_info
,
1958 _("Information about the current source file."));
1960 add_info ("line", line_info
, _("\
1961 Core addresses of the code for a source line.\n\
1962 Line can be specified as\n\
1963 LINENUM, to list around that line in current file,\n\
1964 FILE:LINENUM, to list around that line in that file,\n\
1965 FUNCTION, to list around beginning of that function,\n\
1966 FILE:FUNCTION, to distinguish among like-named static functions.\n\
1967 Default is to describe the last source line that was listed.\n\n\
1968 This sets the default address for \"x\" to the line's first instruction\n\
1969 so that \"x/i\" suffices to start examining the machine code.\n\
1970 The address is also stored as the value of \"$_\"."));
1972 add_com ("forward-search", class_files
, forward_search_command
, _("\
1973 Search for regular expression (see regex(3)) from last line listed.\n\
1974 The matching line number is also stored as the value of \"$_\"."));
1975 add_com_alias ("search", "forward-search", class_files
, 0);
1977 add_com ("reverse-search", class_files
, reverse_search_command
, _("\
1978 Search backward for regular expression (see regex(3)) from last line listed.\n\
1979 The matching line number is also stored as the value of \"$_\"."));
1980 add_com_alias ("rev", "reverse-search", class_files
, 1);
1984 add_com_alias ("/", "forward-search", class_files
, 0);
1985 add_com_alias ("?", "reverse-search", class_files
, 0);
1988 add_setshow_integer_cmd ("listsize", class_support
, &lines_to_list
, _("\
1989 Set number of source lines gdb will list by default."), _("\
1990 Show number of source lines gdb will list by default."), NULL
,
1993 &setlist
, &showlist
);
1995 add_cmd ("substitute-path", class_files
, set_substitute_path_command
,
1997 Usage: set substitute-path FROM TO\n\
1998 Add a substitution rule replacing FROM into TO in source file names.\n\
1999 If a substitution rule was previously set for FROM, the old rule\n\
2000 is replaced by the new one."),
2003 add_cmd ("substitute-path", class_files
, unset_substitute_path_command
,
2005 Usage: unset substitute-path [FROM]\n\
2006 Delete the rule for substituting FROM in source file names. If FROM\n\
2007 is not specified, all substituting rules are deleted.\n\
2008 If the debugger cannot find a rule for FROM, it will display a warning."),
2011 add_cmd ("substitute-path", class_files
, show_substitute_path_command
,
2013 Usage: show substitute-path [FROM]\n\
2014 Print the rule for substituting FROM in source file names. If FROM\n\
2015 is not specified, print all substitution rules."),