1 /* Parser for linespec for the GNU debugger, GDB.
2 Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995,
3 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004
4 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
32 #include "completer.h"
34 #include "parser-defs.h"
36 #include "objc-lang.h"
39 /* We share this one with symtab.c, but it is not exported widely. */
41 extern char *operator_chars (char *, char **);
43 /* Prototypes for local functions */
45 static void initialize_defaults (struct symtab
**default_symtab
,
48 static void set_flags (char *arg
, int *is_quoted
, char **paren_pointer
);
50 static struct symtabs_and_lines
decode_indirect (char **argptr
);
52 static char *locate_first_half (char **argptr
, int *is_quote_enclosed
);
54 static struct symtabs_and_lines
decode_objc (char **argptr
,
56 struct symtab
*file_symtab
,
60 static struct symtabs_and_lines
decode_compound (char **argptr
,
66 static struct symbol
*lookup_prefix_sym (char **argptr
, char *p
);
68 static struct symtabs_and_lines
find_method (int funfirstline
,
73 struct symbol
*sym_class
);
75 static int collect_methods (char *copy
, struct type
*t
,
76 struct symbol
**sym_arr
);
78 static NORETURN
void cplusplus_error (const char *name
,
80 ATTR_NORETURN
ATTR_FORMAT (printf
, 2, 3);
82 static int total_number_of_methods (struct type
*type
);
84 static int find_methods (struct type
*, char *, struct symbol
**);
86 static int add_matching_methods (int method_counter
, struct type
*t
,
87 struct symbol
**sym_arr
);
89 static int add_constructors (int method_counter
, struct type
*t
,
90 struct symbol
**sym_arr
);
92 static void build_canonical_line_spec (struct symtab_and_line
*,
95 static char *find_toplevel_char (char *s
, char c
);
97 static int is_objc_method_format (const char *s
);
99 static struct symtabs_and_lines
decode_line_2 (struct symbol
*[],
102 static struct symtab
*symtab_from_filename (char **argptr
,
103 char *p
, int is_quote_enclosed
,
107 symtabs_and_lines
decode_all_digits (char **argptr
,
108 struct symtab
*default_symtab
,
111 struct symtab
*file_symtab
,
114 static struct symtabs_and_lines
decode_dollar (char *copy
,
116 struct symtab
*default_symtab
,
118 struct symtab
*file_symtab
);
120 static struct symtabs_and_lines
decode_variable (char *copy
,
123 struct symtab
*file_symtab
,
127 symtabs_and_lines
symbol_found (int funfirstline
,
131 struct symtab
*file_symtab
,
132 struct symtab
*sym_symtab
);
135 symtabs_and_lines
minsym_found (int funfirstline
,
136 struct minimal_symbol
*msymbol
);
138 /* Helper functions. */
140 /* Issue a helpful hint on using the command completion feature on
141 single quoted demangled C++ symbols as part of the completion
145 cplusplus_error (const char *name
, const char *fmt
, ...)
147 struct ui_file
*tmp_stream
;
148 tmp_stream
= mem_fileopen ();
149 make_cleanup_ui_file_delete (tmp_stream
);
153 va_start (args
, fmt
);
154 vfprintf_unfiltered (tmp_stream
, fmt
, args
);
158 while (*name
== '\'')
160 fprintf_unfiltered (tmp_stream
,
161 ("Hint: try '%s<TAB> or '%s<ESC-?>\n"
162 "(Note leading single quote.)"),
164 error_stream (tmp_stream
);
167 /* Return the number of methods described for TYPE, including the
168 methods from types it derives from. This can't be done in the symbol
169 reader because the type of the baseclass might still be stubbed
170 when the definition of the derived class is parsed. */
173 total_number_of_methods (struct type
*type
)
178 CHECK_TYPEDEF (type
);
179 if (TYPE_CPLUS_SPECIFIC (type
) == NULL
)
181 count
= TYPE_NFN_FIELDS_TOTAL (type
);
183 for (n
= 0; n
< TYPE_N_BASECLASSES (type
); n
++)
184 count
+= total_number_of_methods (TYPE_BASECLASS (type
, n
));
189 /* Recursive helper function for decode_line_1.
190 Look for methods named NAME in type T.
191 Return number of matches.
192 Put matches in SYM_ARR, which should have been allocated with
193 a size of total_number_of_methods (T) * sizeof (struct symbol *).
194 Note that this function is g++ specific. */
197 find_methods (struct type
*t
, char *name
, struct symbol
**sym_arr
)
201 char *class_name
= type_name_no_tag (t
);
203 /* Ignore this class if it doesn't have a name. This is ugly, but
204 unless we figure out how to get the physname without the name of
205 the class, then the loop can't do any good. */
207 && (lookup_symbol (class_name
, (struct block
*) NULL
,
208 STRUCT_DOMAIN
, (int *) NULL
,
209 (struct symtab
**) NULL
)))
212 int name_len
= strlen (name
);
216 /* Loop over each method name. At this level, all overloads of a name
217 are counted as a single name. There is an inner loop which loops over
220 for (method_counter
= TYPE_NFN_FIELDS (t
) - 1;
224 char *method_name
= TYPE_FN_FIELDLIST_NAME (t
, method_counter
);
227 if (strncmp (method_name
, "__", 2) == 0 ||
228 strncmp (method_name
, "op", 2) == 0 ||
229 strncmp (method_name
, "type", 4) == 0)
231 if (cplus_demangle_opname (method_name
, dem_opname
, DMGL_ANSI
))
232 method_name
= dem_opname
;
233 else if (cplus_demangle_opname (method_name
, dem_opname
, 0))
234 method_name
= dem_opname
;
237 if (strcmp_iw (name
, method_name
) == 0)
238 /* Find all the overloaded methods with that name. */
239 i1
+= add_matching_methods (method_counter
, t
,
241 else if (strncmp (class_name
, name
, name_len
) == 0
242 && (class_name
[name_len
] == '\0'
243 || class_name
[name_len
] == '<'))
244 i1
+= add_constructors (method_counter
, t
,
249 /* Only search baseclasses if there is no match yet, since names in
250 derived classes override those in baseclasses.
252 FIXME: The above is not true; it is only true of member functions
253 if they have the same number of arguments (??? - section 13.1 of the
254 ARM says the function members are not in the same scope but doesn't
255 really spell out the rules in a way I understand. In any case, if
256 the number of arguments differ this is a case in which we can overload
257 rather than hiding without any problem, and gcc 2.4.5 does overload
258 rather than hiding in this case). */
261 for (ibase
= 0; ibase
< TYPE_N_BASECLASSES (t
); ibase
++)
262 i1
+= find_methods (TYPE_BASECLASS (t
, ibase
), name
, sym_arr
+ i1
);
267 /* Add the symbols associated to methods of the class whose type is T
268 and whose name matches the method indexed by METHOD_COUNTER in the
269 array SYM_ARR. Return the number of methods added. */
272 add_matching_methods (int method_counter
, struct type
*t
,
273 struct symbol
**sym_arr
)
278 for (field_counter
= TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
285 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
287 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
291 tmp_name
= gdb_mangle_name (t
,
294 phys_name
= alloca (strlen (tmp_name
) + 1);
295 strcpy (phys_name
, tmp_name
);
299 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
301 /* Destructor is handled by caller, don't add it to
303 if (is_destructor_name (phys_name
) != 0)
306 sym_arr
[i1
] = lookup_symbol (phys_name
,
309 (struct symtab
**) NULL
);
314 /* This error message gets printed, but the method
315 still seems to be found
316 fputs_filtered("(Cannot find method ", gdb_stdout);
317 fprintf_symbol_filtered (gdb_stdout, phys_name,
319 DMGL_PARAMS | DMGL_ANSI);
320 fputs_filtered(" - possibly inlined.)\n", gdb_stdout);
328 /* Add the symbols associated to constructors of the class whose type
329 is CLASS_TYPE and which are indexed by by METHOD_COUNTER to the
330 array SYM_ARR. Return the number of methods added. */
333 add_constructors (int method_counter
, struct type
*t
,
334 struct symbol
**sym_arr
)
339 /* For GCC 3.x and stabs, constructors and destructors
340 have names like __base_ctor and __complete_dtor.
341 Check the physname for now if we're looking for a
344 = TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
351 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
353 /* GCC 3.x will never produce stabs stub methods, so
354 we don't need to handle this case. */
355 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
357 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
358 if (! is_constructor_name (phys_name
))
361 /* If this method is actually defined, include it in the
363 sym_arr
[i1
] = lookup_symbol (phys_name
,
366 (struct symtab
**) NULL
);
374 /* Helper function for decode_line_1.
375 Build a canonical line spec in CANONICAL if it is non-NULL and if
376 the SAL has a symtab.
377 If SYMNAME is non-NULL the canonical line spec is `filename:symname'.
378 If SYMNAME is NULL the line number from SAL is used and the canonical
379 line spec is `filename:linenum'. */
382 build_canonical_line_spec (struct symtab_and_line
*sal
, char *symname
,
385 char **canonical_arr
;
386 char *canonical_name
;
388 struct symtab
*s
= sal
->symtab
;
390 if (s
== (struct symtab
*) NULL
391 || s
->filename
== (char *) NULL
392 || canonical
== (char ***) NULL
)
395 canonical_arr
= (char **) xmalloc (sizeof (char *));
396 *canonical
= canonical_arr
;
398 filename
= s
->filename
;
401 canonical_name
= xmalloc (strlen (filename
) + strlen (symname
) + 2);
402 sprintf (canonical_name
, "%s:%s", filename
, symname
);
406 canonical_name
= xmalloc (strlen (filename
) + 30);
407 sprintf (canonical_name
, "%s:%d", filename
, sal
->line
);
409 canonical_arr
[0] = canonical_name
;
414 /* Find an instance of the character C in the string S that is outside
415 of all parenthesis pairs, single-quoted strings, and double-quoted
416 strings. Also, ignore the char within a template name, like a ','
417 within foo<int, int>. */
420 find_toplevel_char (char *s
, char c
)
422 int quoted
= 0; /* zero if we're not in quotes;
423 '"' if we're in a double-quoted string;
424 '\'' if we're in a single-quoted string. */
425 int depth
= 0; /* Number of unclosed parens we've seen. */
428 for (scan
= s
; *scan
; scan
++)
434 else if (*scan
== '\\' && *(scan
+ 1))
437 else if (*scan
== c
&& ! quoted
&& depth
== 0)
439 else if (*scan
== '"' || *scan
== '\'')
441 else if (*scan
== '(' || *scan
== '<')
443 else if ((*scan
== ')' || *scan
== '>') && depth
> 0)
450 /* Determines if the gives string corresponds to an Objective-C method
451 representation, such as -[Foo bar:] or +[Foo bar]. Objective-C symbols
452 are allowed to have spaces and parentheses in them. */
455 is_objc_method_format (const char *s
)
457 if (s
== NULL
|| *s
== '\0')
459 /* Handle arguments with the format FILENAME:SYMBOL. */
460 if ((s
[0] == ':') && (strchr ("+-", s
[1]) != NULL
)
461 && (s
[2] == '[') && strchr(s
, ']'))
463 /* Handle arguments that are just SYMBOL. */
464 else if ((strchr ("+-", s
[0]) != NULL
) && (s
[1] == '[') && strchr(s
, ']'))
469 /* Given a list of NELTS symbols in SYM_ARR, return a list of lines to
470 operate on (ask user if necessary).
471 If CANONICAL is non-NULL return a corresponding array of mangled names
472 as canonical line specs there. */
474 static struct symtabs_and_lines
475 decode_line_2 (struct symbol
*sym_arr
[], int nelts
, int funfirstline
,
478 struct symtabs_and_lines values
, return_values
;
483 struct cleanup
*old_chain
;
484 char **canonical_arr
= (char **) NULL
;
486 values
.sals
= (struct symtab_and_line
*)
487 alloca (nelts
* sizeof (struct symtab_and_line
));
488 return_values
.sals
= (struct symtab_and_line
*)
489 xmalloc (nelts
* sizeof (struct symtab_and_line
));
490 old_chain
= make_cleanup (xfree
, return_values
.sals
);
494 canonical_arr
= (char **) xmalloc (nelts
* sizeof (char *));
495 make_cleanup (xfree
, canonical_arr
);
496 memset (canonical_arr
, 0, nelts
* sizeof (char *));
497 *canonical
= canonical_arr
;
501 printf_unfiltered ("[0] cancel\n[1] all\n");
504 init_sal (&return_values
.sals
[i
]); /* Initialize to zeroes. */
505 init_sal (&values
.sals
[i
]);
506 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
508 values
.sals
[i
] = find_function_start_sal (sym_arr
[i
], funfirstline
);
509 if (values
.sals
[i
].symtab
)
510 printf_unfiltered ("[%d] %s at %s:%d\n",
512 SYMBOL_PRINT_NAME (sym_arr
[i
]),
513 values
.sals
[i
].symtab
->filename
,
514 values
.sals
[i
].line
);
516 printf_unfiltered ("[%d] %s at ?FILE:%d [No symtab? Probably broken debug info...]\n",
518 SYMBOL_PRINT_NAME (sym_arr
[i
]),
519 values
.sals
[i
].line
);
523 printf_unfiltered ("?HERE\n");
527 prompt
= getenv ("PS2");
532 args
= command_line_input (prompt
, 0, "overload-choice");
534 if (args
== 0 || *args
== 0)
535 error_no_arg ("one or more choice numbers");
543 while (*arg1
>= '0' && *arg1
<= '9')
545 if (*arg1
&& *arg1
!= ' ' && *arg1
!= '\t')
546 error ("Arguments must be choice numbers.");
556 for (i
= 0; i
< nelts
; i
++)
558 if (canonical_arr
[i
] == NULL
)
560 symname
= DEPRECATED_SYMBOL_NAME (sym_arr
[i
]);
561 canonical_arr
[i
] = savestring (symname
, strlen (symname
));
565 memcpy (return_values
.sals
, values
.sals
,
566 (nelts
* sizeof (struct symtab_and_line
)));
567 return_values
.nelts
= nelts
;
568 discard_cleanups (old_chain
);
569 return return_values
;
572 if (num
>= nelts
+ 2)
574 printf_unfiltered ("No choice number %d.\n", num
);
579 if (values
.sals
[num
].pc
)
583 symname
= DEPRECATED_SYMBOL_NAME (sym_arr
[num
]);
584 make_cleanup (xfree
, symname
);
585 canonical_arr
[i
] = savestring (symname
, strlen (symname
));
587 return_values
.sals
[i
++] = values
.sals
[num
];
588 values
.sals
[num
].pc
= 0;
592 printf_unfiltered ("duplicate request for %d ignored.\n", num
);
597 while (*args
== ' ' || *args
== '\t')
600 return_values
.nelts
= i
;
601 discard_cleanups (old_chain
);
602 return return_values
;
605 /* The parser of linespec itself. */
607 /* Parse a string that specifies a line number.
608 Pass the address of a char * variable; that variable will be
609 advanced over the characters actually parsed.
613 LINENUM -- that line number in current file. PC returned is 0.
614 FILE:LINENUM -- that line in that file. PC returned is 0.
615 FUNCTION -- line number of openbrace of that function.
616 PC returned is the start of the function.
617 VARIABLE -- line number of definition of that variable.
619 FILE:FUNCTION -- likewise, but prefer functions in that file.
620 *EXPR -- line in which address EXPR appears.
622 This may all be followed by an "if EXPR", which we ignore.
624 FUNCTION may be an undebuggable function found in minimal symbol table.
626 If the argument FUNFIRSTLINE is nonzero, we want the first line
627 of real code inside a function when a function is specified, and it is
628 not OK to specify a variable or type to get its line number.
630 DEFAULT_SYMTAB specifies the file to use if none is specified.
631 It defaults to current_source_symtab.
632 DEFAULT_LINE specifies the line number to use for relative
633 line numbers (that start with signs). Defaults to current_source_line.
634 If CANONICAL is non-NULL, store an array of strings containing the canonical
635 line specs there if necessary. Currently overloaded member functions and
636 line numbers or static functions without a filename yield a canonical
637 line spec. The array and the line spec strings are allocated on the heap,
638 it is the callers responsibility to free them.
640 Note that it is possible to return zero for the symtab
641 if no file is validly specified. Callers must check that.
642 Also, the line number returned may be invalid.
644 If NOT_FOUND_PTR is not null, store a boolean true/false value at the location, based
645 on whether or not failure occurs due to an unknown function or file. In the case
646 where failure does occur due to an unknown function or file, do not issue an error
649 /* We allow single quotes in various places. This is a hideous
650 kludge, which exists because the completer can't yet deal with the
651 lack of single quotes. FIXME: write a linespec_completer which we
652 can use as appropriate instead of make_symbol_completion_list. */
654 struct symtabs_and_lines
655 decode_line_1 (char **argptr
, int funfirstline
, struct symtab
*default_symtab
,
656 int default_line
, char ***canonical
, int *not_found_ptr
)
660 /* If a file name is specified, this is its symtab. */
661 struct symtab
*file_symtab
= NULL
;
664 /* This is NULL if there are no parens in *ARGPTR, or a pointer to
665 the closing parenthesis if there are parens. */
667 /* This says whether or not something in *ARGPTR is quoted with
668 completer_quotes (i.e. with single quotes). */
670 /* Is part of *ARGPTR is enclosed in double quotes? */
671 int is_quote_enclosed
;
672 int is_objc_method
= 0;
673 char *saved_arg
= *argptr
;
678 /* Defaults have defaults. */
680 initialize_defaults (&default_symtab
, &default_line
);
682 /* See if arg is *PC. */
685 return decode_indirect (argptr
);
687 /* Set various flags. 'paren_pointer' is important for overload
688 checking, where we allow things like:
689 (gdb) break c::f(int)
692 set_flags (*argptr
, &is_quoted
, &paren_pointer
);
694 /* Check to see if it's a multipart linespec (with colons or
697 /* Locate the end of the first half of the linespec.
698 After the call, for instance, if the argptr string is "foo.c:123"
699 p will point at "123". If there is only one part, like "foo", p
700 will point to "". If this is a C++ name, like "A::B::foo", p will
701 point to "::B::foo". Argptr is not changed by this call. */
703 p
= locate_first_half (argptr
, &is_quote_enclosed
);
705 /* Check if this is an Objective-C method (anything that starts with
706 a '+' or '-' and a '['). */
707 if (is_objc_method_format (p
))
710 paren_pointer
= NULL
; /* Just a category name. Ignore it. */
713 /* Check if the symbol could be an Objective-C selector. */
716 struct symtabs_and_lines values
;
717 values
= decode_objc (argptr
, funfirstline
, NULL
,
718 canonical
, saved_arg
);
719 if (values
.sals
!= NULL
)
723 /* Does it look like there actually were two parts? */
725 if ((p
[0] == ':' || p
[0] == '.') && paren_pointer
== NULL
)
728 *argptr
= *argptr
+ 1;
730 /* Is it a C++ or Java compound data structure?
731 The check on p[1] == ':' is capturing the case of "::",
732 since p[0]==':' was checked above.
733 Note that the call to decode_compound does everything
734 for us, including the lookup on the symbol table, so we
737 if (p
[0] == '.' || p
[1] == ':')
738 return decode_compound (argptr
, funfirstline
, canonical
,
741 /* No, the first part is a filename; set s to be that file's
742 symtab. Also, move argptr past the filename. */
744 file_symtab
= symtab_from_filename (argptr
, p
, is_quote_enclosed
,
748 /* No one really seems to know why this was added. It certainly
749 breaks the command line, though, whenever the passed
750 name is of the form ClassName::Method. This bit of code
751 singles out the class name, and if funfirstline is set (for
752 example, you are setting a breakpoint at this function),
753 you get an error. This did not occur with earlier
754 verions, so I am ifdef'ing this out. 3/29/99 */
757 /* Check if what we have till now is a symbol name */
759 /* We may be looking at a template instantiation such
760 as "foo<int>". Check here whether we know about it,
761 instead of falling through to the code below which
762 handles ordinary function names, because that code
763 doesn't like seeing '<' and '>' in a name -- the
764 skip_quoted call doesn't go past them. So see if we
765 can figure it out right now. */
767 copy
= (char *) alloca (p
- *argptr
+ 1);
768 memcpy (copy
, *argptr
, p
- *argptr
);
769 copy
[p
- *argptr
] = '\000';
770 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0, &sym_symtab
);
773 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
774 return symbol_found (funfirstline
, canonical
, copy
, sym
,
777 /* Otherwise fall out from here and go to file/line spec
782 /* S is specified file's symtab, or 0 if no file specified.
783 arg no longer contains the file name. */
785 /* Check whether arg is all digits (and sign). */
788 if (*q
== '-' || *q
== '+')
790 while (*q
>= '0' && *q
<= '9')
793 if (q
!= *argptr
&& (*q
== 0 || *q
== ' ' || *q
== '\t' || *q
== ','))
794 /* We found a token consisting of all digits -- at least one digit. */
795 return decode_all_digits (argptr
, default_symtab
, default_line
,
796 canonical
, file_symtab
, q
);
798 /* Arg token is not digits => try it as a variable name
799 Find the next token (everything up to end or next whitespace). */
801 if (**argptr
== '$') /* May be a convenience variable. */
802 /* One or two $ chars possible. */
803 p
= skip_quoted (*argptr
+ (((*argptr
)[1] == '$') ? 2 : 1));
806 p
= skip_quoted (*argptr
);
808 error ("Unmatched single quote.");
810 else if (is_objc_method
)
812 /* allow word separators in method names for Obj-C */
813 p
= skip_quoted_chars (*argptr
, NULL
, "");
815 else if (paren_pointer
!= NULL
)
817 p
= paren_pointer
+ 1;
821 p
= skip_quoted (*argptr
);
824 copy
= (char *) alloca (p
- *argptr
+ 1);
825 memcpy (copy
, *argptr
, p
- *argptr
);
826 copy
[p
- *argptr
] = '\0';
829 && copy
[0] == copy
[p
- *argptr
- 1]
830 && strchr (get_gdb_completer_quote_characters (), copy
[0]) != NULL
)
832 copy
[p
- *argptr
- 1] = '\0';
835 while (*p
== ' ' || *p
== '\t')
839 /* If it starts with $: may be a legitimate variable or routine name
840 (e.g. HP-UX millicode routines such as $$dyncall), or it may
841 be history value, or it may be a convenience variable. */
844 return decode_dollar (copy
, funfirstline
, default_symtab
,
845 canonical
, file_symtab
);
847 /* Look up that token as a variable.
848 If file specified, use that file's per-file block to start with. */
850 return decode_variable (copy
, funfirstline
, canonical
,
851 file_symtab
, not_found_ptr
);
856 /* Now, more helper functions for decode_line_1. Some conventions
857 that these functions follow:
859 Decode_line_1 typically passes along some of its arguments or local
860 variables to the subfunctions. It passes the variables by
861 reference if they are modified by the subfunction, and by value
864 Some of the functions have side effects that don't arise from
865 variables that are passed by reference. In particular, if a
866 function is passed ARGPTR as an argument, it modifies what ARGPTR
867 points to; typically, it advances *ARGPTR past whatever substring
868 it has just looked at. (If it doesn't modify *ARGPTR, then the
869 function gets passed *ARGPTR instead, which is then called ARG: see
870 set_flags, for example.) Also, functions that return a struct
871 symtabs_and_lines may modify CANONICAL, as in the description of
874 If a function returns a struct symtabs_and_lines, then that struct
875 will immediately make its way up the call chain to be returned by
876 decode_line_1. In particular, all of the functions decode_XXX
877 calculate the appropriate struct symtabs_and_lines, under the
878 assumption that their argument is of the form XXX. */
880 /* First, some functions to initialize stuff at the beggining of the
884 initialize_defaults (struct symtab
**default_symtab
, int *default_line
)
886 if (*default_symtab
== 0)
888 /* Use whatever we have for the default source line. We don't use
889 get_current_or_default_symtab_and_line as it can recurse and call
891 struct symtab_and_line cursal
=
892 get_current_source_symtab_and_line ();
894 *default_symtab
= cursal
.symtab
;
895 *default_line
= cursal
.line
;
900 set_flags (char *arg
, int *is_quoted
, char **paren_pointer
)
905 /* 'has_if' is for the syntax:
906 (gdb) break foo if (a==b)
908 if ((ii
= strstr (arg
, " if ")) != NULL
||
909 (ii
= strstr (arg
, "\tif ")) != NULL
||
910 (ii
= strstr (arg
, " if\t")) != NULL
||
911 (ii
= strstr (arg
, "\tif\t")) != NULL
||
912 (ii
= strstr (arg
, " if(")) != NULL
||
913 (ii
= strstr (arg
, "\tif( ")) != NULL
)
915 /* Temporarily zap out "if (condition)" to not confuse the
916 parenthesis-checking code below. This is undone below. Do not
924 && strchr (get_gdb_completer_quote_characters (),
927 *paren_pointer
= strchr (arg
, '(');
928 if (*paren_pointer
!= NULL
)
929 *paren_pointer
= strrchr (*paren_pointer
, ')');
931 /* Now that we're safely past the paren_pointer check, put back " if
932 (condition)" so outer layers can see it. */
939 /* Decode arg of the form *PC. */
941 static struct symtabs_and_lines
942 decode_indirect (char **argptr
)
944 struct symtabs_and_lines values
;
948 pc
= parse_and_eval_address_1 (argptr
);
950 values
.sals
= (struct symtab_and_line
*)
951 xmalloc (sizeof (struct symtab_and_line
));
954 values
.sals
[0] = find_pc_line (pc
, 0);
955 values
.sals
[0].pc
= pc
;
956 values
.sals
[0].section
= find_pc_overlay (pc
);
963 /* Locate the first half of the linespec, ending in a colon, period,
964 or whitespace. (More or less.) Also, check to see if *ARGPTR is
965 enclosed in double quotes; if so, set is_quote_enclosed, advance
966 ARGPTR past that and zero out the trailing double quote.
967 If ARGPTR is just a simple name like "main", p will point to ""
971 locate_first_half (char **argptr
, int *is_quote_enclosed
)
977 /* Maybe we were called with a line range FILENAME:LINENUM,FILENAME:LINENUM
978 and we must isolate the first half. Outer layers will call again later
981 Don't count commas that appear in argument lists of overloaded
982 functions, or in quoted strings. It's stupid to go to this much
983 trouble when the rest of the function is such an obvious roach hotel. */
984 ii
= find_toplevel_char (*argptr
, ',');
985 has_comma
= (ii
!= 0);
987 /* Temporarily zap out second half to not confuse the code below.
988 This is undone below. Do not change ii!! */
994 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION. May also be
995 CLASS::MEMBER, or NAMESPACE::NAME. Look for ':', but ignore
1001 *is_quote_enclosed
= 1;
1006 *is_quote_enclosed
= 0;
1011 char *temp_end
= find_template_name_end (p
);
1013 error ("malformed template specification in command");
1016 /* Check for a colon and a plus or minus and a [ (which
1017 indicates an Objective-C method) */
1018 if (is_objc_method_format (p
))
1022 /* Check for the end of the first half of the linespec. End of
1023 line, a tab, a double colon or the last single colon, or a
1024 space. But if enclosed in double quotes we do not break on
1029 && ((p
[1] == ':') || (strchr (p
+ 1, ':') == NULL
)))
1030 || ((p
[0] == ' ') && !*is_quote_enclosed
))
1032 if (p
[0] == '.' && strchr (p
, ':') == NULL
)
1034 /* Java qualified method. Find the *last* '.', since the
1035 others are package qualifiers. */
1036 for (p1
= p
; *p1
; p1
++)
1044 while (p
[0] == ' ' || p
[0] == '\t')
1047 /* If the closing double quote was left at the end, remove it. */
1048 if (*is_quote_enclosed
)
1050 char *closing_quote
= strchr (p
- 1, '"');
1051 if (closing_quote
&& closing_quote
[1] == '\0')
1052 *closing_quote
= '\0';
1055 /* Now that we've safely parsed the first half, put back ',' so
1056 outer layers can see it. */
1065 /* Here's where we recognise an Objective-C Selector. An Objective C
1066 selector may be implemented by more than one class, therefore it
1067 may represent more than one method/function. This gives us a
1068 situation somewhat analogous to C++ overloading. If there's more
1069 than one method that could represent the selector, then use some of
1070 the existing C++ code to let the user choose one. */
1072 struct symtabs_and_lines
1073 decode_objc (char **argptr
, int funfirstline
, struct symtab
*file_symtab
,
1074 char ***canonical
, char *saved_arg
)
1076 struct symtabs_and_lines values
;
1077 struct symbol
**sym_arr
= NULL
;
1078 struct symbol
*sym
= NULL
;
1080 struct block
*block
= NULL
;
1087 if (file_symtab
!= NULL
)
1088 block
= BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
), STATIC_BLOCK
);
1090 block
= get_selected_block (0);
1092 copy
= find_imps (file_symtab
, block
, *argptr
, NULL
, &i1
, &i2
);
1096 sym_arr
= (struct symbol
**) alloca ((i1
+ 1) * sizeof (struct symbol
*));
1099 copy
= find_imps (file_symtab
, block
, *argptr
, sym_arr
, &i1
, &i2
);
1103 /* i1 now represents the TOTAL number of matches found.
1104 i2 represents how many HIGH-LEVEL (struct symbol) matches,
1105 which will come first in the sym_arr array. Any low-level
1106 (minimal_symbol) matches will follow those. */
1112 /* Already a struct symbol. */
1117 sym
= find_pc_function (SYMBOL_VALUE_ADDRESS (sym_arr
[0]));
1118 if ((sym
!= NULL
) && strcmp (SYMBOL_LINKAGE_NAME (sym_arr
[0]), SYMBOL_LINKAGE_NAME (sym
)) != 0)
1120 warning ("debugging symbol \"%s\" does not match selector; ignoring", SYMBOL_LINKAGE_NAME (sym
));
1125 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof (struct symtab_and_line
));
1128 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1130 /* Canonicalize this, so it remains resolved for dylib loads. */
1131 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1132 build_canonical_line_spec (values
.sals
, SYMBOL_NATURAL_NAME (sym
), canonical
);
1136 /* The only match was a non-debuggable symbol. */
1137 values
.sals
[0].symtab
= 0;
1138 values
.sals
[0].line
= 0;
1139 values
.sals
[0].end
= 0;
1140 values
.sals
[0].pc
= SYMBOL_VALUE_ADDRESS (sym_arr
[0]);
1147 /* More than one match. The user must choose one or more. */
1148 return decode_line_2 (sym_arr
, i2
, funfirstline
, canonical
);
1154 /* This handles C++ and Java compound data structures. P should point
1155 at the first component separator, i.e. double-colon or period. As
1156 an example, on entrance to this function we could have ARGPTR
1157 pointing to "AAA::inA::fun" and P pointing to "::inA::fun". */
1159 static struct symtabs_and_lines
1160 decode_compound (char **argptr
, int funfirstline
, char ***canonical
,
1161 char *saved_arg
, char *p
)
1163 struct symtabs_and_lines values
;
1165 char *saved_arg2
= *argptr
;
1168 /* The symtab that SYM was found in. */
1169 struct symtab
*sym_symtab
;
1171 struct symbol
*sym_class
;
1172 struct symbol
**sym_arr
;
1175 /* First check for "global" namespace specification, of the form
1176 "::foo". If found, skip over the colons and jump to normal
1177 symbol processing. I.e. the whole line specification starts with
1178 "::" (note the condition that *argptr == p). */
1180 && ((*argptr
== p
) || (p
[-1] == ' ') || (p
[-1] == '\t')))
1183 /* We have what looks like a class or namespace
1184 scope specification (A::B), possibly with many
1185 levels of namespaces or classes (A::B::C::D).
1187 Some versions of the HP ANSI C++ compiler (as also possibly
1188 other compilers) generate class/function/member names with
1189 embedded double-colons if they are inside namespaces. To
1190 handle this, we loop a few times, considering larger and
1191 larger prefixes of the string as though they were single
1192 symbols. So, if the initially supplied string is
1193 A::B::C::D::foo, we have to look up "A", then "A::B",
1194 then "A::B::C", then "A::B::C::D", and finally
1195 "A::B::C::D::foo" as single, monolithic symbols, because
1196 A, B, C or D may be namespaces.
1198 Note that namespaces can nest only inside other
1199 namespaces, and not inside classes. So we need only
1200 consider *prefixes* of the string; there is no need to look up
1201 "B::C" separately as a symbol in the previous example. */
1203 p2
= p
; /* Save for restart. */
1205 /* This is very messy. Following the example above we have now the
1208 argptr -> "AAA::inA::fun
1209 saved_arg -> "AAA::inA::fun
1210 saved_arg2 -> "AAA::inA::fun
1211 p2 -> "::inA::fun". */
1213 /* In the loop below, with these strings, we'll make 2 passes, each
1214 is marked in comments.*/
1219 /* Start of lookup in the symbol tables. */
1221 /* Lookup in the symbol table the substring between argptr and
1222 p. Note, this call changes the value of argptr. */
1223 /* PASS1: Before the call, argptr->"AAA::inA::fun",
1224 p->"::inA::fun". After the call: argptr->"inA::fun", p
1226 /* PASS2: Before the call, argptr->"AAA::inA::fun", p->"::fun".
1227 After the call: argptr->"fun", p->"::fun". */
1228 sym_class
= lookup_prefix_sym (argptr
, p
);
1230 /* PASS1: assume sym_class == NULL. Skip the whole if-stmt. */
1231 /* PASS2: assume sym_class has been found, i.e. "AAA::inA" is a
1232 class. Enter the if-stmt. */
1234 (t
= check_typedef (SYMBOL_TYPE (sym_class
)),
1235 (TYPE_CODE (t
) == TYPE_CODE_STRUCT
1236 || TYPE_CODE (t
) == TYPE_CODE_UNION
)))
1238 /* Arg token is not digits => try it as a function name.
1239 Find the next token (everything up to end or next
1242 && strchr (get_gdb_completer_quote_characters (),
1245 p
= skip_quoted (*argptr
);
1246 *argptr
= *argptr
+ 1;
1250 /* PASS2: at this point argptr->"fun". */
1252 while (*p
&& *p
!= ' ' && *p
!= '\t' && *p
!= ',' && *p
!= ':')
1254 /* PASS2: at this point p->"". String ended. */
1257 /* Allocate our own copy of the substring between argptr and
1259 copy
= (char *) alloca (p
- *argptr
+ 1);
1260 memcpy (copy
, *argptr
, p
- *argptr
);
1261 copy
[p
- *argptr
] = '\0';
1263 && copy
[p
- *argptr
- 1]
1264 && strchr (get_gdb_completer_quote_characters (),
1265 copy
[p
- *argptr
- 1]) != NULL
)
1266 copy
[p
- *argptr
- 1] = '\0';
1268 /* PASS2: At this point copy->"fun", p->"" */
1270 /* No line number may be specified. */
1271 while (*p
== ' ' || *p
== '\t')
1275 /* Look for copy as a method of sym_class. */
1276 /* PASS2: at this point copy->"fun", sym_class is "AAA:inA".
1277 This concludes the scanning of the string for possible
1278 components matches. If we find it here, we return. If
1279 not, and we are at the and of the string, we'll get out
1280 of the loop and lookup the whole string in the symbol
1283 return find_method (funfirstline
, canonical
, saved_arg
,
1284 copy
, t
, sym_class
);
1285 } /* End if symbol found */
1287 /* End of lookup in the symbol tables. */
1289 /* Prepare for next run through the loop. */
1290 /* Move pointer up to next possible class/namespace token. */
1292 p
= p2
+ 1; /* Restart with old value +1. */
1294 /* PASS1: at this point p2->"::inA::fun", so p->":inA::fun",
1295 i.e. if there is a double-colon, p will now point to the
1298 /* Move pointer ahead to next double-colon. */
1299 while (*p
&& (p
[0] != ' ') && (p
[0] != '\t') && (p
[0] != '\''))
1303 temp_end
= find_template_name_end (p
);
1305 error ("malformed template specification in command");
1308 /* Note that, since, at the start of this loop, p would be
1309 pointing to the second colon in a double-colon, we only
1310 satisfy the condition below if there is another
1311 double-colon to the right (after). I.e. there is another
1312 component that can be a class or a namespace. I.e, if at
1313 the beginning of this loop (PASS1), we had
1314 p->":inA::fun", we'll trigger this when p has been
1315 advanced to point to "::fun". */
1316 else if ((p
[0] == ':') && (p
[1] == ':'))
1317 break; /* Found double-colon. */
1323 break; /* Out of the while (1). This would happen
1324 for instance if we have looked up
1325 unsuccessfully all the components of the
1326 string, and p->"". */
1328 /* We get here if p points to ' ', '\t', '\'', "::" or ""(i.e
1330 /* Save restart for next time around. */
1332 /* Restore argptr as it was on entry to this function. */
1333 *argptr
= saved_arg2
;
1334 /* PASS1: at this point p->"::fun" argptr->"AAA::inA::fun". */
1336 /* All ready for next pass through the loop. */
1339 /* Last chance attempt -- check entire name as a symbol. Use "copy"
1340 in preparation for jumping out of this block, to be consistent
1341 with usage following the jump target. */
1342 copy
= (char *) alloca (p
- saved_arg2
+ 1);
1343 memcpy (copy
, saved_arg2
, p
- saved_arg2
);
1344 /* Note: if is_quoted should be true, we snuff out quote here
1346 copy
[p
- saved_arg2
] = '\000';
1347 /* Set argptr to skip over the name. */
1348 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
1350 /* Look up entire name */
1351 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0, &sym_symtab
);
1353 return symbol_found (funfirstline
, canonical
, copy
, sym
,
1356 /* Couldn't find any interpretation as classes/namespaces, so give
1357 up. The quotes are important if copy is empty. */
1358 cplusplus_error (saved_arg
,
1359 "Can't find member of namespace, class, struct, or union named \"%s\"\n",
1363 /* Next come some helper functions for decode_compound. */
1365 /* Return the symbol corresponding to the substring of *ARGPTR ending
1366 at P, allowing whitespace. Also, advance *ARGPTR past the symbol
1367 name in question, the compound object separator ("::" or "."), and
1368 whitespace. Note that *ARGPTR is changed whether or not the
1369 lookup_symbol call finds anything (i.e we return NULL). As an
1370 example, say ARGPTR is "AAA::inA::fun" and P is "::inA::fun". */
1372 static struct symbol
*
1373 lookup_prefix_sym (char **argptr
, char *p
)
1378 /* Extract the class name. */
1380 while (p
!= *argptr
&& p
[-1] == ' ')
1382 copy
= (char *) alloca (p
- *argptr
+ 1);
1383 memcpy (copy
, *argptr
, p
- *argptr
);
1384 copy
[p
- *argptr
] = 0;
1386 /* Discard the class name from the argptr. */
1387 p
= p1
+ (p1
[0] == ':' ? 2 : 1);
1388 while (*p
== ' ' || *p
== '\t')
1392 /* At this point p1->"::inA::fun", p->"inA::fun" copy->"AAA",
1393 argptr->"inA::fun" */
1395 return lookup_symbol (copy
, 0, STRUCT_DOMAIN
, 0,
1396 (struct symtab
**) NULL
);
1399 /* This finds the method COPY in the class whose type is T and whose
1400 symbol is SYM_CLASS. */
1402 static struct symtabs_and_lines
1403 find_method (int funfirstline
, char ***canonical
, char *saved_arg
,
1404 char *copy
, struct type
*t
, struct symbol
*sym_class
)
1406 struct symtabs_and_lines values
;
1407 struct symbol
*sym
= 0;
1408 int i1
; /* Counter for the symbol array. */
1409 struct symbol
**sym_arr
= alloca (total_number_of_methods (t
)
1410 * sizeof (struct symbol
*));
1412 /* Find all methods with a matching name, and put them in
1415 i1
= collect_methods (copy
, t
, sym_arr
);
1419 /* There is exactly one field with that name. */
1422 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1424 values
.sals
= (struct symtab_and_line
*)
1425 xmalloc (sizeof (struct symtab_and_line
));
1427 values
.sals
[0] = find_function_start_sal (sym
,
1438 /* There is more than one field with that name
1439 (overloaded). Ask the user which one to use. */
1440 return decode_line_2 (sym_arr
, i1
, funfirstline
, canonical
);
1446 if (is_operator_name (copy
))
1448 tmp
= (char *) alloca (strlen (copy
+ 3) + 9);
1449 strcpy (tmp
, "operator ");
1450 strcat (tmp
, copy
+ 3);
1455 cplusplus_error (saved_arg
,
1456 "the class `%s' does not have destructor defined\n",
1457 SYMBOL_PRINT_NAME (sym_class
));
1459 cplusplus_error (saved_arg
,
1460 "the class %s does not have any method named %s\n",
1461 SYMBOL_PRINT_NAME (sym_class
), tmp
);
1465 /* Find all methods named COPY in the class whose type is T, and put
1466 them in SYM_ARR. Return the number of methods found. */
1469 collect_methods (char *copy
, struct type
*t
,
1470 struct symbol
**sym_arr
)
1472 int i1
= 0; /* Counter for the symbol array. */
1474 if (destructor_name_p (copy
, t
))
1476 /* Destructors are a special case. */
1477 int m_index
, f_index
;
1479 if (get_destructor_fn_field (t
, &m_index
, &f_index
))
1481 struct fn_field
*f
= TYPE_FN_FIELDLIST1 (t
, m_index
);
1484 lookup_symbol (TYPE_FN_FIELD_PHYSNAME (f
, f_index
),
1485 NULL
, VAR_DOMAIN
, (int *) NULL
,
1486 (struct symtab
**) NULL
);
1492 i1
= find_methods (t
, copy
, sym_arr
);
1499 /* Return the symtab associated to the filename given by the substring
1500 of *ARGPTR ending at P, and advance ARGPTR past that filename. If
1501 NOT_FOUND_PTR is not null and the source file is not found, store
1502 boolean true at the location pointed to and do not issue an
1505 static struct symtab
*
1506 symtab_from_filename (char **argptr
, char *p
, int is_quote_enclosed
,
1511 struct symtab
*file_symtab
;
1514 while (p
!= *argptr
&& p
[-1] == ' ')
1516 if ((*p
== '"') && is_quote_enclosed
)
1518 copy
= (char *) alloca (p
- *argptr
+ 1);
1519 memcpy (copy
, *argptr
, p
- *argptr
);
1520 /* It may have the ending quote right after the file name. */
1521 if (is_quote_enclosed
&& copy
[p
- *argptr
- 1] == '"')
1522 copy
[p
- *argptr
- 1] = 0;
1524 copy
[p
- *argptr
] = 0;
1526 /* Find that file's data. */
1527 file_symtab
= lookup_symtab (copy
);
1528 if (file_symtab
== 0)
1530 if (!have_full_symbols () && !have_partial_symbols ())
1531 error ("No symbol table is loaded. Use the \"file\" command.");
1535 /* The caller has indicated that it wishes quiet notification of any
1536 error where the function or file is not found. A call to
1537 error_silent causes an error to occur, but it does not issue
1538 the supplied message. The message can be manually output by
1539 the caller, if desired. This is used, for example, when
1540 attempting to set breakpoints for functions in shared libraries
1541 that have not yet been loaded. */
1542 error_silent ("No source file named %s.", copy
);
1544 error ("No source file named %s.", copy
);
1547 /* Discard the file name from the arg. */
1549 while (*p
== ' ' || *p
== '\t')
1558 /* This decodes a line where the argument is all digits (possibly
1559 preceded by a sign). Q should point to the end of those digits;
1560 the other arguments are as usual. */
1562 static struct symtabs_and_lines
1563 decode_all_digits (char **argptr
, struct symtab
*default_symtab
,
1564 int default_line
, char ***canonical
,
1565 struct symtab
*file_symtab
, char *q
)
1568 struct symtabs_and_lines values
;
1569 struct symtab_and_line val
;
1577 /* We might need a canonical line spec if no file was specified. */
1578 int need_canonical
= (file_symtab
== 0) ? 1 : 0;
1582 /* This is where we need to make sure that we have good defaults.
1583 We must guarantee that this section of code is never executed
1584 when we are called with just a function name, since
1585 set_default_source_symtab_and_line uses
1586 select_source_symtab that calls us with such an argument. */
1588 if (file_symtab
== 0 && default_symtab
== 0)
1590 /* Make sure we have at least a default source file. */
1591 set_default_source_symtab_and_line ();
1592 initialize_defaults (&default_symtab
, &default_line
);
1595 if (**argptr
== '+')
1596 sign
= plus
, (*argptr
)++;
1597 else if (**argptr
== '-')
1598 sign
= minus
, (*argptr
)++;
1599 val
.line
= atoi (*argptr
);
1605 if (file_symtab
== 0)
1606 val
.line
= default_line
+ val
.line
;
1611 if (file_symtab
== 0)
1612 val
.line
= default_line
- val
.line
;
1617 break; /* No need to adjust val.line. */
1620 while (*q
== ' ' || *q
== '\t')
1623 if (file_symtab
== 0)
1624 file_symtab
= default_symtab
;
1626 /* It is possible that this source file has more than one symtab,
1627 and that the new line number specification has moved us from the
1628 default (in file_symtab) to a new one. */
1629 val
.symtab
= find_line_symtab (file_symtab
, val
.line
, NULL
, NULL
);
1630 if (val
.symtab
== 0)
1631 val
.symtab
= file_symtab
;
1634 values
.sals
= (struct symtab_and_line
*)
1635 xmalloc (sizeof (struct symtab_and_line
));
1636 values
.sals
[0] = val
;
1639 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1645 /* Decode a linespec starting with a dollar sign. */
1647 static struct symtabs_and_lines
1648 decode_dollar (char *copy
, int funfirstline
, struct symtab
*default_symtab
,
1649 char ***canonical
, struct symtab
*file_symtab
)
1653 int need_canonical
= 0;
1654 struct symtabs_and_lines values
;
1655 struct symtab_and_line val
;
1658 /* The symtab that SYM was found in. */
1659 struct symtab
*sym_symtab
;
1660 struct minimal_symbol
*msymbol
;
1662 p
= (copy
[1] == '$') ? copy
+ 2 : copy
+ 1;
1663 while (*p
>= '0' && *p
<= '9')
1665 if (!*p
) /* Reached end of token without hitting non-digit. */
1667 /* We have a value history reference. */
1668 sscanf ((copy
[1] == '$') ? copy
+ 2 : copy
+ 1, "%d", &index
);
1669 valx
= access_value_history ((copy
[1] == '$') ? -index
: index
);
1670 if (TYPE_CODE (VALUE_TYPE (valx
)) != TYPE_CODE_INT
)
1671 error ("History values used in line specs must have integer values.");
1675 /* Not all digits -- may be user variable/function or a
1676 convenience variable. */
1678 /* Look up entire name as a symbol first. */
1679 sym
= lookup_symbol (copy
, 0, VAR_DOMAIN
, 0, &sym_symtab
);
1680 file_symtab
= (struct symtab
*) 0;
1682 /* Symbol was found --> jump to normal symbol processing. */
1684 return symbol_found (funfirstline
, canonical
, copy
, sym
,
1687 /* If symbol was not found, look in minimal symbol tables. */
1688 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1689 /* Min symbol was found --> jump to minsym processing. */
1691 return minsym_found (funfirstline
, msymbol
);
1693 /* Not a user variable or function -- must be convenience variable. */
1694 need_canonical
= (file_symtab
== 0) ? 1 : 0;
1695 valx
= value_of_internalvar (lookup_internalvar (copy
+ 1));
1696 if (TYPE_CODE (VALUE_TYPE (valx
)) != TYPE_CODE_INT
)
1697 error ("Convenience variables used in line specs must have integer values.");
1702 /* Either history value or convenience value from above, in valx. */
1703 val
.symtab
= file_symtab
? file_symtab
: default_symtab
;
1704 val
.line
= value_as_long (valx
);
1707 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof val
);
1708 values
.sals
[0] = val
;
1712 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1719 /* Decode a linespec that's a variable. If FILE_SYMTAB is non-NULL,
1720 look in that symtab's static variables first. If NOT_FOUND_PTR is not NULL and
1721 the function cannot be found, store boolean true in the location pointed to
1722 and do not issue an error message. */
1724 static struct symtabs_and_lines
1725 decode_variable (char *copy
, int funfirstline
, char ***canonical
,
1726 struct symtab
*file_symtab
, int *not_found_ptr
)
1729 /* The symtab that SYM was found in. */
1730 struct symtab
*sym_symtab
;
1732 struct minimal_symbol
*msymbol
;
1734 sym
= lookup_symbol (copy
,
1736 ? BLOCKVECTOR_BLOCK (BLOCKVECTOR (file_symtab
),
1738 : get_selected_block (0)),
1739 VAR_DOMAIN
, 0, &sym_symtab
);
1742 return symbol_found (funfirstline
, canonical
, copy
, sym
,
1743 file_symtab
, sym_symtab
);
1745 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1747 if (msymbol
!= NULL
)
1748 return minsym_found (funfirstline
, msymbol
);
1750 if (!have_full_symbols () &&
1751 !have_partial_symbols () && !have_minimal_symbols ())
1752 error ("No symbol table is loaded. Use the \"file\" command.");
1757 /* The caller has indicated that it wishes quiet notification of any
1758 error where the function or file is not found. A call to
1759 error_silent causes an error to occur, but it does not issue
1760 the supplied message. The message can be manually output by
1761 the caller, if desired. This is used, for example, when
1762 attempting to set breakpoints for functions in shared libraries
1763 that have not yet been loaded. */
1764 error_silent ("Function \"%s\" not defined.", copy
);
1767 error ("Function \"%s\" not defined.", copy
);
1773 /* Now come some functions that are called from multiple places within
1776 /* We've found a symbol SYM to associate with our linespec; build a
1777 corresponding struct symtabs_and_lines. */
1779 static struct symtabs_and_lines
1780 symbol_found (int funfirstline
, char ***canonical
, char *copy
,
1781 struct symbol
*sym
, struct symtab
*file_symtab
,
1782 struct symtab
*sym_symtab
)
1784 struct symtabs_and_lines values
;
1786 if (SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1788 /* Arg is the name of a function */
1789 values
.sals
= (struct symtab_and_line
*)
1790 xmalloc (sizeof (struct symtab_and_line
));
1791 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1794 /* Don't use the SYMBOL_LINE; if used at all it points to
1795 the line containing the parameters or thereabouts, not
1796 the first line of code. */
1798 /* We might need a canonical line spec if it is a static
1800 if (file_symtab
== 0)
1802 struct blockvector
*bv
= BLOCKVECTOR (sym_symtab
);
1803 struct block
*b
= BLOCKVECTOR_BLOCK (bv
, STATIC_BLOCK
);
1804 if (lookup_block_symbol (b
, copy
, NULL
, VAR_DOMAIN
) != NULL
)
1805 build_canonical_line_spec (values
.sals
, copy
, canonical
);
1812 error ("\"%s\" is not a function", copy
);
1813 else if (SYMBOL_LINE (sym
) != 0)
1815 /* We know its line number. */
1816 values
.sals
= (struct symtab_and_line
*)
1817 xmalloc (sizeof (struct symtab_and_line
));
1819 memset (&values
.sals
[0], 0, sizeof (values
.sals
[0]));
1820 values
.sals
[0].symtab
= sym_symtab
;
1821 values
.sals
[0].line
= SYMBOL_LINE (sym
);
1825 /* This can happen if it is compiled with a compiler which doesn't
1826 put out line numbers for variables. */
1827 /* FIXME: Shouldn't we just set .line and .symtab to zero
1828 and return? For example, "info line foo" could print
1830 error ("Line number not known for symbol \"%s\"", copy
);
1834 /* We've found a minimal symbol MSYMBOL to associate with our
1835 linespec; build a corresponding struct symtabs_and_lines. */
1837 static struct symtabs_and_lines
1838 minsym_found (int funfirstline
, struct minimal_symbol
*msymbol
)
1840 struct symtabs_and_lines values
;
1842 values
.sals
= (struct symtab_and_line
*)
1843 xmalloc (sizeof (struct symtab_and_line
));
1844 values
.sals
[0] = find_pc_sect_line (SYMBOL_VALUE_ADDRESS (msymbol
),
1845 (struct bfd_section
*) 0, 0);
1846 values
.sals
[0].section
= SYMBOL_BFD_SECTION (msymbol
);
1849 values
.sals
[0].pc
+= FUNCTION_START_OFFSET
;
1850 values
.sals
[0].pc
= SKIP_PROLOGUE (values
.sals
[0].pc
);