1 /* Parser for linespec for the GNU debugger, GDB.
2 Copyright 1986, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 2000
3 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
31 /* Prototype for one function in parser-defs.h,
32 instead of including that entire file. */
34 extern char *find_template_name_end (char *);
36 /* We share this one with symtab.c, but it is not exported widely. */
38 extern char *operator_chars (char *, char **);
40 /* Prototypes for local functions */
42 static void cplusplus_hint (char *name
);
44 static int total_number_of_methods (struct type
*type
);
46 static int find_methods (struct type
*, char *, struct symbol
**);
48 static void build_canonical_line_spec (struct symtab_and_line
*,
51 static char *find_toplevel_char (char *s
, char c
);
53 static struct symtabs_and_lines
decode_line_2 (struct symbol
*[],
56 /* Helper functions. */
58 /* While the C++ support is still in flux, issue a possibly helpful hint on
59 using the new command completion feature on single quoted demangled C++
60 symbols. Remove when loose ends are cleaned up. FIXME -fnf */
63 cplusplus_hint (char *name
)
67 printf_filtered ("Hint: try '%s<TAB> or '%s<ESC-?>\n", name
, name
);
68 printf_filtered ("(Note leading single quote.)\n");
71 /* Return the number of methods described for TYPE, including the
72 methods from types it derives from. This can't be done in the symbol
73 reader because the type of the baseclass might still be stubbed
74 when the definition of the derived class is parsed. */
77 total_number_of_methods (struct type
*type
)
83 if (TYPE_CPLUS_SPECIFIC (type
) == NULL
)
85 count
= TYPE_NFN_FIELDS_TOTAL (type
);
87 for (n
= 0; n
< TYPE_N_BASECLASSES (type
); n
++)
88 count
+= total_number_of_methods (TYPE_BASECLASS (type
, n
));
93 /* Recursive helper function for decode_line_1.
94 Look for methods named NAME in type T.
95 Return number of matches.
96 Put matches in SYM_ARR, which should have been allocated with
97 a size of total_number_of_methods (T) * sizeof (struct symbol *).
98 Note that this function is g++ specific. */
101 find_methods (struct type
*t
, char *name
, struct symbol
**sym_arr
)
105 struct symbol
*sym_class
;
106 char *class_name
= type_name_no_tag (t
);
108 /* Ignore this class if it doesn't have a name. This is ugly, but
109 unless we figure out how to get the physname without the name of
110 the class, then the loop can't do any good. */
112 && (sym_class
= lookup_symbol (class_name
,
113 (struct block
*) NULL
,
116 (struct symtab
**) NULL
)))
120 /* FIXME: Shouldn't this just be CHECK_TYPEDEF (t)? */
121 t
= SYMBOL_TYPE (sym_class
);
123 /* Loop over each method name. At this level, all overloads of a name
124 are counted as a single name. There is an inner loop which loops over
127 for (method_counter
= TYPE_NFN_FIELDS (t
) - 1;
132 char *method_name
= TYPE_FN_FIELDLIST_NAME (t
, method_counter
);
135 if (strncmp (method_name
, "__", 2) == 0 ||
136 strncmp (method_name
, "op", 2) == 0 ||
137 strncmp (method_name
, "type", 4) == 0)
139 if (cplus_demangle_opname (method_name
, dem_opname
, DMGL_ANSI
))
140 method_name
= dem_opname
;
141 else if (cplus_demangle_opname (method_name
, dem_opname
, 0))
142 method_name
= dem_opname
;
145 if (STREQ (name
, method_name
))
146 /* Find all the overloaded methods with that name. */
147 for (field_counter
= TYPE_FN_FIELDLIST_LENGTH (t
, method_counter
) - 1;
154 f
= TYPE_FN_FIELDLIST1 (t
, method_counter
);
156 if (TYPE_FN_FIELD_STUB (f
, field_counter
))
160 tmp_name
= gdb_mangle_name (t
,
163 phys_name
= alloca (strlen (tmp_name
) + 1);
164 strcpy (phys_name
, tmp_name
);
168 phys_name
= TYPE_FN_FIELD_PHYSNAME (f
, field_counter
);
170 /* Destructor is handled by caller, dont add it to the list */
171 if (DESTRUCTOR_PREFIX_P (phys_name
))
174 sym_arr
[i1
] = lookup_symbol (phys_name
,
177 (struct symtab
**) NULL
);
182 /* This error message gets printed, but the method
183 still seems to be found
184 fputs_filtered("(Cannot find method ", gdb_stdout);
185 fprintf_symbol_filtered (gdb_stdout, phys_name,
187 DMGL_PARAMS | DMGL_ANSI);
188 fputs_filtered(" - possibly inlined.)\n", gdb_stdout);
195 /* Only search baseclasses if there is no match yet, since names in
196 derived classes override those in baseclasses.
198 FIXME: The above is not true; it is only true of member functions
199 if they have the same number of arguments (??? - section 13.1 of the
200 ARM says the function members are not in the same scope but doesn't
201 really spell out the rules in a way I understand. In any case, if
202 the number of arguments differ this is a case in which we can overload
203 rather than hiding without any problem, and gcc 2.4.5 does overload
204 rather than hiding in this case). */
207 for (ibase
= 0; ibase
< TYPE_N_BASECLASSES (t
); ibase
++)
208 i1
+= find_methods (TYPE_BASECLASS (t
, ibase
), name
, sym_arr
+ i1
);
213 /* Helper function for decode_line_1.
214 Build a canonical line spec in CANONICAL if it is non-NULL and if
215 the SAL has a symtab.
216 If SYMNAME is non-NULL the canonical line spec is `filename:symname'.
217 If SYMNAME is NULL the line number from SAL is used and the canonical
218 line spec is `filename:linenum'. */
221 build_canonical_line_spec (struct symtab_and_line
*sal
, char *symname
,
224 char **canonical_arr
;
225 char *canonical_name
;
227 struct symtab
*s
= sal
->symtab
;
229 if (s
== (struct symtab
*) NULL
230 || s
->filename
== (char *) NULL
231 || canonical
== (char ***) NULL
)
234 canonical_arr
= (char **) xmalloc (sizeof (char *));
235 *canonical
= canonical_arr
;
237 filename
= s
->filename
;
240 canonical_name
= xmalloc (strlen (filename
) + strlen (symname
) + 2);
241 sprintf (canonical_name
, "%s:%s", filename
, symname
);
245 canonical_name
= xmalloc (strlen (filename
) + 30);
246 sprintf (canonical_name
, "%s:%d", filename
, sal
->line
);
248 canonical_arr
[0] = canonical_name
;
253 /* Find an instance of the character C in the string S that is outside
254 of all parenthesis pairs, single-quoted strings, and double-quoted
257 find_toplevel_char (char *s
, char c
)
259 int quoted
= 0; /* zero if we're not in quotes;
260 '"' if we're in a double-quoted string;
261 '\'' if we're in a single-quoted string. */
262 int depth
= 0; /* number of unclosed parens we've seen */
265 for (scan
= s
; *scan
; scan
++)
271 else if (*scan
== '\\' && *(scan
+ 1))
274 else if (*scan
== c
&& ! quoted
&& depth
== 0)
276 else if (*scan
== '"' || *scan
== '\'')
278 else if (*scan
== '(')
280 else if (*scan
== ')' && depth
> 0)
287 /* Given a list of NELTS symbols in SYM_ARR, return a list of lines to
288 operate on (ask user if necessary).
289 If CANONICAL is non-NULL return a corresponding array of mangled names
290 as canonical line specs there. */
292 static struct symtabs_and_lines
293 decode_line_2 (struct symbol
*sym_arr
[], int nelts
, int funfirstline
,
296 struct symtabs_and_lines values
, return_values
;
301 struct cleanup
*old_chain
;
302 char **canonical_arr
= (char **) NULL
;
304 values
.sals
= (struct symtab_and_line
*)
305 alloca (nelts
* sizeof (struct symtab_and_line
));
306 return_values
.sals
= (struct symtab_and_line
*)
307 xmalloc (nelts
* sizeof (struct symtab_and_line
));
308 old_chain
= make_cleanup (free
, return_values
.sals
);
312 canonical_arr
= (char **) xmalloc (nelts
* sizeof (char *));
313 make_cleanup (free
, canonical_arr
);
314 memset (canonical_arr
, 0, nelts
* sizeof (char *));
315 *canonical
= canonical_arr
;
319 printf_unfiltered ("[0] cancel\n[1] all\n");
322 INIT_SAL (&return_values
.sals
[i
]); /* initialize to zeroes */
323 INIT_SAL (&values
.sals
[i
]);
324 if (sym_arr
[i
] && SYMBOL_CLASS (sym_arr
[i
]) == LOC_BLOCK
)
326 values
.sals
[i
] = find_function_start_sal (sym_arr
[i
], funfirstline
);
327 printf_unfiltered ("[%d] %s at %s:%d\n",
329 SYMBOL_SOURCE_NAME (sym_arr
[i
]),
330 values
.sals
[i
].symtab
->filename
,
331 values
.sals
[i
].line
);
334 printf_unfiltered ("?HERE\n");
338 if ((prompt
= getenv ("PS2")) == NULL
)
342 args
= command_line_input (prompt
, 0, "overload-choice");
344 if (args
== 0 || *args
== 0)
345 error_no_arg ("one or more choice numbers");
353 while (*arg1
>= '0' && *arg1
<= '9')
355 if (*arg1
&& *arg1
!= ' ' && *arg1
!= '\t')
356 error ("Arguments must be choice numbers.");
366 for (i
= 0; i
< nelts
; i
++)
368 if (canonical_arr
[i
] == NULL
)
370 symname
= SYMBOL_NAME (sym_arr
[i
]);
371 canonical_arr
[i
] = savestring (symname
, strlen (symname
));
375 memcpy (return_values
.sals
, values
.sals
,
376 (nelts
* sizeof (struct symtab_and_line
)));
377 return_values
.nelts
= nelts
;
378 discard_cleanups (old_chain
);
379 return return_values
;
382 if (num
>= nelts
+ 2)
384 printf_unfiltered ("No choice number %d.\n", num
);
389 if (values
.sals
[num
].pc
)
393 symname
= SYMBOL_NAME (sym_arr
[num
]);
394 make_cleanup (free
, symname
);
395 canonical_arr
[i
] = savestring (symname
, strlen (symname
));
397 return_values
.sals
[i
++] = values
.sals
[num
];
398 values
.sals
[num
].pc
= 0;
402 printf_unfiltered ("duplicate request for %d ignored.\n", num
);
407 while (*args
== ' ' || *args
== '\t')
410 return_values
.nelts
= i
;
411 discard_cleanups (old_chain
);
412 return return_values
;
415 /* The parser of linespec itself. */
417 /* Parse a string that specifies a line number.
418 Pass the address of a char * variable; that variable will be
419 advanced over the characters actually parsed.
423 LINENUM -- that line number in current file. PC returned is 0.
424 FILE:LINENUM -- that line in that file. PC returned is 0.
425 FUNCTION -- line number of openbrace of that function.
426 PC returned is the start of the function.
427 VARIABLE -- line number of definition of that variable.
429 FILE:FUNCTION -- likewise, but prefer functions in that file.
430 *EXPR -- line in which address EXPR appears.
432 This may all be followed by an "if EXPR", which we ignore.
434 FUNCTION may be an undebuggable function found in minimal symbol table.
436 If the argument FUNFIRSTLINE is nonzero, we want the first line
437 of real code inside a function when a function is specified, and it is
438 not OK to specify a variable or type to get its line number.
440 DEFAULT_SYMTAB specifies the file to use if none is specified.
441 It defaults to current_source_symtab.
442 DEFAULT_LINE specifies the line number to use for relative
443 line numbers (that start with signs). Defaults to current_source_line.
444 If CANONICAL is non-NULL, store an array of strings containing the canonical
445 line specs there if necessary. Currently overloaded member functions and
446 line numbers or static functions without a filename yield a canonical
447 line spec. The array and the line spec strings are allocated on the heap,
448 it is the callers responsibility to free them.
450 Note that it is possible to return zero for the symtab
451 if no file is validly specified. Callers must check that.
452 Also, the line number returned may be invalid. */
454 /* We allow single quotes in various places. This is a hideous
455 kludge, which exists because the completer can't yet deal with the
456 lack of single quotes. FIXME: write a linespec_completer which we
457 can use as appropriate instead of make_symbol_completion_list. */
459 struct symtabs_and_lines
460 decode_line_1 (char **argptr
, int funfirstline
, struct symtab
*default_symtab
,
461 int default_line
, char ***canonical
)
463 struct symtabs_and_lines values
;
464 #ifdef HPPA_COMPILER_BUG
465 /* FIXME: The native HP 9000/700 compiler has a bug which appears
466 when optimizing this file with target i960-vxworks. I haven't
467 been able to construct a simple test case. The problem is that
468 in the second call to SKIP_PROLOGUE below, the compiler somehow
469 does not realize that the statement val = find_pc_line (...) will
470 change the values of the fields of val. It extracts the elements
471 into registers at the top of the block, and does not update the
472 registers after the call to find_pc_line. You can check this by
473 inserting a printf at the end of find_pc_line to show what values
474 it is returning for val.pc and val.end and another printf after
475 the call to see what values the function actually got (remember,
476 this is compiling with cc -O, with this patch removed). You can
477 also examine the assembly listing: search for the second call to
478 skip_prologue; the LDO statement before the next call to
479 find_pc_line loads the address of the structure which
480 find_pc_line will return; if there is a LDW just before the LDO,
481 which fetches an element of the structure, then the compiler
484 Setting val to volatile avoids the problem. We must undef
485 volatile, because the HPPA native compiler does not define
486 __STDC__, although it does understand volatile, and so volatile
487 will have been defined away in defs.h. */
489 volatile struct symtab_and_line val
;
490 #define volatile /*nothing */
492 struct symtab_and_line val
;
494 register char *p
, *p1
;
495 char *q
, *pp
, *ii
, *p2
;
499 register struct symtab
*s
;
501 register struct symbol
*sym
;
502 /* The symtab that SYM was found in. */
503 struct symtab
*sym_symtab
;
505 register CORE_ADDR pc
;
506 register struct minimal_symbol
*msymbol
;
508 struct symbol
*sym_class
;
511 int is_quote_enclosed
;
515 struct symbol
**sym_arr
;
517 char *saved_arg
= *argptr
;
518 extern char *gdb_completer_quote_characters
;
520 INIT_SAL (&val
); /* initialize to zeroes */
522 /* Defaults have defaults. */
524 if (default_symtab
== 0)
526 default_symtab
= current_source_symtab
;
527 default_line
= current_source_line
;
530 /* See if arg is *PC */
535 pc
= parse_and_eval_address_1 (argptr
);
537 values
.sals
= (struct symtab_and_line
*)
538 xmalloc (sizeof (struct symtab_and_line
));
541 values
.sals
[0] = find_pc_line (pc
, 0);
542 values
.sals
[0].pc
= pc
;
543 values
.sals
[0].section
= find_pc_overlay (pc
);
548 /* 'has_if' is for the syntax:
549 * (gdb) break foo if (a==b)
551 if ((ii
= strstr (*argptr
, " if ")) != NULL
||
552 (ii
= strstr (*argptr
, "\tif ")) != NULL
||
553 (ii
= strstr (*argptr
, " if\t")) != NULL
||
554 (ii
= strstr (*argptr
, "\tif\t")) != NULL
||
555 (ii
= strstr (*argptr
, " if(")) != NULL
||
556 (ii
= strstr (*argptr
, "\tif( ")) != NULL
)
558 /* Temporarily zap out "if (condition)" to not
559 * confuse the parenthesis-checking code below.
560 * This is undone below. Do not change ii!!
567 /* Set various flags.
568 * 'has_parens' is important for overload checking, where
569 * we allow things like:
570 * (gdb) break c::f(int)
573 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION */
575 is_quoted
= (**argptr
576 && strchr (gdb_completer_quote_characters
, **argptr
) != NULL
);
578 has_parens
= ((pp
= strchr (*argptr
, '(')) != NULL
579 && (pp
= strrchr (pp
, ')')) != NULL
);
581 /* Now that we're safely past the has_parens check,
582 * put back " if (condition)" so outer layers can see it
587 /* Maybe we were called with a line range FILENAME:LINENUM,FILENAME:LINENUM
588 and we must isolate the first half. Outer layers will call again later
591 Don't count commas that appear in argument lists of overloaded
592 functions, or in quoted strings. It's stupid to go to this much
593 trouble when the rest of the function is such an obvious roach hotel. */
594 ii
= find_toplevel_char (*argptr
, ',');
595 has_comma
= (ii
!= 0);
597 /* Temporarily zap out second half to not
598 * confuse the code below.
599 * This is undone below. Do not change ii!!
606 /* Maybe arg is FILE : LINENUM or FILE : FUNCTION */
607 /* May also be CLASS::MEMBER, or NAMESPACE::NAME */
608 /* Look for ':', but ignore inside of <> */
614 is_quote_enclosed
= 1;
618 is_quote_enclosed
= 0;
623 char *temp_end
= find_template_name_end (p
);
625 error ("malformed template specification in command");
628 /* Check for the end of the first half of the linespec. End of line,
629 a tab, a double colon or the last single colon, or a space. But
630 if enclosed in double quotes we do not break on enclosed spaces */
634 && ((p
[1] == ':') || (strchr (p
+ 1, ':') == NULL
)))
635 || ((p
[0] == ' ') && !is_quote_enclosed
))
637 if (p
[0] == '.' && strchr (p
, ':') == NULL
) /* Java qualified method. */
639 /* Find the *last* '.', since the others are package qualifiers. */
640 for (p1
= p
; *p1
; p1
++)
648 while (p
[0] == ' ' || p
[0] == '\t')
651 /* if the closing double quote was left at the end, remove it */
652 if (is_quote_enclosed
)
654 char *closing_quote
= strchr (p
, '"');
655 if (closing_quote
&& closing_quote
[1] == '\0')
656 *closing_quote
= '\0';
659 /* Now that we've safely parsed the first half,
660 * put back ',' so outer layers can see it
665 if ((p
[0] == ':' || p
[0] == '.') && !has_parens
)
670 *argptr
= *argptr
+ 1;
671 if (p
[0] == '.' || p
[1] == ':')
673 char *saved_arg2
= *argptr
;
675 /* First check for "global" namespace specification,
676 of the form "::foo". If found, skip over the colons
677 and jump to normal symbol processing */
679 && ((*argptr
== p
) || (p
[-1] == ' ') || (p
[-1] == '\t')))
682 /* We have what looks like a class or namespace
683 scope specification (A::B), possibly with many
684 levels of namespaces or classes (A::B::C::D).
686 Some versions of the HP ANSI C++ compiler (as also possibly
687 other compilers) generate class/function/member names with
688 embedded double-colons if they are inside namespaces. To
689 handle this, we loop a few times, considering larger and
690 larger prefixes of the string as though they were single
691 symbols. So, if the initially supplied string is
692 A::B::C::D::foo, we have to look up "A", then "A::B",
693 then "A::B::C", then "A::B::C::D", and finally
694 "A::B::C::D::foo" as single, monolithic symbols, because
695 A, B, C or D may be namespaces.
697 Note that namespaces can nest only inside other
698 namespaces, and not inside classes. So we need only
699 consider *prefixes* of the string; there is no need to look up
700 "B::C" separately as a symbol in the previous example. */
702 p2
= p
; /* save for restart */
705 /* Extract the class name. */
707 while (p
!= *argptr
&& p
[-1] == ' ')
709 copy
= (char *) alloca (p
- *argptr
+ 1);
710 memcpy (copy
, *argptr
, p
- *argptr
);
711 copy
[p
- *argptr
] = 0;
713 /* Discard the class name from the arg. */
714 p
= p1
+ (p1
[0] == ':' ? 2 : 1);
715 while (*p
== ' ' || *p
== '\t')
719 sym_class
= lookup_symbol (copy
, 0, STRUCT_NAMESPACE
, 0,
720 (struct symtab
**) NULL
);
723 (t
= check_typedef (SYMBOL_TYPE (sym_class
)),
724 (TYPE_CODE (t
) == TYPE_CODE_STRUCT
725 || TYPE_CODE (t
) == TYPE_CODE_UNION
)))
727 /* Arg token is not digits => try it as a function name
728 Find the next token(everything up to end or next blank). */
730 && strchr (gdb_completer_quote_characters
, **argptr
) != NULL
)
732 p
= skip_quoted (*argptr
);
733 *argptr
= *argptr
+ 1;
738 while (*p
&& *p
!= ' ' && *p
!= '\t' && *p
!= ',' && *p
!= ':')
742 q = operator_chars (*argptr, &q1);
746 char *tmp = alloca (q1 - q + 1);
747 memcpy (tmp, q, q1 - q);
749 opname = cplus_mangle_opname (tmp, DMGL_ANSI);
753 printf_filtered ("no mangling for \"%s\"\n", tmp);
754 cplusplus_hint (saved_arg);
755 return_to_top_level (RETURN_ERROR);
757 copy = (char*) alloca (3 + strlen(opname));
758 sprintf (copy, "__%s", opname);
764 copy
= (char *) alloca (p
- *argptr
+ 1);
765 memcpy (copy
, *argptr
, p
- *argptr
);
766 copy
[p
- *argptr
] = '\0';
768 && copy
[p
- *argptr
- 1]
769 && strchr (gdb_completer_quote_characters
,
770 copy
[p
- *argptr
- 1]) != NULL
)
771 copy
[p
- *argptr
- 1] = '\0';
774 /* no line number may be specified */
775 while (*p
== ' ' || *p
== '\t')
780 i1
= 0; /* counter for the symbol array */
781 sym_arr
= (struct symbol
**) alloca (total_number_of_methods (t
)
782 * sizeof (struct symbol
*));
784 if (destructor_name_p (copy
, t
))
786 /* Destructors are a special case. */
787 int m_index
, f_index
;
789 if (get_destructor_fn_field (t
, &m_index
, &f_index
))
791 struct fn_field
*f
= TYPE_FN_FIELDLIST1 (t
, m_index
);
794 lookup_symbol (TYPE_FN_FIELD_PHYSNAME (f
, f_index
),
795 NULL
, VAR_NAMESPACE
, (int *) NULL
,
796 (struct symtab
**) NULL
);
802 i1
= find_methods (t
, copy
, sym_arr
);
805 /* There is exactly one field with that name. */
808 if (sym
&& SYMBOL_CLASS (sym
) == LOC_BLOCK
)
810 values
.sals
= (struct symtab_and_line
*)
811 xmalloc (sizeof (struct symtab_and_line
));
813 values
.sals
[0] = find_function_start_sal (sym
,
824 /* There is more than one field with that name
825 (overloaded). Ask the user which one to use. */
826 return decode_line_2 (sym_arr
, i1
, funfirstline
, canonical
);
832 if (OPNAME_PREFIX_P (copy
))
834 tmp
= (char *) alloca (strlen (copy
+ 3) + 9);
835 strcpy (tmp
, "operator ");
836 strcat (tmp
, copy
+ 3);
843 ("the class `%s' does not have destructor defined\n",
844 SYMBOL_SOURCE_NAME (sym_class
));
847 ("the class %s does not have any method named %s\n",
848 SYMBOL_SOURCE_NAME (sym_class
), tmp
);
849 cplusplus_hint (saved_arg
);
850 return_to_top_level (RETURN_ERROR
);
854 /* Move pointer up to next possible class/namespace token */
855 p
= p2
+ 1; /* restart with old value +1 */
856 /* Move pointer ahead to next double-colon */
857 while (*p
&& (p
[0] != ' ') && (p
[0] != '\t') && (p
[0] != '\''))
861 temp_end
= find_template_name_end (p
);
863 error ("malformed template specification in command");
866 else if ((p
[0] == ':') && (p
[1] == ':'))
867 break; /* found double-colon */
873 break; /* out of the while (1) */
875 p2
= p
; /* save restart for next time around */
876 *argptr
= saved_arg2
; /* restore argptr */
879 /* Last chance attempt -- check entire name as a symbol */
880 /* Use "copy" in preparation for jumping out of this block,
881 to be consistent with usage following the jump target */
882 copy
= (char *) alloca (p
- saved_arg2
+ 1);
883 memcpy (copy
, saved_arg2
, p
- saved_arg2
);
884 /* Note: if is_quoted should be true, we snuff out quote here anyway */
885 copy
[p
- saved_arg2
] = '\000';
886 /* Set argptr to skip over the name */
887 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
888 /* Look up entire name */
889 sym
= lookup_symbol (copy
, 0, VAR_NAMESPACE
, 0, &sym_symtab
);
890 s
= (struct symtab
*) 0;
891 /* Prepare to jump: restore the " if (condition)" so outer layers see it */
892 /* Symbol was found --> jump to normal symbol processing.
893 Code following "symbol_found" expects "copy" to have the
894 symbol name, "sym" to have the symbol pointer, "s" to be
895 a specified file's symtab, and sym_symtab to be the symbol's
897 /* By jumping there we avoid falling through the FILE:LINE and
898 FILE:FUNC processing stuff below */
902 /* Couldn't find any interpretation as classes/namespaces, so give up */
904 /* The quotes are important if copy is empty. */
906 ("Can't find member of namespace, class, struct, or union named \"%s\"\n", copy
);
907 cplusplus_hint (saved_arg
);
908 return_to_top_level (RETURN_ERROR
);
913 /* Extract the file name. */
915 while (p
!= *argptr
&& p
[-1] == ' ')
917 if ((*p
== '"') && is_quote_enclosed
)
919 copy
= (char *) alloca (p
- *argptr
+ 1);
920 if ((**argptr
== '"') && is_quote_enclosed
)
922 memcpy (copy
, *argptr
+ 1, p
- *argptr
- 1);
923 /* It may have the ending quote right after the file name */
924 if (copy
[p
- *argptr
- 2] == '"')
925 copy
[p
- *argptr
- 2] = 0;
927 copy
[p
- *argptr
- 1] = 0;
931 memcpy (copy
, *argptr
, p
- *argptr
);
932 copy
[p
- *argptr
] = 0;
935 /* Find that file's data. */
936 s
= lookup_symtab (copy
);
939 if (!have_full_symbols () && !have_partial_symbols ())
940 error ("No symbol table is loaded. Use the \"file\" command.");
941 error ("No source file named %s.", copy
);
944 /* Discard the file name from the arg. */
946 while (*p
== ' ' || *p
== '\t')
951 /* No one really seems to know why this was added. It certainly
952 breaks the command line, though, whenever the passed
953 name is of the form ClassName::Method. This bit of code
954 singles out the class name, and if funfirstline is set (for
955 example, you are setting a breakpoint at this function),
956 you get an error. This did not occur with earlier
957 verions, so I am ifdef'ing this out. 3/29/99 */
960 /* Check if what we have till now is a symbol name */
962 /* We may be looking at a template instantiation such
963 as "foo<int>". Check here whether we know about it,
964 instead of falling through to the code below which
965 handles ordinary function names, because that code
966 doesn't like seeing '<' and '>' in a name -- the
967 skip_quoted call doesn't go past them. So see if we
968 can figure it out right now. */
970 copy
= (char *) alloca (p
- *argptr
+ 1);
971 memcpy (copy
, *argptr
, p
- *argptr
);
972 copy
[p
- *argptr
] = '\000';
973 sym
= lookup_symbol (copy
, 0, VAR_NAMESPACE
, 0, &sym_symtab
);
976 /* Yes, we have a symbol; jump to symbol processing */
977 /* Code after symbol_found expects S, SYM_SYMTAB, SYM,
978 and COPY to be set correctly */
979 *argptr
= (*p
== '\'') ? p
+ 1 : p
;
980 s
= (struct symtab
*) 0;
983 /* Otherwise fall out from here and go to file/line spec
988 /* S is specified file's symtab, or 0 if no file specified.
989 arg no longer contains the file name. */
991 /* Check whether arg is all digits (and sign) */
994 if (*q
== '-' || *q
== '+')
996 while (*q
>= '0' && *q
<= '9')
999 if (q
!= *argptr
&& (*q
== 0 || *q
== ' ' || *q
== '\t' || *q
== ','))
1001 /* We found a token consisting of all digits -- at least one digit. */
1008 /* We might need a canonical line spec if no file was specified. */
1009 int need_canonical
= (s
== 0) ? 1 : 0;
1011 /* This is where we need to make sure that we have good defaults.
1012 We must guarantee that this section of code is never executed
1013 when we are called with just a function name, since
1014 select_source_symtab calls us with such an argument */
1016 if (s
== 0 && default_symtab
== 0)
1018 select_source_symtab (0);
1019 default_symtab
= current_source_symtab
;
1020 default_line
= current_source_line
;
1023 if (**argptr
== '+')
1024 sign
= plus
, (*argptr
)++;
1025 else if (**argptr
== '-')
1026 sign
= minus
, (*argptr
)++;
1027 val
.line
= atoi (*argptr
);
1034 val
.line
= default_line
+ val
.line
;
1040 val
.line
= default_line
- val
.line
;
1045 break; /* No need to adjust val.line. */
1048 while (*q
== ' ' || *q
== '\t')
1054 /* It is possible that this source file has more than one symtab,
1055 and that the new line number specification has moved us from the
1056 default (in s) to a new one. */
1057 val
.symtab
= find_line_symtab (s
, val
.line
, NULL
, NULL
);
1058 if (val
.symtab
== 0)
1062 values
.sals
= (struct symtab_and_line
*)
1063 xmalloc (sizeof (struct symtab_and_line
));
1064 values
.sals
[0] = val
;
1067 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1071 /* Arg token is not digits => try it as a variable name
1072 Find the next token (everything up to end or next whitespace). */
1074 if (**argptr
== '$') /* May be a convenience variable */
1075 p
= skip_quoted (*argptr
+ (((*argptr
)[1] == '$') ? 2 : 1)); /* One or two $ chars possible */
1078 p
= skip_quoted (*argptr
);
1080 error ("Unmatched single quote.");
1082 else if (has_parens
)
1088 p
= skip_quoted (*argptr
);
1091 if (is_quote_enclosed
&& **argptr
== '"')
1094 copy
= (char *) alloca (p
- *argptr
+ 1);
1095 memcpy (copy
, *argptr
, p
- *argptr
);
1096 copy
[p
- *argptr
] = '\0';
1099 && copy
[0] == copy
[p
- *argptr
- 1]
1100 && strchr (gdb_completer_quote_characters
, copy
[0]) != NULL
)
1102 copy
[p
- *argptr
- 1] = '\0';
1105 while (*p
== ' ' || *p
== '\t')
1109 /* If it starts with $: may be a legitimate variable or routine name
1110 (e.g. HP-UX millicode routines such as $$dyncall), or it may
1111 be history value, or it may be a convenience variable */
1117 int need_canonical
= 0;
1119 p
= (copy
[1] == '$') ? copy
+ 2 : copy
+ 1;
1120 while (*p
>= '0' && *p
<= '9')
1122 if (!*p
) /* reached end of token without hitting non-digit */
1124 /* We have a value history reference */
1125 sscanf ((copy
[1] == '$') ? copy
+ 2 : copy
+ 1, "%d", &index
);
1126 valx
= access_value_history ((copy
[1] == '$') ? -index
: index
);
1127 if (TYPE_CODE (VALUE_TYPE (valx
)) != TYPE_CODE_INT
)
1128 error ("History values used in line specs must have integer values.");
1132 /* Not all digits -- may be user variable/function or a
1133 convenience variable */
1135 /* Look up entire name as a symbol first */
1136 sym
= lookup_symbol (copy
, 0, VAR_NAMESPACE
, 0, &sym_symtab
);
1137 s
= (struct symtab
*) 0;
1139 /* Symbol was found --> jump to normal symbol processing.
1140 Code following "symbol_found" expects "copy" to have the
1141 symbol name, "sym" to have the symbol pointer, "s" to be
1142 a specified file's symtab, and sym_symtab to be the symbol's
1147 /* If symbol was not found, look in minimal symbol tables */
1148 msymbol
= lookup_minimal_symbol (copy
, 0, 0);
1149 /* Min symbol was found --> jump to minsym processing. */
1151 goto minimal_symbol_found
;
1153 /* Not a user variable or function -- must be convenience variable */
1154 need_canonical
= (s
== 0) ? 1 : 0;
1155 valx
= value_of_internalvar (lookup_internalvar (copy
+ 1));
1156 if (TYPE_CODE (VALUE_TYPE (valx
)) != TYPE_CODE_INT
)
1157 error ("Convenience variables used in line specs must have integer values.");
1160 /* Either history value or convenience value from above, in valx */
1161 val
.symtab
= s
? s
: default_symtab
;
1162 val
.line
= value_as_long (valx
);
1165 values
.sals
= (struct symtab_and_line
*) xmalloc (sizeof val
);
1166 values
.sals
[0] = val
;
1170 build_canonical_line_spec (values
.sals
, NULL
, canonical
);
1176 /* Look up that token as a variable.
1177 If file specified, use that file's per-file block to start with. */
1179 sym
= lookup_symbol (copy
,
1180 (s
? BLOCKVECTOR_BLOCK (BLOCKVECTOR (s
), STATIC_BLOCK
)
1181 : get_selected_block ()),
1182 VAR_NAMESPACE
, 0, &sym_symtab
);
1184 symbol_found
: /* We also jump here from inside the C++ class/namespace
1185 code on finding a symbol of the form "A::B::C" */
1189 if (SYMBOL_CLASS (sym
) == LOC_BLOCK
)
1191 /* Arg is the name of a function */
1192 values
.sals
= (struct symtab_and_line
*)
1193 xmalloc (sizeof (struct symtab_and_line
));
1194 values
.sals
[0] = find_function_start_sal (sym
, funfirstline
);
1197 /* Don't use the SYMBOL_LINE; if used at all it points to
1198 the line containing the parameters or thereabouts, not
1199 the first line of code. */
1201 /* We might need a canonical line spec if it is a static
1205 struct blockvector
*bv
= BLOCKVECTOR (sym_symtab
);
1206 struct block
*b
= BLOCKVECTOR_BLOCK (bv
, STATIC_BLOCK
);
1207 if (lookup_block_symbol (b
, copy
, VAR_NAMESPACE
) != NULL
)
1208 build_canonical_line_spec (values
.sals
, copy
, canonical
);
1215 error ("\"%s\" is not a function", copy
);
1216 else if (SYMBOL_LINE (sym
) != 0)
1218 /* We know its line number. */
1219 values
.sals
= (struct symtab_and_line
*)
1220 xmalloc (sizeof (struct symtab_and_line
));
1222 memset (&values
.sals
[0], 0, sizeof (values
.sals
[0]));
1223 values
.sals
[0].symtab
= sym_symtab
;
1224 values
.sals
[0].line
= SYMBOL_LINE (sym
);
1228 /* This can happen if it is compiled with a compiler which doesn't
1229 put out line numbers for variables. */
1230 /* FIXME: Shouldn't we just set .line and .symtab to zero
1231 and return? For example, "info line foo" could print
1233 error ("Line number not known for symbol \"%s\"", copy
);
1237 msymbol
= lookup_minimal_symbol (copy
, NULL
, NULL
);
1239 minimal_symbol_found
: /* We also jump here from the case for variables
1240 that begin with '$' */
1242 if (msymbol
!= NULL
)
1244 values
.sals
= (struct symtab_and_line
*)
1245 xmalloc (sizeof (struct symtab_and_line
));
1246 values
.sals
[0] = find_pc_sect_line (SYMBOL_VALUE_ADDRESS (msymbol
),
1247 (struct sec
*) 0, 0);
1248 values
.sals
[0].section
= SYMBOL_BFD_SECTION (msymbol
);
1251 values
.sals
[0].pc
+= FUNCTION_START_OFFSET
;
1252 values
.sals
[0].pc
= SKIP_PROLOGUE (values
.sals
[0].pc
);
1258 if (!have_full_symbols () &&
1259 !have_partial_symbols () && !have_minimal_symbols ())
1260 error ("No symbol table is loaded. Use the \"file\" command.");
1262 error ("Function \"%s\" not defined.", copy
);
1263 return values
; /* for lint */