1 /* TUI display registers in window.
3 Copyright (C) 1998-2015 Free Software Foundation, Inc.
5 Contributed by Hewlett-Packard Company.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
23 #include "arch-utils.h"
25 #include "tui/tui-data.h"
33 #include "tui/tui-layout.h"
34 #include "tui/tui-win.h"
35 #include "tui/tui-windata.h"
36 #include "tui/tui-wingeneral.h"
37 #include "tui/tui-file.h"
38 #include "tui/tui-regs.h"
39 #include "tui/tui-io.h"
40 #include "reggroups.h"
43 #include "gdb_curses.h"
46 /*****************************************
47 ** STATIC LOCAL FUNCTIONS FORWARD DECLS **
48 ******************************************/
50 tui_display_register (struct tui_data_element
*data
,
51 struct tui_gen_win_info
*win_info
);
53 static enum tui_status
tui_show_register_group (struct reggroup
*group
,
54 struct frame_info
*frame
,
55 int refresh_values_only
);
57 static enum tui_status
tui_get_register (struct frame_info
*frame
,
58 struct tui_data_element
*data
,
59 int regnum
, int *changedp
);
63 /*****************************************
64 ** PUBLIC FUNCTIONS **
65 ******************************************/
67 /* Answer the number of the last line in the regs display. If there
68 are no registers (-1) is returned. */
70 tui_last_regs_line_no (void)
74 if (TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
> 0)
76 num_lines
= (TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
/
77 TUI_DATA_WIN
->detail
.data_display_info
.regs_column_count
);
78 if (TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
%
79 TUI_DATA_WIN
->detail
.data_display_info
.regs_column_count
)
86 /* Answer the line number that the register element at element_no is
87 on. If element_no is greater than the number of register elements
88 there are, -1 is returned. */
90 tui_line_from_reg_element_no (int element_no
)
92 if (element_no
< TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
)
100 (TUI_DATA_WIN
->detail
.data_display_info
.regs_column_count
* i
))
113 /* Answer the index of the first element in line_no. If line_no is
114 past the register area (-1) is returned. */
116 tui_first_reg_element_no_inline (int line_no
)
118 if ((line_no
* TUI_DATA_WIN
->detail
.data_display_info
.regs_column_count
)
119 <= TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
)
120 return ((line_no
+ 1) *
121 TUI_DATA_WIN
->detail
.data_display_info
.regs_column_count
) -
122 TUI_DATA_WIN
->detail
.data_display_info
.regs_column_count
;
128 /* Show the registers of the given group in the data window
129 and refresh the window. */
131 tui_show_registers (struct reggroup
*group
)
133 enum tui_status ret
= TUI_FAILURE
;
134 struct tui_data_info
*display_info
;
136 /* Make sure the curses mode is enabled. */
139 /* Make sure the register window is visible. If not, select an
140 appropriate layout. */
141 if (TUI_DATA_WIN
== NULL
|| !TUI_DATA_WIN
->generic
.is_visible
)
142 tui_set_layout_for_display_command (DATA_NAME
);
144 display_info
= &TUI_DATA_WIN
->detail
.data_display_info
;
146 group
= general_reggroup
;
148 /* Say that registers should be displayed, even if there is a
150 display_info
->display_regs
= TRUE
;
152 if (target_has_registers
&& target_has_stack
&& target_has_memory
)
154 ret
= tui_show_register_group (group
, get_selected_frame (NULL
),
155 group
== display_info
->current_group
);
157 if (ret
== TUI_FAILURE
)
159 display_info
->current_group
= 0;
160 tui_erase_data_content (NO_REGS_STRING
);
166 /* Clear all notation of changed values. */
167 for (i
= 0; i
< display_info
->regs_content_count
; i
++)
169 struct tui_gen_win_info
*data_item_win
;
170 struct tui_win_element
*win
;
172 data_item_win
= &display_info
->regs_content
[i
]
173 ->which_element
.data_window
;
174 win
= (struct tui_win_element
*) data_item_win
->content
[0];
175 win
->which_element
.data
.highlight
= FALSE
;
177 display_info
->current_group
= group
;
178 tui_display_all_data ();
183 /* Set the data window to display the registers of the register group
184 using the given frame. Values are refreshed only when
185 refresh_values_only is TRUE. */
187 static enum tui_status
188 tui_show_register_group (struct reggroup
*group
,
189 struct frame_info
*frame
,
190 int refresh_values_only
)
192 struct gdbarch
*gdbarch
= get_frame_arch (frame
);
193 enum tui_status ret
= TUI_FAILURE
;
195 int allocated_here
= FALSE
;
198 struct tui_data_info
*display_info
= &TUI_DATA_WIN
->detail
.data_display_info
;
200 /* Make a new title showing which group we display. */
201 snprintf (title
, sizeof (title
) - 1, "Register group: %s",
202 reggroup_name (group
));
203 xfree (TUI_DATA_WIN
->generic
.title
);
204 TUI_DATA_WIN
->generic
.title
= xstrdup (title
);
206 /* See how many registers must be displayed. */
209 regnum
< gdbarch_num_regs (gdbarch
)
210 + gdbarch_num_pseudo_regs (gdbarch
);
215 /* Must be in the group. */
216 if (!gdbarch_register_reggroup_p (gdbarch
, regnum
, group
))
219 /* If the register name is empty, it is undefined for this
220 processor, so don't display anything. */
221 name
= gdbarch_register_name (gdbarch
, regnum
);
222 if (name
== 0 || *name
== '\0')
228 if (display_info
->regs_content_count
> 0 && !refresh_values_only
)
230 tui_free_data_content (display_info
->regs_content
,
231 display_info
->regs_content_count
);
232 display_info
->regs_content_count
= 0;
235 if (display_info
->regs_content_count
<= 0)
237 display_info
->regs_content
= tui_alloc_content (nr_regs
, DATA_WIN
);
238 allocated_here
= TRUE
;
239 refresh_values_only
= FALSE
;
242 if (display_info
->regs_content
!= (tui_win_content
) NULL
)
244 if (!refresh_values_only
|| allocated_here
)
246 TUI_DATA_WIN
->generic
.content
= (void*) NULL
;
247 TUI_DATA_WIN
->generic
.content_size
= 0;
248 tui_add_content_elements (&TUI_DATA_WIN
->generic
, nr_regs
);
249 display_info
->regs_content
250 = (tui_win_content
) TUI_DATA_WIN
->generic
.content
;
251 display_info
->regs_content_count
= nr_regs
;
254 /* Now set the register names and values. */
257 regnum
< gdbarch_num_regs (gdbarch
)
258 + gdbarch_num_pseudo_regs (gdbarch
);
261 struct tui_gen_win_info
*data_item_win
;
262 struct tui_data_element
*data
;
265 /* Must be in the group. */
266 if (!gdbarch_register_reggroup_p (gdbarch
, regnum
, group
))
269 /* If the register name is empty, it is undefined for this
270 processor, so don't display anything. */
271 name
= gdbarch_register_name (gdbarch
, regnum
);
272 if (name
== 0 || *name
== '\0')
276 &display_info
->regs_content
[pos
]->which_element
.data_window
;
277 data
= &((struct tui_win_element
*)
278 data_item_win
->content
[0])->which_element
.data
;
281 if (!refresh_values_only
)
283 data
->item_no
= regnum
;
285 data
->highlight
= FALSE
;
287 tui_get_register (frame
, data
, regnum
, 0);
292 TUI_DATA_WIN
->generic
.content_size
=
293 display_info
->regs_content_count
+ display_info
->data_content_count
;
300 /* Function to display the registers in the content from
301 'start_element_no' until the end of the register content or the end
302 of the display height. No checking for displaying past the end of
303 the registers is done here. */
305 tui_display_registers_from (int start_element_no
)
307 struct tui_data_info
*display_info
= &TUI_DATA_WIN
->detail
.data_display_info
;
309 if (display_info
->regs_content
!= (tui_win_content
) NULL
310 && display_info
->regs_content_count
> 0)
312 int i
= start_element_no
;
313 int j
, item_win_width
, cur_y
;
316 for (i
= 0; i
< display_info
->regs_content_count
; i
++)
318 struct tui_data_element
*data
;
319 struct tui_gen_win_info
*data_item_win
;
324 = &display_info
->regs_content
[i
]->which_element
.data_window
;
325 data
= &((struct tui_win_element
*)
326 data_item_win
->content
[0])->which_element
.data
;
333 len
= 8 * ((len
/ 8) + 1);
341 item_win_width
= max_len
+ 1;
342 i
= start_element_no
;
344 display_info
->regs_column_count
=
345 (TUI_DATA_WIN
->generic
.width
- 2) / item_win_width
;
346 if (display_info
->regs_column_count
== 0)
347 display_info
->regs_column_count
= 1;
349 (TUI_DATA_WIN
->generic
.width
- 2) / display_info
->regs_column_count
;
351 /* Now create each data "sub" window, and write the display into
354 while (i
< display_info
->regs_content_count
355 && cur_y
<= TUI_DATA_WIN
->generic
.viewport_height
)
358 j
< display_info
->regs_column_count
359 && i
< display_info
->regs_content_count
;
362 struct tui_gen_win_info
*data_item_win
;
363 struct tui_data_element
*data_element_ptr
;
365 /* Create the window if necessary. */
366 data_item_win
= &display_info
->regs_content
[i
]
367 ->which_element
.data_window
;
368 data_element_ptr
= &((struct tui_win_element
*)
369 data_item_win
->content
[0])->which_element
.data
;
370 if (data_item_win
->handle
!= (WINDOW
*) NULL
371 && (data_item_win
->height
!= 1
372 || data_item_win
->width
!= item_win_width
373 || data_item_win
->origin
.x
!= (item_win_width
* j
) + 1
374 || data_item_win
->origin
.y
!= cur_y
))
376 tui_delete_win (data_item_win
->handle
);
377 data_item_win
->handle
= 0;
380 if (data_item_win
->handle
== (WINDOW
*) NULL
)
382 data_item_win
->height
= 1;
383 data_item_win
->width
= item_win_width
;
384 data_item_win
->origin
.x
= (item_win_width
* j
) + 1;
385 data_item_win
->origin
.y
= cur_y
;
386 tui_make_window (data_item_win
, DONT_BOX_WINDOW
);
387 scrollok (data_item_win
->handle
, FALSE
);
389 touchwin (data_item_win
->handle
);
391 /* Get the printable representation of the register
393 tui_display_register (data_element_ptr
, data_item_win
);
394 i
++; /* Next register. */
396 cur_y
++; /* Next row. */
402 /* Function to display the registers in the content from
403 'start_element_no' on 'start_line_no' until the end of the register
404 content or the end of the display height. This function checks
405 that we won't display off the end of the register display. */
407 tui_display_reg_element_at_line (int start_element_no
,
410 if (TUI_DATA_WIN
->detail
.data_display_info
.regs_content
411 != (tui_win_content
) NULL
412 && TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
> 0)
414 int element_no
= start_element_no
;
416 if (start_element_no
!= 0 && start_line_no
!= 0)
418 int last_line_no
, first_line_on_last_page
;
420 last_line_no
= tui_last_regs_line_no ();
421 first_line_on_last_page
422 = last_line_no
- (TUI_DATA_WIN
->generic
.height
- 2);
423 if (first_line_on_last_page
< 0)
424 first_line_on_last_page
= 0;
426 /* If there is no other data displayed except registers, and
427 the element_no causes us to scroll past the end of the
428 registers, adjust what element to really start the
430 if (TUI_DATA_WIN
->detail
.data_display_info
.data_content_count
<= 0
431 && start_line_no
> first_line_on_last_page
)
433 = tui_first_reg_element_no_inline (first_line_on_last_page
);
435 tui_display_registers_from (element_no
);
441 /* Function to display the registers starting at line line_no in the
442 data window. Answers the line number that the display actually
443 started from. If nothing is displayed (-1) is returned. */
445 tui_display_registers_from_line (int line_no
,
448 if (TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
> 0)
450 int line
, element_no
;
454 else if (force_display
)
455 { /* If we must display regs (force_display is true), then
456 make sure that we don't display off the end of the
458 if (line_no
>= tui_last_regs_line_no ())
460 if ((line
= tui_line_from_reg_element_no (
461 TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
- 1)) < 0)
470 element_no
= tui_first_reg_element_no_inline (line
);
472 < TUI_DATA_WIN
->detail
.data_display_info
.regs_content_count
)
473 tui_display_reg_element_at_line (element_no
, line
);
480 return (-1); /* Nothing was displayed. */
484 /* This function check all displayed registers for changes in values,
485 given a particular frame. If the values have changed, they are
486 updated with the new value and highlighted. */
488 tui_check_register_values (struct frame_info
*frame
)
490 if (TUI_DATA_WIN
!= NULL
491 && TUI_DATA_WIN
->generic
.is_visible
)
493 struct tui_data_info
*display_info
494 = &TUI_DATA_WIN
->detail
.data_display_info
;
496 if (display_info
->regs_content_count
<= 0
497 && display_info
->display_regs
)
498 tui_show_registers (display_info
->current_group
);
503 for (i
= 0; (i
< display_info
->regs_content_count
); i
++)
505 struct tui_data_element
*data
;
506 struct tui_gen_win_info
*data_item_win_ptr
;
509 data_item_win_ptr
= &display_info
->regs_content
[i
]->
510 which_element
.data_window
;
511 data
= &((struct tui_win_element
*)
512 data_item_win_ptr
->content
[0])->which_element
.data
;
513 was_hilighted
= data
->highlight
;
515 tui_get_register (frame
, data
,
516 data
->item_no
, &data
->highlight
);
518 if (data
->highlight
|| was_hilighted
)
520 tui_display_register (data
, data_item_win_ptr
);
527 /* Display a register in a window. If hilite is TRUE, then the value
528 will be displayed in reverse video. */
530 tui_display_register (struct tui_data_element
*data
,
531 struct tui_gen_win_info
*win_info
)
533 if (win_info
->handle
!= (WINDOW
*) NULL
)
538 /* We ignore the return value, casting it to void in order to avoid
539 a compiler warning. The warning itself was introduced by a patch
540 to ncurses 5.7 dated 2009-08-29, changing this macro to expand
541 to code that causes the compiler to generate an unused-value
543 (void) wstandout (win_info
->handle
);
545 wmove (win_info
->handle
, 0, 0);
546 for (i
= 1; i
< win_info
->width
; i
++)
547 waddch (win_info
->handle
, ' ');
548 wmove (win_info
->handle
, 0, 0);
550 waddstr (win_info
->handle
, data
->content
);
553 /* We ignore the return value, casting it to void in order to avoid
554 a compiler warning. The warning itself was introduced by a patch
555 to ncurses 5.7 dated 2009-08-29, changing this macro to expand
556 to code that causes the compiler to generate an unused-value
558 (void) wstandend (win_info
->handle
);
559 tui_refresh_win (win_info
);
564 tui_reg_next_command (char *arg
, int from_tty
)
566 struct gdbarch
*gdbarch
= get_current_arch ();
568 if (TUI_DATA_WIN
!= 0)
570 struct reggroup
*group
571 = TUI_DATA_WIN
->detail
.data_display_info
.current_group
;
573 group
= reggroup_next (gdbarch
, group
);
575 group
= reggroup_next (gdbarch
, 0);
578 tui_show_registers (group
);
583 tui_reg_float_command (char *arg
, int from_tty
)
585 tui_show_registers (float_reggroup
);
589 tui_reg_general_command (char *arg
, int from_tty
)
591 tui_show_registers (general_reggroup
);
595 tui_reg_system_command (char *arg
, int from_tty
)
597 tui_show_registers (system_reggroup
);
600 static struct cmd_list_element
*tuireglist
;
603 tui_reg_command (char *args
, int from_tty
)
605 printf_unfiltered (_("\"tui reg\" must be followed by the name of a "
606 "tui reg command.\n"));
607 help_list (tuireglist
, "tui reg ", all_commands
, gdb_stdout
);
610 /* Provide a prototype to silence -Wmissing-prototypes. */
611 extern initialize_file_ftype _initialize_tui_regs
;
614 _initialize_tui_regs (void)
616 struct cmd_list_element
**tuicmd
;
618 tuicmd
= tui_get_cmd_list ();
620 add_prefix_cmd ("reg", class_tui
, tui_reg_command
,
621 _("TUI commands to control the register window."),
622 &tuireglist
, "tui reg ", 0,
625 add_cmd ("float", class_tui
, tui_reg_float_command
,
626 _("Display only floating point registers."),
628 add_cmd ("general", class_tui
, tui_reg_general_command
,
629 _("Display only general registers."),
631 add_cmd ("system", class_tui
, tui_reg_system_command
,
632 _("Display only system registers."),
634 add_cmd ("next", class_tui
, tui_reg_next_command
,
635 _("Display next register group."),
640 /*****************************************
641 ** STATIC LOCAL FUNCTIONS **
642 ******************************************/
645 tui_restore_gdbout (void *ui
)
647 ui_file_delete (gdb_stdout
);
648 gdb_stdout
= (struct ui_file
*) ui
;
649 pagination_enabled
= 1;
652 /* Get the register from the frame and return a printable
653 representation of it. */
656 tui_register_format (struct frame_info
*frame
, int regnum
)
658 struct gdbarch
*gdbarch
= get_frame_arch (frame
);
659 struct ui_file
*stream
;
660 struct ui_file
*old_stdout
;
661 struct cleanup
*cleanups
;
665 pagination_enabled
= 0;
666 old_stdout
= gdb_stdout
;
667 stream
= tui_sfileopen (256);
669 cleanups
= make_cleanup (tui_restore_gdbout
, (void*) old_stdout
);
670 gdbarch_print_registers_info (gdbarch
, stream
, frame
, regnum
, 1);
672 /* Save formatted output in the buffer. */
673 p
= tui_file_get_strbuf (stream
);
675 /* Remove the possible \n. */
676 s
= strrchr (p
, '\n');
680 /* Expand tabs into spaces, since ncurses on MS-Windows doesn't. */
681 ret
= tui_expand_tabs (p
, 0);
683 do_cleanups (cleanups
);
688 /* Get the register value from the given frame and format it for the
689 display. When changep is set, check if the new register value has
690 changed with respect to the previous call. */
691 static enum tui_status
692 tui_get_register (struct frame_info
*frame
,
693 struct tui_data_element
*data
,
694 int regnum
, int *changedp
)
696 enum tui_status ret
= TUI_FAILURE
;
700 if (target_has_registers
)
702 char *prev_content
= data
->content
;
704 data
->content
= tui_register_format (frame
, regnum
);
707 && strcmp (prev_content
, data
->content
) != 0)
710 xfree (prev_content
);