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 2009 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"
43 /* We share this one with symtab.c, but it is not exported widely. */
45 extern char *operator_chars (char *, char **);
47 /* Prototypes for local functions */
49 static void initialize_defaults (struct symtab
**default_symtab
,
52 static void set_flags (char *arg
, int *is_quoted
, char **paren_pointer
);
54 static struct symtabs_and_lines
decode_indirect (char **argptr
);
56 static char *locate_first_half (char **argptr
, int *is_quote_enclosed
);
58 static struct symtabs_and_lines
decode_objc (char **argptr
,
60 struct symtab
*file_symtab
,
64 static struct symtabs_and_lines
decode_compound (char **argptr
,
70 static struct symbol
*lookup_prefix_sym (char **argptr
, char *p
);
72 static struct symtabs_and_lines
find_method (int funfirstline
,
77 struct symbol
*sym_class
);
79 static NORETURN
void cplusplus_error (const char *name
,
81 ATTR_NORETURN
ATTR_FORMAT (printf
, 2, 3);
83 static int total_number_of_methods (struct type
*type
);
85 static int find_methods (struct type
*, char *,
86 enum language
, struct symbol
**);
88 static int add_matching_methods (int method_counter
, struct type
*t
,
89 enum language language
,
90 struct symbol
**sym_arr
);
92 static int add_constructors (int method_counter
, struct type
*t
,
93 enum language language
,
94 struct symbol
**sym_arr
);
96 static void build_canonical_line_spec (struct symtab_and_line
*,
99 static char *find_toplevel_char (char *s
, char c
);
101 static int is_objc_method_format (const char *s
);
103 static struct symtabs_and_lines
decode_line_2 (struct symbol
*[],
106 static struct symtab
*symtab_from_filename (char **argptr
,
107 char *p
, int is_quote_enclosed
,
111 symtabs_and_lines
decode_all_digits (char **argptr
,
112 struct symtab
*default_symtab
,
115 struct symtab
*file_symtab
,
118 static struct symtabs_and_lines
decode_dollar (char *copy
,
120 struct symtab
*default_symtab
,
122 struct symtab
*file_symtab
);
124 static struct symtabs_and_lines
decode_variable (char *copy
,
127 struct symtab
*file_symtab
,
131 symtabs_and_lines
symbol_found (int funfirstline
,
135 struct symtab
*file_symtab
);
138 symtabs_and_lines
minsym_found (int funfirstline
,
139 struct minimal_symbol
*msymbol
);
141 /* Helper functions. */
143 /* Issue a helpful hint on using the command completion feature on
144 single quoted demangled C++ symbols as part of the completion
148 cplusplus_error (const char *name
, const char *fmt
, ...)
150 struct ui_file
*tmp_stream
;
151 tmp_stream
= mem_fileopen ();
152 make_cleanup_ui_file_delete (tmp_stream
);
156 va_start (args
, fmt
);
157 vfprintf_unfiltered (tmp_stream
, fmt
, args
);
161 while (*name
== '\'')
163 fprintf_unfiltered (tmp_stream
,
164 ("Hint: try '%s<TAB> or '%s<ESC-?>\n"
165 "(Note leading single quote.)"),
167 error_stream (tmp_stream
);
170 /* Return the number of methods described for TYPE, including the
171 methods from types it derives from. This can't be done in the symbol
172 reader because the type of the baseclass might still be stubbed
173 when the definition of the derived class is parsed. */
176 total_number_of_methods (struct type
*type
)
181 CHECK_TYPEDEF (type
);
182 if (TYPE_CPLUS_SPECIFIC (type
) == NULL
)
184 count
= TYPE_NFN_FIELDS_TOTAL (type
);
186 for (n
= 0; n
< TYPE_N_BASECLASSES (type
); n
++)
187 count
+= total_number_of_methods (TYPE_BASECLASS (type
, n
));
192 /* Recursive helper function for decode_line_1.
193 Look for methods named NAME in type T.
194 Return number of matches.
195 Put matches in SYM_ARR, which should have been allocated with
196 a size of total_number_of_methods (T) * sizeof (struct symbol *).
197 Note that this function is g++ specific. */
200 find_methods (struct type
*t
, char *name
, enum language language
,
201 struct symbol
**sym_arr
)
205 char *class_name
= type_name_no_tag (t
);
207 /* Ignore this class if it doesn't have a name. This is ugly, but
208 unless we figure out how to get the physname without the name of
209 the class, then the loop can't do any good. */
211 && (lookup_symbol_in_language (class_name
, (struct block
*) NULL
,
212 STRUCT_DOMAIN
, language
, (int *) NULL
)))
215 int name_len
= strlen (name
);
219 /* Loop over each method name. At this level, all overloads of a name
220 are counted as a single name. There is an inner loop which loops over
223 for (method_counter
= TYPE_NFN_FIELDS (t
) - 1;
227 char *method_name
= TYPE_FN_FIELDLIST_NAME (t
, method_counter
);
230 if (strncmp (method_name
, "__", 2) == 0 ||
231 strncmp (method_name
, "op", 2) == 0 ||
232 strncmp (method_name
, "type", 4) == 0)
234 if (cplus_demangle_opname (method_name
, dem_opname
, DMGL_ANSI
))
235 method_name
= dem_opname
;
236 else if (cplus_demangle_opname (method_name
, dem_opname
, 0))
237 method_name
= dem_opname
;
240 if (strcmp_iw (name
, method_name
) == 0)
241 /* Find all the overloaded methods with that name. */
242 i1
+= add_matching_methods (method_counter
, t
, language
,
244 else if (strncmp (class_name
, name
, name_len
) == 0
245 && (class_name
[name_len
] == '\0'
246 || class_name
[name_len
] == '<'))
247 i1
+= add_constructors (method_counter
, t
, language
,
252 /* Only search baseclasses if there is no match yet, since names in
253 derived classes override those in baseclasses.
255 FIXME: The above is not true; it is only true of member functions
256 if they have the same number of arguments (??? - section 13.1 of the
257 ARM says the function members are not in the same scope but doesn't
258 really spell out the rules in a way I understand. In any case, if
259 the number of arguments differ this is a case in which we can overload
260 rather than hiding without any problem, and gcc 2.4.5 does overload
261 rather than hiding in this case). */
264 for (ibase
= 0; ibase
< TYPE_N_BASECLASSES (t
); ibase
++)
265 i1
+= find_methods (TYPE_BASECLASS (t
, ibase
), name
,
266 language
, sym_arr
+ i1
);
271 /* Add the symbols associated to methods of the class whose type is T
272 and whose name matches the method indexed by METHOD_COUNTER in the
273 array SYM_ARR. Return the number of methods added. */
276 add_matching_methods (int method_counter
, struct type
*t
,
277 enum language language
, struct symbol
**sym_arr
)
282 for (field_counter
= TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
289 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
291 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
295 tmp_name
= gdb_mangle_name (t
,
298 phys_name
= alloca (strlen (tmp_name
) + 1);
299 strcpy (phys_name
, tmp_name
);
303 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
305 sym_arr
[i1
] = lookup_symbol_in_language (phys_name
,
313 /* This error message gets printed, but the method
314 still seems to be found
315 fputs_filtered("(Cannot find method ", gdb_stdout);
316 fprintf_symbol_filtered (gdb_stdout, phys_name,
318 DMGL_PARAMS | DMGL_ANSI);
319 fputs_filtered(" - possibly inlined.)\n", gdb_stdout);
327 /* Add the symbols associated to constructors of the class whose type
328 is CLASS_TYPE and which are indexed by by METHOD_COUNTER to the
329 array SYM_ARR. Return the number of methods added. */
332 add_constructors (int method_counter
, struct type
*t
,
333 enum language language
, struct symbol
**sym_arr
)
338 /* For GCC 3.x and stabs, constructors and destructors
339 have names like __base_ctor and __complete_dtor.
340 Check the physname for now if we're looking for a
343 = TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
350 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
352 /* GCC 3.x will never produce stabs stub methods, so
353 we don't need to handle this case. */
354 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
356 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
357 if (! is_constructor_name (phys_name
))
360 /* If this method is actually defined, include it in the
362 sym_arr
[i1
] = lookup_symbol_in_language (phys_name
,
373 /* Helper function for decode_line_1.
374 Build a canonical line spec in CANONICAL if it is non-NULL and if
375 the SAL has a symtab.
376 If SYMNAME is non-NULL the canonical line spec is `filename:symname'.
377 If SYMNAME is NULL the line number from SAL is used and the canonical
378 line spec is `filename:linenum'. */
381 build_canonical_line_spec (struct symtab_and_line
*sal
, char *symname
,
384 char **canonical_arr
;
385 char *canonical_name
;
387 struct symtab
*s
= sal
->symtab
;
389 if (s
== (struct symtab
*) NULL
390 || s
->filename
== (char *) NULL
391 || canonical
== (char ***) NULL
)
394 canonical_arr
= (char **) xmalloc (sizeof (char *));
395 *canonical
= canonical_arr
;
397 filename
= s
->filename
;
400 canonical_name
= xmalloc (strlen (filename
) + strlen (symname
) + 2);
401 sprintf (canonical_name
, "%s:%s", filename
, symname
);
405 canonical_name
= xmalloc (strlen (filename
) + 30);
406 sprintf (canonical_name
, "%s:%d", filename
, sal
->line
);
408 canonical_arr
[0] = canonical_name
;
413 /* Find an instance of the character C in the string S that is outside
414 of all parenthesis pairs, single-quoted strings, and double-quoted
415 strings. Also, ignore the char within a template name, like a ','
416 within foo<int, int>. */
419 find_toplevel_char (char *s
, char c
)
421 int quoted
= 0; /* zero if we're not in quotes;
422 '"' if we're in a double-quoted string;
423 '\'' if we're in a single-quoted string. */
424 int depth
= 0; /* Number of unclosed parens we've seen. */
427 for (scan
= s
; *scan
; scan
++)
433 else if (*scan
== '\\' && *(scan
+ 1))
436 else if (*scan
== c
&& ! quoted
&& depth
== 0)
438 else if (*scan
== '"' || *scan
== '\'')
440 else if (*scan
== '(' || *scan
== '<')
442 else if ((*scan
== ')' || *scan
== '>') && depth
> 0)
449 /* Determines if the gives string corresponds to an Objective-C method
450 representation, such as -[Foo bar:] or +[Foo bar]. Objective-C symbols
451 are allowed to have spaces and parentheses in them. */
454 is_objc_method_format (const char *s
)
456 if (s
== NULL
|| *s
== '\0')
458 /* Handle arguments with the format FILENAME:SYMBOL. */
459 if ((s
[0] == ':') && (strchr ("+-", s
[1]) != NULL
)
460 && (s
[2] == '[') && strchr(s
, ']'))
462 /* Handle arguments that are just SYMBOL. */
463 else if ((strchr ("+-", s
[0]) != NULL
) && (s
[1] == '[') && strchr(s
, ']'))
468 /* Given a list of NELTS symbols in SYM_ARR, return a list of lines to
469 operate on (ask user if necessary).
470 If CANONICAL is non-NULL return a corresponding array of mangled names
471 as canonical line specs there. */
473 static struct symtabs_and_lines
474 decode_line_2 (struct symbol
*sym_arr
[], int nelts
, int funfirstline
,
477 struct symtabs_and_lines values
, return_values
;
482 struct cleanup
*old_chain
;
483 char **canonical_arr
= (char **) NULL
;
484 const char *select_mode
= multiple_symbols_select_mode ();
486 if (select_mode
== multiple_symbols_cancel
)
488 canceled because the command is ambiguous\n\
489 See set/show multiple-symbol."));
491 values
.sals
= (struct symtab_and_line
*)
492 alloca (nelts
* sizeof (struct symtab_and_line
));
493 return_values
.sals
= (struct symtab_and_line
*)
494 xmalloc (nelts
* sizeof (struct symtab_and_line
));
495 old_chain
= make_cleanup (xfree
, return_values
.sals
);
499 canonical_arr
= (char **) xmalloc (nelts
* sizeof (char *));
500 make_cleanup (xfree
, canonical_arr
);
501 memset (canonical_arr
, 0, nelts
* sizeof (char *));
502 *canonical
= canonical_arr
;
508 init_sal (&return_values
.sals
[i
]); /* Initialize to zeroes. */
509 init_sal (&values
.sals
[i
]);
510 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
511 values
.sals
[i
] = find_function_start_sal (sym_arr
[i
], funfirstline
);
515 /* If select_mode is "all", then do not print the multiple-choice
516 menu and act as if the user had chosen choice "1" (all). */
517 if (select_mode
== multiple_symbols_all
518 || ui_out_is_mi_like_p (interp_ui_out (top_level_interpreter ())))
523 printf_unfiltered (_("[0] cancel\n[1] all\n"));
526 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
528 if (values
.sals
[i
].symtab
)
529 printf_unfiltered ("[%d] %s at %s:%d\n",
531 SYMBOL_PRINT_NAME (sym_arr
[i
]),
532 values
.sals
[i
].symtab
->filename
,
533 values
.sals
[i
].line
);
535 printf_unfiltered (_("[%d] %s at ?FILE:%d [No symtab? Probably broken debug info...]\n"),
537 SYMBOL_PRINT_NAME (sym_arr
[i
]),
538 values
.sals
[i
].line
);
542 printf_unfiltered (_("?HERE\n"));
546 prompt
= getenv ("PS2");
551 args
= command_line_input (prompt
, 0, "overload-choice");
554 if (args
== 0 || *args
== 0)
555 error_no_arg (_("one or more choice numbers"));
563 while (*arg1
>= '0' && *arg1
<= '9')
565 if (*arg1
&& *arg1
!= ' ' && *arg1
!= '\t')
566 error (_("Arguments must be choice numbers."));
571 error (_("canceled"));
576 for (i
= 0; i
< nelts
; i
++)
578 if (canonical_arr
[i
] == NULL
)
580 symname
= SYMBOL_LINKAGE_NAME (sym_arr
[i
]);
581 canonical_arr
[i
] = xstrdup (symname
);
585 memcpy (return_values
.sals
, values
.sals
,
586 (nelts
* sizeof (struct symtab_and_line
)));
587 return_values
.nelts
= nelts
;
588 discard_cleanups (old_chain
);
589 return return_values
;
592 if (num
>= nelts
+ 2)
594 printf_unfiltered (_("No choice number %d.\n"), num
);
599 if (values
.sals
[num
].pc
)
603 symname
= SYMBOL_LINKAGE_NAME (sym_arr
[num
]);
604 make_cleanup (xfree
, symname
);
605 canonical_arr
[i
] = xstrdup (symname
);
607 return_values
.sals
[i
++] = values
.sals
[num
];
608 values
.sals
[num
].pc
= 0;
612 printf_unfiltered (_("duplicate request for %d ignored.\n"), num
);
617 while (*args
== ' ' || *args
== '\t')
620 return_values
.nelts
= i
;
621 discard_cleanups (old_chain
);
622 return return_values
;
625 /* The parser of linespec itself. */
627 /* Parse a string that specifies a line number.
628 Pass the address of a char * variable; that variable will be
629 advanced over the characters actually parsed.
633 LINENUM -- that line number in current file. PC returned is 0.
634 FILE:LINENUM -- that line in that file. PC returned is 0.
635 FUNCTION -- line number of openbrace of that function.
636 PC returned is the start of the function.
637 VARIABLE -- line number of definition of that variable.
639 FILE:FUNCTION -- likewise, but prefer functions in that file.
640 *EXPR -- line in which address EXPR appears.
642 This may all be followed by an "if EXPR", which we ignore.
644 FUNCTION may be an undebuggable function found in minimal symbol table.
646 If the argument FUNFIRSTLINE is nonzero, we want the first line
647 of real code inside a function when a function is specified, and it is
648 not OK to specify a variable or type to get its line number.
650 DEFAULT_SYMTAB specifies the file to use if none is specified.
651 It defaults to current_source_symtab.
652 DEFAULT_LINE specifies the line number to use for relative
653 line numbers (that start with signs). Defaults to current_source_line.
654 If CANONICAL is non-NULL, store an array of strings containing the canonical
655 line specs there if necessary. Currently overloaded member functions and
656 line numbers or static functions without a filename yield a canonical
657 line spec. The array and the line spec strings are allocated on the heap,
658 it is the callers responsibility to free them.
660 Note that it is possible to return zero for the symtab
661 if no file is validly specified. Callers must check that.
662 Also, the line number returned may be invalid.
664 If NOT_FOUND_PTR is not null, store a boolean true/false value at the location, based
665 on whether or not failure occurs due to an unknown function or file. In the case
666 where failure does occur due to an unknown function or file, do not issue an error
669 /* We allow single quotes in various places. This is a hideous
670 kludge, which exists because the completer can't yet deal with the
671 lack of single quotes. FIXME: write a linespec_completer which we
672 can use as appropriate instead of make_symbol_completion_list. */
674 struct symtabs_and_lines
675 decode_line_1 (char **argptr
, int funfirstline
, struct symtab
*default_symtab
,
676 int default_line
, char ***canonical
, int *not_found_ptr
)
680 /* If a file name is specified, this is its symtab. */
681 struct symtab
*file_symtab
= NULL
;
684 /* This is NULL if there are no parens in *ARGPTR, or a pointer to
685 the closing parenthesis if there are parens. */
687 /* This says whether or not something in *ARGPTR is quoted with
688 completer_quotes (i.e. with single quotes). */
690 /* Is part of *ARGPTR is enclosed in double quotes? */
691 int is_quote_enclosed
;
692 int is_objc_method
= 0;
693 char *saved_arg
= *argptr
;
698 /* Defaults have defaults. */
700 initialize_defaults (&default_symtab
, &default_line
);
702 /* See if arg is *PC. */
705 return decode_indirect (argptr
);
707 /* Set various flags. 'paren_pointer' is important for overload
708 checking, where we allow things like:
709 (gdb) break c::f(int)
712 set_flags (*argptr
, &is_quoted
, &paren_pointer
);
714 /* Check to see if it's a multipart linespec (with colons or
717 /* Locate the end of the first half of the linespec.
718 After the call, for instance, if the argptr string is "foo.c:123"
719 p will point at "123". If there is only one part, like "foo", p
720 will point to "". If this is a C++ name, like "A::B::foo", p will
721 point to "::B::foo". Argptr is not changed by this call. */
723 p
= locate_first_half (argptr
, &is_quote_enclosed
);
725 /* Check if this is an Objective-C method (anything that starts with
726 a '+' or '-' and a '['). */
727 if (is_objc_method_format (p
))
730 paren_pointer
= NULL
; /* Just a category name. Ignore it. */
733 /* Check if the symbol could be an Objective-C selector. */
736 struct symtabs_and_lines values
;
737 values
= decode_objc (argptr
, funfirstline
, NULL
,
738 canonical
, saved_arg
);
739 if (values
.sals
!= NULL
)
743 /* Does it look like there actually were two parts? */
745 if ((p
[0] == ':' || p
[0] == '.') && paren_pointer
== NULL
)
748 *argptr
= *argptr
+ 1;
750 /* Is it a C++ or Java compound data structure?
751 The check on p[1] == ':' is capturing the case of "::",
752 since p[0]==':' was checked above.
753 Note that the call to decode_compound does everything
754 for us, including the lookup on the symbol table, so we
757 if (p
[0] == '.' || p
[1] == ':')
758 return decode_compound (argptr
, funfirstline
, canonical
,
761 /* No, the first part is a filename; set file_symtab to be that file's
762 symtab. Also, move argptr past the filename. */
764 file_symtab
= symtab_from_filename (argptr
, p
, is_quote_enclosed
,
768 /* No one really seems to know why this was added. It certainly
769 breaks the command line, though, whenever the passed
770 name is of the form ClassName::Method. This bit of code
771 singles out the class name, and if funfirstline is set (for
772 example, you are setting a breakpoint at this function),
773 you get an error. This did not occur with earlier
774 verions, so I am ifdef'ing this out. 3/29/99 */
777 /* Check if what we have till now is a symbol name */
779 /* We may be looking at a template instantiation such
780 as "foo<int>". Check here whether we know about it,
781 instead of falling through to the code below which
782 handles ordinary function names, because that code
783 doesn't like seeing '<' and '>' in a name -- the
784 skip_quoted call doesn't go past them. So see if we
785 can figure it out right now. */
787 copy
= (char *) alloca (p
- *argptr
+ 1);
788 memcpy (copy
, *argptr
, p
- *argptr
);
789 copy
[p
- *argptr
] = '\000';
790 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0);
793 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
794 return symbol_found (funfirstline
, canonical
, copy
, sym
, NULL
);
796 /* Otherwise fall out from here and go to file/line spec
801 /* file_symtab is specified file's symtab, or 0 if no file specified.
802 arg no longer contains the file name. */
804 /* Check whether arg is all digits (and sign). */
807 if (*q
== '-' || *q
== '+')
809 while (*q
>= '0' && *q
<= '9')
812 if (q
!= *argptr
&& (*q
== 0 || *q
== ' ' || *q
== '\t' || *q
== ','))
813 /* We found a token consisting of all digits -- at least one digit. */
814 return decode_all_digits (argptr
, default_symtab
, default_line
,
815 canonical
, file_symtab
, q
);
817 /* Arg token is not digits => try it as a variable name
818 Find the next token (everything up to end or next whitespace). */
820 if (**argptr
== '$') /* May be a convenience variable. */
821 /* One or two $ chars possible. */
822 p
= skip_quoted (*argptr
+ (((*argptr
)[1] == '$') ? 2 : 1));
825 p
= skip_quoted (*argptr
);
827 error (_("Unmatched single quote."));
829 else if (is_objc_method
)
831 /* allow word separators in method names for Obj-C */
832 p
= skip_quoted_chars (*argptr
, NULL
, "");
834 else if (paren_pointer
!= NULL
)
836 p
= paren_pointer
+ 1;
840 p
= skip_quoted (*argptr
);
843 /* Keep any template parameters */
845 p
= find_template_name_end (p
);
847 copy
= (char *) alloca (p
- *argptr
+ 1);
848 memcpy (copy
, *argptr
, p
- *argptr
);
849 copy
[p
- *argptr
] = '\0';
852 && copy
[0] == copy
[p
- *argptr
- 1]
853 && strchr (get_gdb_completer_quote_characters (), copy
[0]) != NULL
)
855 copy
[p
- *argptr
- 1] = '\0';
858 while (*p
== ' ' || *p
== '\t')
862 /* If it starts with $: may be a legitimate variable or routine name
863 (e.g. HP-UX millicode routines such as $$dyncall), or it may
864 be history value, or it may be a convenience variable. */
867 return decode_dollar (copy
, funfirstline
, default_symtab
,
868 canonical
, file_symtab
);
870 /* Look up that token as a variable.
871 If file specified, use that file's per-file block to start with. */
873 return decode_variable (copy
, funfirstline
, canonical
,
874 file_symtab
, not_found_ptr
);
879 /* Now, more helper functions for decode_line_1. Some conventions
880 that these functions follow:
882 Decode_line_1 typically passes along some of its arguments or local
883 variables to the subfunctions. It passes the variables by
884 reference if they are modified by the subfunction, and by value
887 Some of the functions have side effects that don't arise from
888 variables that are passed by reference. In particular, if a
889 function is passed ARGPTR as an argument, it modifies what ARGPTR
890 points to; typically, it advances *ARGPTR past whatever substring
891 it has just looked at. (If it doesn't modify *ARGPTR, then the
892 function gets passed *ARGPTR instead, which is then called ARG: see
893 set_flags, for example.) Also, functions that return a struct
894 symtabs_and_lines may modify CANONICAL, as in the description of
897 If a function returns a struct symtabs_and_lines, then that struct
898 will immediately make its way up the call chain to be returned by
899 decode_line_1. In particular, all of the functions decode_XXX
900 calculate the appropriate struct symtabs_and_lines, under the
901 assumption that their argument is of the form XXX. */
903 /* First, some functions to initialize stuff at the beggining of the
907 initialize_defaults (struct symtab
**default_symtab
, int *default_line
)
909 if (*default_symtab
== 0)
911 /* Use whatever we have for the default source line. We don't use
912 get_current_or_default_symtab_and_line as it can recurse and call
914 struct symtab_and_line cursal
=
915 get_current_source_symtab_and_line ();
917 *default_symtab
= cursal
.symtab
;
918 *default_line
= cursal
.line
;
923 set_flags (char *arg
, int *is_quoted
, char **paren_pointer
)
928 /* 'has_if' is for the syntax:
929 (gdb) break foo if (a==b)
931 if ((ii
= strstr (arg
, " if ")) != NULL
||
932 (ii
= strstr (arg
, "\tif ")) != NULL
||
933 (ii
= strstr (arg
, " if\t")) != NULL
||
934 (ii
= strstr (arg
, "\tif\t")) != NULL
||
935 (ii
= strstr (arg
, " if(")) != NULL
||
936 (ii
= strstr (arg
, "\tif( ")) != NULL
)
938 /* Temporarily zap out "if (condition)" to not confuse the
939 parenthesis-checking code below. This is undone below. Do not
947 && strchr (get_gdb_completer_quote_characters (),
950 *paren_pointer
= strchr (arg
, '(');
951 if (*paren_pointer
!= NULL
)
952 *paren_pointer
= strrchr (*paren_pointer
, ')');
954 /* Now that we're safely past the paren_pointer check, put back " if
955 (condition)" so outer layers can see it. */
962 /* Decode arg of the form *PC. */
964 static struct symtabs_and_lines
965 decode_indirect (char **argptr
)
967 struct symtabs_and_lines values
;
971 pc
= parse_and_eval_address_1 (argptr
);
973 values
.sals
= (struct symtab_and_line
*)
974 xmalloc (sizeof (struct symtab_and_line
));
977 values
.sals
[0] = find_pc_line (pc
, 0);
978 values
.sals
[0].pc
= pc
;
979 values
.sals
[0].section
= find_pc_overlay (pc
);
980 values
.sals
[0].explicit_pc
= 1;
987 /* Locate the first half of the linespec, ending in a colon, period,
988 or whitespace. (More or less.) Also, check to see if *ARGPTR is
989 enclosed in double quotes; if so, set is_quote_enclosed, advance
990 ARGPTR past that and zero out the trailing double quote.
991 If ARGPTR is just a simple name like "main", p will point to ""
995 locate_first_half (char **argptr
, int *is_quote_enclosed
)
1001 /* Maybe we were called with a line range FILENAME:LINENUM,FILENAME:LINENUM
1002 and we must isolate the first half. Outer layers will call again later
1003 for the second half.
1005 Don't count commas that appear in argument lists of overloaded
1006 functions, or in quoted strings. It's stupid to go to this much
1007 trouble when the rest of the function is such an obvious roach hotel. */
1008 ii
= find_toplevel_char (*argptr
, ',');
1009 has_comma
= (ii
!= 0);
1011 /* Temporarily zap out second half to not confuse the code below.
1012 This is undone below. Do not change ii!! */
1018 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION. May also be
1019 CLASS::MEMBER, or NAMESPACE::NAME. Look for ':', but ignore
1025 *is_quote_enclosed
= 1;
1030 *is_quote_enclosed
= 0;
1035 char *temp_end
= find_template_name_end (p
);
1037 error (_("malformed template specification in command"));
1040 /* Check for a colon and a plus or minus and a [ (which
1041 indicates an Objective-C method) */
1042 if (is_objc_method_format (p
))
1046 /* Check for the end of the first half of the linespec. End of
1047 line, a tab, a double colon or the last single colon, or a
1048 space. But if enclosed in double quotes we do not break on
1053 && ((p
[1] == ':') || (strchr (p
+ 1, ':') == NULL
)))
1054 || ((p
[0] == ' ') && !*is_quote_enclosed
))
1056 if (p
[0] == '.' && strchr (p
, ':') == NULL
)
1058 /* Java qualified method. Find the *last* '.', since the
1059 others are package qualifiers. */
1060 for (p1
= p
; *p1
; p1
++)
1068 while (p
[0] == ' ' || p
[0] == '\t')
1071 /* If the closing double quote was left at the end, remove it. */
1072 if (*is_quote_enclosed
)
1074 char *closing_quote
= strchr (p
- 1, '"');
1075 if (closing_quote
&& closing_quote
[1] == '\0')
1076 *closing_quote
= '\0';
1079 /* Now that we've safely parsed the first half, put back ',' so
1080 outer layers can see it. */
1089 /* Here's where we recognise an Objective-C Selector. An Objective C
1090 selector may be implemented by more than one class, therefore it
1091 may represent more than one method/function. This gives us a
1092 situation somewhat analogous to C++ overloading. If there's more
1093 than one method that could represent the selector, then use some of
1094 the existing C++ code to let the user choose one. */
1096 struct symtabs_and_lines
1097 decode_objc (char **argptr
, int funfirstline
, struct symtab
*file_symtab
,
1098 char ***canonical
, char *saved_arg
)
1100 struct symtabs_and_lines values
;
1101 struct symbol
**sym_arr
= NULL
;
1102 struct symbol
*sym
= NULL
;
1104 struct block
*block
= NULL
;
1111 if (file_symtab
!= NULL
)
1112 block
= BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
), STATIC_BLOCK
);
1115 enum language save_language
;
1117 /* get_selected_block can change the current language when there is
1118 no selected frame yet. */
1119 save_language
= current_language
->la_language
;
1120 block
= get_selected_block (0);
1121 set_language (save_language
);
1124 copy
= find_imps (file_symtab
, block
, *argptr
, NULL
, &i1
, &i2
);
1128 sym_arr
= (struct symbol
**) alloca ((i1
+ 1) * sizeof (struct symbol
*));
1131 copy
= find_imps (file_symtab
, block
, *argptr
, sym_arr
, &i1
, &i2
);
1135 /* i1 now represents the TOTAL number of matches found.
1136 i2 represents how many HIGH-LEVEL (struct symbol) matches,
1137 which will come first in the sym_arr array. Any low-level
1138 (minimal_symbol) matches will follow those. */
1144 /* Already a struct symbol. */
1149 sym
= find_pc_function (SYMBOL_VALUE_ADDRESS (sym_arr
[0]));
1150 if ((sym
!= NULL
) && strcmp (SYMBOL_LINKAGE_NAME (sym_arr
[0]), SYMBOL_LINKAGE_NAME (sym
)) != 0)
1152 warning (_("debugging symbol \"%s\" does not match selector; ignoring"), SYMBOL_LINKAGE_NAME (sym
));
1157 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof (struct symtab_and_line
));
1160 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1162 /* Canonicalize this, so it remains resolved for dylib loads. */
1163 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1164 build_canonical_line_spec (values
.sals
, SYMBOL_NATURAL_NAME (sym
), canonical
);
1168 /* The only match was a non-debuggable symbol. */
1169 values
.sals
[0].symtab
= NULL
;
1170 values
.sals
[0].line
= 0;
1171 values
.sals
[0].end
= 0;
1172 values
.sals
[0].pc
= SYMBOL_VALUE_ADDRESS (sym_arr
[0]);
1179 /* More than one match. The user must choose one or more. */
1180 return decode_line_2 (sym_arr
, i2
, funfirstline
, canonical
);
1186 /* This handles C++ and Java compound data structures. P should point
1187 at the first component separator, i.e. double-colon or period. As
1188 an example, on entrance to this function we could have ARGPTR
1189 pointing to "AAA::inA::fun" and P pointing to "::inA::fun". */
1191 static struct symtabs_and_lines
1192 decode_compound (char **argptr
, int funfirstline
, char ***canonical
,
1193 char *saved_arg
, char *p
)
1195 struct symtabs_and_lines values
;
1197 char *saved_arg2
= *argptr
;
1201 struct symbol
*sym_class
;
1202 struct symbol
**sym_arr
;
1205 /* First check for "global" namespace specification, of the form
1206 "::foo". If found, skip over the colons and jump to normal
1207 symbol processing. I.e. the whole line specification starts with
1208 "::" (note the condition that *argptr == p). */
1210 && ((*argptr
== p
) || (p
[-1] == ' ') || (p
[-1] == '\t')))
1213 /* Given our example "AAA::inA::fun", we have two cases to consider:
1215 1) AAA::inA is the name of a class. In that case, presumably it
1216 has a method called "fun"; we then look up that method using
1219 2) AAA::inA isn't the name of a class. In that case, either the
1220 user made a typo or AAA::inA is the name of a namespace.
1221 Either way, we just look up AAA::inA::fun with lookup_symbol.
1223 Thus, our first task is to find everything before the last set of
1224 double-colons and figure out if it's the name of a class. So we
1225 first loop through all of the double-colons. */
1227 p2
= p
; /* Save for restart. */
1229 /* This is very messy. Following the example above we have now the
1232 argptr -> "AAA::inA::fun
1233 saved_arg -> "AAA::inA::fun
1234 saved_arg2 -> "AAA::inA::fun
1235 p2 -> "::inA::fun". */
1237 /* In the loop below, with these strings, we'll make 2 passes, each
1238 is marked in comments.*/
1242 /* Move pointer up to next possible class/namespace token. */
1244 p
= p2
+ 1; /* Restart with old value +1. */
1246 /* PASS1: at this point p2->"::inA::fun", so p->":inA::fun",
1247 i.e. if there is a double-colon, p will now point to the
1249 /* PASS2: p2->"::fun", p->":fun" */
1251 /* Move pointer ahead to next double-colon. */
1252 while (*p
&& (p
[0] != ' ') && (p
[0] != '\t') && (p
[0] != '\''))
1256 temp_end
= find_template_name_end (p
);
1258 error (_("malformed template specification in command"));
1261 /* Note that, since, at the start of this loop, p would be
1262 pointing to the second colon in a double-colon, we only
1263 satisfy the condition below if there is another
1264 double-colon to the right (after). I.e. there is another
1265 component that can be a class or a namespace. I.e, if at
1266 the beginning of this loop (PASS1), we had
1267 p->":inA::fun", we'll trigger this when p has been
1268 advanced to point to "::fun". */
1269 /* PASS2: we will not trigger this. */
1270 else if ((p
[0] == ':') && (p
[1] == ':'))
1271 break; /* Found double-colon. */
1273 /* PASS2: We'll keep getting here, until p->"", at which point
1274 we exit this loop. */
1279 break; /* Out of the while (1). This would happen
1280 for instance if we have looked up
1281 unsuccessfully all the components of the
1282 string, and p->""(PASS2) */
1284 /* We get here if p points to ' ', '\t', '\'', "::" or ""(i.e
1286 /* Save restart for next time around. */
1288 /* Restore argptr as it was on entry to this function. */
1289 *argptr
= saved_arg2
;
1290 /* PASS1: at this point p->"::fun" argptr->"AAA::inA::fun",
1293 /* All ready for next pass through the loop. */
1297 /* Start of lookup in the symbol tables. */
1299 /* Lookup in the symbol table the substring between argptr and
1300 p. Note, this call changes the value of argptr. */
1301 /* Before the call, argptr->"AAA::inA::fun",
1302 p->"", p2->"::fun". After the call: argptr->"fun", p, p2
1304 sym_class
= lookup_prefix_sym (argptr
, p2
);
1306 /* If sym_class has been found, and if "AAA::inA" is a class, then
1307 we're in case 1 above. So we look up "fun" as a method of that
1310 (t
= check_typedef (SYMBOL_TYPE (sym_class
)),
1311 (TYPE_CODE (t
) == TYPE_CODE_STRUCT
1312 || TYPE_CODE (t
) == TYPE_CODE_UNION
)))
1314 /* Arg token is not digits => try it as a function name.
1315 Find the next token (everything up to end or next
1318 && strchr (get_gdb_completer_quote_characters (),
1321 p
= skip_quoted (*argptr
);
1322 *argptr
= *argptr
+ 1;
1326 /* At this point argptr->"fun". */
1328 while (*p
&& *p
!= ' ' && *p
!= '\t' && *p
!= ',' && *p
!= ':')
1330 /* At this point p->"". String ended. */
1333 /* Allocate our own copy of the substring between argptr and
1335 copy
= (char *) alloca (p
- *argptr
+ 1);
1336 memcpy (copy
, *argptr
, p
- *argptr
);
1337 copy
[p
- *argptr
] = '\0';
1339 && copy
[p
- *argptr
- 1]
1340 && strchr (get_gdb_completer_quote_characters (),
1341 copy
[p
- *argptr
- 1]) != NULL
)
1342 copy
[p
- *argptr
- 1] = '\0';
1344 /* At this point copy->"fun", p->"" */
1346 /* No line number may be specified. */
1347 while (*p
== ' ' || *p
== '\t')
1350 /* At this point arptr->"". */
1352 /* Look for copy as a method of sym_class. */
1353 /* At this point copy->"fun", sym_class is "AAA:inA",
1354 saved_arg->"AAA::inA::fun". This concludes the scanning of
1355 the string for possible components matches. If we find it
1356 here, we return. If not, and we are at the and of the string,
1357 we'll lookup the whole string in the symbol tables. */
1359 return find_method (funfirstline
, canonical
, saved_arg
,
1360 copy
, t
, sym_class
);
1362 } /* End if symbol found */
1365 /* We couldn't find a class, so we're in case 2 above. We check the
1366 entire name as a symbol instead. */
1368 copy
= (char *) alloca (p
- saved_arg2
+ 1);
1369 memcpy (copy
, saved_arg2
, p
- saved_arg2
);
1370 /* Note: if is_quoted should be true, we snuff out quote here
1372 copy
[p
- saved_arg2
] = '\000';
1373 /* Set argptr to skip over the name. */
1374 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
1376 /* Look up entire name */
1377 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0);
1379 return symbol_found (funfirstline
, canonical
, copy
, sym
, NULL
);
1381 /* Couldn't find any interpretation as classes/namespaces, so give
1382 up. The quotes are important if copy is empty. */
1383 cplusplus_error (saved_arg
,
1384 "Can't find member of namespace, class, struct, or union named \"%s\"\n",
1388 /* Next come some helper functions for decode_compound. */
1390 /* Return the symbol corresponding to the substring of *ARGPTR ending
1391 at P, allowing whitespace. Also, advance *ARGPTR past the symbol
1392 name in question, the compound object separator ("::" or "."), and
1393 whitespace. Note that *ARGPTR is changed whether or not the
1394 lookup_symbol call finds anything (i.e we return NULL). As an
1395 example, say ARGPTR is "AAA::inA::fun" and P is "::inA::fun". */
1397 static struct symbol
*
1398 lookup_prefix_sym (char **argptr
, char *p
)
1403 /* Extract the class name. */
1405 while (p
!= *argptr
&& p
[-1] == ' ')
1407 copy
= (char *) alloca (p
- *argptr
+ 1);
1408 memcpy (copy
, *argptr
, p
- *argptr
);
1409 copy
[p
- *argptr
] = 0;
1411 /* Discard the class name from the argptr. */
1412 p
= p1
+ (p1
[0] == ':' ? 2 : 1);
1413 while (*p
== ' ' || *p
== '\t')
1417 /* At this point p1->"::inA::fun", p->"inA::fun" copy->"AAA",
1418 argptr->"inA::fun" */
1420 return lookup_symbol (copy
, 0, STRUCT_DOMAIN
, 0);
1423 /* This finds the method COPY in the class whose type is T and whose
1424 symbol is SYM_CLASS. */
1426 static struct symtabs_and_lines
1427 find_method (int funfirstline
, char ***canonical
, char *saved_arg
,
1428 char *copy
, struct type
*t
, struct symbol
*sym_class
)
1430 struct symtabs_and_lines values
;
1431 struct symbol
*sym
= NULL
;
1432 int i1
; /* Counter for the symbol array. */
1433 struct symbol
**sym_arr
= alloca (total_number_of_methods (t
)
1434 * sizeof (struct symbol
*));
1436 /* Find all methods with a matching name, and put them in
1439 i1
= find_methods (t
, copy
, SYMBOL_LANGUAGE (sym_class
), sym_arr
);
1443 /* There is exactly one field with that name. */
1446 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1448 values
.sals
= (struct symtab_and_line
*)
1449 xmalloc (sizeof (struct symtab_and_line
));
1451 values
.sals
[0] = find_function_start_sal (sym
,
1463 /* There is more than one field with that name
1464 (overloaded). Ask the user which one to use. */
1465 return decode_line_2 (sym_arr
, i1
, funfirstline
, canonical
);
1471 if (is_operator_name (copy
))
1473 tmp
= (char *) alloca (strlen (copy
+ 3) + 9);
1474 strcpy (tmp
, "operator ");
1475 strcat (tmp
, copy
+ 3);
1480 cplusplus_error (saved_arg
,
1481 "the class `%s' does not have destructor defined\n",
1482 SYMBOL_PRINT_NAME (sym_class
));
1484 cplusplus_error (saved_arg
,
1485 "the class %s does not have any method named %s\n",
1486 SYMBOL_PRINT_NAME (sym_class
), tmp
);
1492 /* Return the symtab associated to the filename given by the substring
1493 of *ARGPTR ending at P, and advance ARGPTR past that filename. If
1494 NOT_FOUND_PTR is not null and the source file is not found, store
1495 boolean true at the location pointed to and do not issue an
1498 static struct symtab
*
1499 symtab_from_filename (char **argptr
, char *p
, int is_quote_enclosed
,
1504 struct symtab
*file_symtab
;
1507 while (p
!= *argptr
&& p
[-1] == ' ')
1509 if ((*p
== '"') && is_quote_enclosed
)
1511 copy
= (char *) alloca (p
- *argptr
+ 1);
1512 memcpy (copy
, *argptr
, p
- *argptr
);
1513 /* It may have the ending quote right after the file name. */
1514 if (is_quote_enclosed
&& copy
[p
- *argptr
- 1] == '"')
1515 copy
[p
- *argptr
- 1] = 0;
1517 copy
[p
- *argptr
] = 0;
1519 /* Find that file's data. */
1520 file_symtab
= lookup_symtab (copy
);
1521 if (file_symtab
== 0)
1525 if (!have_full_symbols () && !have_partial_symbols ())
1526 throw_error (NOT_FOUND_ERROR
,
1527 _("No symbol table is loaded. Use the \"file\" command."));
1528 throw_error (NOT_FOUND_ERROR
, _("No source file named %s."), copy
);
1531 /* Discard the file name from the arg. */
1533 while (*p
== ' ' || *p
== '\t')
1542 /* This decodes a line where the argument is all digits (possibly
1543 preceded by a sign). Q should point to the end of those digits;
1544 the other arguments are as usual. */
1546 static struct symtabs_and_lines
1547 decode_all_digits (char **argptr
, struct symtab
*default_symtab
,
1548 int default_line
, char ***canonical
,
1549 struct symtab
*file_symtab
, char *q
)
1552 struct symtabs_and_lines values
;
1553 struct symtab_and_line val
;
1561 /* We might need a canonical line spec if no file was specified. */
1562 int need_canonical
= (file_symtab
== NULL
) ? 1 : 0;
1566 /* This is where we need to make sure that we have good defaults.
1567 We must guarantee that this section of code is never executed
1568 when we are called with just a function name, since
1569 set_default_source_symtab_and_line uses
1570 select_source_symtab that calls us with such an argument. */
1572 if (file_symtab
== 0 && default_symtab
== 0)
1574 /* Make sure we have at least a default source file. */
1575 set_default_source_symtab_and_line ();
1576 initialize_defaults (&default_symtab
, &default_line
);
1579 if (**argptr
== '+')
1580 sign
= plus
, (*argptr
)++;
1581 else if (**argptr
== '-')
1582 sign
= minus
, (*argptr
)++;
1583 val
.line
= atoi (*argptr
);
1589 if (file_symtab
== 0)
1590 val
.line
= default_line
+ val
.line
;
1595 if (file_symtab
== 0)
1596 val
.line
= default_line
- val
.line
;
1601 break; /* No need to adjust val.line. */
1604 while (*q
== ' ' || *q
== '\t')
1607 if (file_symtab
== 0)
1608 file_symtab
= default_symtab
;
1610 /* It is possible that this source file has more than one symtab,
1611 and that the new line number specification has moved us from the
1612 default (in file_symtab) to a new one. */
1613 val
.symtab
= find_line_symtab (file_symtab
, val
.line
, NULL
, NULL
);
1614 if (val
.symtab
== 0)
1615 val
.symtab
= file_symtab
;
1618 values
.sals
= (struct symtab_and_line
*)
1619 xmalloc (sizeof (struct symtab_and_line
));
1620 values
.sals
[0] = val
;
1623 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1624 values
.sals
[0].explicit_line
= 1;
1630 /* Decode a linespec starting with a dollar sign. */
1632 static struct symtabs_and_lines
1633 decode_dollar (char *copy
, int funfirstline
, struct symtab
*default_symtab
,
1634 char ***canonical
, struct symtab
*file_symtab
)
1638 int need_canonical
= 0;
1639 struct symtabs_and_lines values
;
1640 struct symtab_and_line val
;
1643 struct minimal_symbol
*msymbol
;
1645 p
= (copy
[1] == '$') ? copy
+ 2 : copy
+ 1;
1646 while (*p
>= '0' && *p
<= '9')
1648 if (!*p
) /* Reached end of token without hitting non-digit. */
1650 /* We have a value history reference. */
1651 struct value
*val_history
;
1652 sscanf ((copy
[1] == '$') ? copy
+ 2 : copy
+ 1, "%d", &index
);
1653 val_history
= access_value_history ((copy
[1] == '$') ? -index
: index
);
1654 if (TYPE_CODE (value_type (val_history
)) != TYPE_CODE_INT
)
1655 error (_("History values used in line specs must have integer values."));
1656 valx
= value_as_long (val_history
);
1660 /* Not all digits -- may be user variable/function or a
1661 convenience variable. */
1663 /* Look up entire name as a symbol first. */
1664 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0);
1665 file_symtab
= (struct symtab
*) NULL
;
1667 /* Symbol was found --> jump to normal symbol processing. */
1669 return symbol_found (funfirstline
, canonical
, copy
, sym
, NULL
);
1671 /* If symbol was not found, look in minimal symbol tables. */
1672 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1673 /* Min symbol was found --> jump to minsym processing. */
1675 return minsym_found (funfirstline
, msymbol
);
1677 /* Not a user variable or function -- must be convenience variable. */
1678 if (!get_internalvar_integer (lookup_internalvar (copy
+ 1), &valx
))
1679 error (_("Convenience variables used in line specs must have integer values."));
1684 /* Either history value or convenience value from above, in valx. */
1685 val
.symtab
= file_symtab
? file_symtab
: default_symtab
;
1689 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof val
);
1690 values
.sals
[0] = val
;
1694 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1701 /* Decode a linespec that's a variable. If FILE_SYMTAB is non-NULL,
1702 look in that symtab's static variables first. If NOT_FOUND_PTR is not NULL and
1703 the function cannot be found, store boolean true in the location pointed to
1704 and do not issue an error message. */
1706 static struct symtabs_and_lines
1707 decode_variable (char *copy
, int funfirstline
, char ***canonical
,
1708 struct symtab
*file_symtab
, int *not_found_ptr
)
1712 struct minimal_symbol
*msymbol
;
1714 sym
= lookup_symbol (copy
,
1716 ? BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
),
1718 : get_selected_block (0)),
1722 return symbol_found (funfirstline
, canonical
, copy
, sym
, file_symtab
);
1724 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1726 if (msymbol
!= NULL
)
1727 return minsym_found (funfirstline
, msymbol
);
1732 if (!have_full_symbols ()
1733 && !have_partial_symbols ()
1734 && !have_minimal_symbols ())
1735 throw_error (NOT_FOUND_ERROR
,
1736 _("No symbol table is loaded. Use the \"file\" command."));
1737 throw_error (NOT_FOUND_ERROR
, _("Function \"%s\" not defined."), copy
);
1743 /* Now come some functions that are called from multiple places within
1746 /* We've found a symbol SYM to associate with our linespec; build a
1747 corresponding struct symtabs_and_lines. */
1749 static struct symtabs_and_lines
1750 symbol_found (int funfirstline
, char ***canonical
, char *copy
,
1751 struct symbol
*sym
, struct symtab
*file_symtab
)
1753 struct symtabs_and_lines values
;
1755 if (SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1757 /* Arg is the name of a function */
1758 values
.sals
= (struct symtab_and_line
*)
1759 xmalloc (sizeof (struct symtab_and_line
));
1760 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1763 /* Don't use the SYMBOL_LINE; if used at all it points to
1764 the line containing the parameters or thereabouts, not
1765 the first line of code. */
1767 /* We might need a canonical line spec if it is a static
1769 if (file_symtab
== 0)
1771 struct blockvector
*bv
= BLOCKVECTOR (SYMBOL_SYMTAB (sym
));
1772 struct block
*b
= BLOCKVECTOR_BLOCK (bv
, STATIC_BLOCK
);
1773 if (lookup_block_symbol (b
, copy
, NULL
, VAR_DOMAIN
) != NULL
)
1774 build_canonical_line_spec (values
.sals
, copy
, canonical
);
1781 error (_("\"%s\" is not a function"), copy
);
1782 else if (SYMBOL_LINE (sym
) != 0)
1784 /* We know its line number. */
1785 values
.sals
= (struct symtab_and_line
*)
1786 xmalloc (sizeof (struct symtab_and_line
));
1788 memset (&values
.sals
[0], 0, sizeof (values
.sals
[0]));
1789 values
.sals
[0].symtab
= SYMBOL_SYMTAB (sym
);
1790 values
.sals
[0].line
= SYMBOL_LINE (sym
);
1794 /* This can happen if it is compiled with a compiler which doesn't
1795 put out line numbers for variables. */
1796 /* FIXME: Shouldn't we just set .line and .symtab to zero
1797 and return? For example, "info line foo" could print
1799 error (_("Line number not known for symbol \"%s\""), copy
);
1803 /* We've found a minimal symbol MSYMBOL to associate with our
1804 linespec; build a corresponding struct symtabs_and_lines. */
1806 static struct symtabs_and_lines
1807 minsym_found (int funfirstline
, struct minimal_symbol
*msymbol
)
1809 struct objfile
*objfile
= msymbol_objfile (msymbol
);
1810 struct gdbarch
*gdbarch
= get_objfile_arch (objfile
);
1811 struct symtabs_and_lines values
;
1814 values
.sals
= (struct symtab_and_line
*)
1815 xmalloc (sizeof (struct symtab_and_line
));
1816 values
.sals
[0] = find_pc_sect_line (SYMBOL_VALUE_ADDRESS (msymbol
),
1817 (struct obj_section
*) 0, 0);
1818 values
.sals
[0].section
= SYMBOL_OBJ_SECTION (msymbol
);
1820 /* The minimal symbol might point to a function descriptor;
1821 resolve it to the actual code address instead. */
1822 pc
= gdbarch_convert_from_func_ptr_addr (gdbarch
,
1825 if (pc
!= values
.sals
[0].pc
)
1826 values
.sals
[0] = find_pc_sect_line (pc
, NULL
, 0);
1830 struct symtab_and_line sal
;
1832 values
.sals
[0].pc
= find_function_start_pc (gdbarch
,
1834 values
.sals
[0].section
);
1836 sal
= find_pc_sect_line (values
.sals
[0].pc
, values
.sals
[0].section
, 0);
1838 /* Check if SKIP_PROLOGUE left us in mid-line, and the next
1839 line is still part of the same function. If there is no
1840 line information here, sal.pc will be the passed in PC. */
1841 if (sal
.pc
!= values
.sals
[0].pc
1842 && (lookup_minimal_symbol_by_pc_section (values
.sals
[0].pc
,
1843 values
.sals
[0].section
)
1844 == lookup_minimal_symbol_by_pc_section (sal
.end
,
1845 values
.sals
[0].section
)))
1846 /* Recalculate the line number (might not be N+1). */
1847 values
.sals
[0] = find_pc_sect_line (sal
.end
, values
.sals
[0].section
, 0);
This page took 0.082341 seconds and 4 git commands to generate.