1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
/* Simple interpreter interface for GDB, the GNU debugger.
Copyright (C) 1996 Free Software Foundation
This file is part of GDB.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
The author can be reached at djurfeldt@nada.kth.se
Mikael Djurfeldt, SANS/NADA KTH, 10044 STOCKHOLM, SWEDEN */
#ifndef GDB_INTERFACE_H
#define GDB_INTERFACE_H
/* This is the header file for GDB's interpreter interface. The
interpreter must supply definitions of all symbols declared in this
file.
Before including this file, you must #define GDB_TYPE to be the
data type used for communication with the interpreter. */
/* The following macro can be used to anchor the symbols of the
interface in your main program. This is necessary if the interface
is defined in a library, such as Guile. */
#define GDB_INTERFACE \
void *gdb_interface[] = { \
&gdb_options, \
&gdb_language, \
&gdb_result, \
&gdb_output, \
&gdb_output_length, \
(void *) gdb_maybe_valid_type_p, \
(void *) gdb_read, \
(void *) gdb_eval, \
(void *) gdb_print, \
(void *) gdb_binding \
}
/* GDB_OPTIONS is a set of flags informing gdb what features are present
in the interface. Currently only one option is supported: */
/* GDB_HAVE_BINDINGS: Set this bit if your interpreter can create new
top level bindings on demand (through gdb_top_level_binding) */
#define GDB_HAVE_BINDINGS 1
extern unsigned short gdb_options;
/* GDB_LANGUAGE holds the name of the preferred language mode for this
interpreter. For lisp interpreters, the suggested mode is "lisp/c". */
extern char *gdb_language;
/* GDB_RESULT is used for passing results from the interpreter to GDB */
extern GDB_TYPE gdb_result;
/* The interpreter passes strings to GDB in GDB_OUTPUT and
GDB_OUTPUT_LENGTH. GDB_OUTPUT should hold the pointer to the
string. GDB_OUTPUT_LENGTH should hold its length. The string
doesn't need to be terminated by '\0'. */
extern char *gdb_output;
extern int gdb_output_length;
/* Return TRUE if the interpreter regards VALUE's type as valid. A
lazy implementation is allowed to pass TRUE always. FALSE should
only be returned when it is certain that VALUE is not valid.
In the "lisp/c" language mode, this is used to heuristically
discriminate lisp values from C values during printing. */
extern int gdb_maybe_valid_type_p (GDB_TYPE value);
/* Parse expression in string STR. Store result in GDB_RESULT, then
return 0 to indicate success. On error, return -1 to indicate
failure. An error string can be passed in GDB_OUTPUT and
GDB_OUTPUT_LENGTH. Be careful to set GDB_OUTPUT_LENGTH to zero if
no message is passed. Please note that the resulting value should
be protected against garbage collection. */
extern int gdb_read (char *str);
/* Evaluate expression EXP. Store result in GDB_RESULT, then return 0
to indicate success. On error, return -1 to indicate failure. Any
output (both on success and failure) can be passed in GDB_OUTPUT
and GDB_OUTPUT_LENGTH. Be careful to set GDB_OUTPUT_LENGTH to zero
if no output is passed. Please note that the resulting lisp object
should be protected against garbage collection. */
extern int gdb_eval (GDB_TYPE exp);
/* Print VALUE. Store output in GDB_OUTPUT and GDB_OUTPUT_LENGTH.
Return 0 to indicate success. On error, return -1 to indicate
failure. GDB will not look at GDB_OUTPUT or GDB_OUTPUT_LENGTH on
failure. Note that this function should be robust against strange
values. It could in fact be passed any kind of value. */
extern int gdb_print (GDB_TYPE value);
/* Bind NAME to VALUE in interpreter. (GDB has previously obtained
NAME by passing a string to gdb_read.) Return 0 to indicate
success or -1 to indicate failure. This feature is optional. GDB
will only call this function if the GDB_HAVE_BINDINGS flag is set
in gdb_options. Note that GDB may call this function many times
for the same name.
For scheme interpreters, this function should introduce top-level
bindings. */
extern int gdb_binding (GDB_TYPE name, GDB_TYPE value);
#endif /* GDB_INTERFACE_H */
|