1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<!-- Copyright (C) 1988-2021 Free Software Foundation, Inc. 4 5Permission is granted to copy, distribute and/or modify this document 6under the terms of the GNU Free Documentation License, Version 1.3 or 7any later version published by the Free Software Foundation; with the 8Invariant Sections being "Free Software" and "Free Software Needs 9Free Documentation", with the Front-Cover Texts being "A GNU Manual," 10and with the Back-Cover Texts as in (a) below. 11 12(a) The FSF's Back-Cover Text is: "You are free to copy and modify 13this GNU Manual. Buying copies from GNU Press supports the FSF in 14developing GNU and promoting software freedom." --> 15<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> 16<head> 17<title>Debugging with GDB: TUI Keys</title> 18 19<meta name="description" content="Debugging with GDB: TUI Keys"> 20<meta name="keywords" content="Debugging with GDB: TUI Keys"> 21<meta name="resource-type" content="document"> 22<meta name="distribution" content="global"> 23<meta name="Generator" content="makeinfo"> 24<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 25<link href="index.html#Top" rel="start" title="Top"> 26<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index"> 27<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 28<link href="TUI.html#TUI" rel="up" title="TUI"> 29<link href="TUI-Single-Key-Mode.html#TUI-Single-Key-Mode" rel="next" title="TUI Single Key Mode"> 30<link href="TUI-Overview.html#TUI-Overview" rel="previous" title="TUI Overview"> 31<style type="text/css"> 32<!-- 33a.summary-letter {text-decoration: none} 34blockquote.smallquotation {font-size: smaller} 35div.display {margin-left: 3.2em} 36div.example {margin-left: 3.2em} 37div.indentedblock {margin-left: 3.2em} 38div.lisp {margin-left: 3.2em} 39div.smalldisplay {margin-left: 3.2em} 40div.smallexample {margin-left: 3.2em} 41div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 42div.smalllisp {margin-left: 3.2em} 43kbd {font-style:oblique} 44pre.display {font-family: inherit} 45pre.format {font-family: inherit} 46pre.menu-comment {font-family: serif} 47pre.menu-preformatted {font-family: serif} 48pre.smalldisplay {font-family: inherit; font-size: smaller} 49pre.smallexample {font-size: smaller} 50pre.smallformat {font-family: inherit; font-size: smaller} 51pre.smalllisp {font-size: smaller} 52span.nocodebreak {white-space:nowrap} 53span.nolinebreak {white-space:nowrap} 54span.roman {font-family:serif; font-weight:normal} 55span.sansserif {font-family:sans-serif; font-weight:normal} 56ul.no-bullet {list-style: none} 57--> 58</style> 59 60 61</head> 62 63<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 64<a name="TUI-Keys"></a> 65<div class="header"> 66<p> 67Next: <a href="TUI-Single-Key-Mode.html#TUI-Single-Key-Mode" accesskey="n" rel="next">TUI Single Key Mode</a>, Previous: <a href="TUI-Overview.html#TUI-Overview" accesskey="p" rel="previous">TUI Overview</a>, Up: <a href="TUI.html#TUI" accesskey="u" rel="up">TUI</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p> 68</div> 69<hr> 70<a name="TUI-Key-Bindings"></a> 71<h3 class="section">25.2 TUI Key Bindings</h3> 72<a name="index-TUI-key-bindings"></a> 73 74<p>The TUI installs several key bindings in the readline keymaps 75(see <a href="Command-Line-Editing.html#Command-Line-Editing">Command Line Editing</a>). 76The following key bindings are installed for both TUI mode and the 77<small>GDB</small> standard mode. 78</p> 79<dl compact="compact"> 80<dd><a name="index-C_002dx-C_002da"></a> 81</dd> 82<dt><kbd>C-x C-a</kbd></dt> 83<dd><a name="index-C_002dx-a"></a> 84</dd> 85<dt><kbd>C-x a</kbd></dt> 86<dd><a name="index-C_002dx-A"></a> 87</dd> 88<dt><kbd>C-x A</kbd></dt> 89<dd><p>Enter or leave the TUI mode. When leaving the TUI mode, 90the curses window management stops and <small>GDB</small> operates using 91its standard mode, writing on the terminal directly. When reentering 92the TUI mode, control is given back to the curses windows. 93The screen is then refreshed. 94</p> 95<p>This key binding uses the bindable Readline function 96<code>tui-switch-mode</code>. 97</p> 98<a name="index-C_002dx-1"></a> 99</dd> 100<dt><kbd>C-x 1</kbd></dt> 101<dd><p>Use a TUI layout with only one window. The layout will 102either be ‘<samp>source</samp>’ or ‘<samp>assembly</samp>’. When the TUI mode 103is not active, it will switch to the TUI mode. 104</p> 105<p>Think of this key binding as the Emacs <kbd>C-x 1</kbd> binding. 106</p> 107<p>This key binding uses the bindable Readline function 108<code>tui-delete-other-windows</code>. 109</p> 110<a name="index-C_002dx-2"></a> 111</dd> 112<dt><kbd>C-x 2</kbd></dt> 113<dd><p>Use a TUI layout with at least two windows. When the current 114layout already has two windows, the next layout with two windows is used. 115When a new layout is chosen, one window will always be common to the 116previous layout and the new one. 117</p> 118<p>Think of it as the Emacs <kbd>C-x 2</kbd> binding. 119</p> 120<p>This key binding uses the bindable Readline function 121<code>tui-change-windows</code>. 122</p> 123<a name="index-C_002dx-o"></a> 124</dd> 125<dt><kbd>C-x o</kbd></dt> 126<dd><p>Change the active window. The TUI associates several key bindings 127(like scrolling and arrow keys) with the active window. This command 128gives the focus to the next TUI window. 129</p> 130<p>Think of it as the Emacs <kbd>C-x o</kbd> binding. 131</p> 132<p>This key binding uses the bindable Readline function 133<code>tui-other-window</code>. 134</p> 135<a name="index-C_002dx-s"></a> 136</dd> 137<dt><kbd>C-x s</kbd></dt> 138<dd><p>Switch in and out of the TUI SingleKey mode that binds single 139keys to <small>GDB</small> commands (see <a href="TUI-Single-Key-Mode.html#TUI-Single-Key-Mode">TUI Single Key Mode</a>). 140</p> 141<p>This key binding uses the bindable Readline function 142<code>next-keymap</code>. 143</p></dd> 144</dl> 145 146<p>The following key bindings only work in the TUI mode: 147</p> 148<dl compact="compact"> 149<dd><a name="index-PgUp"></a> 150</dd> 151<dt><tt class="key">PgUp</tt></dt> 152<dd><p>Scroll the active window one page up. 153</p> 154<a name="index-PgDn"></a> 155</dd> 156<dt><tt class="key">PgDn</tt></dt> 157<dd><p>Scroll the active window one page down. 158</p> 159<a name="index-Up"></a> 160</dd> 161<dt><tt class="key">Up</tt></dt> 162<dd><p>Scroll the active window one line up. 163</p> 164<a name="index-Down"></a> 165</dd> 166<dt><tt class="key">Down</tt></dt> 167<dd><p>Scroll the active window one line down. 168</p> 169<a name="index-Left"></a> 170</dd> 171<dt><tt class="key">Left</tt></dt> 172<dd><p>Scroll the active window one column left. 173</p> 174<a name="index-Right"></a> 175</dd> 176<dt><tt class="key">Right</tt></dt> 177<dd><p>Scroll the active window one column right. 178</p> 179<a name="index-C_002dL"></a> 180</dd> 181<dt><kbd>C-L</kbd></dt> 182<dd><p>Refresh the screen. 183</p></dd> 184</dl> 185 186<p>Because the arrow keys scroll the active window in the TUI mode, they 187are not available for their normal use by readline unless the command 188window has the focus. When another window is active, you must use 189other readline key bindings such as <kbd>C-p</kbd>, <kbd>C-n</kbd>, <kbd>C-b</kbd> 190and <kbd>C-f</kbd> to control the command window. 191</p> 192<hr> 193<div class="header"> 194<p> 195Next: <a href="TUI-Single-Key-Mode.html#TUI-Single-Key-Mode" accesskey="n" rel="next">TUI Single Key Mode</a>, Previous: <a href="TUI-Overview.html#TUI-Overview" accesskey="p" rel="previous">TUI Overview</a>, Up: <a href="TUI.html#TUI" accesskey="u" rel="up">TUI</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p> 196</div> 197 198 199 200</body> 201</html> 202