SPU.html 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151
  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-2019 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.2, http://www.gnu.org/software/texinfo/ -->
  14. <head>
  15. <title>Debugging with GDB: SPU</title>
  16. <meta name="description" content="Debugging with GDB: SPU">
  17. <meta name="keywords" content="Debugging with GDB: SPU">
  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="Architectures.html#Architectures" rel="up" title="Architectures">
  26. <link href="PowerPC.html#PowerPC" rel="next" title="PowerPC">
  27. <link href="HPPA.html#HPPA" rel="prev" title="HPPA">
  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="SPU"></a>
  59. <div class="header">
  60. <p>
  61. Next: <a href="PowerPC.html#PowerPC" accesskey="n" rel="next">PowerPC</a>, Previous: <a href="HPPA.html#HPPA" accesskey="p" rel="prev">HPPA</a>, Up: <a href="Architectures.html#Architectures" accesskey="u" rel="up">Architectures</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="Cell-Broadband-Engine-SPU-architecture"></a>
  65. <h4 class="subsection">21.4.6 Cell Broadband Engine SPU architecture</h4>
  66. <a name="index-Cell-Broadband-Engine"></a>
  67. <a name="index-SPU"></a>
  68. <p>When <small>GDB</small> is debugging the Cell Broadband Engine SPU architecture,
  69. it provides the following special commands:
  70. </p>
  71. <dl compact="compact">
  72. <dt><code>info spu event</code></dt>
  73. <dd><a name="index-info-spu"></a>
  74. <p>Display SPU event facility status. Shows current event mask
  75. and pending event status.
  76. </p>
  77. </dd>
  78. <dt><code>info spu signal</code></dt>
  79. <dd><p>Display SPU signal notification facility status. Shows pending
  80. signal-control word and signal notification mode of both signal
  81. notification channels.
  82. </p>
  83. </dd>
  84. <dt><code>info spu mailbox</code></dt>
  85. <dd><p>Display SPU mailbox facility status. Shows all pending entries,
  86. in order of processing, in each of the SPU Write Outbound,
  87. SPU Write Outbound Interrupt, and SPU Read Inbound mailboxes.
  88. </p>
  89. </dd>
  90. <dt><code>info spu dma</code></dt>
  91. <dd><p>Display MFC DMA status. Shows all pending commands in the MFC
  92. DMA queue. For each entry, opcode, tag, class IDs, effective
  93. and local store addresses and transfer size are shown.
  94. </p>
  95. </dd>
  96. <dt><code>info spu proxydma</code></dt>
  97. <dd><p>Display MFC Proxy-DMA status. Shows all pending commands in the MFC
  98. Proxy-DMA queue. For each entry, opcode, tag, class IDs, effective
  99. and local store addresses and transfer size are shown.
  100. </p>
  101. </dd>
  102. </dl>
  103. <p>When <small>GDB</small> is debugging a combined PowerPC/SPU application
  104. on the Cell Broadband Engine, it provides in addition the following
  105. special commands:
  106. </p>
  107. <dl compact="compact">
  108. <dt><code>set spu stop-on-load <var>arg</var></code></dt>
  109. <dd><a name="index-set-spu"></a>
  110. <p>Set whether to stop for new SPE threads. When set to <code>on</code>, <small>GDB</small>
  111. will give control to the user when a new SPE thread enters its <code>main</code>
  112. function. The default is <code>off</code>.
  113. </p>
  114. </dd>
  115. <dt><code>show spu stop-on-load</code></dt>
  116. <dd><a name="index-show-spu"></a>
  117. <p>Show whether to stop for new SPE threads.
  118. </p>
  119. </dd>
  120. <dt><code>set spu auto-flush-cache <var>arg</var></code></dt>
  121. <dd><p>Set whether to automatically flush the software-managed cache. When set to
  122. <code>on</code>, <small>GDB</small> will automatically cause the SPE software-managed
  123. cache to be flushed whenever SPE execution stops. This provides a consistent
  124. view of PowerPC memory that is accessed via the cache. If an application
  125. does not use the software-managed cache, this option has no effect.
  126. </p>
  127. </dd>
  128. <dt><code>show spu auto-flush-cache</code></dt>
  129. <dd><p>Show whether to automatically flush the software-managed cache.
  130. </p>
  131. </dd>
  132. </dl>
  133. <hr>
  134. <div class="header">
  135. <p>
  136. Next: <a href="PowerPC.html#PowerPC" accesskey="n" rel="next">PowerPC</a>, Previous: <a href="HPPA.html#HPPA" accesskey="p" rel="prev">HPPA</a>, Up: <a href="Architectures.html#Architectures" accesskey="u" rel="up">Architectures</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>
  137. </div>
  138. </body>
  139. </html>