You cannot 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.5 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1988-2019 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "Free Software" and "Free Software Needs
Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
and with the Back-Cover Texts as in (a) below.
(a) The FSF's Back-Cover Text is: "You are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 6.4, http://www.gnu.org/software/texinfo/ -->
<head>
<title>RISC-V Features (Debugging with GDB)</title>
<meta name="description" content="RISC-V Features (Debugging with GDB)">
<meta name="keywords" content="RISC-V Features (Debugging with GDB)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Standard-Target-Features.html#Standard-Target-Features" rel="up" title="Standard Target Features">
<link href="S_002f390-and-System-z-Features.html#S_002f390-and-System-z-Features" rel="next" title="S/390 and System z Features">
<link href="PowerPC-Features.html#PowerPC-Features" rel="prev" title="PowerPC Features">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="RISC_002dV-Features"></a>
<div class="header">
<p>
Next: <a href="S_002f390-and-System-z-Features.html#S_002f390-and-System-z-Features" accesskey="n" rel="next">S/390 and System z 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>
</div>
<hr>
<a name="RISC_002dV-Features-1"></a>
<h4 class="subsection">G.5.12 RISC-V Features</h4>
<a name="index-target-descriptions_002c-RISC_002dV-Features"></a>
<p>The &lsquo;<samp>org.gnu.gdb.riscv.cpu</samp>&rsquo; feature is required for RISC-V
targets. It should contain the registers &lsquo;<samp>x0</samp>&rsquo; through
&lsquo;<samp>x31</samp>&rsquo;, and &lsquo;<samp>pc</samp>&rsquo;. Either the architectural names (&lsquo;<samp>x0</samp>&rsquo;,
&lsquo;<samp>x1</samp>&rsquo;, etc) can be used, or the ABI names (&lsquo;<samp>zero</samp>&rsquo;, &lsquo;<samp>ra</samp>&rsquo;,
etc).
</p>
<p>The &lsquo;<samp>org.gnu.gdb.riscv.fpu</samp>&rsquo; feature is optional. If present, it
should contain registers &lsquo;<samp>f0</samp>&rsquo; through &lsquo;<samp>f31</samp>&rsquo;, &lsquo;<samp>fflags</samp>&rsquo;,
&lsquo;<samp>frm</samp>&rsquo;, and &lsquo;<samp>fcsr</samp>&rsquo;. As with the cpu feature, either the
architectural register names, or the ABI names can be used.
</p>
<p>The &lsquo;<samp>org.gnu.gdb.riscv.virtual</samp>&rsquo; feature is optional. If present,
it should contain registers that are not backed by real registers on
the target, but are instead virtual, where the register value is
derived from other target state. In many ways these are like
<small>GDB</small>s pseudo-registers, except implemented by the target.
Currently the only register expected in this set is the one byte
&lsquo;<samp>priv</samp>&rsquo; register that contains the target&rsquo;s privilege level in the
least significant two bits.
</p>
<p>The &lsquo;<samp>org.gnu.gdb.riscv.csr</samp>&rsquo; feature is optional. If present, it
should contain all of the target&rsquo;s standard CSRs. Standard CSRs are
those defined in the RISC-V specification documents. There is some
overlap between this feature and the fpu feature; the &lsquo;<samp>fflags</samp>&rsquo;,
&lsquo;<samp>frm</samp>&rsquo;, and &lsquo;<samp>fcsr</samp>&rsquo; registers could be in either feature. The
expectation is that these registers will be in the fpu feature if the
target has floating point hardware, but can be moved into the csr
feature if the target has the floating point control registers, but no
other floating point hardware.
</p>
</body>
</html>