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.

108 lines
5.4KB

  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>RISC-V Features (Debugging with GDB)</title>
  17. <meta name="description" content="RISC-V Features (Debugging with GDB)">
  18. <meta name="keywords" content="RISC-V Features (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="Standard-Target-Features.html#Standard-Target-Features" rel="up" title="Standard Target Features">
  26. <link href="RX-Features.html#RX-Features" rel="next" title="RX Features">
  27. <link href="PowerPC-Features.html#PowerPC-Features" rel="prev" title="PowerPC Features">
  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="RISC_002dV-Features"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="RX-Features.html#RX-Features" accesskey="n" rel="next">RX Features</a>, Previous: <a href="PowerPC-Features.html#PowerPC-Features" accesskey="p" rel="prev">PowerPC Features</a>, Up: <a href="Standard-Target-Features.html#Standard-Target-Features" accesskey="u" rel="up">Standard Target Features</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="RISC_002dV-Features-1"></a>
  64. <h4 class="subsection">G.5.12 RISC-V Features</h4>
  65. <a name="index-target-descriptions_002c-RISC_002dV-Features"></a>
  66. <p>The &lsquo;<samp>org.gnu.gdb.riscv.cpu</samp>&rsquo; feature is required for RISC-V
  67. targets. It should contain the registers &lsquo;<samp>x0</samp>&rsquo; through
  68. &lsquo;<samp>x31</samp>&rsquo;, and &lsquo;<samp>pc</samp>&rsquo;. Either the architectural names (&lsquo;<samp>x0</samp>&rsquo;,
  69. &lsquo;<samp>x1</samp>&rsquo;, etc) can be used, or the ABI names (&lsquo;<samp>zero</samp>&rsquo;, &lsquo;<samp>ra</samp>&rsquo;,
  70. etc).
  71. </p>
  72. <p>The &lsquo;<samp>org.gnu.gdb.riscv.fpu</samp>&rsquo; feature is optional. If present, it
  73. should contain registers &lsquo;<samp>f0</samp>&rsquo; through &lsquo;<samp>f31</samp>&rsquo;, &lsquo;<samp>fflags</samp>&rsquo;,
  74. &lsquo;<samp>frm</samp>&rsquo;, and &lsquo;<samp>fcsr</samp>&rsquo;. As with the cpu feature, either the
  75. architectural register names, or the ABI names can be used.
  76. </p>
  77. <p>The &lsquo;<samp>org.gnu.gdb.riscv.virtual</samp>&rsquo; feature is optional. If present,
  78. it should contain registers that are not backed by real registers on
  79. the target, but are instead virtual, where the register value is
  80. derived from other target state. In many ways these are like
  81. <small>GDB</small>s pseudo-registers, except implemented by the target.
  82. Currently the only register expected in this set is the one byte
  83. &lsquo;<samp>priv</samp>&rsquo; register that contains the target&rsquo;s privilege level in the
  84. least significant two bits.
  85. </p>
  86. <p>The &lsquo;<samp>org.gnu.gdb.riscv.csr</samp>&rsquo; feature is optional. If present, it
  87. should contain all of the target&rsquo;s standard CSRs. Standard CSRs are
  88. those defined in the RISC-V specification documents. There is some
  89. overlap between this feature and the fpu feature; the &lsquo;<samp>fflags</samp>&rsquo;,
  90. &lsquo;<samp>frm</samp>&rsquo;, and &lsquo;<samp>fcsr</samp>&rsquo; registers could be in either feature. The
  91. expectation is that these registers will be in the fpu feature if the
  92. target has floating point hardware, but can be moved into the csr
  93. feature if the target has the floating point control registers, but no
  94. other floating point hardware.
  95. </p>
  96. </body>
  97. </html>