1 /* Parser for linespec for the GNU debugger, GDB.
3 Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
4 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008
5 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
31 #include "completer.h"
33 #include "parser-defs.h"
35 #include "objc-lang.h"
37 #include "exceptions.h"
40 #include "mi/mi-cmds.h"
42 /* We share this one with symtab.c, but it is not exported widely. */
44 extern char *operator_chars (char *, char **);
46 /* Prototypes for local functions */
48 static void initialize_defaults (struct symtab
**default_symtab
,
51 static void set_flags (char *arg
, int *is_quoted
, char **paren_pointer
);
53 static struct symtabs_and_lines
decode_indirect (char **argptr
);
55 static char *locate_first_half (char **argptr
, int *is_quote_enclosed
);
57 static struct symtabs_and_lines
decode_objc (char **argptr
,
59 struct symtab
*file_symtab
,
63 static struct symtabs_and_lines
decode_compound (char **argptr
,
69 static struct symbol
*lookup_prefix_sym (char **argptr
, char *p
);
71 static struct symtabs_and_lines
find_method (int funfirstline
,
76 struct symbol
*sym_class
);
78 static int collect_methods (char *copy
, struct type
*t
,
79 struct symbol
*sym_class
,
80 struct symbol
**sym_arr
);
82 static NORETURN
void cplusplus_error (const char *name
,
84 ATTR_NORETURN
ATTR_FORMAT (printf
, 2, 3);
86 static int total_number_of_methods (struct type
*type
);
88 static int find_methods (struct type
*, char *,
89 enum language
, struct symbol
**);
91 static int add_matching_methods (int method_counter
, struct type
*t
,
92 enum language language
,
93 struct symbol
**sym_arr
);
95 static int add_constructors (int method_counter
, struct type
*t
,
96 enum language language
,
97 struct symbol
**sym_arr
);
99 static void build_canonical_line_spec (struct symtab_and_line
*,
102 static char *find_toplevel_char (char *s
, char c
);
104 static int is_objc_method_format (const char *s
);
106 static struct symtabs_and_lines
decode_line_2 (struct symbol
*[],
109 static struct symtab
*symtab_from_filename (char **argptr
,
110 char *p
, int is_quote_enclosed
,
114 symtabs_and_lines
decode_all_digits (char **argptr
,
115 struct symtab
*default_symtab
,
118 struct symtab
*file_symtab
,
121 static struct symtabs_and_lines
decode_dollar (char *copy
,
123 struct symtab
*default_symtab
,
125 struct symtab
*file_symtab
);
127 static struct symtabs_and_lines
decode_variable (char *copy
,
130 struct symtab
*file_symtab
,
134 symtabs_and_lines
symbol_found (int funfirstline
,
138 struct symtab
*file_symtab
,
139 struct symtab
*sym_symtab
);
142 symtabs_and_lines
minsym_found (int funfirstline
,
143 struct minimal_symbol
*msymbol
);
145 /* Helper functions. */
147 /* Issue a helpful hint on using the command completion feature on
148 single quoted demangled C++ symbols as part of the completion
152 cplusplus_error (const char *name
, const char *fmt
, ...)
154 struct ui_file
*tmp_stream
;
155 tmp_stream
= mem_fileopen ();
156 make_cleanup_ui_file_delete (tmp_stream
);
160 va_start (args
, fmt
);
161 vfprintf_unfiltered (tmp_stream
, fmt
, args
);
165 while (*name
== '\'')
167 fprintf_unfiltered (tmp_stream
,
168 ("Hint: try '%s<TAB> or '%s<ESC-?>\n"
169 "(Note leading single quote.)"),
171 error_stream (tmp_stream
);
174 /* Return the number of methods described for TYPE, including the
175 methods from types it derives from. This can't be done in the symbol
176 reader because the type of the baseclass might still be stubbed
177 when the definition of the derived class is parsed. */
180 total_number_of_methods (struct type
*type
)
185 CHECK_TYPEDEF (type
);
186 if (TYPE_CPLUS_SPECIFIC (type
) == NULL
)
188 count
= TYPE_NFN_FIELDS_TOTAL (type
);
190 for (n
= 0; n
< TYPE_N_BASECLASSES (type
); n
++)
191 count
+= total_number_of_methods (TYPE_BASECLASS (type
, n
));
196 /* Recursive helper function for decode_line_1.
197 Look for methods named NAME in type T.
198 Return number of matches.
199 Put matches in SYM_ARR, which should have been allocated with
200 a size of total_number_of_methods (T) * sizeof (struct symbol *).
201 Note that this function is g++ specific. */
204 find_methods (struct type
*t
, char *name
, enum language language
,
205 struct symbol
**sym_arr
)
209 char *class_name
= type_name_no_tag (t
);
211 /* Ignore this class if it doesn't have a name. This is ugly, but
212 unless we figure out how to get the physname without the name of
213 the class, then the loop can't do any good. */
215 && (lookup_symbol_in_language (class_name
, (struct block
*) NULL
,
216 STRUCT_DOMAIN
, language
, (int *) NULL
,
217 (struct symtab
**) NULL
)))
220 int name_len
= strlen (name
);
224 /* Loop over each method name. At this level, all overloads of a name
225 are counted as a single name. There is an inner loop which loops over
228 for (method_counter
= TYPE_NFN_FIELDS (t
) - 1;
232 char *method_name
= TYPE_FN_FIELDLIST_NAME (t
, method_counter
);
235 if (strncmp (method_name
, "__", 2) == 0 ||
236 strncmp (method_name
, "op", 2) == 0 ||
237 strncmp (method_name
, "type", 4) == 0)
239 if (cplus_demangle_opname (method_name
, dem_opname
, DMGL_ANSI
))
240 method_name
= dem_opname
;
241 else if (cplus_demangle_opname (method_name
, dem_opname
, 0))
242 method_name
= dem_opname
;
245 if (strcmp_iw (name
, method_name
) == 0)
246 /* Find all the overloaded methods with that name. */
247 i1
+= add_matching_methods (method_counter
, t
, language
,
249 else if (strncmp (class_name
, name
, name_len
) == 0
250 && (class_name
[name_len
] == '\0'
251 || class_name
[name_len
] == '<'))
252 i1
+= add_constructors (method_counter
, t
, language
,
257 /* Only search baseclasses if there is no match yet, since names in
258 derived classes override those in baseclasses.
260 FIXME: The above is not true; it is only true of member functions
261 if they have the same number of arguments (??? - section 13.1 of the
262 ARM says the function members are not in the same scope but doesn't
263 really spell out the rules in a way I understand. In any case, if
264 the number of arguments differ this is a case in which we can overload
265 rather than hiding without any problem, and gcc 2.4.5 does overload
266 rather than hiding in this case). */
269 for (ibase
= 0; ibase
< TYPE_N_BASECLASSES (t
); ibase
++)
270 i1
+= find_methods (TYPE_BASECLASS (t
, ibase
), name
,
271 language
, sym_arr
+ i1
);
276 /* Add the symbols associated to methods of the class whose type is T
277 and whose name matches the method indexed by METHOD_COUNTER in the
278 array SYM_ARR. Return the number of methods added. */
281 add_matching_methods (int method_counter
, struct type
*t
,
282 enum language language
, struct symbol
**sym_arr
)
287 for (field_counter
= TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
294 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
296 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
300 tmp_name
= gdb_mangle_name (t
,
303 phys_name
= alloca (strlen (tmp_name
) + 1);
304 strcpy (phys_name
, tmp_name
);
308 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
310 /* Destructor is handled by caller, don't add it to
312 if (is_destructor_name (phys_name
) != 0)
315 sym_arr
[i1
] = lookup_symbol_in_language (phys_name
,
319 (struct symtab
**) NULL
);
324 /* This error message gets printed, but the method
325 still seems to be found
326 fputs_filtered("(Cannot find method ", gdb_stdout);
327 fprintf_symbol_filtered (gdb_stdout, phys_name,
329 DMGL_PARAMS | DMGL_ANSI);
330 fputs_filtered(" - possibly inlined.)\n", gdb_stdout);
338 /* Add the symbols associated to constructors of the class whose type
339 is CLASS_TYPE and which are indexed by by METHOD_COUNTER to the
340 array SYM_ARR. Return the number of methods added. */
343 add_constructors (int method_counter
, struct type
*t
,
344 enum language language
, struct symbol
**sym_arr
)
349 /* For GCC 3.x and stabs, constructors and destructors
350 have names like __base_ctor and __complete_dtor.
351 Check the physname for now if we're looking for a
354 = TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
361 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
363 /* GCC 3.x will never produce stabs stub methods, so
364 we don't need to handle this case. */
365 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
367 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
368 if (! is_constructor_name (phys_name
))
371 /* If this method is actually defined, include it in the
373 sym_arr
[i1
] = lookup_symbol_in_language (phys_name
,
377 (struct symtab
**) NULL
);
385 /* Helper function for decode_line_1.
386 Build a canonical line spec in CANONICAL if it is non-NULL and if
387 the SAL has a symtab.
388 If SYMNAME is non-NULL the canonical line spec is `filename:symname'.
389 If SYMNAME is NULL the line number from SAL is used and the canonical
390 line spec is `filename:linenum'. */
393 build_canonical_line_spec (struct symtab_and_line
*sal
, char *symname
,
396 char **canonical_arr
;
397 char *canonical_name
;
399 struct symtab
*s
= sal
->symtab
;
401 if (s
== (struct symtab
*) NULL
402 || s
->filename
== (char *) NULL
403 || canonical
== (char ***) NULL
)
406 canonical_arr
= (char **) xmalloc (sizeof (char *));
407 *canonical
= canonical_arr
;
409 filename
= s
->filename
;
412 canonical_name
= xmalloc (strlen (filename
) + strlen (symname
) + 2);
413 sprintf (canonical_name
, "%s:%s", filename
, symname
);
417 canonical_name
= xmalloc (strlen (filename
) + 30);
418 sprintf (canonical_name
, "%s:%d", filename
, sal
->line
);
420 canonical_arr
[0] = canonical_name
;
425 /* Find an instance of the character C in the string S that is outside
426 of all parenthesis pairs, single-quoted strings, and double-quoted
427 strings. Also, ignore the char within a template name, like a ','
428 within foo<int, int>. */
431 find_toplevel_char (char *s
, char c
)
433 int quoted
= 0; /* zero if we're not in quotes;
434 '"' if we're in a double-quoted string;
435 '\'' if we're in a single-quoted string. */
436 int depth
= 0; /* Number of unclosed parens we've seen. */
439 for (scan
= s
; *scan
; scan
++)
445 else if (*scan
== '\\' && *(scan
+ 1))
448 else if (*scan
== c
&& ! quoted
&& depth
== 0)
450 else if (*scan
== '"' || *scan
== '\'')
452 else if (*scan
== '(' || *scan
== '<')
454 else if ((*scan
== ')' || *scan
== '>') && depth
> 0)
461 /* Determines if the gives string corresponds to an Objective-C method
462 representation, such as -[Foo bar:] or +[Foo bar]. Objective-C symbols
463 are allowed to have spaces and parentheses in them. */
466 is_objc_method_format (const char *s
)
468 if (s
== NULL
|| *s
== '\0')
470 /* Handle arguments with the format FILENAME:SYMBOL. */
471 if ((s
[0] == ':') && (strchr ("+-", s
[1]) != NULL
)
472 && (s
[2] == '[') && strchr(s
, ']'))
474 /* Handle arguments that are just SYMBOL. */
475 else if ((strchr ("+-", s
[0]) != NULL
) && (s
[1] == '[') && strchr(s
, ']'))
480 /* Given a list of NELTS symbols in SYM_ARR, return a list of lines to
481 operate on (ask user if necessary).
482 If CANONICAL is non-NULL return a corresponding array of mangled names
483 as canonical line specs there. */
485 static struct symtabs_and_lines
486 decode_line_2 (struct symbol
*sym_arr
[], int nelts
, int funfirstline
,
489 struct symtabs_and_lines values
, return_values
;
494 struct cleanup
*old_chain
;
495 char **canonical_arr
= (char **) NULL
;
496 const char *select_mode
= multiple_symbols_select_mode ();
498 if (select_mode
== multiple_symbols_cancel
)
500 canceled because the command is ambiguous\n\
501 See set/show multiple-symbol."));
503 values
.sals
= (struct symtab_and_line
*)
504 alloca (nelts
* sizeof (struct symtab_and_line
));
505 return_values
.sals
= (struct symtab_and_line
*)
506 xmalloc (nelts
* sizeof (struct symtab_and_line
));
507 old_chain
= make_cleanup (xfree
, return_values
.sals
);
511 canonical_arr
= (char **) xmalloc (nelts
* sizeof (char *));
512 make_cleanup (xfree
, canonical_arr
);
513 memset (canonical_arr
, 0, nelts
* sizeof (char *));
514 *canonical
= canonical_arr
;
520 init_sal (&return_values
.sals
[i
]); /* Initialize to zeroes. */
521 init_sal (&values
.sals
[i
]);
522 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
523 values
.sals
[i
] = find_function_start_sal (sym_arr
[i
], funfirstline
);
527 /* If select_mode is "all", then do not print the multiple-choice
528 menu and act as if the user had chosen choice "1" (all). */
529 if (select_mode
== multiple_symbols_all
530 || ui_out_is_mi_like_p (interp_ui_out (top_level_interpreter ())))
535 printf_unfiltered (_("[0] cancel\n[1] all\n"));
538 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
540 if (values
.sals
[i
].symtab
)
541 printf_unfiltered ("[%d] %s at %s:%d\n",
543 SYMBOL_PRINT_NAME (sym_arr
[i
]),
544 values
.sals
[i
].symtab
->filename
,
545 values
.sals
[i
].line
);
547 printf_unfiltered (_("[%d] %s at ?FILE:%d [No symtab? Probably broken debug info...]\n"),
549 SYMBOL_PRINT_NAME (sym_arr
[i
]),
550 values
.sals
[i
].line
);
554 printf_unfiltered (_("?HERE\n"));
558 prompt
= getenv ("PS2");
563 args
= command_line_input (prompt
, 0, "overload-choice");
566 if (args
== 0 || *args
== 0)
567 error_no_arg (_("one or more choice numbers"));
575 while (*arg1
>= '0' && *arg1
<= '9')
577 if (*arg1
&& *arg1
!= ' ' && *arg1
!= '\t')
578 error (_("Arguments must be choice numbers."));
583 error (_("canceled"));
588 for (i
= 0; i
< nelts
; i
++)
590 if (canonical_arr
[i
] == NULL
)
592 symname
= DEPRECATED_SYMBOL_NAME (sym_arr
[i
]);
593 canonical_arr
[i
] = savestring (symname
, strlen (symname
));
597 memcpy (return_values
.sals
, values
.sals
,
598 (nelts
* sizeof (struct symtab_and_line
)));
599 return_values
.nelts
= nelts
;
600 discard_cleanups (old_chain
);
601 return return_values
;
604 if (num
>= nelts
+ 2)
606 printf_unfiltered (_("No choice number %d.\n"), num
);
611 if (values
.sals
[num
].pc
)
615 symname
= DEPRECATED_SYMBOL_NAME (sym_arr
[num
]);
616 make_cleanup (xfree
, symname
);
617 canonical_arr
[i
] = savestring (symname
, strlen (symname
));
619 return_values
.sals
[i
++] = values
.sals
[num
];
620 values
.sals
[num
].pc
= 0;
624 printf_unfiltered (_("duplicate request for %d ignored.\n"), num
);
629 while (*args
== ' ' || *args
== '\t')
632 return_values
.nelts
= i
;
633 discard_cleanups (old_chain
);
634 return return_values
;
637 /* The parser of linespec itself. */
639 /* Parse a string that specifies a line number.
640 Pass the address of a char * variable; that variable will be
641 advanced over the characters actually parsed.
645 LINENUM -- that line number in current file. PC returned is 0.
646 FILE:LINENUM -- that line in that file. PC returned is 0.
647 FUNCTION -- line number of openbrace of that function.
648 PC returned is the start of the function.
649 VARIABLE -- line number of definition of that variable.
651 FILE:FUNCTION -- likewise, but prefer functions in that file.
652 *EXPR -- line in which address EXPR appears.
654 This may all be followed by an "if EXPR", which we ignore.
656 FUNCTION may be an undebuggable function found in minimal symbol table.
658 If the argument FUNFIRSTLINE is nonzero, we want the first line
659 of real code inside a function when a function is specified, and it is
660 not OK to specify a variable or type to get its line number.
662 DEFAULT_SYMTAB specifies the file to use if none is specified.
663 It defaults to current_source_symtab.
664 DEFAULT_LINE specifies the line number to use for relative
665 line numbers (that start with signs). Defaults to current_source_line.
666 If CANONICAL is non-NULL, store an array of strings containing the canonical
667 line specs there if necessary. Currently overloaded member functions and
668 line numbers or static functions without a filename yield a canonical
669 line spec. The array and the line spec strings are allocated on the heap,
670 it is the callers responsibility to free them.
672 Note that it is possible to return zero for the symtab
673 if no file is validly specified. Callers must check that.
674 Also, the line number returned may be invalid.
676 If NOT_FOUND_PTR is not null, store a boolean true/false value at the location, based
677 on whether or not failure occurs due to an unknown function or file. In the case
678 where failure does occur due to an unknown function or file, do not issue an error
681 /* We allow single quotes in various places. This is a hideous
682 kludge, which exists because the completer can't yet deal with the
683 lack of single quotes. FIXME: write a linespec_completer which we
684 can use as appropriate instead of make_symbol_completion_list. */
686 struct symtabs_and_lines
687 decode_line_1 (char **argptr
, int funfirstline
, struct symtab
*default_symtab
,
688 int default_line
, char ***canonical
, int *not_found_ptr
)
692 /* If a file name is specified, this is its symtab. */
693 struct symtab
*file_symtab
= NULL
;
696 /* This is NULL if there are no parens in *ARGPTR, or a pointer to
697 the closing parenthesis if there are parens. */
699 /* This says whether or not something in *ARGPTR is quoted with
700 completer_quotes (i.e. with single quotes). */
702 /* Is part of *ARGPTR is enclosed in double quotes? */
703 int is_quote_enclosed
;
704 int is_objc_method
= 0;
705 char *saved_arg
= *argptr
;
710 /* Defaults have defaults. */
712 initialize_defaults (&default_symtab
, &default_line
);
714 /* See if arg is *PC. */
717 return decode_indirect (argptr
);
719 /* Set various flags. 'paren_pointer' is important for overload
720 checking, where we allow things like:
721 (gdb) break c::f(int)
724 set_flags (*argptr
, &is_quoted
, &paren_pointer
);
726 /* Check to see if it's a multipart linespec (with colons or
729 /* Locate the end of the first half of the linespec.
730 After the call, for instance, if the argptr string is "foo.c:123"
731 p will point at "123". If there is only one part, like "foo", p
732 will point to "". If this is a C++ name, like "A::B::foo", p will
733 point to "::B::foo". Argptr is not changed by this call. */
735 p
= locate_first_half (argptr
, &is_quote_enclosed
);
737 /* Check if this is an Objective-C method (anything that starts with
738 a '+' or '-' and a '['). */
739 if (is_objc_method_format (p
))
742 paren_pointer
= NULL
; /* Just a category name. Ignore it. */
745 /* Check if the symbol could be an Objective-C selector. */
748 struct symtabs_and_lines values
;
749 values
= decode_objc (argptr
, funfirstline
, NULL
,
750 canonical
, saved_arg
);
751 if (values
.sals
!= NULL
)
755 /* Does it look like there actually were two parts? */
757 if ((p
[0] == ':' || p
[0] == '.') && paren_pointer
== NULL
)
760 *argptr
= *argptr
+ 1;
762 /* Is it a C++ or Java compound data structure?
763 The check on p[1] == ':' is capturing the case of "::",
764 since p[0]==':' was checked above.
765 Note that the call to decode_compound does everything
766 for us, including the lookup on the symbol table, so we
769 if (p
[0] == '.' || p
[1] == ':')
770 return decode_compound (argptr
, funfirstline
, canonical
,
773 /* No, the first part is a filename; set s to be that file's
774 symtab. Also, move argptr past the filename. */
776 file_symtab
= symtab_from_filename (argptr
, p
, is_quote_enclosed
,
780 /* No one really seems to know why this was added. It certainly
781 breaks the command line, though, whenever the passed
782 name is of the form ClassName::Method. This bit of code
783 singles out the class name, and if funfirstline is set (for
784 example, you are setting a breakpoint at this function),
785 you get an error. This did not occur with earlier
786 verions, so I am ifdef'ing this out. 3/29/99 */
789 /* Check if what we have till now is a symbol name */
791 /* We may be looking at a template instantiation such
792 as "foo<int>". Check here whether we know about it,
793 instead of falling through to the code below which
794 handles ordinary function names, because that code
795 doesn't like seeing '<' and '>' in a name -- the
796 skip_quoted call doesn't go past them. So see if we
797 can figure it out right now. */
799 copy
= (char *) alloca (p
- *argptr
+ 1);
800 memcpy (copy
, *argptr
, p
- *argptr
);
801 copy
[p
- *argptr
] = '\000';
802 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0, &sym_symtab
);
805 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
806 return symbol_found (funfirstline
, canonical
, copy
, sym
,
809 /* Otherwise fall out from here and go to file/line spec
814 /* S is specified file's symtab, or 0 if no file specified.
815 arg no longer contains the file name. */
817 /* Check whether arg is all digits (and sign). */
820 if (*q
== '-' || *q
== '+')
822 while (*q
>= '0' && *q
<= '9')
825 if (q
!= *argptr
&& (*q
== 0 || *q
== ' ' || *q
== '\t' || *q
== ','))
826 /* We found a token consisting of all digits -- at least one digit. */
827 return decode_all_digits (argptr
, default_symtab
, default_line
,
828 canonical
, file_symtab
, q
);
830 /* Arg token is not digits => try it as a variable name
831 Find the next token (everything up to end or next whitespace). */
833 if (**argptr
== '$') /* May be a convenience variable. */
834 /* One or two $ chars possible. */
835 p
= skip_quoted (*argptr
+ (((*argptr
)[1] == '$') ? 2 : 1));
838 p
= skip_quoted (*argptr
);
840 error (_("Unmatched single quote."));
842 else if (is_objc_method
)
844 /* allow word separators in method names for Obj-C */
845 p
= skip_quoted_chars (*argptr
, NULL
, "");
847 else if (paren_pointer
!= NULL
)
849 p
= paren_pointer
+ 1;
853 p
= skip_quoted (*argptr
);
856 copy
= (char *) alloca (p
- *argptr
+ 1);
857 memcpy (copy
, *argptr
, p
- *argptr
);
858 copy
[p
- *argptr
] = '\0';
861 && copy
[0] == copy
[p
- *argptr
- 1]
862 && strchr (get_gdb_completer_quote_characters (), copy
[0]) != NULL
)
864 copy
[p
- *argptr
- 1] = '\0';
867 while (*p
== ' ' || *p
== '\t')
871 /* If it starts with $: may be a legitimate variable or routine name
872 (e.g. HP-UX millicode routines such as $$dyncall), or it may
873 be history value, or it may be a convenience variable. */
876 return decode_dollar (copy
, funfirstline
, default_symtab
,
877 canonical
, file_symtab
);
879 /* Look up that token as a variable.
880 If file specified, use that file's per-file block to start with. */
882 return decode_variable (copy
, funfirstline
, canonical
,
883 file_symtab
, not_found_ptr
);
888 /* Now, more helper functions for decode_line_1. Some conventions
889 that these functions follow:
891 Decode_line_1 typically passes along some of its arguments or local
892 variables to the subfunctions. It passes the variables by
893 reference if they are modified by the subfunction, and by value
896 Some of the functions have side effects that don't arise from
897 variables that are passed by reference. In particular, if a
898 function is passed ARGPTR as an argument, it modifies what ARGPTR
899 points to; typically, it advances *ARGPTR past whatever substring
900 it has just looked at. (If it doesn't modify *ARGPTR, then the
901 function gets passed *ARGPTR instead, which is then called ARG: see
902 set_flags, for example.) Also, functions that return a struct
903 symtabs_and_lines may modify CANONICAL, as in the description of
906 If a function returns a struct symtabs_and_lines, then that struct
907 will immediately make its way up the call chain to be returned by
908 decode_line_1. In particular, all of the functions decode_XXX
909 calculate the appropriate struct symtabs_and_lines, under the
910 assumption that their argument is of the form XXX. */
912 /* First, some functions to initialize stuff at the beggining of the
916 initialize_defaults (struct symtab
**default_symtab
, int *default_line
)
918 if (*default_symtab
== 0)
920 /* Use whatever we have for the default source line. We don't use
921 get_current_or_default_symtab_and_line as it can recurse and call
923 struct symtab_and_line cursal
=
924 get_current_source_symtab_and_line ();
926 *default_symtab
= cursal
.symtab
;
927 *default_line
= cursal
.line
;
932 set_flags (char *arg
, int *is_quoted
, char **paren_pointer
)
937 /* 'has_if' is for the syntax:
938 (gdb) break foo if (a==b)
940 if ((ii
= strstr (arg
, " if ")) != NULL
||
941 (ii
= strstr (arg
, "\tif ")) != NULL
||
942 (ii
= strstr (arg
, " if\t")) != NULL
||
943 (ii
= strstr (arg
, "\tif\t")) != NULL
||
944 (ii
= strstr (arg
, " if(")) != NULL
||
945 (ii
= strstr (arg
, "\tif( ")) != NULL
)
947 /* Temporarily zap out "if (condition)" to not confuse the
948 parenthesis-checking code below. This is undone below. Do not
956 && strchr (get_gdb_completer_quote_characters (),
959 *paren_pointer
= strchr (arg
, '(');
960 if (*paren_pointer
!= NULL
)
961 *paren_pointer
= strrchr (*paren_pointer
, ')');
963 /* Now that we're safely past the paren_pointer check, put back " if
964 (condition)" so outer layers can see it. */
971 /* Decode arg of the form *PC. */
973 static struct symtabs_and_lines
974 decode_indirect (char **argptr
)
976 struct symtabs_and_lines values
;
980 pc
= parse_and_eval_address_1 (argptr
);
982 values
.sals
= (struct symtab_and_line
*)
983 xmalloc (sizeof (struct symtab_and_line
));
986 values
.sals
[0] = find_pc_line (pc
, 0);
987 values
.sals
[0].pc
= pc
;
988 values
.sals
[0].section
= find_pc_overlay (pc
);
989 values
.sals
[0].explicit_pc
= 1;
996 /* Locate the first half of the linespec, ending in a colon, period,
997 or whitespace. (More or less.) Also, check to see if *ARGPTR is
998 enclosed in double quotes; if so, set is_quote_enclosed, advance
999 ARGPTR past that and zero out the trailing double quote.
1000 If ARGPTR is just a simple name like "main", p will point to ""
1004 locate_first_half (char **argptr
, int *is_quote_enclosed
)
1010 /* Maybe we were called with a line range FILENAME:LINENUM,FILENAME:LINENUM
1011 and we must isolate the first half. Outer layers will call again later
1012 for the second half.
1014 Don't count commas that appear in argument lists of overloaded
1015 functions, or in quoted strings. It's stupid to go to this much
1016 trouble when the rest of the function is such an obvious roach hotel. */
1017 ii
= find_toplevel_char (*argptr
, ',');
1018 has_comma
= (ii
!= 0);
1020 /* Temporarily zap out second half to not confuse the code below.
1021 This is undone below. Do not change ii!! */
1027 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION. May also be
1028 CLASS::MEMBER, or NAMESPACE::NAME. Look for ':', but ignore
1034 *is_quote_enclosed
= 1;
1039 *is_quote_enclosed
= 0;
1044 char *temp_end
= find_template_name_end (p
);
1046 error (_("malformed template specification in command"));
1049 /* Check for a colon and a plus or minus and a [ (which
1050 indicates an Objective-C method) */
1051 if (is_objc_method_format (p
))
1055 /* Check for the end of the first half of the linespec. End of
1056 line, a tab, a double colon or the last single colon, or a
1057 space. But if enclosed in double quotes we do not break on
1062 && ((p
[1] == ':') || (strchr (p
+ 1, ':') == NULL
)))
1063 || ((p
[0] == ' ') && !*is_quote_enclosed
))
1065 if (p
[0] == '.' && strchr (p
, ':') == NULL
)
1067 /* Java qualified method. Find the *last* '.', since the
1068 others are package qualifiers. */
1069 for (p1
= p
; *p1
; p1
++)
1077 while (p
[0] == ' ' || p
[0] == '\t')
1080 /* If the closing double quote was left at the end, remove it. */
1081 if (*is_quote_enclosed
)
1083 char *closing_quote
= strchr (p
- 1, '"');
1084 if (closing_quote
&& closing_quote
[1] == '\0')
1085 *closing_quote
= '\0';
1088 /* Now that we've safely parsed the first half, put back ',' so
1089 outer layers can see it. */
1098 /* Here's where we recognise an Objective-C Selector. An Objective C
1099 selector may be implemented by more than one class, therefore it
1100 may represent more than one method/function. This gives us a
1101 situation somewhat analogous to C++ overloading. If there's more
1102 than one method that could represent the selector, then use some of
1103 the existing C++ code to let the user choose one. */
1105 struct symtabs_and_lines
1106 decode_objc (char **argptr
, int funfirstline
, struct symtab
*file_symtab
,
1107 char ***canonical
, char *saved_arg
)
1109 struct symtabs_and_lines values
;
1110 struct symbol
**sym_arr
= NULL
;
1111 struct symbol
*sym
= NULL
;
1113 struct block
*block
= NULL
;
1120 if (file_symtab
!= NULL
)
1121 block
= BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
), STATIC_BLOCK
);
1123 block
= get_selected_block (0);
1125 copy
= find_imps (file_symtab
, block
, *argptr
, NULL
, &i1
, &i2
);
1129 sym_arr
= (struct symbol
**) alloca ((i1
+ 1) * sizeof (struct symbol
*));
1132 copy
= find_imps (file_symtab
, block
, *argptr
, sym_arr
, &i1
, &i2
);
1136 /* i1 now represents the TOTAL number of matches found.
1137 i2 represents how many HIGH-LEVEL (struct symbol) matches,
1138 which will come first in the sym_arr array. Any low-level
1139 (minimal_symbol) matches will follow those. */
1145 /* Already a struct symbol. */
1150 sym
= find_pc_function (SYMBOL_VALUE_ADDRESS (sym_arr
[0]));
1151 if ((sym
!= NULL
) && strcmp (SYMBOL_LINKAGE_NAME (sym_arr
[0]), SYMBOL_LINKAGE_NAME (sym
)) != 0)
1153 warning (_("debugging symbol \"%s\" does not match selector; ignoring"), SYMBOL_LINKAGE_NAME (sym
));
1158 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof (struct symtab_and_line
));
1161 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1163 /* Canonicalize this, so it remains resolved for dylib loads. */
1164 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1165 build_canonical_line_spec (values
.sals
, SYMBOL_NATURAL_NAME (sym
), canonical
);
1169 /* The only match was a non-debuggable symbol. */
1170 values
.sals
[0].symtab
= NULL
;
1171 values
.sals
[0].line
= 0;
1172 values
.sals
[0].end
= 0;
1173 values
.sals
[0].pc
= SYMBOL_VALUE_ADDRESS (sym_arr
[0]);
1180 /* More than one match. The user must choose one or more. */
1181 return decode_line_2 (sym_arr
, i2
, funfirstline
, canonical
);
1187 /* This handles C++ and Java compound data structures. P should point
1188 at the first component separator, i.e. double-colon or period. As
1189 an example, on entrance to this function we could have ARGPTR
1190 pointing to "AAA::inA::fun" and P pointing to "::inA::fun". */
1192 static struct symtabs_and_lines
1193 decode_compound (char **argptr
, int funfirstline
, char ***canonical
,
1194 char *saved_arg
, char *p
)
1196 struct symtabs_and_lines values
;
1198 char *saved_arg2
= *argptr
;
1201 /* The symtab that SYM was found in. */
1202 struct symtab
*sym_symtab
;
1204 struct symbol
*sym_class
;
1205 struct symbol
**sym_arr
;
1208 /* First check for "global" namespace specification, of the form
1209 "::foo". If found, skip over the colons and jump to normal
1210 symbol processing. I.e. the whole line specification starts with
1211 "::" (note the condition that *argptr == p). */
1213 && ((*argptr
== p
) || (p
[-1] == ' ') || (p
[-1] == '\t')))
1216 /* Given our example "AAA::inA::fun", we have two cases to consider:
1218 1) AAA::inA is the name of a class. In that case, presumably it
1219 has a method called "fun"; we then look up that method using
1222 2) AAA::inA isn't the name of a class. In that case, either the
1223 user made a typo or AAA::inA is the name of a namespace.
1224 Either way, we just look up AAA::inA::fun with lookup_symbol.
1226 Thus, our first task is to find everything before the last set of
1227 double-colons and figure out if it's the name of a class. So we
1228 first loop through all of the double-colons. */
1230 p2
= p
; /* Save for restart. */
1232 /* This is very messy. Following the example above we have now the
1235 argptr -> "AAA::inA::fun
1236 saved_arg -> "AAA::inA::fun
1237 saved_arg2 -> "AAA::inA::fun
1238 p2 -> "::inA::fun". */
1240 /* In the loop below, with these strings, we'll make 2 passes, each
1241 is marked in comments.*/
1245 /* Move pointer up to next possible class/namespace token. */
1247 p
= p2
+ 1; /* Restart with old value +1. */
1249 /* PASS1: at this point p2->"::inA::fun", so p->":inA::fun",
1250 i.e. if there is a double-colon, p will now point to the
1252 /* PASS2: p2->"::fun", p->":fun" */
1254 /* Move pointer ahead to next double-colon. */
1255 while (*p
&& (p
[0] != ' ') && (p
[0] != '\t') && (p
[0] != '\''))
1259 temp_end
= find_template_name_end (p
);
1261 error (_("malformed template specification in command"));
1264 /* Note that, since, at the start of this loop, p would be
1265 pointing to the second colon in a double-colon, we only
1266 satisfy the condition below if there is another
1267 double-colon to the right (after). I.e. there is another
1268 component that can be a class or a namespace. I.e, if at
1269 the beginning of this loop (PASS1), we had
1270 p->":inA::fun", we'll trigger this when p has been
1271 advanced to point to "::fun". */
1272 /* PASS2: we will not trigger this. */
1273 else if ((p
[0] == ':') && (p
[1] == ':'))
1274 break; /* Found double-colon. */
1276 /* PASS2: We'll keep getting here, until p->"", at which point
1277 we exit this loop. */
1282 break; /* Out of the while (1). This would happen
1283 for instance if we have looked up
1284 unsuccessfully all the components of the
1285 string, and p->""(PASS2) */
1287 /* We get here if p points to ' ', '\t', '\'', "::" or ""(i.e
1289 /* Save restart for next time around. */
1291 /* Restore argptr as it was on entry to this function. */
1292 *argptr
= saved_arg2
;
1293 /* PASS1: at this point p->"::fun" argptr->"AAA::inA::fun",
1296 /* All ready for next pass through the loop. */
1300 /* Start of lookup in the symbol tables. */
1302 /* Lookup in the symbol table the substring between argptr and
1303 p. Note, this call changes the value of argptr. */
1304 /* Before the call, argptr->"AAA::inA::fun",
1305 p->"", p2->"::fun". After the call: argptr->"fun", p, p2
1307 sym_class
= lookup_prefix_sym (argptr
, p2
);
1309 /* If sym_class has been found, and if "AAA::inA" is a class, then
1310 we're in case 1 above. So we look up "fun" as a method of that
1313 (t
= check_typedef (SYMBOL_TYPE (sym_class
)),
1314 (TYPE_CODE (t
) == TYPE_CODE_STRUCT
1315 || TYPE_CODE (t
) == TYPE_CODE_UNION
)))
1317 /* Arg token is not digits => try it as a function name.
1318 Find the next token (everything up to end or next
1321 && strchr (get_gdb_completer_quote_characters (),
1324 p
= skip_quoted (*argptr
);
1325 *argptr
= *argptr
+ 1;
1329 /* At this point argptr->"fun". */
1331 while (*p
&& *p
!= ' ' && *p
!= '\t' && *p
!= ',' && *p
!= ':')
1333 /* At this point p->"". String ended. */
1336 /* Allocate our own copy of the substring between argptr and
1338 copy
= (char *) alloca (p
- *argptr
+ 1);
1339 memcpy (copy
, *argptr
, p
- *argptr
);
1340 copy
[p
- *argptr
] = '\0';
1342 && copy
[p
- *argptr
- 1]
1343 && strchr (get_gdb_completer_quote_characters (),
1344 copy
[p
- *argptr
- 1]) != NULL
)
1345 copy
[p
- *argptr
- 1] = '\0';
1347 /* At this point copy->"fun", p->"" */
1349 /* No line number may be specified. */
1350 while (*p
== ' ' || *p
== '\t')
1353 /* At this point arptr->"". */
1355 /* Look for copy as a method of sym_class. */
1356 /* At this point copy->"fun", sym_class is "AAA:inA",
1357 saved_arg->"AAA::inA::fun". This concludes the scanning of
1358 the string for possible components matches. If we find it
1359 here, we return. If not, and we are at the and of the string,
1360 we'll lookup the whole string in the symbol tables. */
1362 return find_method (funfirstline
, canonical
, saved_arg
,
1363 copy
, t
, sym_class
);
1365 } /* End if symbol found */
1368 /* We couldn't find a class, so we're in case 2 above. We check the
1369 entire name as a symbol instead. */
1371 copy
= (char *) alloca (p
- saved_arg2
+ 1);
1372 memcpy (copy
, saved_arg2
, p
- saved_arg2
);
1373 /* Note: if is_quoted should be true, we snuff out quote here
1375 copy
[p
- saved_arg2
] = '\000';
1376 /* Set argptr to skip over the name. */
1377 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
1379 /* Look up entire name */
1380 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0, &sym_symtab
);
1382 return symbol_found (funfirstline
, canonical
, copy
, sym
,
1385 /* Couldn't find any interpretation as classes/namespaces, so give
1386 up. The quotes are important if copy is empty. */
1387 cplusplus_error (saved_arg
,
1388 "Can't find member of namespace, class, struct, or union named \"%s\"\n",
1392 /* Next come some helper functions for decode_compound. */
1394 /* Return the symbol corresponding to the substring of *ARGPTR ending
1395 at P, allowing whitespace. Also, advance *ARGPTR past the symbol
1396 name in question, the compound object separator ("::" or "."), and
1397 whitespace. Note that *ARGPTR is changed whether or not the
1398 lookup_symbol call finds anything (i.e we return NULL). As an
1399 example, say ARGPTR is "AAA::inA::fun" and P is "::inA::fun". */
1401 static struct symbol
*
1402 lookup_prefix_sym (char **argptr
, char *p
)
1407 /* Extract the class name. */
1409 while (p
!= *argptr
&& p
[-1] == ' ')
1411 copy
= (char *) alloca (p
- *argptr
+ 1);
1412 memcpy (copy
, *argptr
, p
- *argptr
);
1413 copy
[p
- *argptr
] = 0;
1415 /* Discard the class name from the argptr. */
1416 p
= p1
+ (p1
[0] == ':' ? 2 : 1);
1417 while (*p
== ' ' || *p
== '\t')
1421 /* At this point p1->"::inA::fun", p->"inA::fun" copy->"AAA",
1422 argptr->"inA::fun" */
1424 return lookup_symbol (copy
, 0, STRUCT_DOMAIN
, 0,
1425 (struct symtab
**) NULL
);
1428 /* This finds the method COPY in the class whose type is T and whose
1429 symbol is SYM_CLASS. */
1431 static struct symtabs_and_lines
1432 find_method (int funfirstline
, char ***canonical
, char *saved_arg
,
1433 char *copy
, struct type
*t
, struct symbol
*sym_class
)
1435 struct symtabs_and_lines values
;
1436 struct symbol
*sym
= NULL
;
1437 int i1
; /* Counter for the symbol array. */
1438 struct symbol
**sym_arr
= alloca (total_number_of_methods (t
)
1439 * sizeof (struct symbol
*));
1441 /* Find all methods with a matching name, and put them in
1444 i1
= collect_methods (copy
, t
, sym_class
, sym_arr
);
1448 /* There is exactly one field with that name. */
1451 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1453 values
.sals
= (struct symtab_and_line
*)
1454 xmalloc (sizeof (struct symtab_and_line
));
1456 values
.sals
[0] = find_function_start_sal (sym
,
1468 /* There is more than one field with that name
1469 (overloaded). Ask the user which one to use. */
1470 return decode_line_2 (sym_arr
, i1
, funfirstline
, canonical
);
1476 if (is_operator_name (copy
))
1478 tmp
= (char *) alloca (strlen (copy
+ 3) + 9);
1479 strcpy (tmp
, "operator ");
1480 strcat (tmp
, copy
+ 3);
1485 cplusplus_error (saved_arg
,
1486 "the class `%s' does not have destructor defined\n",
1487 SYMBOL_PRINT_NAME (sym_class
));
1489 cplusplus_error (saved_arg
,
1490 "the class %s does not have any method named %s\n",
1491 SYMBOL_PRINT_NAME (sym_class
), tmp
);
1495 /* Find all methods named COPY in the class whose type is T, and put
1496 them in SYM_ARR. Return the number of methods found. */
1499 collect_methods (char *copy
, struct type
*t
,
1500 struct symbol
*sym_class
, struct symbol
**sym_arr
)
1502 int i1
= 0; /* Counter for the symbol array. */
1504 if (destructor_name_p (copy
, t
))
1506 /* Destructors are a special case. */
1507 int m_index
, f_index
;
1509 if (get_destructor_fn_field (t
, &m_index
, &f_index
))
1511 struct fn_field
*f
= TYPE_FN_FIELDLIST1 (t
, m_index
);
1514 lookup_symbol (TYPE_FN_FIELD_PHYSNAME (f
, f_index
),
1515 NULL
, VAR_DOMAIN
, (int *) NULL
,
1516 (struct symtab
**) NULL
);
1522 i1
= find_methods (t
, copy
, SYMBOL_LANGUAGE (sym_class
), sym_arr
);
1529 /* Return the symtab associated to the filename given by the substring
1530 of *ARGPTR ending at P, and advance ARGPTR past that filename. If
1531 NOT_FOUND_PTR is not null and the source file is not found, store
1532 boolean true at the location pointed to and do not issue an
1535 static struct symtab
*
1536 symtab_from_filename (char **argptr
, char *p
, int is_quote_enclosed
,
1541 struct symtab
*file_symtab
;
1544 while (p
!= *argptr
&& p
[-1] == ' ')
1546 if ((*p
== '"') && is_quote_enclosed
)
1548 copy
= (char *) alloca (p
- *argptr
+ 1);
1549 memcpy (copy
, *argptr
, p
- *argptr
);
1550 /* It may have the ending quote right after the file name. */
1551 if (is_quote_enclosed
&& copy
[p
- *argptr
- 1] == '"')
1552 copy
[p
- *argptr
- 1] = 0;
1554 copy
[p
- *argptr
] = 0;
1556 /* Find that file's data. */
1557 file_symtab
= lookup_symtab (copy
);
1558 if (file_symtab
== 0)
1560 if (!have_full_symbols () && !have_partial_symbols ())
1561 error (_("No symbol table is loaded. Use the \"file\" command."));
1564 throw_error (NOT_FOUND_ERROR
, _("No source file named %s."), copy
);
1567 /* Discard the file name from the arg. */
1569 while (*p
== ' ' || *p
== '\t')
1578 /* This decodes a line where the argument is all digits (possibly
1579 preceded by a sign). Q should point to the end of those digits;
1580 the other arguments are as usual. */
1582 static struct symtabs_and_lines
1583 decode_all_digits (char **argptr
, struct symtab
*default_symtab
,
1584 int default_line
, char ***canonical
,
1585 struct symtab
*file_symtab
, char *q
)
1588 struct symtabs_and_lines values
;
1589 struct symtab_and_line val
;
1597 /* We might need a canonical line spec if no file was specified. */
1598 int need_canonical
= (file_symtab
== NULL
) ? 1 : 0;
1602 /* This is where we need to make sure that we have good defaults.
1603 We must guarantee that this section of code is never executed
1604 when we are called with just a function name, since
1605 set_default_source_symtab_and_line uses
1606 select_source_symtab that calls us with such an argument. */
1608 if (file_symtab
== 0 && default_symtab
== 0)
1610 /* Make sure we have at least a default source file. */
1611 set_default_source_symtab_and_line ();
1612 initialize_defaults (&default_symtab
, &default_line
);
1615 if (**argptr
== '+')
1616 sign
= plus
, (*argptr
)++;
1617 else if (**argptr
== '-')
1618 sign
= minus
, (*argptr
)++;
1619 val
.line
= atoi (*argptr
);
1625 if (file_symtab
== 0)
1626 val
.line
= default_line
+ val
.line
;
1631 if (file_symtab
== 0)
1632 val
.line
= default_line
- val
.line
;
1637 break; /* No need to adjust val.line. */
1640 while (*q
== ' ' || *q
== '\t')
1643 if (file_symtab
== 0)
1644 file_symtab
= default_symtab
;
1646 /* It is possible that this source file has more than one symtab,
1647 and that the new line number specification has moved us from the
1648 default (in file_symtab) to a new one. */
1649 val
.symtab
= find_line_symtab (file_symtab
, val
.line
, NULL
, NULL
);
1650 if (val
.symtab
== 0)
1651 val
.symtab
= file_symtab
;
1654 values
.sals
= (struct symtab_and_line
*)
1655 xmalloc (sizeof (struct symtab_and_line
));
1656 values
.sals
[0] = val
;
1659 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1660 values
.sals
[0].explicit_line
= 1;
1666 /* Decode a linespec starting with a dollar sign. */
1668 static struct symtabs_and_lines
1669 decode_dollar (char *copy
, int funfirstline
, struct symtab
*default_symtab
,
1670 char ***canonical
, struct symtab
*file_symtab
)
1674 int need_canonical
= 0;
1675 struct symtabs_and_lines values
;
1676 struct symtab_and_line val
;
1679 /* The symtab that SYM was found in. */
1680 struct symtab
*sym_symtab
;
1681 struct minimal_symbol
*msymbol
;
1683 p
= (copy
[1] == '$') ? copy
+ 2 : copy
+ 1;
1684 while (*p
>= '0' && *p
<= '9')
1686 if (!*p
) /* Reached end of token without hitting non-digit. */
1688 /* We have a value history reference. */
1689 sscanf ((copy
[1] == '$') ? copy
+ 2 : copy
+ 1, "%d", &index
);
1690 valx
= access_value_history ((copy
[1] == '$') ? -index
: index
);
1691 if (TYPE_CODE (value_type (valx
)) != TYPE_CODE_INT
)
1692 error (_("History values used in line specs must have integer values."));
1696 /* Not all digits -- may be user variable/function or a
1697 convenience variable. */
1699 /* Look up entire name as a symbol first. */
1700 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0, &sym_symtab
);
1701 file_symtab
= (struct symtab
*) NULL
;
1703 /* Symbol was found --> jump to normal symbol processing. */
1705 return symbol_found (funfirstline
, canonical
, copy
, sym
,
1708 /* If symbol was not found, look in minimal symbol tables. */
1709 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1710 /* Min symbol was found --> jump to minsym processing. */
1712 return minsym_found (funfirstline
, msymbol
);
1714 /* Not a user variable or function -- must be convenience variable. */
1715 valx
= value_of_internalvar (lookup_internalvar (copy
+ 1));
1716 if (TYPE_CODE (value_type (valx
)) != TYPE_CODE_INT
)
1717 error (_("Convenience variables used in line specs must have integer values."));
1722 /* Either history value or convenience value from above, in valx. */
1723 val
.symtab
= file_symtab
? file_symtab
: default_symtab
;
1724 val
.line
= value_as_long (valx
);
1727 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof val
);
1728 values
.sals
[0] = val
;
1732 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1739 /* Decode a linespec that's a variable. If FILE_SYMTAB is non-NULL,
1740 look in that symtab's static variables first. If NOT_FOUND_PTR is not NULL and
1741 the function cannot be found, store boolean true in the location pointed to
1742 and do not issue an error message. */
1744 static struct symtabs_and_lines
1745 decode_variable (char *copy
, int funfirstline
, char ***canonical
,
1746 struct symtab
*file_symtab
, int *not_found_ptr
)
1749 /* The symtab that SYM was found in. */
1750 struct symtab
*sym_symtab
;
1752 struct minimal_symbol
*msymbol
;
1754 sym
= lookup_symbol (copy
,
1756 ? BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
),
1758 : get_selected_block (0)),
1759 VAR_DOMAIN
, 0, &sym_symtab
);
1762 return symbol_found (funfirstline
, canonical
, copy
, sym
,
1763 file_symtab
, sym_symtab
);
1765 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1767 if (msymbol
!= NULL
)
1768 return minsym_found (funfirstline
, msymbol
);
1770 if (!have_full_symbols () &&
1771 !have_partial_symbols () && !have_minimal_symbols ())
1772 error (_("No symbol table is loaded. Use the \"file\" command."));
1776 throw_error (NOT_FOUND_ERROR
, _("Function \"%s\" not defined."), copy
);
1782 /* Now come some functions that are called from multiple places within
1785 /* We've found a symbol SYM to associate with our linespec; build a
1786 corresponding struct symtabs_and_lines. */
1788 static struct symtabs_and_lines
1789 symbol_found (int funfirstline
, char ***canonical
, char *copy
,
1790 struct symbol
*sym
, struct symtab
*file_symtab
,
1791 struct symtab
*sym_symtab
)
1793 struct symtabs_and_lines values
;
1795 if (SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1797 /* Arg is the name of a function */
1798 values
.sals
= (struct symtab_and_line
*)
1799 xmalloc (sizeof (struct symtab_and_line
));
1800 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1803 /* Don't use the SYMBOL_LINE; if used at all it points to
1804 the line containing the parameters or thereabouts, not
1805 the first line of code. */
1807 /* We might need a canonical line spec if it is a static
1809 if (file_symtab
== 0)
1811 struct blockvector
*bv
= BLOCKVECTOR (sym_symtab
);
1812 struct block
*b
= BLOCKVECTOR_BLOCK (bv
, STATIC_BLOCK
);
1813 if (lookup_block_symbol (b
, copy
, NULL
, VAR_DOMAIN
) != NULL
)
1814 build_canonical_line_spec (values
.sals
, copy
, canonical
);
1821 error (_("\"%s\" is not a function"), copy
);
1822 else if (SYMBOL_LINE (sym
) != 0)
1824 /* We know its line number. */
1825 values
.sals
= (struct symtab_and_line
*)
1826 xmalloc (sizeof (struct symtab_and_line
));
1828 memset (&values
.sals
[0], 0, sizeof (values
.sals
[0]));
1829 values
.sals
[0].symtab
= sym_symtab
;
1830 values
.sals
[0].line
= SYMBOL_LINE (sym
);
1834 /* This can happen if it is compiled with a compiler which doesn't
1835 put out line numbers for variables. */
1836 /* FIXME: Shouldn't we just set .line and .symtab to zero
1837 and return? For example, "info line foo" could print
1839 error (_("Line number not known for symbol \"%s\""), copy
);
1843 /* We've found a minimal symbol MSYMBOL to associate with our
1844 linespec; build a corresponding struct symtabs_and_lines. */
1846 static struct symtabs_and_lines
1847 minsym_found (int funfirstline
, struct minimal_symbol
*msymbol
)
1849 struct symtabs_and_lines values
;
1851 values
.sals
= (struct symtab_and_line
*)
1852 xmalloc (sizeof (struct symtab_and_line
));
1853 values
.sals
[0] = find_pc_sect_line (SYMBOL_VALUE_ADDRESS (msymbol
),
1854 (struct bfd_section
*) 0, 0);
1855 values
.sals
[0].section
= SYMBOL_BFD_SECTION (msymbol
);
1858 struct symtab_and_line sal
;
1861 += gdbarch_deprecated_function_start_offset (current_gdbarch
);
1862 values
.sals
[0].pc
= gdbarch_skip_prologue
1863 (current_gdbarch
, values
.sals
[0].pc
);
1865 sal
= find_pc_sect_line (values
.sals
[0].pc
, values
.sals
[0].section
, 0);
1867 /* Check if SKIP_PROLOGUE left us in mid-line, and the next
1868 line is still part of the same function. If there is no
1869 line information here, sal.pc will be the passed in PC. */
1870 if (sal
.pc
!= values
.sals
[0].pc
1871 && (lookup_minimal_symbol_by_pc_section (values
.sals
[0].pc
,
1872 values
.sals
[0].section
)
1873 == lookup_minimal_symbol_by_pc_section (sal
.end
,
1874 values
.sals
[0].section
)))
1875 /* Recalculate the line number (might not be N+1). */
1876 values
.sals
[0] = find_pc_sect_line (sal
.end
, values
.sals
[0].section
, 0);
This page took 0.067925 seconds and 4 git commands to generate.