Prompt.html 5.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  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: Prompt</title>
  16. <meta name="description" content="Debugging with GDB: Prompt">
  17. <meta name="keywords" content="Debugging with GDB: Prompt">
  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="Controlling-GDB.html#Controlling-GDB" rel="up" title="Controlling GDB">
  26. <link href="Editing.html#Editing" rel="next" title="Editing">
  27. <link href="Controlling-GDB.html#Controlling-GDB" rel="previous" title="Controlling GDB">
  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="Prompt"></a>
  59. <div class="header">
  60. <p>
  61. Next: <a href="Editing.html#Editing" accesskey="n" rel="next">Editing</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>
  62. </div>
  63. <hr>
  64. <a name="Prompt-1"></a>
  65. <h3 class="section">22.1 Prompt</h3>
  66. <a name="index-prompt"></a>
  67. <p><small>GDB</small> indicates its readiness to read a command by printing a string
  68. called the <em>prompt</em>. This string is normally &lsquo;<samp>(gdb)</samp>&rsquo;. You
  69. can change the prompt string with the <code>set prompt</code> command. For
  70. instance, when debugging <small>GDB</small> with <small>GDB</small>, it is useful to change
  71. the prompt in one of the <small>GDB</small> sessions so that you can always tell
  72. which one you are talking to.
  73. </p>
  74. <p><em>Note:</em> <code>set prompt</code> does not add a space for you after the
  75. prompt you set. This allows you to set a prompt which ends in a space
  76. or a prompt that does not.
  77. </p>
  78. <dl compact="compact">
  79. <dd><a name="index-set-prompt"></a>
  80. </dd>
  81. <dt><code>set prompt <var>newprompt</var></code></dt>
  82. <dd><p>Directs <small>GDB</small> to use <var>newprompt</var> as its prompt string henceforth.
  83. </p>
  84. <a name="index-show-prompt"></a>
  85. </dd>
  86. <dt><code>show prompt</code></dt>
  87. <dd><p>Prints a line of the form: &lsquo;<samp>Gdb's prompt is: <var>your-prompt</var></samp>&rsquo;
  88. </p></dd>
  89. </dl>
  90. <p>Versions of <small>GDB</small> that ship with Python scripting enabled have
  91. prompt extensions. The commands for interacting with these extensions
  92. are:
  93. </p>
  94. <dl compact="compact">
  95. <dd><a name="index-set-extended_002dprompt"></a>
  96. </dd>
  97. <dt><code>set extended-prompt <var>prompt</var></code></dt>
  98. <dd><p>Set an extended prompt that allows for substitutions.
  99. See <a href="gdb_002eprompt.html#gdb_002eprompt">gdb.prompt</a>, for a list of escape sequences that can be used for
  100. substitution. Any escape sequences specified as part of the prompt
  101. string are replaced with the corresponding strings each time the prompt
  102. is displayed.
  103. </p>
  104. <p>For example:
  105. </p>
  106. <div class="smallexample">
  107. <pre class="smallexample">set extended-prompt Current working directory: \w (gdb)
  108. </pre></div>
  109. <p>Note that when an extended-prompt is set, it takes control of the
  110. <var>prompt_hook</var> hook. See <a href="Basic-Python.html#prompt_005fhook">prompt_hook</a>, for further information.
  111. </p>
  112. <a name="index-show-extended_002dprompt"></a>
  113. </dd>
  114. <dt><code>show extended-prompt</code></dt>
  115. <dd><p>Prints the extended prompt. Any escape sequences specified as part of
  116. the prompt string with <code>set extended-prompt</code>, are replaced with the
  117. corresponding strings each time the prompt is displayed.
  118. </p></dd>
  119. </dl>
  120. <hr>
  121. <div class="header">
  122. <p>
  123. Next: <a href="Editing.html#Editing" accesskey="n" rel="next">Editing</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>
  124. </div>
  125. </body>
  126. </html>