gdb: TUI Commands
25.4 TUI-specific Commands
==========================
The TUI has specific commands to control the text windows. These
commands are always available, even when GDB is not in the TUI mode.
When GDB is in the standard mode, most of these commands will
automatically switch to the TUI mode.
Note that if GDB's 'stdout' is not connected to a terminal, or GDB
has been started with the machine interface interpreter (The
GDB/MI Interface GDB/MI.), most of these commands will fail with an
error, because it would not be possible or desirable to enable curses
window management.
'tui enable'
Activate TUI mode. The last active TUI window layout will be used
if TUI mode has prevsiouly been used in the current debugging
session, otherwise a default layout is used.
'tui disable'
Disable TUI mode, returning to the console interpreter.
'info win'
List and give the size of all displayed windows.
'layout NAME'
Changes which TUI windows are displayed. In each layout the
command window is always displayed, the NAME parameter controls
which additional windows are displayed, and can be any of the
following:
'next'
Display the next layout.
'prev'
Display the previous layout.
'src'
Display the source and command windows.
'asm'
Display the assembly and command windows.
'split'
Display the source, assembly, and command windows.
'regs'
When in 'src' layout display the register, source, and command
windows. When in 'asm' or 'split' layout display the
register, assembler, and command windows.
'focus NAME'
Changes which TUI window is currently active for scrolling. The
NAME parameter can be any of the following:
'next'
Make the next window active for scrolling.
'prev'
Make the previous window active for scrolling.
'src'
Make the source window active for scrolling.
'asm'
Make the assembly window active for scrolling.
'regs'
Make the register window active for scrolling.
'cmd'
Make the command window active for scrolling.
'refresh'
Refresh the screen. This is similar to typing 'C-L'.
'tui reg GROUP'
Changes the register group displayed in the tui register window to
GROUP. If the register window is not currently displayed this
command will cause the register window to be displayed. The list
of register groups, as well as their order is target specific. The
following groups are available on most targets:
'next'
Repeatedly selecting this group will cause the display to
cycle through all of the available register groups.
'prev'
Repeatedly selecting this group will cause the display to
cycle through all of the available register groups in the
reverse order to NEXT.
'general'
Display the general registers.
'float'
Display the floating point registers.
'system'
Display the system registers.
'vector'
Display the vector registers.
'all'
Display all registers.
'update'
Update the source window and the current execution point.
'winheight NAME +COUNT'
'winheight NAME -COUNT'
Change the height of the window NAME by COUNT lines. Positive
counts increase the height, while negative counts decrease it. The
NAME parameter can be one of 'src' (the source window), 'cmd' (the
command window), 'asm' (the disassembly window), or 'regs' (the
register display window).