Next: TUI Configuration, Previous: TUI Single Key Mode, Up: TUI [Contents][Index]
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 (see The GDB/MI Interface), most of
these commands will fail with an error, because it would not be
possible or desirable to enable curses window management.
tui enableActivate 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 disableDisable TUI mode, returning to the console interpreter.
info winList and give the size of all displayed windows.
layout nameChanges 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:
nextDisplay the next layout.
prevDisplay the previous layout.
srcDisplay the source and command windows.
asmDisplay the assembly and command windows.
splitDisplay the source, assembly, and command windows.
regsWhen in src layout display the register, source, and command
windows. When in asm or split layout display the
register, assembler, and command windows.
focus nameChanges which TUI window is currently active for scrolling. The name parameter can be any of the following:
nextMake the next window active for scrolling.
prevMake the previous window active for scrolling.
srcMake the source window active for scrolling.
asmMake the assembly window active for scrolling.
regsMake the register window active for scrolling.
cmdMake the command window active for scrolling.
refreshRefresh the screen. This is similar to typing C-L.
tui reg groupChanges 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:
nextRepeatedly selecting this group will cause the display to cycle through all of the available register groups.
prevRepeatedly selecting this group will cause the display to cycle through all of the available register groups in the reverse order to next.
generalDisplay the general registers.
floatDisplay the floating point registers.
systemDisplay the system registers.
vectorDisplay the vector registers.
allDisplay all registers.
updateUpdate the source window and the current execution point.
winheight name +countwinheight name -countChange 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).
tabset ncharsSet the width of tab stops to be nchars characters. This setting affects the display of TAB characters in the source and assembly windows.
Next: TUI Configuration, Previous: TUI Single Key Mode, Up: TUI [Contents][Index]