[[risc-v-isa]]
= The RISC-V Instruction Set Manual
:description: Volume I: Unprivileged ISA
:company: RISC-V.org
//:authors: Editors: Andrew waterman, Krste Asanovic, SiFive, Inc., CS Division, EECS Department, University of California, Berkeley
:revdate: 12/2022
:revnumber: ASCIIDOC Conversion
:revremark: Pre-release version
//development: assume everything can change
//stable: assume everything could change
//frozen: of you implement this version you assume the risk that something might change because of the public review cycle  but we expect little to no change.
//ratified: you can implement this and be assured nothing will change. if something needs to change due to an errata or enhancement, it will come out in a new extension. we do not revise extensions.
:url-riscv: http://riscv.org
:doctype: book
//:doctype: report
:colophon:
:pdf-theme: ../src/resources/themes/riscv-spec.yml
:pdf-fontsdir: ../src/resources/fonts/
:preface-title: Preamble
:appendix-caption: Appendix
:imagesdir: images
:title-logo-image: image:risc-v_logo.png[pdfwidth=3.25in,align=center]
:page-background-image: image:draft.png[opacity=20%]
//:title-page-background-image: none
:back-cover-image: image:backpage.png[opacity=25%]
// Settings:
:experimental:
:reproducible:
:imagesoutdir: images
:bibtex-file: ../src/resources/riscv-spec.bib
:bibtex-order: alphabetical
:bibtex-style: apa
:bibtex-format: asciidoc
:bibtex-throw: false
:icons: font
:lang: en
:listing-caption: Example
:sectnums:
:toc: left
:toclevels: 4
:source-highlighter: pygments
ifdef::backend-pdf[]
:source-highlighter: rouge
endif::[]
:table-caption: Table
:figure-caption: Figure
:xrefstyle: short 
:chapter-refsig: Chapter
:section-refsig: Section
:appendix-refsig: Appendix
:data-uri:
:hide-uri-scheme:
:stem: latexmath
:footnote:

_Contributors to all versions of the spec in alphabetical order (please contact editors to suggest
corrections): Arvind, Krste Asanović;, Rimas Avižienis, Jacob Bachmeyer, Christopher F. Batten,
Allen J. Baum, Alex Bradbury, Scott Beamer, Preston Briggs, Christopher Celio, Chuanhua
Chang, David Chisnall, Paul Clayton, Palmer Dabbelt, Ken Dockser, Roger Espasa, Greg Favor,
Shaked Flur, Stefan Freudenberger, Marc Gauthier, Andy Glew, Jan Gray, Michael Hamburg, John
Hauser, David Horner, Bruce Hoult, Bill Huffman, Alexandre Joannou, Olof Johansson, Ben Keller,
David Kruckemyer, Yunsup Lee, Paul Loewenstein, Daniel Lustig, Yatin Manerkar, Luc Maranget,
Margaret Martonosi, Joseph Myers, Vijayanand Nagarajan, Rishiyur Nikhil, Jonas Oberhauser,
Stefan O'Rear, Albert Ou, John Ousterhout, David Patterson, Christopher Pulte, Jose Renau,
Josh Scheid, Colin Schmidt, Peter Sewell, Susmit Sarkar, Michael Taylor, Wesley Terpstra, Matt
Thomas, Tommy Thorn, Caroline Trippel, Ray VanDeWalker, Muralidaran Vijayaraghavan, Megan
Wachs, Andrew Waterman, Robert Watson, Derek Williams, Andrew Wright, Reinoud Zandijk,
and Sizhuo Zhang._

_This document is released under a Creative Commons Attribution 4.0 International License._

_This document is a derivative of “The RISC-V Instruction Set Manual, Volume I: User-Level ISA
Version 2.1” released under the following license: ©2010-2017 Andrew Waterman, Yunsup Lee,
David Patterson, Krste Asanović. Creative Commons Attribution 4.0 International License.
Please cite as: “The RISC-V Instruction Set Manual, Volume I: User-Level ISA, Document
Version 20191214-draft”, Editors Andrew Waterman and Krste Asanović, RISC-V Foundation,
December 2019._

//the colophon allows for a section after the preamble that is part of the frontmatter and therefore not assigned a page number.
include::colophon.adoc[]
//preface.tex
include::intro.adoc[]
//intro.tex
include::rv32.adoc[]
//rv32.tex
include::zifencei.adoc[]
//zfencei.tex
include::zihintntl.adoc[]
//zihintntl.tex
include::zihintpause.adoc[]
//zihintpause.tex
include::rv32e.adoc[]
//rv32e.tex
include::rv64.adoc[]
//rv54.tex
include::rv128.adoc[]
//rv128.tex
include::m-st-ext.adoc[]
//m.tex
include::a-st-ext.adoc[]
//a.tex
include::zicsr.adoc[]
//csr.tex
include::counters.adoc[]
//counters.tex
include::f-st-ext.adoc[]
//f.tex t
include::d-st-ext.adoc[]
//d.tex
include::q-st-ext.adoc[]
//q.tex
include::zfh.adoc[]
//zfh.tex
include::rvwmo.adoc[]
//rvwmo.tex
include::c-st-ext.adoc[]
//c.tex
include::b-st-ext.adoc[]
//b.tex
include::j-st-ext.adoc[]
//j.tex
include::p-st-ext.adoc[]
//p.tex
include::v-st-ext.adoc[]
//v.tex
include::zam-st-ext.adoc[]
//zam.tex
include::zfinx.adoc[]
//zfinx.tex
include::zfa.adoc[]
//zfa.tex
include::ztso-st-ext.adoc[]
//ztso.tex
include::rv-32-64g.adoc[]
//gmaps.tex
include::extending.adoc[]
//extensions.tex
include::naming.adoc[]
//naming.tex
include::history.adoc[]
//history.tex
include::mm-eplan.adoc[]
//memory.tex
include::mm-formal.adoc[]
//end of memory.tex, memory-model-alloy.tex, memory-model-herd.tex
include::index.adoc[]
// this is generated generated from index markers.
include::bibliography.adoc[]
// this references the riscv-spec.bi file that has been copied into the resources directoy