collab/polyglot-riscv-arm

what if the same machine code was valid riscv and arm asm

git clone https://git.julia.blue/collab/polyglot-riscv-arm

Jonathan Dönszelmannwebsite start885cc4e

main
29.0 KiB221 linesraw
1<?xml version="1.0" encoding="utf-8"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml"><head><link rel="stylesheet" type="text/css" href="insn.css"/><meta name="generator" content="iform.xsl"/><title>SUB, SUBS (immediate) -- AArch32</title></head><body><table style="margin: 0 auto;"><tr><td><div class="topbar"><a href="index.html">Base Instructions</a></div></td><td><div class="topbar"><a href="fpsimdindex.html">SIMD&amp;FP Instructions</a></div></td><td><div class="topbar"><a href="a32_encindex.html">A32 Instructions by Encoding</a></div></td><td><div class="topbar"><a href="t32_encindex.html">T32 Instructions by Encoding</a></div></td><td><div class="topbar"><a href="shared_pseudocode.html">Shared Pseudocode</a></div></td><td><div class="topbar"><a href="notice.html">Proprietary Notice</a></div></td></tr></table><hr/><h2 class="instruction-section">SUB, SUBS (immediate)</h2>
4      <p class="aml">Subtract (immediate) subtracts an immediate value from a register value, and writes the result to the destination register.</p>
5      <p class="aml">If the destination register is not the PC, the SUBS variant of the instruction updates the condition flags based on the result.</p>
6      <p class="aml">The field descriptions for &lt;Rd&gt; identify the encodings where the PC is permitted as the destination register. If the destination register is the PC:</p>
7      <ul>
8        <li>The SUB variant of the instruction is an interworking branch, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="BEICJFEH">Pseudocode description of operations on the AArch32 general-purpose registers and the PC</a>.</li>
9        <li>The SUBS variant of the instruction performs an exception return without the use of the stack. In this case:<ul><li>The PE branches to the address written to the PC, and restores <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="BEIDIGBH">PSTATE</a> from SPSR_&lt;current_mode&gt;.</li><li>The PE checks SPSR_&lt;current_mode&gt; for an illegal return event. See <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="CHDDDJDB">Illegal return events from AArch32 state</a>.</li><li>The instruction is <span class="arm-defined-word">undefined</span> in Hyp mode, except for encoding T5 with &lt;imm8&gt; set to zero, which is the encoding for the <span class="asm-code">ERET</span> instruction, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="A32T32-base.instructions.ERET">ERET</a>.</li><li>The instruction is <span class="arm-defined-word">constrained unpredictable</span> in User mode and System mode.</li></ul></li>
10      </ul>
11    
12    <p class="desc">
13      It has encodings from the following instruction sets:
14       A32 (
15      <a href="#iclass_a1">A1</a>
16      )
17       and 
18       T32 (
19      <a href="#iclass_t1">T1</a>
20      , 
21      <a href="#iclass_t2">T2</a>
22      , 
23      <a href="#iclass_t3">T3</a>
24      , 
25      <a href="#iclass_t4">T4</a>
26       and 
27      <a href="#iclass_t5">T5</a>
28      )
29      .
30    </p>
31    <h3 class="classheading"><a id="iclass_a1"/>A1</h3><p class="desc"/><div class="regdiagram-32"><table class="regdiagram"><thead><tr><td>31</td><td>30</td><td>29</td><td>28</td><td>27</td><td>26</td><td>25</td><td>24</td><td>23</td><td>22</td><td>21</td><td>20</td><td>19</td><td>18</td><td>17</td><td>16</td><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td></tr></thead><tbody><tr class="firstrow"><td colspan="4" class="lr">!= 1111</td><td class="l">0</td><td>0</td><td>1</td><td class="r">0</td><td class="l">0</td><td>1</td><td class="r">0</td><td class="lr">S</td><td colspan="4" class="lr">Rn</td><td colspan="4" class="lr">Rd</td><td colspan="12" class="lr">imm12</td></tr><tr class="secondrow"><td colspan="4" class="droppedname">cond</td><td colspan="4"/><td colspan="3"/><td/><td colspan="4"/><td colspan="4"/><td colspan="12"/></tr></tbody></table></div><div class="encoding"><h4 class="encoding">SUB<span class="bitdiff"> (S == 0 &amp;&amp; Rn != 11x1)</span></h4><a id="SUB_i_A1"/><p class="asm-code">SUB{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rd_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const_1" title="An immediate value">&lt;const&gt;</a></p></div><div class="encoding"><h4 class="encoding">SUBS<span class="bitdiff"> (S == 1 &amp;&amp; Rn != 1101)</span></h4><a id="SUBS_i_A1"/><p class="asm-code">SUBS{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rd_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const_1" title="An immediate value">&lt;const&gt;</a></p></div><p class="pseudocode">if Rn == '1111' &amp;&amp; S == '0' then SEE "ADR";
32if Rn == '1101' then SEE "SUB (SP minus immediate)";
33constant d = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rd);  constant n = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rn);  constant setflags = (S == '1');
34constant imm32 = <a href="shared_pseudocode.html#impl-aarch32.A32ExpandImm.1" title="function: bits(32) A32ExpandImm(bits(12) imm12)">A32ExpandImm</a>(imm12);</p>
35    <h3 class="classheading"><a id="iclass_t1"/>T1</h3><div class="regdiagram-16"><table class="regdiagram"><thead><tr><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td></tr></thead><tbody><tr class="firstrow"><td class="l">0</td><td>0</td><td>0</td><td>1</td><td>1</td><td class="r">1</td><td class="lr">1</td><td colspan="3" class="lr">imm3</td><td colspan="3" class="lr">Rn</td><td colspan="3" class="lr">Rd</td></tr></tbody></table></div><div class="encoding"><h4 class="encoding">T1</h4><a id="SUB_i_T1"/><p class="asm-code">SUB<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rn" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm3" title="3-bit unsigned immediate [0-7] (field &quot;imm3&quot;)">&lt;imm3&gt;</a>
36        //
37      
38        (Inside IT block)
39      </p><p class="asm-code">SUBS{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rn" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm3" title="3-bit unsigned immediate [0-7] (field &quot;imm3&quot;)">&lt;imm3&gt;</a>
40        //
41      
42        (Outside IT block)
43      </p></div><p class="pseudocode">constant d = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rd);  constant n = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rn);  constant setflags = !<a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>();
44constant imm32 = <a href="shared_pseudocode.html#impl-shared.ZeroExtend.2" title="function: bits(N) ZeroExtend(bits(M) x, integer N)">ZeroExtend</a>(imm3, 32);</p>
45    <h3 class="classheading"><a id="iclass_t2"/>T2</h3><div class="regdiagram-16"><table class="regdiagram"><thead><tr><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td></tr></thead><tbody><tr class="firstrow"><td class="l">0</td><td>0</td><td class="r">1</td><td class="l">1</td><td class="r">1</td><td colspan="3" class="lr">Rdn</td><td colspan="8" class="lr">imm8</td></tr></tbody></table></div><div class="encoding"><h4 class="encoding">T2</h4><a id="SUB_i_T2"/><p class="asm-code">SUB<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
46        //
47      
48        (Inside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; can be represented in T1)
49      </p><p class="asm-code">SUB<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>,} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
50        //
51      
52        (Inside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; cannot be represented in T1)
53      </p><p class="asm-code">SUBS{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
54        //
55      
56        (Outside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; can be represented in T1)
57      </p><p class="asm-code">SUBS{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>,} <a href="#sa_rdn" title="General-purpose source and destination register (field &quot;Rdn&quot;)">&lt;Rdn&gt;</a>, #<a href="#sa_imm8" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a>
58        //
59      
60        (Outside IT block, and &lt;Rdn&gt;, &lt;imm8&gt; cannot be represented in T1)
61      </p></div><p class="pseudocode">constant d = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rdn);  constant n = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rdn);  constant setflags = !<a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>();
62constant imm32 = <a href="shared_pseudocode.html#impl-shared.ZeroExtend.2" title="function: bits(N) ZeroExtend(bits(M) x, integer N)">ZeroExtend</a>(imm8, 32);</p>
63    <h3 class="classheading"><a id="iclass_t3"/>T3</h3><p class="desc"/><div class="regdiagram-16x2"><table class="regdiagram"><thead><tr><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td></tr></thead><tbody><tr class="firstrow"><td class="l">1</td><td>1</td><td>1</td><td>1</td><td class="r">0</td><td class="lr">i</td><td class="lr">0</td><td class="l">1</td><td>1</td><td>0</td><td class="r">1</td><td class="lr">S</td><td colspan="4" class="lr">!= 1101</td><td class="lr">0</td><td colspan="3" class="lr">imm3</td><td colspan="4" class="lr">Rd</td><td colspan="8" class="lr">imm8</td></tr><tr class="secondrow"><td colspan="5"/><td/><td/><td colspan="4"/><td/><td colspan="4" class="droppedname">Rn</td><td/><td colspan="3"/><td colspan="4"/><td colspan="8"/></tr></tbody></table></div><div class="encoding"><h4 class="encoding">SUB<span class="bitdiff"> (S == 0)</span></h4><a id="SUB_i_T3"/><p class="asm-code">SUB<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>.W {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a>
64        //
65      
66        (Inside IT block, and &lt;Rd&gt;, &lt;Rn&gt;, &lt;const&gt; can be represented in T1 or T2)
67      </p><p class="asm-code">SUB{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a></p></div><div class="encoding"><h4 class="encoding">SUBS<span class="bitdiff"> (S == 1 &amp;&amp; Rd != 1111)</span></h4><a id="SUBS_i_T3"/><p class="asm-code">SUBS.W {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a>
68        //
69      
70        (Outside IT block, and &lt;Rd&gt;, &lt;Rn&gt;, &lt;const&gt; can be represented in T1 or T2)
71      </p><p class="asm-code">SUBS{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_1" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_const" title="An immediate value">&lt;const&gt;</a></p></div><p class="pseudocode">if Rd == '1111' &amp;&amp; S == '1' then SEE "CMP (immediate)";
72if Rn == '1101' then SEE "SUB (SP minus immediate)";
73constant d = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rd);  constant n = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rn);  constant setflags = (S == '1');
74constant imm32 = <a href="shared_pseudocode.html#impl-aarch32.T32ExpandImm.1" title="function: bits(32) T32ExpandImm(bits(12) imm12)">T32ExpandImm</a>(i:imm3:imm8);
75// Armv8-A removes UNPREDICTABLE for R13
76if (d == 15 &amp;&amp; !setflags) || n == 15 then UNPREDICTABLE;</p>
77    <h3 class="classheading"><a id="iclass_t4"/>T4</h3><div class="regdiagram-16x2"><table class="regdiagram"><thead><tr><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td></tr></thead><tbody><tr class="firstrow"><td class="l">1</td><td>1</td><td>1</td><td>1</td><td class="r">0</td><td class="lr">i</td><td class="l">1</td><td class="r">0</td><td class="lr">1</td><td class="lr">0</td><td class="lr">1</td><td class="lr">0</td><td colspan="4" class="lr">!= 11x1</td><td class="lr">0</td><td colspan="3" class="lr">imm3</td><td colspan="4" class="lr">Rd</td><td colspan="8" class="lr">imm8</td></tr><tr class="secondrow"><td colspan="5"/><td/><td colspan="2"/><td/><td/><td/><td/><td colspan="4" class="droppedname">Rn</td><td/><td colspan="3"/><td colspan="4"/><td colspan="8"/></tr></tbody></table></div><div class="encoding"><h4 class="encoding">T4</h4><a id="SUB_i_T4"/><p class="asm-code">SUB{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm12" title="12-bit unsigned immediate [0-4095] (field &quot;i:imm3:imm8&quot;)">&lt;imm12&gt;</a>
78        //
79      
80        (&lt;imm12&gt; cannot be represented in T1, T2, or T3)
81      </p><p class="asm-code">SUBW{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} {<a href="#sa_rd" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>,} <a href="#sa_rn_2" title="General-purpose source register (field &quot;Rn&quot;)">&lt;Rn&gt;</a>, #<a href="#sa_imm12" title="12-bit unsigned immediate [0-4095] (field &quot;i:imm3:imm8&quot;)">&lt;imm12&gt;</a>
82        //
83      
84        (&lt;imm12&gt; can be represented in T1, T2, or T3)
85      </p></div><p class="pseudocode">if Rn == '1111' then SEE "ADR";
86if Rn == '1101' then SEE "SUB (SP minus immediate)";
87constant d = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rd);  constant n = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rn);  constant setflags = FALSE;
88constant imm32 = <a href="shared_pseudocode.html#impl-shared.ZeroExtend.2" title="function: bits(N) ZeroExtend(bits(M) x, integer N)">ZeroExtend</a>(i:imm3:imm8, 32);
89// Armv8-A removes UNPREDICTABLE for R13
90if d == 15 then UNPREDICTABLE;</p>
91    <h3 class="classheading"><a id="iclass_t5"/>T5</h3><div class="regdiagram-16x2"><table class="regdiagram"><thead><tr><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td><td>15</td><td>14</td><td>13</td><td>12</td><td>11</td><td>10</td><td>9</td><td>8</td><td>7</td><td>6</td><td>5</td><td>4</td><td>3</td><td>2</td><td>1</td><td>0</td></tr></thead><tbody><tr class="firstrow"><td class="l">1</td><td>1</td><td>1</td><td>1</td><td>0</td><td>0</td><td>1</td><td>1</td><td>1</td><td>1</td><td>0</td><td class="r">1</td><td colspan="4" class="lr">Rn</td><td class="l">1</td><td class="r">0</td><td class="lr">(0)</td><td class="lr">0</td><td class="lr">(1)</td><td class="lr">(1)</td><td class="lr">(1)</td><td class="lr">(1)</td><td colspan="8" class="lr">imm8</td></tr></tbody></table></div><div class="encoding"><h4 class="encoding">T5<span class="bitdiff"> (!(Rn == 1110 &amp;&amp; imm8 == 00000000))</span></h4><a id="SUBS_PC_T5_AS"/><p class="asm-code">SUBS{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}{<a href="#sa_q" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;q&gt;</a>} PC, LR, #<a href="#sa_imm8_1" title="8-bit unsigned immediate [0-255] (field &quot;imm8&quot;)">&lt;imm8&gt;</a></p></div><p class="pseudocode">if Rn == '1110' &amp;&amp; <a href="shared_pseudocode.html#impl-shared.IsZero.1" title="function: boolean IsZero(bits(N) x)">IsZero</a>(imm8) then SEE "ERET";
92constant d = 15;  constant n = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rn);  constant setflags = TRUE;
93constant imm32 = <a href="shared_pseudocode.html#impl-shared.ZeroExtend.2" title="function: bits(N) ZeroExtend(bits(M) x, integer N)">ZeroExtend</a>(imm8, 32);
94if n != 14 then UNPREDICTABLE;
95if <a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>() &amp;&amp; !<a href="shared_pseudocode.html#impl-aarch32.LastInITBlock.0" title="function: boolean LastInITBlock()">LastInITBlock</a>() then UNPREDICTABLE;</p>
96  <div class="encoding-notes">
97      <p class="aml">For more information about the <span class="arm-defined-word">constrained unpredictable</span> behavior of this instruction, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="CJAEGDJC">Architectural Constraints on UNPREDICTABLE behaviors</a>, and particularly <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="CEGCDCGA">SUBS PC. LR and related instructions (A32)</a> and <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="CEGDJHBD">SUBS PC, LR and related instructions (T32)</a>.</p>
98    </div><h3 class="explanations">Assembler Symbols</h3><div class="explanations"><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;c&gt;</td><td><a id="sa_c"/>
99        
100          <p class="aml">See <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="Babbefhf">Standard assembler syntax fields</a>.</p>
101        
102      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;q&gt;</td><td><a id="sa_q"/>
103        
104          <p class="aml">See <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="Babbefhf">Standard assembler syntax fields</a>.</p>
105        
106      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rdn&gt;</td><td><a id="sa_rdn"/>
107        
108          <p class="aml">Is the general-purpose source and destination register, encoded in the "Rdn" field.</p>
109        
110      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;imm8&gt;</td><td><a id="sa_imm8"/>
111        
112          
113          
114        
115        
116          <p class="aml">For encoding T2: is a 8-bit unsigned immediate, in the range 0 to 255, encoded in the "imm8" field.</p>
117        
118      </td></tr><tr><td/><td><a id="sa_imm8_1"/>
119        
120          
121          
122        
123        
124          <p class="aml">For encoding T5: is a 8-bit unsigned immediate, in the range 0 to 255, encoded in the "imm8" field. If &lt;Rn&gt; is the LR, and zero is used, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="A32T32-base.instructions.ERET">ERET</a>.</p>
125        
126      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rd&gt;</td><td><a id="sa_rd_1"/>
127        
128          
129          
130          
131        
132        
133          <p class="aml">For encoding A1: is the general-purpose destination register, encoded in the "Rd" field. If omitted, this register is the same as &lt;Rn&gt;. If the PC is used:</p>
134          <ul>
135            <li>For the SUB variant, the instruction is a branch to the address calculated by the operation. This is an interworking branch, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="BEICJFEH">Pseudocode description of operations on the AArch32 general-purpose registers and the PC</a>.</li>
136            <li>For the SUBS variant, the instruction performs an exception return, that restores <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="BEIDIGBH">PSTATE</a> from SPSR_&lt;current_mode&gt;. Arm deprecates use of this instruction unless &lt;Rn&gt; is the LR.</li>
137          </ul>
138        
139      </td></tr><tr><td/><td><a id="sa_rd"/>
140        
141          
142        
143        
144          <p class="aml">For encoding T1, T3 and T4: is the general-purpose destination register, encoded in the "Rd" field. If omitted, this register is the same as &lt;Rn&gt;.</p>
145        
146      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rn&gt;</td><td><a id="sa_rn_2"/>
147        
148          <p class="aml">For encoding A1 and T4: is the general-purpose source register, encoded in the "Rn" field. If the SP is used, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="A32T32-base.instructions.SUB_SP_i">SUB (SP minus immediate)</a>. If the PC is used, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="A32T32-base.instructions.ADR">ADR</a>.</p>
149        
150      </td></tr><tr><td/><td><a id="sa_rn"/>
151        
152          
153          
154          
155        
156        
157          <p class="aml">For encoding T1: is the general-purpose source register, encoded in the "Rn" field.</p>
158        
159      </td></tr><tr><td/><td><a id="sa_rn_1"/>
160        
161          
162          
163          
164        
165        
166          <p class="aml">For encoding T3: is the general-purpose source register, encoded in the "Rn" field. If the SP is used, see <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="A32T32-base.instructions.SUB_SP_i">SUB (SP minus immediate)</a>.</p>
167        
168      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;imm3&gt;</td><td><a id="sa_imm3"/>
169        
170          <p class="aml">Is a 3-bit unsigned immediate, in the range 0 to 7, encoded in the "imm3" field.</p>
171        
172      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;imm12&gt;</td><td><a id="sa_imm12"/>
173        
174          <p class="aml">Is a 12-bit unsigned immediate, in the range 0 to 4095, encoded in the "i:imm3:imm8" field.</p>
175        
176      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;const&gt;</td><td><a id="sa_const_1"/>
177        
178          
179          
180        
181        
182          <p class="aml">For encoding A1: an immediate value. See <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="BABHDAJF">Modified immediate constants in A32 instructions</a> for the range of values.</p>
183        
184      </td></tr><tr><td/><td><a id="sa_const"/>
185        
186          
187          
188        
189        
190          <p class="aml">For encoding T3: an immediate value. See <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="BABGHAGA">Modified immediate constants in T32 instructions</a> for the range of values.</p>
191        
192      </td></tr></table></div><div class="syntax-notes">
193      <p class="aml">In the T32 instruction set, MOVS{&lt;c&gt;}{&lt;q&gt;} PC, LR is a pseudo-instruction for SUBS{&lt;c&gt;}{&lt;q&gt;} PC, LR, #0.</p>
194    </div>
195    <div class="ps"><a id="execute"/><h3 class="pseudocode">Operation</h3>
196      <p class="pseudocode">if <a href="shared_pseudocode.html#impl-aarch32.ConditionPassed.0" title="function: boolean ConditionPassed()">ConditionPassed</a>() then
197    EncodingSpecificOperations();
198    constant (result, nzcv) = <a href="shared_pseudocode.html#impl-shared.AddWithCarry.3" title="function: (bits(N), bits(4)) AddWithCarry(bits(N) x, bits(N) y, bit carry_in)">AddWithCarry</a>(<a href="shared_pseudocode.html#impl-aarch32.R.read.1" title="accessor: bits(32) R[integer n]">R</a>[n], NOT(imm32), '1');
199    if d == 15 then
200        if setflags then
201            <a href="shared_pseudocode.html#impl-aarch32.ALUExceptionReturn.1" title="function: ALUExceptionReturn(bits(32) address)">ALUExceptionReturn</a>(result);
202        else
203            <a href="shared_pseudocode.html#impl-aarch32.ALUWritePC.1" title="function: ALUWritePC(bits(32) address)">ALUWritePC</a>(result);
204    else
205        <a href="shared_pseudocode.html#impl-aarch32.R.write.1" title="accessor: R[integer n] = bits(32) value">R</a>[d] = result;
206        if setflags then
207            PSTATE.&lt;N,Z,C,V&gt; = nzcv;</p>
208    </div>
209  <h3>Operational information</h3>
210    <p class="aml">If CPSR.DIT is 1 and this instruction does not use R15 as either its source or destination:</p>
211    <ul>
212      <li>The execution time of this instruction is independent of:<ul><li>The values of the data supplied in any of its registers.</li><li>The values of the NZCV flags.</li></ul></li>
213      <li>The response of this instruction to asynchronous exceptions does not vary based on:<ul><li>The values of the data supplied in any of its registers.</li><li>The values of the NZCV flags.</li></ul></li>
214    </ul>
215  <hr/><table style="margin: 0 auto;"><tr><td><div class="topbar"><a href="index.html">Base Instructions</a></div></td><td><div class="topbar"><a href="fpsimdindex.html">SIMD&amp;FP Instructions</a></div></td><td><div class="topbar"><a href="a32_encindex.html">A32 Instructions by Encoding</a></div></td><td><div class="topbar"><a href="t32_encindex.html">T32 Instructions by Encoding</a></div></td><td><div class="topbar"><a href="shared_pseudocode.html">Shared Pseudocode</a></div></td><td><div class="topbar"><a href="notice.html">Proprietary Notice</a></div></td></tr></table><p class="versions">
216      Internal version only: isa v01_31, pseudocode v2024-09_rel
217      ; Build timestamp: 2024-09-26T13:26
218    </p><p class="copyconf">
219      Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved.
220      This document is Non-Confidential.
221    </p></body></html>