GDB (xrefs)

mi-cmd-disas.c
Go to the documentation of this file.
1 /* MI Command Set - disassemble commands.
2 Copyright (C) 2000-2018 Free Software Foundation, Inc.
3 Contributed by Cygnus Solutions (a Red Hat company).
4
5 This file is part of GDB.
6
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.
11
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.
16
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/>. */
19
20 #include "defs.h"
21 #include "arch-utils.h"
22 #include "target.h"
23 #include "value.h"
24 #include "mi-cmds.h"
25 #include "mi-getopt.h"
26 #include "ui-out.h"
27 #include "disasm.h"
28
29 /* The arguments to be passed on the command line and parsed here are
30 either:
31
32 START-ADDRESS: address to start the disassembly at.
33 END-ADDRESS: address to end the disassembly at.
34
35 or:
36
37 FILENAME: The name of the file where we want disassemble from.
38 LINE: The line around which we want to disassemble. It will
39 disassemble the function that contins that line.
40 HOW_MANY: Number of disassembly lines to display. With source, it
41 is the number of disassembly lines only, not counting the source
42 lines.
43
44 always required:
45
46 MODE: 0 -- disassembly.
47 1 -- disassembly and source (with deprecated source-centric view).
48 2 -- disassembly and opcodes.
49 3 -- disassembly, source-centric and opcodes.
50 4 -- disassembly, and source (with pc-centric view).
51 5 -- disassembly, source (pc-centric) and opcodes. */
52
53 void
54 mi_cmd_disassemble (const char *command, char **argv, int argc)
55 {
56 struct gdbarch *gdbarch = get_current_arch ();
57 struct ui_out *uiout = current_uiout;
58 CORE_ADDR start;
59
60 int mode;
61 gdb_disassembly_flags disasm_flags;
62 struct symtab *s;
63
64 /* Which options have we processed ... */
65 int file_seen = 0;
66 int line_seen = 0;
67 int num_seen = 0;
68 int start_seen = 0;
69 int end_seen = 0;
70
71 /* ... and their corresponding value. */
72 char *file_string = NULL;
73 int line_num = -1;
74 int how_many = -1;
75 CORE_ADDR low = 0;
76 CORE_ADDR high = 0;
77
78 /* Options processing stuff. */
79 int oind = 0;
80 char *oarg;
81 enum opt
82 {
83 FILE_OPT, LINE_OPT, NUM_OPT, START_OPT, END_OPT
84 };
85 static const struct mi_opt opts[] =
86 {
87 {"f", FILE_OPT, 1},
88 {"l", LINE_OPT, 1},
89 {"n", NUM_OPT, 1},
90 {"s", START_OPT, 1},
91 {"e", END_OPT, 1},
92 { 0, 0, 0 }
93 };
94
95 /* Get the options with their arguments. Keep track of what we
96 encountered. */
97 while (1)
98 {
99 int opt = mi_getopt ("-data-disassemble", argc, argv, opts,
100 &oind, &oarg);
101 if (opt < 0)
102 break;
103 switch ((enum opt) opt)
104 {
105 case FILE_OPT:
106 file_string = oarg;
107 file_seen = 1;
108 break;
109 case LINE_OPT:
110 line_num = atoi (oarg);
111 line_seen = 1;
112 break;
113 case NUM_OPT:
114 how_many = atoi (oarg);
115 num_seen = 1;
116 break;
117 case START_OPT:
118 low = parse_and_eval_address (oarg);
119 start_seen = 1;
120 break;
121 case END_OPT:
122 high = parse_and_eval_address (oarg);
123 end_seen = 1;
124 break;
125 }
126 }
127 argv += oind;
128 argc -= oind;
129
130 /* Allow only filename + linenum (with how_many which is not
131 required) OR start_addr + end_addr. */
132
133 if (!((line_seen && file_seen && num_seen && !start_seen && !end_seen)
134 || (line_seen && file_seen && !num_seen && !start_seen && !end_seen)
135 || (!line_seen && !file_seen && !num_seen && start_seen && end_seen)))
136 error (_("-data-disassemble: Usage: ( [-f filename -l linenum [-n "
137 "howmany]] | [-s startaddr -e endaddr]) [--] mode."));
138
139 if (argc != 1)
140 error (_("-data-disassemble: Usage: [-f filename -l linenum "
141 "[-n howmany]] [-s startaddr -e endaddr] [--] mode."));
142
143 mode = atoi (argv[0]);
144 if (mode < 0 || mode > 5)
145 error (_("-data-disassemble: Mode argument must be in the range 0-5."));
146
147 /* Convert the mode into a set of disassembly flags. */
148
149 disasm_flags = 0; /* Initialize here for -Wall. */
150 switch (mode)
151 {
152 case 0:
153 break;
154 case 1:
155 disasm_flags |= DISASSEMBLY_SOURCE_DEPRECATED;
156 break;
157 case 2:
158 disasm_flags |= DISASSEMBLY_RAW_INSN;
159 break;
160 case 3:
161 disasm_flags |= DISASSEMBLY_SOURCE_DEPRECATED | DISASSEMBLY_RAW_INSN;
162 break;
163 case 4:
164 disasm_flags |= DISASSEMBLY_SOURCE;
165 break;
166 case 5:
167 disasm_flags |= DISASSEMBLY_SOURCE | DISASSEMBLY_RAW_INSN;
168 break;
169 default:
170 gdb_assert_not_reached ("bad disassembly mode");
171 }
172
173 /* We must get the function beginning and end where line_num is
174 contained. */
175
176 if (line_seen && file_seen)
177 {
178 s = lookup_symtab (file_string);
179 if (s == NULL)
180 error (_("-data-disassemble: Invalid filename."));
181 if (!find_line_pc (s, line_num, &start))
182 error (_("-data-disassemble: Invalid line number"));
183 if (find_pc_partial_function (start, NULL, &low, &high) == 0)
184 error (_("-data-disassemble: "
185 "No function contains specified address"));
186 }
187
188 gdb_disassembly (gdbarch, uiout,
189 disasm_flags,
190 how_many, low, high);
191 }
gdbarch
Definition: gdbarch.c:127
CORE_ADDR
bfd_vma CORE_ADDR
Definition: common-types.h:41
mi-cmds.h
lookup_symtab
struct symtab * lookup_symtab(const char *name)
Definition: symtab.c:502
disasm.h
_
#define _(String)
Definition: gdb_locale.h:35
defs.h
arch-utils.h
DISASSEMBLY_SOURCE_DEPRECATED
Definition: disasm.h:27
mi_getopt
int mi_getopt(const char *prefix, int argc, char **argv, const struct mi_opt *opts, int *oind, char **oarg)
Definition: mi-getopt.c:83
gdb_assert_not_reached
#define gdb_assert_not_reached(message)
Definition: gdb_assert.h:55
current_uiout
#define current_uiout
Definition: ui-out.h:39
find_pc_partial_function
int find_pc_partial_function(CORE_ADDR pc, const char **name, CORE_ADDR *address, CORE_ADDR *endaddr)
Definition: blockframe.c:320
get_current_arch
struct gdbarch * get_current_arch(void)
Definition: arch-utils.c:798
mi_cmd_disassemble
void mi_cmd_disassemble(const char *command, char **argv, int argc)
Definition: mi-cmd-disas.c:54
symtab
Definition: symtab.h:1291
DISASSEMBLY_RAW_INSN
Definition: disasm.h:28
find_line_pc
int find_line_pc(struct symtab *symtab, int line, CORE_ADDR *pc)
Definition: symtab.c:3456
ui_out
Definition: ui-out.h:77
gdb_disassembly
void gdb_disassembly(struct gdbarch *gdbarch, struct ui_out *uiout, gdb_disassembly_flags flags, int how_many, CORE_ADDR low, CORE_ADDR high)
Definition: disasm.c:780
parse_and_eval_address
CORE_ADDR parse_and_eval_address(const char *exp)
Definition: eval.c:101
DISASSEMBLY_SOURCE
Definition: disasm.h:32
target.h
value.h
gdb.argv
argv
Definition: __init__.py:63
mi-getopt.h
error
void error(const char *fmt,...)
Definition: errors.c:38
mi_opt
Definition: mi-getopt.h:26
ui-out.h