1 /* Parser for linespec for the GNU debugger, GDB.
3 Copyright (C) 1986-2005, 2007-2012 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 3 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, see <http://www.gnu.org/licenses/>. */
29 #include "completer.h"
31 #include "cp-support.h"
32 #include "parser-defs.h"
34 #include "objc-lang.h"
36 #include "exceptions.h"
39 #include "mi/mi-cmds.h"
41 #include "arch-utils.h"
43 #include "cli/cli-utils.h"
44 #include "filenames.h"
48 typedef struct symtab *symtab_p;
51 typedef struct symbol *symbolp;
54 typedef struct type *typep;
57 /* An address entry is used to ensure that any given location is only
58 added to the result a single time. It holds an address and the
59 program space from which the address came. */
63 struct program_space *pspace;
67 /* A helper struct which just holds a minimal symbol and the object
68 file from which it came. */
70 typedef struct minsym_and_objfile
72 struct minimal_symbol *minsym;
73 struct objfile *objfile;
74 } minsym_and_objfile_d;
76 DEF_VEC_O (minsym_and_objfile_d);
78 /* An enumeration of possible signs for a line offset. */
79 enum offset_relative_sign
84 /* A plus sign ("+") */
87 /* A minus sign ("-") */
90 /* A special "sign" for unspecified offset. */
94 /* A line offset in a linespec. */
98 /* Line offset and any specified sign. */
100 enum offset_relative_sign sign;
103 /* A linespec. Elements of this structure are filled in by a parser
104 (either parse_linespec or some other function). The structure is
105 then converted into SALs by convert_linespec_to_sals. */
109 /* An expression and the resulting PC. Specifying an expression
110 currently precludes the use of other members. */
112 /* The expression entered by the user. */
113 const char *expression;
115 /* The resulting PC expression derived from evaluating EXPRESSION. */
118 /* Any specified file symtabs. */
120 /* The user-supplied source filename or NULL if none was specified. */
121 const char *source_filename;
123 /* The list of symtabs to search to which to limit the search. May not
124 be NULL. If SOURCE_FILENAME is NULL (no user-specified filename),
125 FILE_SYMTABS should contain one single NULL member. This will
126 cause the code to use the default symtab. */
127 VEC (symtab_p) *file_symtabs;
129 /* The name of a function or method and any matching symbols. */
131 /* The user-specified function name. If no function name was
132 supplied, this may be NULL. */
133 const char *function_name;
135 /* A list of matching function symbols and minimal symbols. Both lists
136 may be NULL if no matching symbols were found. */
137 VEC (symbolp) *function_symbols;
138 VEC (minsym_and_objfile_d) *minimal_symbols;
140 /* The name of a label and matching symbols. */
142 /* The user-specified label name. */
143 const char *label_name;
145 /* A structure of matching label symbols and the corresponding
146 function symbol in which the label was found. Both may be NULL
147 or both must be non-NULL. */
150 VEC (symbolp) *label_symbols;
151 VEC (symbolp) *function_symbols;
154 /* Line offset. It may be LINE_OFFSET_UNKNOWN, meaning that no
155 offset was specified. */
156 struct line_offset line_offset;
158 typedef struct linespec *linespec_p;
160 /* An instance of this is used to keep all state while linespec
161 operates. This instance is passed around as a 'this' pointer to
162 the various implementation methods. */
164 struct linespec_state
166 /* The language in use during linespec processing. */
167 const struct language_defn *language;
169 /* The program space as seen when the module was entered. */
170 struct program_space *program_space;
172 /* The default symtab to use, if no other symtab is specified. */
173 struct symtab *default_symtab;
175 /* The default line to use. */
178 /* The 'funfirstline' value that was passed in to decode_line_1 or
182 /* Nonzero if we are running in 'list' mode; see decode_line_list. */
185 /* The 'canonical' value passed to decode_line_full, or NULL. */
186 struct linespec_result *canonical;
188 /* Canonical strings that mirror the symtabs_and_lines result. */
189 char **canonical_names;
191 /* This is a set of address_entry objects which is used to prevent
192 duplicate symbols from being entered into the result. */
196 /* This is a helper object that is used when collecting symbols into a
201 /* The linespec object in use. */
202 struct linespec_state *state;
204 /* A list of symtabs to which to restrict matches. */
205 VEC (symtab_p) *file_symtabs;
207 /* The result being accumulated. */
210 VEC (symbolp) *symbols;
211 VEC (minsym_and_objfile_d) *minimal_symbols;
222 /* A colon "separator" */
234 /* EOI (end of input) */
240 typedef enum ls_token_type linespec_token_type;
242 /* List of keywords */
244 static const char * const linespec_keywords[] = { "if", "thread", "task" };
246 /* A token of the linespec lexer */
250 /* The type of the token */
251 linespec_token_type type;
253 /* Data for the token */
256 /* A string, given as a stoken */
257 struct stoken string;
263 typedef struct ls_token linespec_token;
265 #define LS_TOKEN_STOKEN(TOK) (TOK).data.string
266 #define LS_TOKEN_KEYWORD(TOK) (TOK).data.keyword
268 /* An instance of the linespec parser. */
272 /* Lexer internal data */
275 /* Save head of input stream. */
278 /* Head of the input stream. */
280 #define PARSER_STREAM(P) (*(P)->lexer.stream)
282 /* The current token. */
283 linespec_token current;
286 /* Is the entire linespec quote-enclosed? */
287 int is_quote_enclosed;
289 /* The state of the parse. */
290 struct linespec_state state;
291 #define PARSER_STATE(PPTR) (&(PPTR)->state)
293 /* The result of the parse. */
294 struct linespec result;
295 #define PARSER_RESULT(PPTR) (&(PPTR)->result)
297 typedef struct ls_parser linespec_parser;
299 /* Prototypes for local functions. */
301 static void initialize_defaults (struct symtab **default_symtab,
304 static CORE_ADDR linespec_expression_to_pc (char **exp_ptr);
306 static struct symtabs_and_lines decode_objc (struct linespec_state *self,
310 static VEC (symtab_p) *symtabs_from_filename (const char *);
312 static VEC (symbolp) *find_label_symbols (struct linespec_state *self,
313 VEC (symbolp) *function_symbols,
314 VEC (symbolp) **label_funcs_ret,
317 void find_linespec_symbols (struct linespec_state *self,
318 VEC (symtab_p) *file_symtabs,
320 VEC (symbolp) **symbols,
321 VEC (minsym_and_objfile_d) **minsyms);
323 static struct line_offset
324 linespec_parse_variable (struct linespec_state *self,
325 const char *variable);
327 static int symbol_to_sal (struct symtab_and_line *result,
328 int funfirstline, struct symbol *sym);
330 static void add_matching_symbols_to_info (const char *name,
331 struct collect_info *info,
332 struct program_space *pspace);
334 static void add_all_symbol_names_from_pspace (struct collect_info *info,
335 struct program_space *pspace,
336 VEC (const_char_ptr) *names);
338 static VEC (symtab_p) *collect_symtabs_from_filename (const char *file);
340 static void decode_digits_ordinary (struct linespec_state *self,
343 struct symtabs_and_lines *sals,
344 struct linetable_entry **best_entry);
346 static void decode_digits_list_mode (struct linespec_state *self,
348 struct symtabs_and_lines *values,
349 struct symtab_and_line val);
351 static void minsym_found (struct linespec_state *self, struct objfile *objfile,
352 struct minimal_symbol *msymbol,
353 struct symtabs_and_lines *result);
355 static int compare_symbols (const void *a, const void *b);
357 static int compare_msymbols (const void *a, const void *b);
359 static const char *find_toplevel_char (const char *s, char c);
361 /* Permitted quote characters for the parser. This is different from the
362 completer's quote characters to allow backward compatibility with the
364 static const char *const linespec_quote_characters = "\"\'";
366 /* Lexer functions. */
368 /* Lex a number from the input in PARSER. This only supports
371 Return true if input is decimal numbers. Return false if not. */
374 linespec_lexer_lex_number (linespec_parser *parser, linespec_token *tokenp)
376 tokenp->type = LSTOKEN_NUMBER;
377 LS_TOKEN_STOKEN (*tokenp).length = 0;
378 LS_TOKEN_STOKEN (*tokenp).ptr = PARSER_STREAM (parser);
380 /* Keep any sign at the start of the stream. */
381 if (*PARSER_STREAM (parser) == '+' || *PARSER_STREAM (parser) == '-')
383 ++LS_TOKEN_STOKEN (*tokenp).length;
384 ++(PARSER_STREAM (parser));
387 while (isdigit (*PARSER_STREAM (parser)))
389 ++LS_TOKEN_STOKEN (*tokenp).length;
390 ++(PARSER_STREAM (parser));
393 /* If the next character in the input buffer is not a space, comma,
394 quote, or colon, this input does not represent a number. */
395 if (*PARSER_STREAM (parser) != '\0'
396 && !isspace (*PARSER_STREAM (parser)) && *PARSER_STREAM (parser) != ','
397 && *PARSER_STREAM (parser) != ':'
398 && !strchr (linespec_quote_characters, *PARSER_STREAM (parser)))
400 PARSER_STREAM (parser) = LS_TOKEN_STOKEN (*tokenp).ptr;
407 /* Does P represent one of the keywords? If so, return
408 the keyword. If not, return NULL. */
411 linespec_lexer_lex_keyword (const char *p)
417 for (i = 0; i < ARRAY_SIZE (linespec_keywords); ++i)
419 int len = strlen (linespec_keywords[i]);
421 /* If P begins with one of the keywords and the next
422 character is not a valid identifier character,
423 we have found a keyword. */
424 if (strncmp (p, linespec_keywords[i], len) == 0
425 && !(isalnum (p[len]) || p[len] == '_'))
426 return linespec_keywords[i];
433 /* Does STRING represent an Ada operator? If so, return the length
434 of the decoded operator name. If not, return 0. */
437 is_ada_operator (const char *string)
439 const struct ada_opname_map *mapping;
441 for (mapping = ada_opname_table;
442 mapping->encoded != NULL
443 && strncmp (mapping->decoded, string,
444 strlen (mapping->decoded)) != 0; ++mapping)
447 return mapping->decoded == NULL ? 0 : strlen (mapping->decoded);
450 /* Find QUOTE_CHAR in STRING, accounting for the ':' terminal. Return
451 the location of QUOTE_CHAR, or NULL if not found. */
454 skip_quote_char (const char *string, char quote_char)
456 const char *p, *last;
458 p = last = find_toplevel_char (string, quote_char);
459 while (p && *p != '\0' && *p != ':')
461 p = find_toplevel_char (p, quote_char);
469 /* Make a writable copy of the string given in TOKEN, trimming
470 any trailing whitespace. */
473 copy_token_string (linespec_token token)
477 if (token.type == LSTOKEN_KEYWORD)
478 return xstrdup (LS_TOKEN_KEYWORD (token));
480 str = savestring (LS_TOKEN_STOKEN (token).ptr,
481 LS_TOKEN_STOKEN (token).length);
482 s = remove_trailing_whitespace (str, str + LS_TOKEN_STOKEN (token).length);
488 /* Does P represent the end of a quote-enclosed linespec? */
491 is_closing_quote_enclosed (const char *p)
493 if (strchr (linespec_quote_characters, *p))
495 p = skip_spaces ((char *) p);
496 return (*p == '\0' || linespec_lexer_lex_keyword (p));
499 /* Find the end of the parameter list that starts with *INPUT.
500 This helper function assists with lexing string segments
501 which might contain valid (non-terminating) commas. */
504 find_parameter_list_end (char *input)
506 char end_char, start_char;
511 if (start_char == '(')
513 else if (start_char == '<')
522 if (*p == start_char)
524 else if (*p == end_char)
539 /* Lex a string from the input in PARSER. */
541 static linespec_token
542 linespec_lexer_lex_string (linespec_parser *parser)
544 linespec_token token;
545 char *start = PARSER_STREAM (parser);
547 token.type = LSTOKEN_STRING;
549 /* If the input stream starts with a quote character, skip to the next
550 quote character, regardless of the content. */
551 if (strchr (linespec_quote_characters, *PARSER_STREAM (parser)))
554 char quote_char = *PARSER_STREAM (parser);
556 /* Special case: Ada operators. */
557 if (PARSER_STATE (parser)->language->la_language == language_ada
558 && quote_char == '\"')
560 int len = is_ada_operator (PARSER_STREAM (parser));
564 /* The input is an Ada operator. Return the quoted string
566 LS_TOKEN_STOKEN (token).ptr = PARSER_STREAM (parser);
567 LS_TOKEN_STOKEN (token).length = len;
568 PARSER_STREAM (parser) += len;
572 /* The input does not represent an Ada operator -- fall through
573 to normal quoted string handling. */
576 /* Skip past the beginning quote. */
577 ++(PARSER_STREAM (parser));
579 /* Mark the start of the string. */
580 LS_TOKEN_STOKEN (token).ptr = PARSER_STREAM (parser);
582 /* Skip to the ending quote. */
583 end = skip_quote_char (PARSER_STREAM (parser), quote_char);
585 /* Error if the input did not terminate properly. */
587 error (_("unmatched quote"));
589 /* Skip over the ending quote and mark the length of the string. */
590 PARSER_STREAM (parser) = (char *) ++end;
591 LS_TOKEN_STOKEN (token).length = PARSER_STREAM (parser) - 2 - start;
597 /* Otherwise, only identifier characters are permitted.
598 Spaces are the exception. In general, we keep spaces,
599 but only if the next characters in the input do not resolve
600 to one of the keywords.
602 This allows users to forgo quoting CV-qualifiers, template arguments,
603 and similar common language constructs. */
607 if (isspace (*PARSER_STREAM (parser)))
609 p = skip_spaces (PARSER_STREAM (parser));
610 if (linespec_lexer_lex_keyword (p) != NULL)
612 LS_TOKEN_STOKEN (token).ptr = start;
613 LS_TOKEN_STOKEN (token).length
614 = PARSER_STREAM (parser) - start;
618 /* Advance past the whitespace. */
619 PARSER_STREAM (parser) = p;
622 /* If the next character is EOI or (single) ':', the
623 string is complete; return the token. */
624 if (*PARSER_STREAM (parser) == 0)
626 LS_TOKEN_STOKEN (token).ptr = start;
627 LS_TOKEN_STOKEN (token).length = PARSER_STREAM (parser) - start;
630 else if (PARSER_STREAM (parser)[0] == ':')
632 /* Do not tokenize the C++ scope operator. */
633 if (PARSER_STREAM (parser)[1] == ':')
634 ++(PARSER_STREAM (parser));
636 /* Do not tokenify if the input length so far is one
637 (i.e, a single-letter drive name) and the next character
638 is a directory separator. This allows Windows-style
639 paths to be recognized as filenames without quoting it. */
640 else if ((PARSER_STREAM (parser) - start) != 1
641 || !IS_DIR_SEPARATOR (PARSER_STREAM (parser)[1]))
643 LS_TOKEN_STOKEN (token).ptr = start;
644 LS_TOKEN_STOKEN (token).length
645 = PARSER_STREAM (parser) - start;
649 /* Special case: permit quote-enclosed linespecs. */
650 else if (parser->is_quote_enclosed
651 && strchr (linespec_quote_characters,
652 *PARSER_STREAM (parser))
653 && is_closing_quote_enclosed (PARSER_STREAM (parser)))
655 LS_TOKEN_STOKEN (token).ptr = start;
656 LS_TOKEN_STOKEN (token).length = PARSER_STREAM (parser) - start;
659 /* Because commas may terminate a linespec and appear in
660 the middle of valid string input, special cases for
661 '<' and '(' are necessary. */
662 else if (*PARSER_STREAM (parser) == '<'
663 || *PARSER_STREAM (parser) == '(')
667 p = find_parameter_list_end (PARSER_STREAM (parser));
670 PARSER_STREAM (parser) = p;
674 /* Commas are terminators, but not if they are part of an
676 else if (*PARSER_STREAM (parser) == ',')
678 if ((PARSER_STATE (parser)->language->la_language
680 && (PARSER_STREAM (parser) - start) > 8
681 /* strlen ("operator") */)
683 char *p = strstr (start, "operator");
685 if (p != NULL && is_operator_name (p))
687 /* This is an operator name. Keep going. */
688 ++(PARSER_STREAM (parser));
693 /* Comma terminates the string. */
694 LS_TOKEN_STOKEN (token).ptr = start;
695 LS_TOKEN_STOKEN (token).length = PARSER_STREAM (parser) - start;
699 /* Advance the stream. */
700 ++(PARSER_STREAM (parser));
707 /* Lex a single linespec token from PARSER. */
709 static linespec_token
710 linespec_lexer_lex_one (linespec_parser *parser)
714 if (parser->lexer.current.type == LSTOKEN_CONSUMED)
716 /* Skip any whitespace. */
717 PARSER_STREAM (parser) = skip_spaces (PARSER_STREAM (parser));
719 /* Check for a keyword. */
720 keyword = linespec_lexer_lex_keyword (PARSER_STREAM (parser));
723 parser->lexer.current.type = LSTOKEN_KEYWORD;
724 LS_TOKEN_KEYWORD (parser->lexer.current) = keyword;
725 return parser->lexer.current;
728 /* Handle other tokens. */
729 switch (*PARSER_STREAM (parser))
732 parser->lexer.current.type = LSTOKEN_EOI;
736 case '0': case '1': case '2': case '3': case '4':
737 case '5': case '6': case '7': case '8': case '9':
738 if (!linespec_lexer_lex_number (parser, &(parser->lexer.current)))
739 parser->lexer.current = linespec_lexer_lex_string (parser);
743 /* If we have a scope operator, lex the input as a string.
744 Otherwise, return LSTOKEN_COLON. */
745 if (PARSER_STREAM (parser)[1] == ':')
746 parser->lexer.current = linespec_lexer_lex_string (parser);
749 parser->lexer.current.type = LSTOKEN_COLON;
750 ++(PARSER_STREAM (parser));
754 case '\'': case '\"':
755 /* Special case: permit quote-enclosed linespecs. */
756 if (parser->is_quote_enclosed
757 && is_closing_quote_enclosed (PARSER_STREAM (parser)))
759 ++(PARSER_STREAM (parser));
760 parser->lexer.current.type = LSTOKEN_EOI;
763 parser->lexer.current = linespec_lexer_lex_string (parser);
767 parser->lexer.current.type = LSTOKEN_COMMA;
768 LS_TOKEN_STOKEN (parser->lexer.current).ptr
769 = PARSER_STREAM (parser);
770 LS_TOKEN_STOKEN (parser->lexer.current).length = 1;
771 ++(PARSER_STREAM (parser));
775 /* If the input is not a number, it must be a string.
776 [Keywords were already considered above.] */
777 parser->lexer.current = linespec_lexer_lex_string (parser);
782 return parser->lexer.current;
785 /* Consume the current token and return the next token in PARSER's
788 static linespec_token
789 linespec_lexer_consume_token (linespec_parser *parser)
791 parser->lexer.current.type = LSTOKEN_CONSUMED;
792 return linespec_lexer_lex_one (parser);
795 /* Return the next token without consuming the current token. */
797 static linespec_token
798 linespec_lexer_peek_token (linespec_parser *parser)
801 char *saved_stream = PARSER_STREAM (parser);
802 linespec_token saved_token = parser->lexer.current;
804 next = linespec_lexer_consume_token (parser);
805 PARSER_STREAM (parser) = saved_stream;
806 parser->lexer.current = saved_token;
810 /* Helper functions. */
812 /* Add SAL to SALS. */
815 add_sal_to_sals_basic (struct symtabs_and_lines *sals,
816 struct symtab_and_line *sal)
819 sals->sals = xrealloc (sals->sals, sals->nelts * sizeof (sals->sals[0]));
820 sals->sals[sals->nelts - 1] = *sal;
823 /* Add SAL to SALS, and also update SELF->CANONICAL_NAMES to reflect
824 the new sal, if needed. If not NULL, SYMNAME is the name of the
825 symbol to use when constructing the new canonical name.
827 If LITERAL_CANONICAL is non-zero, SYMNAME will be used as the
828 canonical name for the SAL. */
831 add_sal_to_sals (struct linespec_state *self,
832 struct symtabs_and_lines *sals,
833 struct symtab_and_line *sal,
834 const char *symname, int literal_canonical)
836 add_sal_to_sals_basic (sals, sal);
840 char *canonical_name = NULL;
842 self->canonical_names = xrealloc (self->canonical_names,
843 sals->nelts * sizeof (char *));
844 if (!literal_canonical && sal->symtab && sal->symtab->filename)
846 char *filename = sal->symtab->filename;
848 /* Note that the filter doesn't have to be a valid linespec
849 input. We only apply the ":LINE" treatment to Ada for
851 if (symname != NULL && sal->line != 0
852 && self->language->la_language == language_ada)
853 canonical_name = xstrprintf ("%s:%s:%d", filename, symname,
855 else if (symname != NULL)
856 canonical_name = xstrprintf ("%s:%s", filename, symname);
858 canonical_name = xstrprintf ("%s:%d", filename, sal->line);
860 else if (symname != NULL)
861 canonical_name = xstrdup (symname);
863 self->canonical_names[sals->nelts - 1] = canonical_name;
867 /* A hash function for address_entry. */
870 hash_address_entry (const void *p)
872 const struct address_entry *aep = p;
875 hash = iterative_hash_object (aep->pspace, 0);
876 return iterative_hash_object (aep->addr, hash);
879 /* An equality function for address_entry. */
882 eq_address_entry (const void *a, const void *b)
884 const struct address_entry *aea = a;
885 const struct address_entry *aeb = b;
887 return aea->pspace == aeb->pspace && aea->addr == aeb->addr;
890 /* Check whether the address, represented by PSPACE and ADDR, is
891 already in the set. If so, return 0. Otherwise, add it and return
895 maybe_add_address (htab_t set, struct program_space *pspace, CORE_ADDR addr)
897 struct address_entry e, *p;
902 slot = htab_find_slot (set, &e, INSERT);
906 p = XNEW (struct address_entry);
907 memcpy (p, &e, sizeof (struct address_entry));
913 /* A callback function and the additional data to call it with. */
915 struct symbol_and_data_callback
917 /* The callback to use. */
918 symbol_found_callback_ftype *callback;
920 /* Data to be passed to the callback. */
924 /* A helper for iterate_over_all_matching_symtabs that is used to
925 restrict calls to another callback to symbols representing inline
929 iterate_inline_only (struct symbol *sym, void *d)
931 if (SYMBOL_INLINED (sym))
933 struct symbol_and_data_callback *cad = d;
935 return cad->callback (sym, cad->data);
937 return 1; /* Continue iterating. */
940 /* Some data for the expand_symtabs_matching callback. */
942 struct symbol_matcher_data
944 /* The lookup name against which symbol name should be compared. */
945 const char *lookup_name;
947 /* The routine to be used for comparison. */
948 symbol_name_cmp_ftype symbol_name_cmp;
951 /* A helper for iterate_over_all_matching_symtabs that is passed as a
952 callback to the expand_symtabs_matching method. */
955 iterate_name_matcher (const char *name, void *d)
957 const struct symbol_matcher_data *data = d;
959 if (data->symbol_name_cmp (name, data->lookup_name) == 0)
960 return 1; /* Expand this symbol's symbol table. */
961 return 0; /* Skip this symbol. */
964 /* A helper that walks over all matching symtabs in all objfiles and
965 calls CALLBACK for each symbol matching NAME. If SEARCH_PSPACE is
966 not NULL, then the search is restricted to just that program
967 space. If INCLUDE_INLINE is nonzero then symbols representing
968 inlined instances of functions will be included in the result. */
971 iterate_over_all_matching_symtabs (struct linespec_state *state,
973 const domain_enum domain,
974 symbol_found_callback_ftype *callback,
976 struct program_space *search_pspace,
979 struct objfile *objfile;
980 struct program_space *pspace;
981 struct symbol_matcher_data matcher_data;
983 matcher_data.lookup_name = name;
984 matcher_data.symbol_name_cmp =
985 state->language->la_get_symbol_name_cmp != NULL
986 ? state->language->la_get_symbol_name_cmp (name)
991 if (search_pspace != NULL && search_pspace != pspace)
993 if (pspace->executing_startup)
996 set_current_program_space (pspace);
998 ALL_OBJFILES (objfile)
1000 struct symtab *symtab;
1003 objfile->sf->qf->expand_symtabs_matching (objfile, NULL,
1004 iterate_name_matcher,
1008 ALL_OBJFILE_PRIMARY_SYMTABS (objfile, symtab)
1010 struct block *block;
1012 block = BLOCKVECTOR_BLOCK (BLOCKVECTOR (symtab), STATIC_BLOCK);
1013 state->language->la_iterate_over_symbols (block, name, domain,
1018 struct symbol_and_data_callback cad = { callback, data };
1021 for (i = FIRST_LOCAL_BLOCK;
1022 i < BLOCKVECTOR_NBLOCKS (BLOCKVECTOR (symtab)); i++)
1024 block = BLOCKVECTOR_BLOCK (BLOCKVECTOR (symtab), i);
1025 state->language->la_iterate_over_symbols
1026 (block, name, domain, iterate_inline_only, &cad);
1034 /* Returns the block to be used for symbol searches for the given SYMTAB,
1035 which may be NULL. */
1037 static struct block *
1038 get_search_block (struct symtab *symtab)
1040 struct block *block;
1043 block = BLOCKVECTOR_BLOCK (BLOCKVECTOR (symtab), STATIC_BLOCK);
1046 enum language save_language;
1048 /* get_selected_block can change the current language when there is
1049 no selected frame yet. */
1050 save_language = current_language->la_language;
1051 block = get_selected_block (0);
1052 set_language (save_language);
1058 /* A helper for find_method. This finds all methods in type T which
1059 match NAME. It adds matching symbol names to RESULT_NAMES, and
1060 adds T's direct superclasses to SUPERCLASSES. */
1063 find_methods (struct type *t, const char *name,
1064 VEC (const_char_ptr) **result_names,
1065 VEC (typep) **superclasses)
1068 const char *class_name = type_name_no_tag (t);
1070 /* Ignore this class if it doesn't have a name. This is ugly, but
1071 unless we figure out how to get the physname without the name of
1072 the class, then the loop can't do any good. */
1079 /* Loop over each method name. At this level, all overloads of a name
1080 are counted as a single name. There is an inner loop which loops over
1083 for (method_counter = TYPE_NFN_FIELDS (t) - 1;
1084 method_counter >= 0;
1087 const char *method_name = TYPE_FN_FIELDLIST_NAME (t, method_counter);
1088 char dem_opname[64];
1090 if (strncmp (method_name, "__", 2) == 0 ||
1091 strncmp (method_name, "op", 2) == 0 ||
1092 strncmp (method_name, "type", 4) == 0)
1094 if (cplus_demangle_opname (method_name, dem_opname, DMGL_ANSI))
1095 method_name = dem_opname;
1096 else if (cplus_demangle_opname (method_name, dem_opname, 0))
1097 method_name = dem_opname;
1100 if (strcmp_iw (method_name, name) == 0)
1104 for (field_counter = (TYPE_FN_FIELDLIST_LENGTH (t, method_counter)
1110 const char *phys_name;
1112 f = TYPE_FN_FIELDLIST1 (t, method_counter);
1113 if (TYPE_FN_FIELD_STUB (f, field_counter))
1115 phys_name = TYPE_FN_FIELD_PHYSNAME (f, field_counter);
1116 VEC_safe_push (const_char_ptr, *result_names, phys_name);
1122 for (ibase = 0; ibase < TYPE_N_BASECLASSES (t); ibase++)
1123 VEC_safe_push (typep, *superclasses, TYPE_BASECLASS (t, ibase));
1126 /* Find an instance of the character C in the string S that is outside
1127 of all parenthesis pairs, single-quoted strings, and double-quoted
1128 strings. Also, ignore the char within a template name, like a ','
1129 within foo<int, int>. */
1132 find_toplevel_char (const char *s, char c)
1134 int quoted = 0; /* zero if we're not in quotes;
1135 '"' if we're in a double-quoted string;
1136 '\'' if we're in a single-quoted string. */
1137 int depth = 0; /* Number of unclosed parens we've seen. */
1140 for (scan = s; *scan; scan++)
1144 if (*scan == quoted)
1146 else if (*scan == '\\' && *(scan + 1))
1149 else if (*scan == c && ! quoted && depth == 0)
1151 else if (*scan == '"' || *scan == '\'')
1153 else if (*scan == '(' || *scan == '<')
1155 else if ((*scan == ')' || *scan == '>') && depth > 0)
1162 /* The string equivalent of find_toplevel_char. Returns a pointer
1163 to the location of NEEDLE in HAYSTACK, ignoring any occurrences
1164 inside "()" and "<>". Returns NULL if NEEDLE was not found. */
1167 find_toplevel_string (const char *haystack, const char *needle)
1169 const char *s = haystack;
1173 s = find_toplevel_char (s, *needle);
1177 /* Found first char in HAYSTACK; check rest of string. */
1178 if (strncmp (s, needle, strlen (needle)) == 0)
1181 /* Didn't find it; loop over HAYSTACK, looking for the next
1182 instance of the first character of NEEDLE. */
1186 while (s != NULL && *s != '\0');
1188 /* NEEDLE was not found in HAYSTACK. */
1192 /* Given FILTERS, a list of canonical names, filter the sals in RESULT
1193 and store the result in SELF->CANONICAL. */
1196 filter_results (struct linespec_state *self,
1197 struct symtabs_and_lines *result,
1198 VEC (const_char_ptr) *filters)
1203 for (i = 0; VEC_iterate (const_char_ptr, filters, i, name); ++i)
1205 struct linespec_sals lsal;
1208 memset (&lsal, 0, sizeof (lsal));
1210 for (j = 0; j < result->nelts; ++j)
1212 if (strcmp (name, self->canonical_names[j]) == 0)
1213 add_sal_to_sals_basic (&lsal.sals, &result->sals[j]);
1216 if (lsal.sals.nelts > 0)
1218 lsal.canonical = xstrdup (name);
1219 VEC_safe_push (linespec_sals, self->canonical->sals, &lsal);
1223 self->canonical->pre_expanded = 0;
1226 /* Store RESULT into SELF->CANONICAL. */
1229 convert_results_to_lsals (struct linespec_state *self,
1230 struct symtabs_and_lines *result)
1232 struct linespec_sals lsal;
1234 lsal.canonical = NULL;
1235 lsal.sals = *result;
1236 VEC_safe_push (linespec_sals, self->canonical->sals, &lsal);
1239 /* Handle multiple results in RESULT depending on SELECT_MODE. This
1240 will either return normally, throw an exception on multiple
1241 results, or present a menu to the user. On return, the SALS vector
1242 in SELF->CANONICAL is set up properly. */
1245 decode_line_2 (struct linespec_state *self,
1246 struct symtabs_and_lines *result,
1247 const char *select_mode)
1250 char *args, *prompt;
1252 struct cleanup *old_chain;
1253 VEC (const_char_ptr) *item_names = NULL, *filters = NULL;
1254 struct get_number_or_range_state state;
1256 gdb_assert (select_mode != multiple_symbols_all);
1257 gdb_assert (self->canonical != NULL);
1259 old_chain = make_cleanup (VEC_cleanup (const_char_ptr), &item_names);
1260 make_cleanup (VEC_cleanup (const_char_ptr), &filters);
1261 for (i = 0; i < result->nelts; ++i)
1266 gdb_assert (self->canonical_names[i] != NULL);
1267 for (j = 0; VEC_iterate (const_char_ptr, item_names, j, iter); ++j)
1269 if (strcmp (iter, self->canonical_names[i]) == 0)
1277 VEC_safe_push (const_char_ptr, item_names, self->canonical_names[i]);
1280 if (select_mode == multiple_symbols_cancel
1281 && VEC_length (const_char_ptr, item_names) > 1)
1282 error (_("canceled because the command is ambiguous\n"
1283 "See set/show multiple-symbol."));
1285 if (select_mode == multiple_symbols_all
1286 || VEC_length (const_char_ptr, item_names) == 1)
1288 do_cleanups (old_chain);
1289 convert_results_to_lsals (self, result);
1293 /* Sort the list of method names alphabetically. */
1294 qsort (VEC_address (const_char_ptr, item_names),
1295 VEC_length (const_char_ptr, item_names),
1296 sizeof (const_char_ptr), compare_strings);
1298 printf_unfiltered (_("[0] cancel\n[1] all\n"));
1299 for (i = 0; VEC_iterate (const_char_ptr, item_names, i, iter); ++i)
1300 printf_unfiltered ("[%d] %s\n", i + 2, iter);
1302 prompt = getenv ("PS2");
1307 args = command_line_input (prompt, 0, "overload-choice");
1309 if (args == 0 || *args == 0)
1310 error_no_arg (_("one or more choice numbers"));
1312 init_number_or_range (&state, args);
1313 while (!state.finished)
1317 num = get_number_or_range (&state);
1320 error (_("canceled"));
1323 /* We intentionally make this result in a single breakpoint,
1324 contrary to what older versions of gdb did. The
1325 rationale is that this lets a user get the
1326 multiple_symbols_all behavior even with the 'ask'
1327 setting; and he can get separate breakpoints by entering
1328 "2-57" at the query. */
1329 do_cleanups (old_chain);
1330 convert_results_to_lsals (self, result);
1335 if (num >= VEC_length (const_char_ptr, item_names))
1336 printf_unfiltered (_("No choice number %d.\n"), num);
1339 const char *elt = VEC_index (const_char_ptr, item_names, num);
1343 VEC_safe_push (const_char_ptr, filters, elt);
1344 VEC_replace (const_char_ptr, item_names, num, NULL);
1348 printf_unfiltered (_("duplicate request for %d ignored.\n"),
1354 filter_results (self, result, filters);
1355 do_cleanups (old_chain);
1360 /* The parser of linespec itself. */
1362 /* Throw an appropriate error when SYMBOL is not found (optionally in
1365 static void ATTRIBUTE_NORETURN
1366 symbol_not_found_error (const char *symbol, const char *filename)
1371 if (!have_full_symbols ()
1372 && !have_partial_symbols ()
1373 && !have_minimal_symbols ())
1374 throw_error (NOT_FOUND_ERROR,
1375 _("No symbol table is loaded. Use the \"file\" command."));
1377 /* If SYMBOL starts with '$', the user attempted to either lookup
1378 a function/variable in his code starting with '$' or an internal
1379 variable of that name. Since we do not know which, be concise and
1380 explain both possibilities. */
1384 throw_error (NOT_FOUND_ERROR,
1385 _("Undefined convenience variable or function \"%s\" "
1386 "not defined in \"%s\"."), symbol, filename);
1388 throw_error (NOT_FOUND_ERROR,
1389 _("Undefined convenience variable or function \"%s\" "
1390 "not defined."), symbol);
1395 throw_error (NOT_FOUND_ERROR,
1396 _("Function \"%s\" not defined in \"%s\"."),
1399 throw_error (NOT_FOUND_ERROR,
1400 _("Function \"%s\" not defined."), symbol);
1404 /* Throw an appropriate error when an unexpected token is encountered
1407 static void ATTRIBUTE_NORETURN
1408 unexpected_linespec_error (linespec_parser *parser)
1410 linespec_token token;
1411 static const char * token_type_strings[]
1412 = {"keyword", "colon", "string", "number", "comma", "end of input"};
1414 /* Get the token that generated the error. */
1415 token = linespec_lexer_lex_one (parser);
1417 /* Finally, throw the error. */
1418 if (token.type == LSTOKEN_STRING || token.type == LSTOKEN_NUMBER
1419 || token.type == LSTOKEN_KEYWORD)
1422 struct cleanup *cleanup;
1424 string = copy_token_string (token);
1425 cleanup = make_cleanup (xfree, string);
1426 throw_error (GENERIC_ERROR,
1427 _("malformed linespec error: unexpected %s, \"%s\""),
1428 token_type_strings[token.type], string);
1431 throw_error (GENERIC_ERROR,
1432 _("malformed linespec error: unexpected %s"),
1433 token_type_strings[token.type]);
1436 /* Parse and return a line offset in STRING. */
1438 static struct line_offset
1439 linespec_parse_line_offset (const char *string)
1441 struct line_offset line_offset = {0, LINE_OFFSET_NONE};
1445 line_offset.sign = LINE_OFFSET_PLUS;
1448 else if (*string == '-')
1450 line_offset.sign = LINE_OFFSET_MINUS;
1454 /* Right now, we only allow base 10 for offsets. */
1455 line_offset.offset = atoi (string);
1459 /* Parse the basic_spec in PARSER's input. */
1462 linespec_parse_basic (linespec_parser *parser)
1465 linespec_token token;
1466 VEC (symbolp) *symbols, *labels;
1467 VEC (minsym_and_objfile_d) *minimal_symbols;
1468 struct cleanup *cleanup;
1470 /* Get the next token. */
1471 token = linespec_lexer_lex_one (parser);
1473 /* If it is EOI or KEYWORD, issue an error. */
1474 if (token.type == LSTOKEN_KEYWORD || token.type == LSTOKEN_EOI)
1475 unexpected_linespec_error (parser);
1476 /* If it is a LSTOKEN_NUMBER, we have an offset. */
1477 else if (token.type == LSTOKEN_NUMBER)
1479 /* Record the line offset and get the next token. */
1480 name = copy_token_string (token);
1481 cleanup = make_cleanup (xfree, name);
1482 PARSER_RESULT (parser)->line_offset = linespec_parse_line_offset (name);
1483 do_cleanups (cleanup);
1485 /* Get the next token. */
1486 token = linespec_lexer_consume_token (parser);
1488 /* If the next token is a comma, stop parsing and return. */
1489 if (token.type == LSTOKEN_COMMA)
1492 /* If the next token is anything but EOI or KEYWORD, issue
1494 if (token.type != LSTOKEN_KEYWORD && token.type != LSTOKEN_EOI)
1495 unexpected_linespec_error (parser);
1498 if (token.type == LSTOKEN_KEYWORD || token.type == LSTOKEN_EOI)
1501 /* Next token must be LSTOKEN_STRING. */
1502 if (token.type != LSTOKEN_STRING)
1503 unexpected_linespec_error (parser);
1505 /* The current token will contain the name of a function, method,
1507 name = copy_token_string (token);
1508 cleanup = make_cleanup (xfree, name);
1510 /* Try looking it up as a function/method. */
1511 find_linespec_symbols (PARSER_STATE (parser),
1512 PARSER_RESULT (parser)->file_symtabs, name,
1513 &symbols, &minimal_symbols);
1515 if (symbols != NULL || minimal_symbols != NULL)
1517 PARSER_RESULT (parser)->function_symbols = symbols;
1518 PARSER_RESULT (parser)->minimal_symbols = minimal_symbols;
1519 PARSER_RESULT (parser)->function_name = name;
1521 discard_cleanups (cleanup);
1525 /* NAME was not a function or a method. So it must be a label
1527 labels = find_label_symbols (PARSER_STATE (parser), NULL,
1531 PARSER_RESULT (parser)->labels.label_symbols = labels;
1532 PARSER_RESULT (parser)->labels.function_symbols = symbols;
1533 PARSER_RESULT (parser)->label_name = name;
1535 discard_cleanups (cleanup);
1539 /* The name is also not a label. Abort parsing. Do not throw
1540 an error here. parse_linespec will do it for us. */
1542 /* Save a copy of the name we were trying to lookup. */
1543 PARSER_RESULT (parser)->function_name = name;
1544 discard_cleanups (cleanup);
1549 /* Get the next token. */
1550 token = linespec_lexer_consume_token (parser);
1552 if (token.type == LSTOKEN_COLON)
1554 /* User specified a label or a lineno. */
1555 token = linespec_lexer_consume_token (parser);
1557 if (token.type == LSTOKEN_NUMBER)
1559 /* User specified an offset. Record the line offset and
1560 get the next token. */
1561 name = copy_token_string (token);
1562 cleanup = make_cleanup (xfree, name);
1563 PARSER_RESULT (parser)->line_offset
1564 = linespec_parse_line_offset (name);
1565 do_cleanups (cleanup);
1567 /* Ge the next token. */
1568 token = linespec_lexer_consume_token (parser);
1570 else if (token.type == LSTOKEN_STRING)
1572 /* Grab a copy of the label's name and look it up. */
1573 name = copy_token_string (token);
1574 cleanup = make_cleanup (xfree, name);
1575 labels = find_label_symbols (PARSER_STATE (parser),
1576 PARSER_RESULT (parser)->function_symbols,
1581 PARSER_RESULT (parser)->labels.label_symbols = labels;
1582 PARSER_RESULT (parser)->labels.function_symbols = symbols;
1583 PARSER_RESULT (parser)->label_name = name;
1585 discard_cleanups (cleanup);
1589 /* We don't know what it was, but it isn't a label. */
1590 throw_error (NOT_FOUND_ERROR,
1591 _("No label \"%s\" defined in function \"%s\"."),
1592 name, PARSER_RESULT (parser)->function_name);
1595 /* Check for a line offset. */
1596 token = linespec_lexer_consume_token (parser);
1597 if (token.type == LSTOKEN_COLON)
1599 /* Get the next token. */
1600 token = linespec_lexer_consume_token (parser);
1602 /* It must be a line offset. */
1603 if (token.type != LSTOKEN_NUMBER)
1604 unexpected_linespec_error (parser);
1606 /* Record the lione offset and get the next token. */
1607 name = copy_token_string (token);
1608 cleanup = make_cleanup (xfree, name);
1610 PARSER_RESULT (parser)->line_offset
1611 = linespec_parse_line_offset (name);
1612 do_cleanups (cleanup);
1614 /* Get the next token. */
1615 token = linespec_lexer_consume_token (parser);
1620 /* Trailing ':' in the input. Issue an error. */
1621 unexpected_linespec_error (parser);
1626 /* Canonicalize the linespec contained in LS. The result is saved into
1627 STATE->canonical. */
1630 canonicalize_linespec (struct linespec_state *state, linespec_p ls)
1632 /* If canonicalization was not requested, no need to do anything. */
1633 if (!state->canonical)
1636 /* Shortcut expressions, which can only appear by themselves. */
1637 if (ls->expression != NULL)
1638 state->canonical->addr_string = xstrdup (ls->expression);
1641 struct ui_file *buf;
1644 buf = mem_fileopen ();
1645 if (ls->source_filename)
1647 fputs_unfiltered (ls->source_filename, buf);
1651 if (ls->function_name)
1654 fputc_unfiltered (':', buf);
1655 fputs_unfiltered (ls->function_name, buf);
1662 fputc_unfiltered (':', buf);
1664 if (ls->function_name == NULL)
1668 /* No function was specified, so add the symbol name. */
1669 gdb_assert (ls->labels.function_symbols != NULL
1670 && (VEC_length (symbolp, ls->labels.function_symbols)
1672 s = VEC_index (symbolp, ls->labels.function_symbols, 0);
1673 fputs_unfiltered (SYMBOL_NATURAL_NAME (s), buf);
1674 fputc_unfiltered (':', buf);
1677 fputs_unfiltered (ls->label_name, buf);
1679 state->canonical->special_display = 1;
1682 if (ls->line_offset.sign != LINE_OFFSET_UNKNOWN)
1685 fputc_unfiltered (':', buf);
1686 fprintf_filtered (buf, "%s%d",
1687 (ls->line_offset.sign == LINE_OFFSET_NONE ? ""
1688 : (ls->line_offset.sign
1689 == LINE_OFFSET_PLUS ? "+" : "-")),
1690 ls->line_offset.offset);
1693 state->canonical->addr_string = ui_file_xstrdup (buf, NULL);
1694 ui_file_delete (buf);
1698 /* Given a line offset in LS, construct the relevant SALs. */
1700 static struct symtabs_and_lines
1701 create_sals_line_offset (struct linespec_state *self,
1704 struct symtabs_and_lines values;
1705 struct symtab_and_line val;
1706 int use_default = 0;
1712 /* This is where we need to make sure we have good defaults.
1713 We must guarantee that this section of code is never executed
1714 when we are called with just a function name, since
1715 set_default_source_symtab_and_line uses
1716 select_source_symtab that calls us with such an argument. */
1718 if (VEC_length (symtab_p, ls->file_symtabs) == 1
1719 && VEC_index (symtab_p, ls->file_symtabs, 0) == NULL)
1721 set_current_program_space (self->program_space);
1723 /* Make sure we have at least a default source line. */
1724 set_default_source_symtab_and_line ();
1725 initialize_defaults (&self->default_symtab, &self->default_line);
1726 VEC_pop (symtab_p, ls->file_symtabs);
1727 VEC_free (symtab_p, ls->file_symtabs);
1729 = collect_symtabs_from_filename (self->default_symtab->filename);
1733 val.line = ls->line_offset.offset;
1734 switch (ls->line_offset.sign)
1736 case LINE_OFFSET_PLUS:
1737 if (ls->line_offset.offset == 0)
1740 val.line = self->default_line + val.line;
1743 case LINE_OFFSET_MINUS:
1744 if (ls->line_offset.offset == 0)
1747 val.line = self->default_line - val.line;
1749 val.line = -val.line;
1752 case LINE_OFFSET_NONE:
1753 break; /* No need to adjust val.line. */
1756 if (self->list_mode)
1757 decode_digits_list_mode (self, ls, &values, val);
1760 struct linetable_entry *best_entry = NULL;
1762 struct block **blocks;
1763 struct cleanup *cleanup;
1764 struct symtabs_and_lines intermediate_results;
1767 intermediate_results.sals = NULL;
1768 intermediate_results.nelts = 0;
1770 decode_digits_ordinary (self, ls, val.line, &intermediate_results,
1772 if (intermediate_results.nelts == 0 && best_entry != NULL)
1773 decode_digits_ordinary (self, ls, best_entry->line,
1774 &intermediate_results, &best_entry);
1776 cleanup = make_cleanup (xfree, intermediate_results.sals);
1778 /* For optimized code, the compiler can scatter one source line
1779 across disjoint ranges of PC values, even when no duplicate
1780 functions or inline functions are involved. For example,
1781 'for (;;)' inside a non-template, non-inline, and non-ctor-or-dtor
1782 function can result in two PC ranges. In this case, we don't
1783 want to set a breakpoint on the first PC of each range. To filter
1784 such cases, we use containing blocks -- for each PC found
1785 above, we see if there are other PCs that are in the same
1786 block. If yes, the other PCs are filtered out. */
1788 filter = XNEWVEC (int, intermediate_results.nelts);
1789 make_cleanup (xfree, filter);
1790 blocks = XNEWVEC (struct block *, intermediate_results.nelts);
1791 make_cleanup (xfree, blocks);
1793 for (i = 0; i < intermediate_results.nelts; ++i)
1795 set_current_program_space (intermediate_results.sals[i].pspace);
1798 blocks[i] = block_for_pc_sect (intermediate_results.sals[i].pc,
1799 intermediate_results.sals[i].section);
1802 for (i = 0; i < intermediate_results.nelts; ++i)
1804 if (blocks[i] != NULL)
1805 for (j = i + 1; j < intermediate_results.nelts; ++j)
1807 if (blocks[j] == blocks[i])
1815 for (i = 0; i < intermediate_results.nelts; ++i)
1818 struct symbol *sym = (blocks[i]
1819 ? block_containing_function (blocks[i])
1822 if (self->funfirstline)
1823 skip_prologue_sal (&intermediate_results.sals[i]);
1824 /* Make sure the line matches the request, not what was
1826 intermediate_results.sals[i].line = val.line;
1827 add_sal_to_sals (self, &values, &intermediate_results.sals[i],
1828 sym ? SYMBOL_NATURAL_NAME (sym) : NULL, 0);
1831 do_cleanups (cleanup);
1834 if (values.nelts == 0)
1836 if (ls->source_filename)
1837 throw_error (NOT_FOUND_ERROR, _("No line %d in file \"%s\"."),
1838 val.line, ls->source_filename);
1840 throw_error (NOT_FOUND_ERROR, _("No line %d in the current file."),
1847 /* Create and return SALs from the linespec LS. */
1849 static struct symtabs_and_lines
1850 convert_linespec_to_sals (struct linespec_state *state, linespec_p ls)
1852 struct symtabs_and_lines sals = {NULL, 0};
1854 if (ls->expression != NULL)
1856 struct symtab_and_line sal;
1858 /* We have an expression. No other attribute is allowed. */
1859 sal = find_pc_line (ls->expr_pc, 0);
1860 sal.pc = ls->expr_pc;
1861 sal.section = find_pc_overlay (ls->expr_pc);
1862 sal.explicit_pc = 1;
1863 add_sal_to_sals (state, &sals, &sal, ls->expression, 1);
1865 else if (ls->labels.label_symbols != NULL)
1867 /* We have just a bunch of functions/methods or labels. */
1869 struct symtab_and_line sal;
1872 for (i = 0; VEC_iterate (symbolp, ls->labels.label_symbols, i, sym); ++i)
1874 if (symbol_to_sal (&sal, state->funfirstline, sym))
1875 add_sal_to_sals (state, &sals, &sal,
1876 SYMBOL_NATURAL_NAME (sym), 0);
1879 else if (ls->function_symbols != NULL || ls->minimal_symbols != NULL)
1881 /* We have just a bunch of functions and/or methods. */
1883 struct symtab_and_line sal;
1885 minsym_and_objfile_d *elem;
1886 struct program_space *pspace;
1888 if (ls->function_symbols != NULL)
1890 /* Sort symbols so that symbols with the same program space are next
1892 qsort (VEC_address (symbolp, ls->function_symbols),
1893 VEC_length (symbolp, ls->function_symbols),
1894 sizeof (symbolp), compare_symbols);
1896 for (i = 0; VEC_iterate (symbolp, ls->function_symbols, i, sym); ++i)
1898 pspace = SYMTAB_PSPACE (SYMBOL_SYMTAB (sym));
1899 set_current_program_space (pspace);
1900 if (symbol_to_sal (&sal, state->funfirstline, sym)
1901 && maybe_add_address (state->addr_set, pspace, sal.pc))
1902 add_sal_to_sals (state, &sals, &sal,
1903 SYMBOL_NATURAL_NAME (sym), 0);
1907 if (ls->minimal_symbols != NULL)
1909 /* Sort minimal symbols by program space, too. */
1910 qsort (VEC_address (minsym_and_objfile_d, ls->minimal_symbols),
1911 VEC_length (minsym_and_objfile_d, ls->minimal_symbols),
1912 sizeof (minsym_and_objfile_d), compare_msymbols);
1915 VEC_iterate (minsym_and_objfile_d, ls->minimal_symbols, i, elem);
1918 pspace = elem->objfile->pspace;
1919 set_current_program_space (pspace);
1920 minsym_found (state, elem->objfile, elem->minsym, &sals);
1924 else if (ls->line_offset.sign != LINE_OFFSET_UNKNOWN)
1926 /* Only an offset was specified. */
1927 sals = create_sals_line_offset (state, ls);
1929 /* Make sure we have a filename for canonicalization. */
1930 if (ls->source_filename == NULL)
1931 ls->source_filename = xstrdup (state->default_symtab->filename);
1935 /* We haven't found any results... */
1939 canonicalize_linespec (state, ls);
1941 if (sals.nelts > 0 && state->canonical != NULL)
1942 state->canonical->pre_expanded = 1;
1947 /* Parse a string that specifies a linespec.
1948 Pass the address of a char * variable; that variable will be
1949 advanced over the characters actually parsed.
1951 The basic grammar of linespecs:
1953 linespec -> expr_spec | var_spec | basic_spec
1954 expr_spec -> '*' STRING
1955 var_spec -> '$' (STRING | NUMBER)
1957 basic_spec -> file_offset_spec | function_spec | label_spec
1958 file_offset_spec -> opt_file_spec offset_spec
1959 function_spec -> opt_file_spec function_name_spec opt_label_spec
1960 label_spec -> label_name_spec
1962 opt_file_spec -> "" | file_name_spec ':'
1963 opt_label_spec -> "" | ':' label_name_spec
1965 file_name_spec -> STRING
1966 function_name_spec -> STRING
1967 label_name_spec -> STRING
1968 function_name_spec -> STRING
1969 offset_spec -> NUMBER
1973 This may all be followed by several keywords such as "if EXPR",
1976 A comma will terminate parsing.
1978 The function may be an undebuggable function found in minimal symbol table.
1980 If the argument FUNFIRSTLINE is nonzero, we want the first line
1981 of real code inside a function when a function is specified, and it is
1982 not OK to specify a variable or type to get its line number.
1984 DEFAULT_SYMTAB specifies the file to use if none is specified.
1985 It defaults to current_source_symtab.
1986 DEFAULT_LINE specifies the line number to use for relative
1987 line numbers (that start with signs). Defaults to current_source_line.
1988 If CANONICAL is non-NULL, store an array of strings containing the canonical
1989 line specs there if necessary. Currently overloaded member functions and
1990 line numbers or static functions without a filename yield a canonical
1991 line spec. The array and the line spec strings are allocated on the heap,
1992 it is the callers responsibility to free them.
1994 Note that it is possible to return zero for the symtab
1995 if no file is validly specified. Callers must check that.
1996 Also, the line number returned may be invalid. */
1998 /* Parse the linespec in ARGPTR. */
2000 static struct symtabs_and_lines
2001 parse_linespec (linespec_parser *parser, char **argptr)
2003 linespec_token token;
2004 struct symtabs_and_lines values;
2005 volatile struct gdb_exception file_exception;
2006 struct cleanup *cleanup;
2008 /* A special case to start. It has become quite popular for
2009 IDEs to work around bugs in the previous parser by quoting
2010 the entire linespec, so we attempt to deal with this nicely. */
2011 parser->is_quote_enclosed = 0;
2012 if (!is_ada_operator (*argptr)
2013 && strchr (linespec_quote_characters, **argptr) != NULL)
2017 end = skip_quote_char (*argptr + 1, **argptr);
2018 if (end != NULL && is_closing_quote_enclosed (end))
2020 /* Here's the special case. Skip ARGPTR past the initial
2023 parser->is_quote_enclosed = 1;
2027 parser->lexer.saved_arg = *argptr;
2028 parser->lexer.stream = argptr;
2029 file_exception.reason = 0;
2031 /* Initialize the default symtab and line offset. */
2032 initialize_defaults (&PARSER_STATE (parser)->default_symtab,
2033 &PARSER_STATE (parser)->default_line);
2035 /* Objective-C shortcut. */
2036 values = decode_objc (PARSER_STATE (parser), PARSER_RESULT (parser), argptr);
2037 if (values.sals != NULL)
2040 /* Start parsing. */
2042 /* Get the first token. */
2043 token = linespec_lexer_lex_one (parser);
2045 /* It must be either LSTOKEN_STRING or LSTOKEN_NUMBER. */
2046 if (token.type == LSTOKEN_STRING && *LS_TOKEN_STOKEN (token).ptr == '*')
2050 /* User specified an expression, *EXPR. */
2051 copy = expr = copy_token_string (token);
2052 cleanup = make_cleanup (xfree, expr);
2053 PARSER_RESULT (parser)->expr_pc = linespec_expression_to_pc (©);
2054 discard_cleanups (cleanup);
2055 PARSER_RESULT (parser)->expression = expr;
2057 /* This is a little hacky/tricky. If linespec_expression_to_pc
2058 did not evaluate the entire token, then we must find the
2059 string COPY inside the original token buffer. */
2062 PARSER_STREAM (parser) = strstr (parser->lexer.saved_arg, copy);
2063 gdb_assert (PARSER_STREAM (parser) != NULL);
2066 /* Consume the token. */
2067 linespec_lexer_consume_token (parser);
2069 goto convert_to_sals;
2071 else if (token.type == LSTOKEN_STRING && *LS_TOKEN_STOKEN (token).ptr == '$')
2075 /* A NULL entry means to use GLOBAL_DEFAULT_SYMTAB. */
2076 VEC_safe_push (symtab_p, PARSER_RESULT (parser)->file_symtabs, NULL);
2078 /* User specified a convenience variable or history value. */
2079 var = copy_token_string (token);
2080 cleanup = make_cleanup (xfree, var);
2081 PARSER_RESULT (parser)->line_offset
2082 = linespec_parse_variable (PARSER_STATE (parser), var);
2084 /* If a line_offset wasn't found (VAR is the name of a user
2085 variable/function), then skip to normal symbol processing. */
2086 if (PARSER_RESULT (parser)->line_offset.sign != LINE_OFFSET_UNKNOWN)
2088 discard_cleanups (cleanup);
2090 /* Consume this token. */
2091 linespec_lexer_consume_token (parser);
2093 goto convert_to_sals;
2096 do_cleanups (cleanup);
2098 else if (token.type != LSTOKEN_STRING && token.type != LSTOKEN_NUMBER)
2099 unexpected_linespec_error (parser);
2101 /* Shortcut: If the next token is not LSTOKEN_COLON, we know that
2102 this token cannot represent a filename. */
2103 token = linespec_lexer_peek_token (parser);
2105 if (token.type == LSTOKEN_COLON)
2107 char *user_filename;
2109 /* Get the current token again and extract the filename. */
2110 token = linespec_lexer_lex_one (parser);
2111 user_filename = copy_token_string (token);
2113 /* Check if the input is a filename. */
2114 TRY_CATCH (file_exception, RETURN_MASK_ERROR)
2116 PARSER_RESULT (parser)->file_symtabs
2117 = symtabs_from_filename (user_filename);
2120 if (file_exception.reason >= 0)
2122 /* Symtabs were found for the file. Record the filename. */
2123 PARSER_RESULT (parser)->source_filename = user_filename;
2125 /* Get the next token. */
2126 token = linespec_lexer_consume_token (parser);
2128 /* This is LSTOKEN_COLON; consume it. */
2129 linespec_lexer_consume_token (parser);
2133 /* No symtabs found -- discard user_filename. */
2134 xfree (user_filename);
2136 /* A NULL entry means to use GLOBAL_DEFAULT_SYMTAB. */
2137 VEC_safe_push (symtab_p, PARSER_RESULT (parser)->file_symtabs, NULL);
2140 /* If the next token is not EOI, KEYWORD, or COMMA, issue an error. */
2141 else if (token.type != LSTOKEN_EOI && token.type != LSTOKEN_KEYWORD
2142 && token.type != LSTOKEN_COMMA)
2144 /* TOKEN is the _next_ token, not the one currently in the parser.
2145 Consuming the token will give the correct error message. */
2146 linespec_lexer_consume_token (parser);
2147 unexpected_linespec_error (parser);
2151 /* A NULL entry means to use GLOBAL_DEFAULT_SYMTAB. */
2152 VEC_safe_push (symtab_p, PARSER_RESULT (parser)->file_symtabs, NULL);
2155 /* Parse the rest of the linespec. */
2156 linespec_parse_basic (parser);
2158 if (PARSER_RESULT (parser)->function_symbols == NULL
2159 && PARSER_RESULT (parser)->labels.label_symbols == NULL
2160 && PARSER_RESULT (parser)->line_offset.sign == LINE_OFFSET_UNKNOWN
2161 && PARSER_RESULT (parser)->minimal_symbols == NULL)
2163 /* The linespec didn't parse. Re-throw the file exception if
2165 if (file_exception.reason < 0)
2166 throw_exception (file_exception);
2168 /* Otherwise, the symbol is not found. */
2169 symbol_not_found_error (PARSER_RESULT (parser)->function_name,
2170 PARSER_RESULT (parser)->source_filename);
2175 /* Get the last token and record how much of the input was parsed,
2177 token = linespec_lexer_lex_one (parser);
2178 if (token.type != LSTOKEN_EOI && token.type != LSTOKEN_KEYWORD)
2179 PARSER_STREAM (parser) = LS_TOKEN_STOKEN (token).ptr;
2181 /* Convert the data in PARSER_RESULT to SALs. */
2182 values = convert_linespec_to_sals (PARSER_STATE (parser),
2183 PARSER_RESULT (parser));
2189 /* A constructor for linespec_state. */
2192 linespec_state_constructor (struct linespec_state *self,
2193 int flags, const struct language_defn *language,
2194 struct symtab *default_symtab,
2196 struct linespec_result *canonical)
2198 memset (self, 0, sizeof (*self));
2199 self->language = language;
2200 self->funfirstline = (flags & DECODE_LINE_FUNFIRSTLINE) ? 1 : 0;
2201 self->list_mode = (flags & DECODE_LINE_LIST_MODE) ? 1 : 0;
2202 self->default_symtab = default_symtab;
2203 self->default_line = default_line;
2204 self->canonical = canonical;
2205 self->program_space = current_program_space;
2206 self->addr_set = htab_create_alloc (10, hash_address_entry, eq_address_entry,
2207 xfree, xcalloc, xfree);
2210 /* Initialize a new linespec parser. */
2213 linespec_parser_new (linespec_parser *parser,
2214 int flags, const struct language_defn *language,
2215 struct symtab *default_symtab,
2217 struct linespec_result *canonical)
2219 parser->lexer.current.type = LSTOKEN_CONSUMED;
2220 memset (PARSER_RESULT (parser), 0, sizeof (struct linespec));
2221 PARSER_RESULT (parser)->line_offset.sign = LINE_OFFSET_UNKNOWN;
2222 linespec_state_constructor (PARSER_STATE (parser), flags, language,
2223 default_symtab, default_line, canonical);
2226 /* A destructor for linespec_state. */
2229 linespec_state_destructor (struct linespec_state *self)
2231 htab_delete (self->addr_set);
2234 /* Delete a linespec parser. */
2237 linespec_parser_delete (void *arg)
2239 linespec_parser *parser = (linespec_parser *) arg;
2241 xfree ((char *) PARSER_RESULT (parser)->expression);
2242 xfree ((char *) PARSER_RESULT (parser)->source_filename);
2243 xfree ((char *) PARSER_RESULT (parser)->label_name);
2244 xfree ((char *) PARSER_RESULT (parser)->function_name);
2246 if (PARSER_RESULT (parser)->file_symtabs != NULL)
2247 VEC_free (symtab_p, PARSER_RESULT (parser)->file_symtabs);
2249 if (PARSER_RESULT (parser)->function_symbols != NULL)
2250 VEC_free (symbolp, PARSER_RESULT (parser)->function_symbols);
2252 if (PARSER_RESULT (parser)->minimal_symbols != NULL)
2253 VEC_free (minsym_and_objfile_d, PARSER_RESULT (parser)->minimal_symbols);
2255 if (PARSER_RESULT (parser)->labels.label_symbols != NULL)
2256 VEC_free (symbolp, PARSER_RESULT (parser)->labels.label_symbols);
2258 if (PARSER_RESULT (parser)->labels.function_symbols != NULL)
2259 VEC_free (symbolp, PARSER_RESULT (parser)->labels.function_symbols);
2261 linespec_state_destructor (PARSER_STATE (parser));
2264 /* See linespec.h. */
2267 decode_line_full (char **argptr, int flags,
2268 struct symtab *default_symtab,
2269 int default_line, struct linespec_result *canonical,
2270 const char *select_mode,
2273 struct symtabs_and_lines result;
2274 struct cleanup *cleanups;
2275 VEC (const_char_ptr) *filters = NULL;
2276 linespec_parser parser;
2277 struct linespec_state *state;
2279 gdb_assert (canonical != NULL);
2280 /* The filter only makes sense for 'all'. */
2281 gdb_assert (filter == NULL || select_mode == multiple_symbols_all);
2282 gdb_assert (select_mode == NULL
2283 || select_mode == multiple_symbols_all
2284 || select_mode == multiple_symbols_ask
2285 || select_mode == multiple_symbols_cancel);
2286 gdb_assert ((flags & DECODE_LINE_LIST_MODE) == 0);
2288 linespec_parser_new (&parser, flags, current_language, default_symtab,
2289 default_line, canonical);
2290 cleanups = make_cleanup (linespec_parser_delete, &parser);
2291 save_current_program_space ();
2293 result = parse_linespec (&parser, argptr);
2294 state = PARSER_STATE (&parser);
2296 gdb_assert (result.nelts == 1 || canonical->pre_expanded);
2297 gdb_assert (canonical->addr_string != NULL);
2298 canonical->pre_expanded = 1;
2300 /* Arrange for allocated canonical names to be freed. */
2301 if (result.nelts > 0)
2305 make_cleanup (xfree, state->canonical_names);
2306 for (i = 0; i < result.nelts; ++i)
2308 gdb_assert (state->canonical_names[i] != NULL);
2309 make_cleanup (xfree, state->canonical_names[i]);
2313 if (select_mode == NULL)
2315 if (ui_out_is_mi_like_p (interp_ui_out (top_level_interpreter ())))
2316 select_mode = multiple_symbols_all;
2318 select_mode = multiple_symbols_select_mode ();
2321 if (select_mode == multiple_symbols_all)
2325 make_cleanup (VEC_cleanup (const_char_ptr), &filters);
2326 VEC_safe_push (const_char_ptr, filters, filter);
2327 filter_results (state, &result, filters);
2330 convert_results_to_lsals (state, &result);
2333 decode_line_2 (state, &result, select_mode);
2335 do_cleanups (cleanups);
2338 /* See linespec.h. */
2340 struct symtabs_and_lines
2341 decode_line_1 (char **argptr, int flags,
2342 struct symtab *default_symtab,
2345 struct symtabs_and_lines result;
2346 linespec_parser parser;
2347 struct cleanup *cleanups;
2349 linespec_parser_new (&parser, flags, current_language, default_symtab,
2350 default_line, NULL);
2351 cleanups = make_cleanup (linespec_parser_delete, &parser);
2352 save_current_program_space ();
2354 result = parse_linespec (&parser, argptr);
2356 do_cleanups (cleanups);
2360 /* See linespec.h. */
2362 struct symtabs_and_lines
2363 decode_line_with_current_source (char *string, int flags)
2365 struct symtabs_and_lines sals;
2366 struct symtab_and_line cursal;
2369 error (_("Empty line specification."));
2371 /* We use whatever is set as the current source line. We do not try
2372 and get a default source symtab+line or it will recursively call us! */
2373 cursal = get_current_source_symtab_and_line ();
2375 sals = decode_line_1 (&string, flags,
2376 cursal.symtab, cursal.line);
2379 error (_("Junk at end of line specification: %s"), string);
2383 /* See linespec.h. */
2385 struct symtabs_and_lines
2386 decode_line_with_last_displayed (char *string, int flags)
2388 struct symtabs_and_lines sals;
2391 error (_("Empty line specification."));
2393 if (last_displayed_sal_is_valid ())
2394 sals = decode_line_1 (&string, flags,
2395 get_last_displayed_symtab (),
2396 get_last_displayed_line ());
2398 sals = decode_line_1 (&string, flags, (struct symtab *) NULL, 0);
2401 error (_("Junk at end of line specification: %s"), string);
2407 /* First, some functions to initialize stuff at the beggining of the
2411 initialize_defaults (struct symtab **default_symtab, int *default_line)
2413 if (*default_symtab == 0)
2415 /* Use whatever we have for the default source line. We don't use
2416 get_current_or_default_symtab_and_line as it can recurse and call
2418 struct symtab_and_line cursal =
2419 get_current_source_symtab_and_line ();
2421 *default_symtab = cursal.symtab;
2422 *default_line = cursal.line;
2428 /* Evaluate the expression pointed to by EXP_PTR into a CORE_ADDR,
2429 advancing EXP_PTR past any parsed text. */
2432 linespec_expression_to_pc (char **exp_ptr)
2434 if (current_program_space->executing_startup)
2435 /* The error message doesn't really matter, because this case
2436 should only hit during breakpoint reset. */
2437 throw_error (NOT_FOUND_ERROR, _("cannot evaluate expressions while "
2438 "program space is in startup"));
2441 return value_as_address (parse_to_comma_and_eval (exp_ptr));
2446 /* Here's where we recognise an Objective-C Selector. An Objective C
2447 selector may be implemented by more than one class, therefore it
2448 may represent more than one method/function. This gives us a
2449 situation somewhat analogous to C++ overloading. If there's more
2450 than one method that could represent the selector, then use some of
2451 the existing C++ code to let the user choose one. */
2453 static struct symtabs_and_lines
2454 decode_objc (struct linespec_state *self, linespec_p ls, char **argptr)
2456 struct collect_info info;
2457 VEC (const_char_ptr) *symbol_names = NULL;
2458 struct symtabs_and_lines values;
2460 struct cleanup *cleanup = make_cleanup (VEC_cleanup (const_char_ptr),
2464 info.file_symtabs = NULL;
2465 VEC_safe_push (symtab_p, info.file_symtabs, NULL);
2466 make_cleanup (VEC_cleanup (symtab_p), &info.file_symtabs);
2467 info.result.symbols = NULL;
2468 info.result.minimal_symbols = NULL;
2472 new_argptr = find_imps (*argptr, &symbol_names);
2473 if (VEC_empty (const_char_ptr, symbol_names))
2475 do_cleanups (cleanup);
2479 add_all_symbol_names_from_pspace (&info, NULL, symbol_names);
2481 if (!VEC_empty (symbolp, info.result.symbols)
2482 || !VEC_empty (minsym_and_objfile_d, info.result.minimal_symbols))
2486 saved_arg = alloca (new_argptr - *argptr + 1);
2487 memcpy (saved_arg, *argptr, new_argptr - *argptr);
2488 saved_arg[new_argptr - *argptr] = '\0';
2490 ls->function_name = xstrdup (saved_arg);
2491 ls->function_symbols = info.result.symbols;
2492 ls->minimal_symbols = info.result.minimal_symbols;
2493 values = convert_linespec_to_sals (self, ls);
2495 if (self->canonical)
2497 self->canonical->pre_expanded = 1;
2498 if (ls->source_filename)
2499 self->canonical->addr_string
2500 = xstrprintf ("%s:%s", ls->source_filename, saved_arg);
2502 self->canonical->addr_string = xstrdup (saved_arg);
2506 *argptr = new_argptr;
2508 do_cleanups (cleanup);
2513 /* An instance of this type is used when collecting prefix symbols for
2516 struct decode_compound_collector
2518 /* The result vector. */
2519 VEC (symbolp) *symbols;
2521 /* A hash table of all symbols we found. We use this to avoid
2522 adding any symbol more than once. */
2526 /* A callback for iterate_over_symbols that is used by
2527 lookup_prefix_sym to collect type symbols. */
2530 collect_one_symbol (struct symbol *sym, void *d)
2532 struct decode_compound_collector *collector = d;
2536 if (SYMBOL_CLASS (sym) != LOC_TYPEDEF)
2537 return 1; /* Continue iterating. */
2539 t = SYMBOL_TYPE (sym);
2541 if (TYPE_CODE (t) != TYPE_CODE_STRUCT
2542 && TYPE_CODE (t) != TYPE_CODE_UNION
2543 && TYPE_CODE (t) != TYPE_CODE_NAMESPACE)
2544 return 1; /* Continue iterating. */
2546 slot = htab_find_slot (collector->unique_syms, sym, INSERT);
2550 VEC_safe_push (symbolp, collector->symbols, sym);
2553 return 1; /* Continue iterating. */
2556 /* Return any symbols corresponding to CLASS_NAME in FILE_SYMTABS. */
2558 static VEC (symbolp) *
2559 lookup_prefix_sym (struct linespec_state *state, VEC (symtab_p) *file_symtabs,
2560 const char *class_name)
2564 struct decode_compound_collector collector;
2565 struct cleanup *outer;
2566 struct cleanup *cleanup;
2568 collector.symbols = NULL;
2569 outer = make_cleanup (VEC_cleanup (symbolp), &collector.symbols);
2571 collector.unique_syms = htab_create_alloc (1, htab_hash_pointer,
2572 htab_eq_pointer, NULL,
2574 cleanup = make_cleanup_htab_delete (collector.unique_syms);
2576 for (ix = 0; VEC_iterate (symtab_p, file_symtabs, ix, elt); ++ix)
2580 iterate_over_all_matching_symtabs (state, class_name, STRUCT_DOMAIN,
2581 collect_one_symbol, &collector,
2583 iterate_over_all_matching_symtabs (state, class_name, VAR_DOMAIN,
2584 collect_one_symbol, &collector,
2589 struct block *search_block;
2591 /* Program spaces that are executing startup should have
2592 been filtered out earlier. */
2593 gdb_assert (!SYMTAB_PSPACE (elt)->executing_startup);
2594 set_current_program_space (SYMTAB_PSPACE (elt));
2595 search_block = get_search_block (elt);
2596 LA_ITERATE_OVER_SYMBOLS (search_block, class_name, STRUCT_DOMAIN,
2597 collect_one_symbol, &collector);
2598 LA_ITERATE_OVER_SYMBOLS (search_block, class_name, VAR_DOMAIN,
2599 collect_one_symbol, &collector);
2603 do_cleanups (cleanup);
2604 discard_cleanups (outer);
2605 return collector.symbols;
2608 /* A qsort comparison function for symbols. The resulting order does
2609 not actually matter; we just need to be able to sort them so that
2610 symbols with the same program space end up next to each other. */
2613 compare_symbols (const void *a, const void *b)
2615 struct symbol * const *sa = a;
2616 struct symbol * const *sb = b;
2619 uia = (uintptr_t) SYMTAB_PSPACE (SYMBOL_SYMTAB (*sa));
2620 uib = (uintptr_t) SYMTAB_PSPACE (SYMBOL_SYMTAB (*sb));
2627 uia = (uintptr_t) *sa;
2628 uib = (uintptr_t) *sb;
2638 /* Like compare_symbols but for minimal symbols. */
2641 compare_msymbols (const void *a, const void *b)
2643 const struct minsym_and_objfile *sa = a;
2644 const struct minsym_and_objfile *sb = b;
2647 uia = (uintptr_t) sa->objfile->pspace;
2648 uib = (uintptr_t) sa->objfile->pspace;
2655 uia = (uintptr_t) sa->minsym;
2656 uib = (uintptr_t) sb->minsym;
2666 /* Look for all the matching instances of each symbol in NAMES. Only
2667 instances from PSPACE are considered; other program spaces are
2668 handled by our caller. If PSPACE is NULL, then all program spaces
2669 are considered. Results are stored into INFO. */
2672 add_all_symbol_names_from_pspace (struct collect_info *info,
2673 struct program_space *pspace,
2674 VEC (const_char_ptr) *names)
2679 for (ix = 0; VEC_iterate (const_char_ptr, names, ix, iter); ++ix)
2680 add_matching_symbols_to_info (iter, info, pspace);
2684 find_superclass_methods (VEC (typep) *superclasses,
2686 VEC (const_char_ptr) **result_names)
2688 int old_len = VEC_length (const_char_ptr, *result_names);
2689 VEC (typep) *iter_classes;
2690 struct cleanup *cleanup = make_cleanup (null_cleanup, NULL);
2692 iter_classes = superclasses;
2695 VEC (typep) *new_supers = NULL;
2699 make_cleanup (VEC_cleanup (typep), &new_supers);
2700 for (ix = 0; VEC_iterate (typep, iter_classes, ix, t); ++ix)
2701 find_methods (t, name, result_names, &new_supers);
2703 if (VEC_length (const_char_ptr, *result_names) != old_len
2704 || VEC_empty (typep, new_supers))
2707 iter_classes = new_supers;
2710 do_cleanups (cleanup);
2713 /* This finds the method METHOD_NAME in the class CLASS_NAME whose type is
2714 given by one of the symbols in SYM_CLASSES. Matches are returned
2715 in SYMBOLS (for debug symbols) and MINSYMS (for minimal symbols). */
2718 find_method (struct linespec_state *self, VEC (symtab_p) *file_symtabs,
2719 const char *class_name, const char *method_name,
2720 VEC (symbolp) *sym_classes, VEC (symbolp) **symbols,
2721 VEC (minsym_and_objfile_d) **minsyms)
2724 struct cleanup *cleanup = make_cleanup (null_cleanup, NULL);
2726 int last_result_len;
2727 VEC (typep) *superclass_vec;
2728 VEC (const_char_ptr) *result_names;
2729 struct collect_info info;
2731 /* Sort symbols so that symbols with the same program space are next
2733 qsort (VEC_address (symbolp, sym_classes),
2734 VEC_length (symbolp, sym_classes),
2739 info.file_symtabs = file_symtabs;
2740 info.result.symbols = NULL;
2741 info.result.minimal_symbols = NULL;
2743 /* Iterate over all the types, looking for the names of existing
2744 methods matching METHOD_NAME. If we cannot find a direct method in a
2745 given program space, then we consider inherited methods; this is
2746 not ideal (ideal would be to respect C++ hiding rules), but it
2747 seems good enough and is what GDB has historically done. We only
2748 need to collect the names because later we find all symbols with
2749 those names. This loop is written in a somewhat funny way
2750 because we collect data across the program space before deciding
2752 superclass_vec = NULL;
2753 make_cleanup (VEC_cleanup (typep), &superclass_vec);
2754 result_names = NULL;
2755 make_cleanup (VEC_cleanup (const_char_ptr), &result_names);
2756 last_result_len = 0;
2757 for (ix = 0; VEC_iterate (symbolp, sym_classes, ix, sym); ++ix)
2760 struct program_space *pspace;
2762 /* Program spaces that are executing startup should have
2763 been filtered out earlier. */
2764 gdb_assert (!SYMTAB_PSPACE (SYMBOL_SYMTAB (sym))->executing_startup);
2765 pspace = SYMTAB_PSPACE (SYMBOL_SYMTAB (sym));
2766 set_current_program_space (pspace);
2767 t = check_typedef (SYMBOL_TYPE (sym));
2768 find_methods (t, method_name, &result_names, &superclass_vec);
2770 /* Handle all items from a single program space at once; and be
2771 sure not to miss the last batch. */
2772 if (ix == VEC_length (symbolp, sym_classes) - 1
2774 != SYMTAB_PSPACE (SYMBOL_SYMTAB (VEC_index (symbolp, sym_classes,
2777 /* If we did not find a direct implementation anywhere in
2778 this program space, consider superclasses. */
2779 if (VEC_length (const_char_ptr, result_names) == last_result_len)
2780 find_superclass_methods (superclass_vec, method_name,
2783 /* We have a list of candidate symbol names, so now we
2784 iterate over the symbol tables looking for all
2785 matches in this pspace. */
2786 add_all_symbol_names_from_pspace (&info, pspace, result_names);
2788 VEC_truncate (typep, superclass_vec, 0);
2789 last_result_len = VEC_length (const_char_ptr, result_names);
2793 if (!VEC_empty (symbolp, info.result.symbols)
2794 || !VEC_empty (minsym_and_objfile_d, info.result.minimal_symbols))
2796 *symbols = info.result.symbols;
2797 *minsyms = info.result.minimal_symbols;
2798 do_cleanups (cleanup);
2802 /* Throw an NOT_FOUND_ERROR. This will be caught by the caller
2803 and other attempts to locate the symbol will be made. */
2804 throw_error (NOT_FOUND_ERROR, _("see caller, this text doesn't matter"));
2809 /* This object is used when collecting all matching symtabs. */
2811 struct symtab_collector
2813 /* The result vector of symtabs. */
2814 VEC (symtab_p) *symtabs;
2816 /* This is used to ensure the symtabs are unique. */
2817 htab_t symtab_table;
2820 /* Callback for iterate_over_symtabs. */
2823 add_symtabs_to_list (struct symtab *symtab, void *d)
2825 struct symtab_collector *data = d;
2828 slot = htab_find_slot (data->symtab_table, symtab, INSERT);
2832 VEC_safe_push (symtab_p, data->symtabs, symtab);
2838 /* Given a file name, return a VEC of all matching symtabs. */
2840 static VEC (symtab_p) *
2841 collect_symtabs_from_filename (const char *file)
2843 struct symtab_collector collector;
2844 struct cleanup *cleanups;
2845 struct program_space *pspace;
2847 collector.symtabs = NULL;
2848 collector.symtab_table = htab_create (1, htab_hash_pointer, htab_eq_pointer,
2850 cleanups = make_cleanup_htab_delete (collector.symtab_table);
2852 /* Find that file's data. */
2853 ALL_PSPACES (pspace)
2855 if (pspace->executing_startup)
2858 set_current_program_space (pspace);
2859 iterate_over_symtabs (file, add_symtabs_to_list, &collector);
2862 do_cleanups (cleanups);
2863 return collector.symtabs;
2866 /* Return all the symtabs associated to the FILENAME. */
2868 static VEC (symtab_p) *
2869 symtabs_from_filename (const char *filename)
2871 VEC (symtab_p) *result;
2873 result = collect_symtabs_from_filename (filename);
2875 if (VEC_empty (symtab_p, result))
2877 if (!have_full_symbols () && !have_partial_symbols ())
2878 throw_error (NOT_FOUND_ERROR,
2879 _("No symbol table is loaded. "
2880 "Use the \"file\" command."));
2881 throw_error (NOT_FOUND_ERROR, _("No source file named %s."), filename);
2887 /* Look up a function symbol named NAME in symtabs FILE_SYMTABS. Matching
2888 debug symbols are returned in SYMBOLS. Matching minimal symbols are
2889 returned in MINSYMS. */
2892 find_function_symbols (struct linespec_state *state,
2893 VEC (symtab_p) *file_symtabs, const char *name,
2894 VEC (symbolp) **symbols,
2895 VEC (minsym_and_objfile_d) **minsyms)
2897 struct collect_info info;
2898 VEC (const_char_ptr) *symbol_names = NULL;
2899 struct cleanup *cleanup = make_cleanup (VEC_cleanup (const_char_ptr),
2903 info.result.symbols = NULL;
2904 info.result.minimal_symbols = NULL;
2905 info.file_symtabs = file_symtabs;
2907 /* Try NAME as an Objective-C selector. */
2908 find_imps ((char *) name, &symbol_names);
2909 if (!VEC_empty (const_char_ptr, symbol_names))
2910 add_all_symbol_names_from_pspace (&info, NULL, symbol_names);
2912 add_matching_symbols_to_info (name, &info, NULL);
2914 do_cleanups (cleanup);
2916 if (VEC_empty (symbolp, info.result.symbols))
2918 VEC_free (symbolp, info.result.symbols);
2922 *symbols = info.result.symbols;
2924 if (VEC_empty (minsym_and_objfile_d, info.result.minimal_symbols))
2926 VEC_free (minsym_and_objfile_d, info.result.minimal_symbols);
2930 *minsyms = info.result.minimal_symbols;
2933 /* Find all symbols named NAME in FILE_SYMTABS, returning debug symbols
2934 in SYMBOLS and minimal symbols in MINSYMS. */
2937 find_linespec_symbols (struct linespec_state *state,
2938 VEC (symtab_p) *file_symtabs,
2940 VEC (symbolp) **symbols,
2941 VEC (minsym_and_objfile_d) **minsyms)
2943 char *klass, *method, *canon;
2944 const char *lookup_name, *last, *p, *scope_op;
2945 struct cleanup *cleanup;
2946 VEC (symbolp) *classes;
2947 volatile struct gdb_exception except;
2949 cleanup = demangle_for_lookup (name, state->language->la_language,
2951 if (state->language->la_language == language_ada)
2953 /* In Ada, the symbol lookups are performed using the encoded
2954 name rather than the demangled name. */
2955 lookup_name = ada_name_for_lookup (name);
2956 make_cleanup (xfree, (void *) lookup_name);
2959 canon = cp_canonicalize_string_no_typedefs (lookup_name);
2962 lookup_name = canon;
2963 cleanup = make_cleanup (xfree, canon);
2966 /* See if we can find a scope operator and break this symbol
2967 name into namespaces${SCOPE_OPERATOR}class_name and method_name. */
2969 p = find_toplevel_string (lookup_name, scope_op);
2972 /* No C++ scope operator. Try Java. */
2974 p = find_toplevel_string (lookup_name, scope_op);
2981 p = find_toplevel_string (p + strlen (scope_op), scope_op);
2984 /* If no scope operator was found, lookup the name as a symbol. */
2987 find_function_symbols (state, file_symtabs, lookup_name,
2989 do_cleanups (cleanup);
2993 /* NAME points to the class name.
2994 LAST points to the method name. */
2995 klass = xmalloc ((last - lookup_name + 1) * sizeof (char));
2996 make_cleanup (xfree, klass);
2997 strncpy (klass, lookup_name, last - lookup_name);
2998 klass[last - lookup_name] = '\0';
3000 /* Skip past the scope operator. */
3001 last += strlen (scope_op);
3002 method = xmalloc ((strlen (last) + 1) * sizeof (char));
3003 make_cleanup (xfree, method);
3004 strcpy (method, last);
3006 /* Find a list of classes named KLASS. */
3007 classes = lookup_prefix_sym (state, file_symtabs, klass);
3008 make_cleanup (VEC_cleanup (symbolp), &classes);
3009 if (!VEC_empty (symbolp, classes))
3011 /* Now locate a list of suitable methods named METHOD. */
3012 TRY_CATCH (except, RETURN_MASK_ERROR)
3014 find_method (state, file_symtabs, klass, method, classes,
3018 /* If successful, we're done. If NOT_FOUND_ERROR
3019 was not thrown, rethrow the exception that we did get.
3020 Otherwise, fall back to looking up the entire name as a symbol.
3021 This can happen with namespace::function. */
3022 if (except.reason >= 0)
3024 do_cleanups (cleanup);
3027 else if (except.error != NOT_FOUND_ERROR)
3028 throw_exception (except);
3031 /* We couldn't find a class, so we check the entire name as a symbol
3033 find_function_symbols (state, file_symtabs, lookup_name, symbols, minsyms);
3034 do_cleanups (cleanup);
3037 /* Return all labels named NAME in FUNCTION_SYMBOLS. Return the
3038 actual function symbol in which the label was found in LABEL_FUNC_RET. */
3040 static VEC (symbolp) *
3041 find_label_symbols (struct linespec_state *self,
3042 VEC (symbolp) *function_symbols,
3043 VEC (symbolp) **label_funcs_ret, const char *name)
3046 struct block *block;
3048 struct symbol *fn_sym;
3049 VEC (symbolp) *result = NULL;
3051 if (function_symbols == NULL)
3053 set_current_program_space (self->program_space);
3054 block = get_search_block (NULL);
3057 block && !BLOCK_FUNCTION (block);
3058 block = BLOCK_SUPERBLOCK (block))
3062 fn_sym = BLOCK_FUNCTION (block);
3064 sym = lookup_symbol (name, block, LABEL_DOMAIN, 0);
3068 VEC_safe_push (symbolp, result, sym);
3069 VEC_safe_push (symbolp, *label_funcs_ret, fn_sym);
3075 VEC_iterate (symbolp, function_symbols, ix, fn_sym); ++ix)
3077 set_current_program_space (SYMTAB_PSPACE (SYMBOL_SYMTAB (fn_sym)));
3078 block = SYMBOL_BLOCK_VALUE (fn_sym);
3079 sym = lookup_symbol (name, block, LABEL_DOMAIN, 0);
3083 VEC_safe_push (symbolp, result, sym);
3084 VEC_safe_push (symbolp, *label_funcs_ret, fn_sym);
3094 /* A helper for create_sals_line_offset that handles the 'list_mode' case. */
3097 decode_digits_list_mode (struct linespec_state *self,
3099 struct symtabs_and_lines *values,
3100 struct symtab_and_line val)
3105 gdb_assert (self->list_mode);
3107 for (ix = 0; VEC_iterate (symtab_p, ls->file_symtabs, ix, elt);
3110 /* The logic above should ensure this. */
3111 gdb_assert (elt != NULL);
3113 set_current_program_space (SYMTAB_PSPACE (elt));
3115 /* Simplistic search just for the list command. */
3116 val.symtab = find_line_symtab (elt, val.line, NULL, NULL);
3117 if (val.symtab == NULL)
3119 val.pspace = SYMTAB_PSPACE (elt);
3121 val.explicit_line = 1;
3123 add_sal_to_sals (self, values, &val, NULL, 0);
3127 /* A helper for create_sals_line_offset that iterates over the symtabs,
3128 adding lines to the VEC. */
3131 decode_digits_ordinary (struct linespec_state *self,
3134 struct symtabs_and_lines *sals,
3135 struct linetable_entry **best_entry)
3140 for (ix = 0; VEC_iterate (symtab_p, ls->file_symtabs, ix, elt); ++ix)
3143 VEC (CORE_ADDR) *pcs;
3146 /* The logic above should ensure this. */
3147 gdb_assert (elt != NULL);
3149 set_current_program_space (SYMTAB_PSPACE (elt));
3151 pcs = find_pcs_for_symtab_line (elt, line, best_entry);
3152 for (i = 0; VEC_iterate (CORE_ADDR, pcs, i, pc); ++i)
3154 struct symtab_and_line sal;
3157 sal.pspace = SYMTAB_PSPACE (elt);
3161 add_sal_to_sals_basic (sals, &sal);
3164 VEC_free (CORE_ADDR, pcs);
3170 /* Return the line offset represented by VARIABLE. */
3172 static struct line_offset
3173 linespec_parse_variable (struct linespec_state *self, const char *variable)
3177 struct line_offset offset = {0, LINE_OFFSET_NONE};
3179 p = (variable[1] == '$') ? variable + 2 : variable + 1;
3182 while (*p >= '0' && *p <= '9')
3184 if (!*p) /* Reached end of token without hitting non-digit. */
3186 /* We have a value history reference. */
3187 struct value *val_history;
3189 sscanf ((variable[1] == '$') ? variable + 2 : variable + 1, "%d", &index);
3191 = access_value_history ((variable[1] == '$') ? -index : index);
3192 if (TYPE_CODE (value_type (val_history)) != TYPE_CODE_INT)
3193 error (_("History values used in line "
3194 "specs must have integer values."));
3195 offset.offset = value_as_long (val_history);
3199 /* Not all digits -- may be user variable/function or a
3200 convenience variable. */
3202 struct internalvar *ivar;
3204 /* Try it as a convenience variable. If it is not a convenience
3205 variable, return and allow normal symbol lookup to occur. */
3206 ivar = lookup_only_internalvar (variable + 1);
3208 /* No internal variable with that name. Mark the offset
3209 as unknown to allow the name to be looked up as a symbol. */
3210 offset.sign = LINE_OFFSET_UNKNOWN;
3213 /* We found a valid variable name. If it is not an integer,
3215 if (!get_internalvar_integer (ivar, &valx))
3216 error (_("Convenience variables used in line "
3217 "specs must have integer values."));
3219 offset.offset = valx;
3227 /* A callback used to possibly add a symbol to the results. */
3230 collect_symbols (struct symbol *sym, void *data)
3232 struct collect_info *info = data;
3234 /* In list mode, add all matching symbols, regardless of class.
3235 This allows the user to type "list a_global_variable". */
3236 if (SYMBOL_CLASS (sym) == LOC_BLOCK || info->state->list_mode)
3237 VEC_safe_push (symbolp, info->result.symbols, sym);
3238 return 1; /* Continue iterating. */
3241 /* We've found a minimal symbol MSYMBOL in OBJFILE to associate with our
3242 linespec; return the SAL in RESULT. */
3245 minsym_found (struct linespec_state *self, struct objfile *objfile,
3246 struct minimal_symbol *msymbol,
3247 struct symtabs_and_lines *result)
3249 struct gdbarch *gdbarch = get_objfile_arch (objfile);
3251 struct symtab_and_line sal;
3253 sal = find_pc_sect_line (SYMBOL_VALUE_ADDRESS (msymbol),
3254 (struct obj_section *) 0, 0);
3255 sal.section = SYMBOL_OBJ_SECTION (msymbol);
3257 /* The minimal symbol might point to a function descriptor;
3258 resolve it to the actual code address instead. */
3259 pc = gdbarch_convert_from_func_ptr_addr (gdbarch, sal.pc, ¤t_target);
3261 sal = find_pc_sect_line (pc, NULL, 0);
3263 if (self->funfirstline)
3264 skip_prologue_sal (&sal);
3266 if (maybe_add_address (self->addr_set, objfile->pspace, sal.pc))
3267 add_sal_to_sals (self, result, &sal, SYMBOL_NATURAL_NAME (msymbol), 0);
3270 /* A helper struct to pass some data through
3271 iterate_over_minimal_symbols. */
3273 struct collect_minsyms
3275 /* The objfile we're examining. */
3276 struct objfile *objfile;
3278 /* The funfirstline setting from the initial call. */
3281 /* The list_mode setting from the initial call. */
3284 /* The resulting symbols. */
3285 VEC (minsym_and_objfile_d) *msyms;
3288 /* A helper function to classify a minimal_symbol_type according to
3292 classify_mtype (enum minimal_symbol_type t)
3299 /* Intermediate priority. */
3302 case mst_solib_trampoline:
3303 /* Lowest priority. */
3307 /* Highest priority. */
3312 /* Callback for qsort that sorts symbols by priority. */
3315 compare_msyms (const void *a, const void *b)
3317 const minsym_and_objfile_d *moa = a;
3318 const minsym_and_objfile_d *mob = b;
3319 enum minimal_symbol_type ta = MSYMBOL_TYPE (moa->minsym);
3320 enum minimal_symbol_type tb = MSYMBOL_TYPE (mob->minsym);
3322 return classify_mtype (ta) - classify_mtype (tb);
3325 /* Callback for iterate_over_minimal_symbols that adds the symbol to
3329 add_minsym (struct minimal_symbol *minsym, void *d)
3331 struct collect_minsyms *info = d;
3332 minsym_and_objfile_d mo;
3334 /* Exclude data symbols when looking for breakpoint locations. */
3335 if (!info->list_mode)
3336 switch (minsym->type)
3338 case mst_slot_got_plt:
3345 /* Make sure this minsym is not a function descriptor
3346 before we decide to discard it. */
3347 struct gdbarch *gdbarch = info->objfile->gdbarch;
3348 CORE_ADDR addr = gdbarch_convert_from_func_ptr_addr
3349 (gdbarch, SYMBOL_VALUE_ADDRESS (minsym),
3352 if (addr == SYMBOL_VALUE_ADDRESS (minsym))
3358 mo.objfile = info->objfile;
3359 VEC_safe_push (minsym_and_objfile_d, info->msyms, &mo);
3362 /* Search minimal symbols in all objfiles for NAME. If SEARCH_PSPACE
3363 is not NULL, the search is restricted to just that program
3367 search_minsyms_for_name (struct collect_info *info, const char *name,
3368 struct program_space *search_pspace)
3370 struct objfile *objfile;
3371 struct program_space *pspace;
3373 ALL_PSPACES (pspace)
3375 struct collect_minsyms local;
3376 struct cleanup *cleanup;
3378 if (search_pspace != NULL && search_pspace != pspace)
3380 if (pspace->executing_startup)
3383 set_current_program_space (pspace);
3385 memset (&local, 0, sizeof (local));
3386 local.funfirstline = info->state->funfirstline;
3387 local.list_mode = info->state->list_mode;
3389 cleanup = make_cleanup (VEC_cleanup (minsym_and_objfile_d),
3392 ALL_OBJFILES (objfile)
3394 local.objfile = objfile;
3395 iterate_over_minimal_symbols (objfile, name, add_minsym, &local);
3398 if (!VEC_empty (minsym_and_objfile_d, local.msyms))
3402 minsym_and_objfile_d *item;
3404 qsort (VEC_address (minsym_and_objfile_d, local.msyms),
3405 VEC_length (minsym_and_objfile_d, local.msyms),
3406 sizeof (minsym_and_objfile_d),
3409 /* Now the minsyms are in classification order. So, we walk
3410 over them and process just the minsyms with the same
3411 classification as the very first minsym in the list. */
3412 item = VEC_index (minsym_and_objfile_d, local.msyms, 0);
3413 classification = classify_mtype (MSYMBOL_TYPE (item->minsym));
3416 VEC_iterate (minsym_and_objfile_d, local.msyms, ix, item);
3419 if (classify_mtype (MSYMBOL_TYPE (item->minsym)) != classification)
3422 VEC_safe_push (minsym_and_objfile_d,
3423 info->result.minimal_symbols, item);
3427 do_cleanups (cleanup);
3431 /* A helper function to add all symbols matching NAME to INFO. If
3432 PSPACE is not NULL, the search is restricted to just that program
3436 add_matching_symbols_to_info (const char *name,
3437 struct collect_info *info,
3438 struct program_space *pspace)
3443 for (ix = 0; VEC_iterate (symtab_p, info->file_symtabs, ix, elt); ++ix)
3447 iterate_over_all_matching_symtabs (info->state, name, VAR_DOMAIN,
3448 collect_symbols, info,
3450 search_minsyms_for_name (info, name, pspace);
3452 else if (pspace == NULL || pspace == SYMTAB_PSPACE (elt))
3454 /* Program spaces that are executing startup should have
3455 been filtered out earlier. */
3456 gdb_assert (!SYMTAB_PSPACE (elt)->executing_startup);
3457 set_current_program_space (SYMTAB_PSPACE (elt));
3458 LA_ITERATE_OVER_SYMBOLS (get_search_block (elt), name,
3459 VAR_DOMAIN, collect_symbols,
3467 /* Now come some functions that are called from multiple places within
3471 symbol_to_sal (struct symtab_and_line *result,
3472 int funfirstline, struct symbol *sym)
3474 if (SYMBOL_CLASS (sym) == LOC_BLOCK)
3476 *result = find_function_start_sal (sym, funfirstline);
3481 if (SYMBOL_CLASS (sym) == LOC_LABEL && SYMBOL_VALUE_ADDRESS (sym) != 0)
3484 result->symtab = SYMBOL_SYMTAB (sym);
3485 result->line = SYMBOL_LINE (sym);
3486 result->pc = SYMBOL_VALUE_ADDRESS (sym);
3487 result->pspace = SYMTAB_PSPACE (SYMBOL_SYMTAB (sym));
3488 result->explicit_pc = 1;
3491 else if (funfirstline)
3495 else if (SYMBOL_LINE (sym) != 0)
3497 /* We know its line number. */
3499 result->symtab = SYMBOL_SYMTAB (sym);
3500 result->line = SYMBOL_LINE (sym);
3501 result->pspace = SYMTAB_PSPACE (SYMBOL_SYMTAB (sym));
3509 /* See the comment in linespec.h. */
3512 init_linespec_result (struct linespec_result *lr)
3514 memset (lr, 0, sizeof (*lr));
3517 /* See the comment in linespec.h. */
3520 destroy_linespec_result (struct linespec_result *ls)
3523 struct linespec_sals *lsal;
3525 xfree (ls->addr_string);
3526 for (i = 0; VEC_iterate (linespec_sals, ls->sals, i, lsal); ++i)
3528 xfree (lsal->canonical);
3529 xfree (lsal->sals.sals);
3531 VEC_free (linespec_sals, ls->sals);
3534 /* Cleanup function for a linespec_result. */
3537 cleanup_linespec_result (void *a)
3539 destroy_linespec_result (a);
3542 /* See the comment in linespec.h. */
3545 make_cleanup_destroy_linespec_result (struct linespec_result *ls)
3547 return make_cleanup (cleanup_linespec_result, ls);