retirement: Disable side effects on exception (proposed corrections) (#…

…512) Co-authored-by: Arusekk <[email protected]>
kuznia-rdzeni · Nov 18, 2023 · 58eaab4 · 58eaab4
1 parent 1b05ea0
commit 58eaab4
Show file tree

Hide file tree

Showing 42 changed files with 310 additions and 278 deletions.
diff --git a/.doctrees/Current_graph.doctree b/.doctrees/Current_graph.doctree
diff --git a/.doctrees/api.doctree b/.doctrees/api.doctree
diff --git a/.doctrees/auto_graph.doctree b/.doctrees/auto_graph.doctree
diff --git a/.doctrees/coreblocks.params.doctree b/.doctrees/coreblocks.params.doctree
diff --git a/.doctrees/coreblocks.stages.doctree b/.doctrees/coreblocks.stages.doctree
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
diff --git a/Assumptions.html b/Assumptions.html
@@ -104,7 +104,7 @@ <h1>List of assumptions made during development<a class="headerlink" href="#list
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/Current_graph.html b/Current_graph.html
diff --git a/Development_environment.html b/Development_environment.html
@@ -178,7 +178,7 @@ <h3>build_docs.sh<a class="headerlink" href="#build-docs-sh" title="Permalink to
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/Home.html b/Home.html
@@ -129,7 +129,7 @@ <h2>Documentation<a class="headerlink" href="#documentation" title="Permalink to
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/Problem-checklist.html b/Problem-checklist.html
@@ -105,7 +105,7 @@ <h1>Problem checklist<a class="headerlink" href="#problem-checklist" title="Perm
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/Transactions.html b/Transactions.html
@@ -409,7 +409,7 @@ <h3>Transaction and method nesting<a class="headerlink" href="#transaction-and-m
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/_sources/auto_graph.rst.txt b/_sources/auto_graph.rst.txt
diff --git a/api.html b/api.html
@@ -240,7 +240,7 @@ <h2>transactron<a class="headerlink" href="#transactron" title="Permalink to thi
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/auto_graph.html b/auto_graph.html
diff --git a/components/icache.html b/components/icache.html
@@ -131,7 +131,7 @@ <h2>Address mapping example<a class="headerlink" href="#address-mapping-example"
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.frontend.html b/coreblocks.frontend.html
@@ -399,7 +399,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.fu.html b/coreblocks.fu.html
@@ -898,7 +898,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.fu.unsigned_multiplication.html b/coreblocks.fu.unsigned_multiplication.html
@@ -237,7 +237,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.html b/coreblocks.html
@@ -215,7 +215,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.params.html b/coreblocks.params.html
@@ -2230,6 +2230,12 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 <dd><p>Value of second source operand.</p>
 </dd></dl>
 
+<dl class="py attribute">
+<dt class="sig sig-object py" id="coreblocks.params.layouts.CommonLayoutFields.side_fx">
+<span class="sig-name descname"><span class="pre">side_fx</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">LayoutListField</span></em><a class="headerlink" href="#coreblocks.params.layouts.CommonLayoutFields.side_fx" title="Permalink to this definition"></a></dt>
+<dd><p>Side effects are enabled.</p>
+</dd></dl>
+
 </dd></dl>
 
 <dl class="py class">
@@ -2669,7 +2675,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.peripherals.html b/coreblocks.peripherals.html
@@ -348,7 +348,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.scheduler.html b/coreblocks.scheduler.html
@@ -191,7 +191,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.stages.html b/coreblocks.stages.html
@@ -161,7 +161,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 <dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">Elaboratable</span></code></p>
 <dl class="py method">
 <dt class="sig sig-object py" id="coreblocks.stages.retirement.Retirement.__init__">
-<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">gen_params</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="coreblocks.params.html#coreblocks.params.genparams.GenParams" title="coreblocks.params.genparams.GenParams"><span class="pre">GenParams</span></a></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rob_peek</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">rob_retire</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">r_rat_commit</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">free_rf_put</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">rf_free</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">precommit</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">exception_cause_get</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em><span class="sig-paren">)</span><a class="headerlink" href="#coreblocks.stages.retirement.Retirement.__init__" title="Permalink to this definition"></a></dt>
+<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">gen_params</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="coreblocks.params.html#coreblocks.params.genparams.GenParams" title="coreblocks.params.genparams.GenParams"><span class="pre">GenParams</span></a></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">rob_peek</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">rob_retire</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">r_rat_commit</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">free_rf_put</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">rf_free</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">precommit</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">exception_cause_get</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">frat_rename</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="transactron.html#transactron.core.Method" title="transactron.core.Method"><span class="pre">Method</span></a></span></em><span class="sig-paren">)</span><a class="headerlink" href="#coreblocks.stages.retirement.Retirement.__init__" title="Permalink to this definition"></a></dt>
 <dd></dd></dl>
 
 </dd></dl>
@@ -263,7 +263,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.structs_common.html b/coreblocks.structs_common.html
@@ -454,7 +454,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/coreblocks.utils.html b/coreblocks.utils.html
@@ -165,7 +165,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/genindex.html b/genindex.html
@@ -2333,6 +2333,8 @@ <h2 id="S">S</h2>
       <li><a href="coreblocks.fu.unsigned_multiplication.html#coreblocks.fu.unsigned_multiplication.shift.ShiftUnsignedMul">ShiftUnsignedMul (class in coreblocks.fu.unsigned_multiplication.shift)</a>
 </li>
       <li><a href="coreblocks.structs_common.html#coreblocks.structs_common.exception.should_update_prioriy">should_update_prioriy() (in module coreblocks.structs_common.exception)</a>
+</li>
+      <li><a href="coreblocks.params.html#coreblocks.params.layouts.CommonLayoutFields.side_fx">side_fx (coreblocks.params.layouts.CommonLayoutFields attribute)</a>
 </li>
       <li><a href="transactron.utils.html#transactron.utils.utils.silence_mustuse">silence_mustuse() (in module transactron.utils.utils)</a>
 </li>
@@ -2873,7 +2875,7 @@ <h2 id="Z">Z</h2>
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/index.html b/index.html
@@ -221,7 +221,7 @@ <h1>Coreblocks<a class="headerlink" href="#coreblocks" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/miscellany/exceptionsSummary.html b/miscellany/exceptionsSummary.html
@@ -271,7 +271,7 @@ <h2>Summary<a class="headerlink" href="#summary" title="Permalink to this headin
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/modules-coreblocks.html b/modules-coreblocks.html
@@ -184,7 +184,7 @@ <h1>coreblocks<a class="headerlink" href="#coreblocks" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/modules-transactron.html b/modules-transactron.html
@@ -126,7 +126,7 @@ <h1>transactron<a class="headerlink" href="#transactron" title="Permalink to thi
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/objects.inv b/objects.inv
diff --git a/py-modindex.html b/py-modindex.html
@@ -458,7 +458,7 @@ <h1>Python Module Index</h1>
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/scheduler/Overview.html b/scheduler/Overview.html
@@ -146,7 +146,7 @@ <h2>More detailed description of each block<a class="headerlink" href="#more-det
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/search.html b/search.html
@@ -101,7 +101,7 @@
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/searchindex.js b/searchindex.js
diff --git a/shared_structs/Implementation/RS_impl.html b/shared_structs/Implementation/RS_impl.html
@@ -252,7 +252,7 @@ <h3>Read and clean row<a class="headerlink" href="#read-and-clean-row" title="Pe
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/shared_structs/RS.html b/shared_structs/RS.html
@@ -222,7 +222,7 @@ <h2>External interface signals<a class="headerlink" href="#external-interface-si
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/synthesis/Synthesis.html b/synthesis/Synthesis.html
@@ -151,7 +151,7 @@ <h2>Benchmarks<a class="headerlink" href="#benchmarks" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/transactron.html b/transactron.html
@@ -1329,7 +1329,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/transactron.lib.html b/transactron.lib.html
@@ -897,7 +897,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>
 

diff --git a/transactron.utils.html b/transactron.utils.html
@@ -420,7 +420,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2023.
-      <span class="lastupdated">Last updated on 09:27 2023-11-17.
+      <span class="lastupdated">Last updated on 16:29 2023-11-18.
       </span></p>
   </div>