Command-Syntax.html 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
  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 5.1, http://www.gnu.org/software/texinfo/ -->
  14. <head>
  15. <title>Debugging with GDB: Command Syntax</title>
  16. <meta name="description" content="Debugging with GDB: Command Syntax">
  17. <meta name="keywords" content="Debugging with GDB: Command Syntax">
  18. <meta name="resource-type" content="document">
  19. <meta name="distribution" content="global">
  20. <meta name="Generator" content="makeinfo">
  21. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  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="Commands.html#Commands" rel="up" title="Commands">
  26. <link href="Command-Settings.html#Command-Settings" rel="next" title="Command Settings">
  27. <link href="Commands.html#Commands" rel="previous" title="Commands">
  28. <style type="text/css">
  29. <!--
  30. a.summary-letter {text-decoration: none}
  31. blockquote.smallquotation {font-size: smaller}
  32. div.display {margin-left: 3.2em}
  33. div.example {margin-left: 3.2em}
  34. div.indentedblock {margin-left: 3.2em}
  35. div.lisp {margin-left: 3.2em}
  36. div.smalldisplay {margin-left: 3.2em}
  37. div.smallexample {margin-left: 3.2em}
  38. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  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.nocodebreak {white-space:nowrap}
  50. span.nolinebreak {white-space:nowrap}
  51. span.roman {font-family:serif; font-weight:normal}
  52. span.sansserif {font-family:sans-serif; font-weight:normal}
  53. ul.no-bullet {list-style: none}
  54. -->
  55. </style>
  56. </head>
  57. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  58. <a name="Command-Syntax"></a>
  59. <div class="header">
  60. <p>
  61. Next: <a href="Command-Settings.html#Command-Settings" accesskey="n" rel="next">Command Settings</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</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>
  62. </div>
  63. <hr>
  64. <a name="Command-Syntax-1"></a>
  65. <h3 class="section">3.1 Command Syntax</h3>
  66. <p>A <small>GDB</small> command is a single line of input. There is no limit on
  67. how long it can be. It starts with a command name, which is followed by
  68. arguments whose meaning depends on the command name. For example, the
  69. command <code>step</code> accepts an argument which is the number of times to
  70. step, as in &lsquo;<samp>step 5</samp>&rsquo;. You can also use the <code>step</code> command
  71. with no arguments. Some commands do not allow any arguments.
  72. </p>
  73. <a name="index-abbreviation"></a>
  74. <p><small>GDB</small> command names may always be truncated if that abbreviation is
  75. unambiguous. Other possible command abbreviations are listed in the
  76. documentation for individual commands. In some cases, even ambiguous
  77. abbreviations are allowed; for example, <code>s</code> is specially defined as
  78. equivalent to <code>step</code> even though there are other commands whose
  79. names start with <code>s</code>. You can test abbreviations by using them as
  80. arguments to the <code>help</code> command.
  81. </p>
  82. <a name="index-repeating-commands"></a>
  83. <a name="index-RET-_0028repeat-last-command_0029"></a>
  84. <p>A blank line as input to <small>GDB</small> (typing just <tt class="key">RET</tt>) means to
  85. repeat the previous command. Certain commands (for example, <code>run</code>)
  86. will not repeat this way; these are commands whose unintentional
  87. repetition might cause trouble and which you are unlikely to want to
  88. repeat. User-defined commands can disable this feature; see
  89. <a href="Define.html#Define">dont-repeat</a>.
  90. </p>
  91. <p>The <code>list</code> and <code>x</code> commands, when you repeat them with
  92. <tt class="key">RET</tt>, construct new arguments rather than repeating
  93. exactly as typed. This permits easy scanning of source or memory.
  94. </p>
  95. <p><small>GDB</small> can also use <tt class="key">RET</tt> in another way: to partition lengthy
  96. output, in a way similar to the common utility <code>more</code>
  97. (see <a href="Screen-Size.html#Screen-Size">Screen Size</a>). Since it is easy to press one
  98. <tt class="key">RET</tt> too many in this situation, <small>GDB</small> disables command
  99. repetition after any command that generates this sort of display.
  100. </p>
  101. <a name="index-_0023-_0028a-comment_0029"></a>
  102. <a name="index-comment"></a>
  103. <p>Any text from a <kbd>#</kbd> to the end of the line is a comment; it does
  104. nothing. This is useful mainly in command files (see <a href="Command-Files.html#Command-Files">Command Files</a>).
  105. </p>
  106. <a name="index-repeating-command-sequences"></a>
  107. <a name="index-Ctrl_002do-_0028operate_002dand_002dget_002dnext_0029"></a>
  108. <p>The <kbd>Ctrl-o</kbd> binding is useful for repeating a complex sequence of
  109. commands. This command accepts the current line, like <tt class="key">RET</tt>, and
  110. then fetches the next line relative to the current line from the history
  111. for editing.
  112. </p>
  113. <hr>
  114. <div class="header">
  115. <p>
  116. Next: <a href="Command-Settings.html#Command-Settings" accesskey="n" rel="next">Command Settings</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</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>
  117. </div>
  118. </body>
  119. </html>