You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

144 line
6.6KB

  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-2020 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Free Software" and "Free Software Needs
  8. Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
  9. and with the Back-Cover Texts as in (a) below.
  10. (a) The FSF's Back-Cover Text is: "You are free to copy and modify
  11. this GNU Manual. Buying copies from GNU Press supports the FSF in
  12. developing GNU and promoting software freedom." -->
  13. <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
  14. <head>
  15. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  16. <title>Screen Size (Debugging with GDB)</title>
  17. <meta name="description" content="Screen Size (Debugging with GDB)">
  18. <meta name="keywords" content="Screen Size (Debugging with GDB)">
  19. <meta name="resource-type" content="document">
  20. <meta name="distribution" content="global">
  21. <meta name="Generator" content="makeinfo">
  22. <link href="index.html#Top" rel="start" title="Top">
  23. <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
  24. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  25. <link href="Controlling-GDB.html#Controlling-GDB" rel="up" title="Controlling GDB">
  26. <link href="Output-Styling.html#Output-Styling" rel="next" title="Output Styling">
  27. <link href="Command-History.html#Command-History" rel="prev" title="Command History">
  28. <style type="text/css">
  29. <!--
  30. a.summary-letter {text-decoration: none}
  31. blockquote.indentedblock {margin-right: 0em}
  32. blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
  33. blockquote.smallquotation {font-size: smaller}
  34. div.display {margin-left: 3.2em}
  35. div.example {margin-left: 3.2em}
  36. div.lisp {margin-left: 3.2em}
  37. div.smalldisplay {margin-left: 3.2em}
  38. div.smallexample {margin-left: 3.2em}
  39. div.smalllisp {margin-left: 3.2em}
  40. kbd {font-style: oblique}
  41. pre.display {font-family: inherit}
  42. pre.format {font-family: inherit}
  43. pre.menu-comment {font-family: serif}
  44. pre.menu-preformatted {font-family: serif}
  45. pre.smalldisplay {font-family: inherit; font-size: smaller}
  46. pre.smallexample {font-size: smaller}
  47. pre.smallformat {font-family: inherit; font-size: smaller}
  48. pre.smalllisp {font-size: smaller}
  49. span.nolinebreak {white-space: nowrap}
  50. span.roman {font-family: initial; font-weight: normal}
  51. span.sansserif {font-family: sans-serif; font-weight: normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en">
  57. <a name="Screen-Size"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="Output-Styling.html#Output-Styling" accesskey="n" rel="next">Output Styling</a>, Previous: <a href="Command-History.html#Command-History" accesskey="p" rel="prev">Command History</a>, Up: <a href="Controlling-GDB.html#Controlling-GDB" accesskey="u" rel="up">Controlling GDB</a> &nbsp; [<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>
  61. </div>
  62. <hr>
  63. <a name="Screen-Size-1"></a>
  64. <h3 class="section">22.4 Screen Size</h3>
  65. <a name="index-size-of-screen"></a>
  66. <a name="index-screen-size"></a>
  67. <a name="index-pagination"></a>
  68. <a name="index-page-size"></a>
  69. <a name="index-pauses-in-output"></a>
  70. <p>Certain commands to <small>GDB</small> may produce large amounts of
  71. information output to the screen. To help you read all of it,
  72. <small>GDB</small> pauses and asks you for input at the end of each page of
  73. output. Type <tt class="key">RET</tt> when you want to see one more page of output,
  74. <kbd>q</kbd> to discard the remaining output, or <kbd>c</kbd> to continue
  75. without paging for the rest of the current command. Also, the screen
  76. width setting determines when to wrap lines of output. Depending on
  77. what is being printed, <small>GDB</small> tries to break the line at a
  78. readable place, rather than simply letting it overflow onto the
  79. following line.
  80. </p>
  81. <p>Normally <small>GDB</small> knows the size of the screen from the terminal
  82. driver software. For example, on Unix <small>GDB</small> uses the termcap data base
  83. together with the value of the <code>TERM</code> environment variable and the
  84. <code>stty rows</code> and <code>stty cols</code> settings. If this is not correct,
  85. you can override it with the <code>set height</code> and <code>set
  86. width</code> commands:
  87. </p>
  88. <dl compact="compact">
  89. <dd><a name="index-set-height"></a>
  90. <a name="index-set-width"></a>
  91. <a name="index-show-width"></a>
  92. <a name="index-show-height"></a>
  93. </dd>
  94. <dt><code>set height <var>lpp</var></code></dt>
  95. <dt><code>set height unlimited</code></dt>
  96. <dt><code>show height</code></dt>
  97. <dt><code>set width <var>cpl</var></code></dt>
  98. <dt><code>set width unlimited</code></dt>
  99. <dt><code>show width</code></dt>
  100. <dd><p>These <code>set</code> commands specify a screen height of <var>lpp</var> lines and
  101. a screen width of <var>cpl</var> characters. The associated <code>show</code>
  102. commands display the current settings.
  103. </p>
  104. <p>If you specify a height of either <code>unlimited</code> or zero lines,
  105. <small>GDB</small> does not pause during output no matter how long the
  106. output is. This is useful if output is to a file or to an editor
  107. buffer.
  108. </p>
  109. <p>Likewise, you can specify &lsquo;<samp>set width unlimited</samp>&rsquo; or &lsquo;<samp>set
  110. width 0</samp>&rsquo; to prevent <small>GDB</small> from wrapping its output.
  111. </p>
  112. </dd>
  113. <dt><code>set pagination on</code></dt>
  114. <dt><code>set pagination off</code></dt>
  115. <dd><a name="index-set-pagination"></a>
  116. <p>Turn the output pagination on or off; the default is on. Turning
  117. pagination off is the alternative to <code>set height unlimited</code>. Note that
  118. running <small>GDB</small> with the <samp>--batch</samp> option (see <a href="Mode-Options.html#Mode-Options">-batch</a>) also automatically disables pagination.
  119. </p>
  120. </dd>
  121. <dt><code>show pagination</code></dt>
  122. <dd><a name="index-show-pagination"></a>
  123. <p>Show the current pagination mode.
  124. </p></dd>
  125. </dl>
  126. <hr>
  127. <div class="header">
  128. <p>
  129. Next: <a href="Output-Styling.html#Output-Styling" accesskey="n" rel="next">Output Styling</a>, Previous: <a href="Command-History.html#Command-History" accesskey="p" rel="prev">Command History</a>, Up: <a href="Controlling-GDB.html#Controlling-GDB" accesskey="u" rel="up">Controlling GDB</a> &nbsp; [<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>
  130. </div>
  131. </body>
  132. </html>