| 1 |
227 |
jeremybenn |
/* List lines of source files for GDB, the GNU debugger.
|
| 2 |
|
|
Copyright (C) 1999, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
|
| 3 |
|
|
|
| 4 |
|
|
This file is part of GDB.
|
| 5 |
|
|
|
| 6 |
|
|
This program is free software; you can redistribute it and/or modify
|
| 7 |
|
|
it under the terms of the GNU General Public License as published by
|
| 8 |
|
|
the Free Software Foundation; either version 3 of the License, or
|
| 9 |
|
|
(at your option) any later version.
|
| 10 |
|
|
|
| 11 |
|
|
This program is distributed in the hope that it will be useful,
|
| 12 |
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
| 13 |
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
| 14 |
|
|
GNU General Public License for more details.
|
| 15 |
|
|
|
| 16 |
|
|
You should have received a copy of the GNU General Public License
|
| 17 |
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
| 18 |
|
|
|
| 19 |
|
|
#ifndef SOURCE_H
|
| 20 |
|
|
#define SOURCE_H
|
| 21 |
|
|
|
| 22 |
|
|
struct symtab;
|
| 23 |
|
|
|
| 24 |
|
|
/* Open a source file given a symtab S. Returns a file descriptor or
|
| 25 |
|
|
negative number for error. */
|
| 26 |
|
|
extern int open_source_file (struct symtab *s);
|
| 27 |
|
|
|
| 28 |
|
|
extern char* psymtab_to_fullname (struct partial_symtab *ps);
|
| 29 |
|
|
extern char* symtab_to_fullname (struct symtab *s);
|
| 30 |
|
|
|
| 31 |
|
|
/* Create and initialize the table S->line_charpos that records the
|
| 32 |
|
|
positions of the lines in the source file, which is assumed to be
|
| 33 |
|
|
open on descriptor DESC. All set S->nlines to the number of such
|
| 34 |
|
|
lines. */
|
| 35 |
|
|
extern void find_source_lines (struct symtab *s, int desc);
|
| 36 |
|
|
|
| 37 |
|
|
/* Return the first line listed by print_source_lines.
|
| 38 |
|
|
Used by command interpreters to request listing from
|
| 39 |
|
|
a previous point. */
|
| 40 |
|
|
extern int get_first_line_listed (void);
|
| 41 |
|
|
|
| 42 |
|
|
/* Return the default number of lines to print with commands like the
|
| 43 |
|
|
cli "list". The caller of print_source_lines must use this to
|
| 44 |
|
|
calculate the end line and use it in the call to print_source_lines
|
| 45 |
|
|
as it does not automatically use this value. */
|
| 46 |
|
|
extern int get_lines_to_list (void);
|
| 47 |
|
|
|
| 48 |
|
|
/* Return the current source file for listing and next line to list.
|
| 49 |
|
|
NOTE: The returned sal pc and end fields are not valid. */
|
| 50 |
|
|
extern struct symtab_and_line get_current_source_symtab_and_line (void);
|
| 51 |
|
|
|
| 52 |
|
|
/* If the current source file for listing is not set, try and get a default.
|
| 53 |
|
|
Usually called before get_current_source_symtab_and_line() is called.
|
| 54 |
|
|
It may err out if a default cannot be determined.
|
| 55 |
|
|
We must be cautious about where it is called, as it can recurse as the
|
| 56 |
|
|
process of determining a new default may call the caller!
|
| 57 |
|
|
Use get_current_source_symtab_and_line only to get whatever
|
| 58 |
|
|
we have without erroring out or trying to get a default. */
|
| 59 |
|
|
extern void set_default_source_symtab_and_line (void);
|
| 60 |
|
|
|
| 61 |
|
|
/* Return the current default file for listing and next line to list
|
| 62 |
|
|
(the returned sal pc and end fields are not valid.)
|
| 63 |
|
|
and set the current default to whatever is in SAL.
|
| 64 |
|
|
NOTE: The returned sal pc and end fields are not valid. */
|
| 65 |
|
|
extern struct symtab_and_line set_current_source_symtab_and_line (const struct symtab_and_line *);
|
| 66 |
|
|
|
| 67 |
|
|
/* Reset any information stored about a default file and line to print. */
|
| 68 |
|
|
extern void clear_current_source_symtab_and_line (void);
|
| 69 |
|
|
|
| 70 |
|
|
/* Add a source path substitution rule. */
|
| 71 |
|
|
extern void add_substitute_path_rule (char *, char *);
|
| 72 |
|
|
#endif
|
