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
35.7 KiB234 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>MOV, MOVS (register) -- 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">MOV, MOVS (register)</h2>
4      <p class="aml">Move (register) copies a value from a register to the destination register.</p>
5      <p class="aml">If the destination register is not the PC, the MOVS 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 MOV variant of the instruction is a branch. In the T32 instruction set (encoding T1) this is a simple branch, and in the A32 instruction set it 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 MOVS 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.</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    <p class="desc">This instruction is used by the aliases <a href="asrs_mov_r.html" title="Arithmetic Shift Right">ASRS (immediate)</a>, <a href="asr_mov_r.html" title="Arithmetic Shift Right (immediate)">ASR (immediate)</a>, <a href="lsls_mov_r.html" title="Logical Shift Left">LSLS (immediate)</a>, <a href="lsl_mov_r.html" title="Logical Shift Left (immediate)">LSL (immediate)</a>, <a href="lsrs_mov_r.html" title="Logical Shift Right">LSRS (immediate)</a>, <a href="lsr_mov_r.html" title="Logical Shift Right (immediate)">LSR (immediate)</a>, <a href="rors_mov_r.html" title="Rotate Right">RORS (immediate)</a>, <a href="ror_mov_r.html" title="Rotate Right (immediate)">ROR (immediate)</a>, <a href="rrxs_mov_r.html" title="Rotate Right with Extend">RRXS</a>, and <a href="rrx_mov_r.html" title="Rotate Right with Extend">RRX</a>.</p>
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       and 
23      <a href="#iclass_t3">T3</a>
24      )
25      .
26    </p>
27    <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>0</td><td>1</td><td class="r">1</td><td class="l">0</td><td class="r">1</td><td class="lr">S</td><td class="l">(0)</td><td>(0)</td><td>(0)</td><td class="r">(0)</td><td colspan="4" class="lr">Rd</td><td colspan="5" class="lr">imm5</td><td colspan="2" class="lr">stype</td><td class="lr">0</td><td colspan="4" class="lr">Rm</td></tr><tr class="secondrow"><td colspan="4" class="droppedname">cond</td><td colspan="5"/><td colspan="2"/><td/><td colspan="4"/><td colspan="4"/><td colspan="5"/><td colspan="2"/><td/><td colspan="4"/></tr></tbody></table></div><div class="encoding"><h4 class="encoding">MOV, rotate right with extend<span class="bitdiff"> (S == 0 &amp;&amp; imm5 == 00000 &amp;&amp; stype == 11)</span></h4><a id="MOV_r_A1_RRX"/><p class="asm-code">MOV{<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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">MOV, shift or rotate by value<span class="bitdiff"> (S == 0 &amp;&amp; !(imm5 == 00000 &amp;&amp; stype == 11))</span></h4><a id="MOV_r_A1"/><p class="asm-code">MOV{<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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift_1" title="Type of shift applied to source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_2" title="Shift amount [0-31 (when &lt;shift&gt; = LSL)] (field &quot;imm5&quot;)">&lt;amount&gt;</a>}</p></div><div class="encoding"><h4 class="encoding">MOVS, rotate right with extend<span class="bitdiff"> (S == 1 &amp;&amp; imm5 == 00000 &amp;&amp; stype == 11)</span></h4><a id="MOVS_r_A1_RRX"/><p class="asm-code">MOVS{<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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">MOVS, shift or rotate by value<span class="bitdiff"> (S == 1 &amp;&amp; !(imm5 == 00000 &amp;&amp; stype == 11))</span></h4><a id="MOVS_r_A1"/><p class="asm-code">MOVS{<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_2" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift_1" title="Type of shift applied to source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_2" title="Shift amount [0-31 (when &lt;shift&gt; = LSL)] (field &quot;imm5&quot;)">&lt;amount&gt;</a>}</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 m = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rm);  constant setflags = (S == '1');
28constant (shift_t, shift_n) = <a href="shared_pseudocode.html#impl-aarch32.DecodeImmShift.2" title="function: (SRType, integer) DecodeImmShift(bits(2) srtype, bits(5) imm5)">DecodeImmShift</a>(stype, imm5);</p>
29    <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>1</td><td>0</td><td>0</td><td>0</td><td class="r">1</td><td class="l">1</td><td class="r">0</td><td class="lr">D</td><td colspan="4" class="lr">Rm</td><td colspan="3" class="lr">Rd</td></tr></tbody></table></div><div class="encoding"><h4 class="encoding">T1</h4><a id="MOV_r_T1"/><p class="asm-code">MOV{<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;D:Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a></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>(D:Rd);  constant m = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rm);  constant setflags = FALSE;
30constant (shift_t, shift_n) = (<a href="shared_pseudocode.html#SRType_LSL" title="enumeration SRType {SRType_LSL, SRType_LSR, SRType_ASR, SRType_ROR, SRType_RRX}">SRType_LSL</a>, 0);
31if d == 15 &amp;&amp; <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>
32    <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">0</td><td colspan="2" class="lr">!= 11</td><td colspan="5" class="lr">imm5</td><td colspan="3" class="lr">Rm</td><td colspan="3" class="lr">Rd</td></tr><tr class="secondrow"><td colspan="3"/><td colspan="2" class="droppedname">op</td><td colspan="5"/><td colspan="3"/><td colspan="3"/></tr></tbody></table></div><div class="encoding"><h4 class="encoding">T2</h4><a id="MOV_r_T2"/><p class="asm-code">MOV<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_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift" title="Type of shift applied to source register (field &quot;op&quot;) [ASR,LSL,LSR]">&lt;shift&gt;</a> #<a href="#sa_amount" title="Shift amount [1-31 (when &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR)] (field &quot;imm5&quot;)">&lt;amount&gt;</a>}
33        //
34      
35        (Inside IT block)
36      </p><p class="asm-code">MOVS{<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_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift" title="Type of shift applied to source register (field &quot;op&quot;) [ASR,LSL,LSR]">&lt;shift&gt;</a> #<a href="#sa_amount" title="Shift amount [1-31 (when &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR)] (field &quot;imm5&quot;)">&lt;amount&gt;</a>}
37        //
38      
39        (Outside IT block)
40      </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 m = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rm);  constant setflags = !<a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>();
41constant (shift_t, shift_n) = <a href="shared_pseudocode.html#impl-aarch32.DecodeImmShift.2" title="function: (SRType, integer) DecodeImmShift(bits(2) srtype, bits(5) imm5)">DecodeImmShift</a>(op, imm5);
42if op == '00' &amp;&amp; imm5 == '00000' &amp;&amp; <a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>() then UNPREDICTABLE;</p><h3>CONSTRAINED UNPREDICTABLE behavior</h3><p>If <span class="pseudocode">op == '00' &amp;&amp; imm5 == '00000' &amp;&amp; InITBlock()</span>, then one of the following behaviors must occur:</p><ul><li>The instruction is <span class="arm-defined-word">undefined</span>.</li><li>The instruction executes as if it passed its condition code check.</li><li>The instruction executes as <span class="asm-code">NOP</span>, as if it failed its condition code check.</li><li>The instruction executes as <span class="asm-code">MOV</span> Rd, Rm.</li></ul>
43    <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>0</td><td>1</td><td>0</td><td class="r">1</td><td class="l">0</td><td>0</td><td>1</td><td class="r">0</td><td class="lr">S</td><td class="l">1</td><td>1</td><td>1</td><td class="r">1</td><td class="lr">(0)</td><td colspan="3" class="lr">imm3</td><td colspan="4" class="lr">Rd</td><td colspan="2" class="lr">imm2</td><td colspan="2" class="lr">stype</td><td colspan="4" class="lr">Rm</td></tr></tbody></table></div><div class="encoding"><h4 class="encoding">MOV, rotate right with extend<span class="bitdiff"> (S == 0 &amp;&amp; imm3 == 000 &amp;&amp; imm2 == 00 &amp;&amp; stype == 11)</span></h4><a id="MOV_r_T3_RRX"/><p class="asm-code">MOV{<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_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">MOV, shift or rotate by value<span class="bitdiff"> (S == 0 &amp;&amp; !(imm3 == 000 &amp;&amp; imm2 == 00 &amp;&amp; stype == 11))</span></h4><a id="MOV_r_T3"/><p class="asm-code">MOV{<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>}.W <a href="#sa_rd_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, LSL #0}
44        //
45      
46        (&lt;Rd&gt;, &lt;Rm&gt; can be represented in T1)
47      </p><p class="asm-code">MOV<a href="#sa_c" title="See {xref{ARMARM_Babbefhf}{Standard assembler syntax fields}}">&lt;c&gt;</a>.W <a href="#sa_rd_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift_1" title="Type of shift applied to source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_1" title="Shift amount [0-31 (when &lt;shift&gt; = LSL) or 1 to 31 (when &lt;shift&gt; = ROR)] (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a>}
48        //
49      
50        (Inside IT block, and &lt;Rd&gt;, &lt;Rm&gt;, &lt;shift&gt;, &lt;amount&gt; can be represented in T2)
51      </p><p class="asm-code">MOV{<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_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift_1" title="Type of shift applied to source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_1" title="Shift amount [0-31 (when &lt;shift&gt; = LSL) or 1 to 31 (when &lt;shift&gt; = ROR)] (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a>}</p></div><div class="encoding"><h4 class="encoding">MOVS, rotate right with extend<span class="bitdiff"> (S == 1 &amp;&amp; imm3 == 000 &amp;&amp; imm2 == 00 &amp;&amp; stype == 11)</span></h4><a id="MOVS_r_T3_RRX"/><p class="asm-code">MOVS{<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_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a>, RRX</p></div><div class="encoding"><h4 class="encoding">MOVS, shift or rotate by value<span class="bitdiff"> (S == 1 &amp;&amp; !(imm3 == 000 &amp;&amp; imm2 == 00 &amp;&amp; stype == 11))</span></h4><a id="MOVS_r_T3"/><p class="asm-code">MOVS.W <a href="#sa_rd_1" title="General-purpose destination register (field &quot;Rd&quot;)">&lt;Rd&gt;</a>, <a href="#sa_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift_1" title="Type of shift applied to source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_1" title="Shift amount [0-31 (when &lt;shift&gt; = LSL) or 1 to 31 (when &lt;shift&gt; = ROR)] (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a>}
52        //
53      
54        (Outside IT block, and &lt;Rd&gt;, &lt;Rm&gt;, &lt;shift&gt;, &lt;amount&gt; can be represented in T1 or T2)
55      </p><p class="asm-code">MOVS{<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_rm_1" title="General-purpose source register (field &quot;Rm&quot;)">&lt;Rm&gt;</a> {, <a href="#sa_shift_1" title="Type of shift applied to source register (field &quot;stype&quot;) [ASR,LSL,LSR,ROR]">&lt;shift&gt;</a> #<a href="#sa_amount_1" title="Shift amount [0-31 (when &lt;shift&gt; = LSL) or 1 to 31 (when &lt;shift&gt; = ROR)] (field &quot;imm3:imm2&quot;)">&lt;amount&gt;</a>}</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 m = <a href="shared_pseudocode.html#impl-shared.UInt.1" title="function: integer UInt(bits(N) x)">UInt</a>(Rm);  constant setflags = (S == '1');
56constant (shift_t, shift_n) = <a href="shared_pseudocode.html#impl-aarch32.DecodeImmShift.2" title="function: (SRType, integer) DecodeImmShift(bits(2) srtype, bits(5) imm5)">DecodeImmShift</a>(stype, imm3:imm2);
57// Armv8-A removes UNPREDICTABLE for R13
58if d == 15 || m == 15 then UNPREDICTABLE;</p>
59  <div class="encoding-notes">
60      <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>.</p>
61    </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"/>
62        
63          <p class="aml">See <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="Babbefhf">Standard assembler syntax fields</a>.</p>
64        
65      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;q&gt;</td><td><a id="sa_q"/>
66        
67          <p class="aml">See <a class="armarm-xref" title="Reference to Armv8 ARM section" data-linkend="Babbefhf">Standard assembler syntax fields</a>.</p>
68        
69      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rd&gt;</td><td><a id="sa_rd_2"/>
70        
71          
72          
73          
74          
75        
76        
77          <p class="aml">For encoding A1: is the general-purpose destination register, encoded in the "Rd" field. If the PC is used:</p>
78          <ul>
79            <li>For the MOV 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>. Arm deprecates use of the instruction if &lt;Rn&gt; is the PC.</li>
80            <li>For the MOVS 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 the instruction if &lt;Rn&gt; is not the LR, or if the optional shift or RRX argument is specified.</li>
81          </ul>
82        
83      </td></tr><tr><td/><td><a id="sa_rd"/>
84        
85          
86          
87        
88        
89          <p class="aml">For encoding T1: is the general-purpose destination register, encoded in the "D:Rd" field. If the PC is used:</p>
90          <ul>
91            <li>The instruction causes a branch to the address moved to the PC. This is a simple 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>
92            <li>The instruction must either be outside an IT block or the last instruction of an IT block.</li>
93          </ul>
94        
95      </td></tr><tr><td/><td><a id="sa_rd_1"/>
96        
97          
98        
99        
100          <p class="aml">For encoding T2 and T3: is the general-purpose destination register, encoded in the "Rd" field.</p>
101        
102      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;Rm&gt;</td><td><a id="sa_rm"/>
103        
104          <p class="aml">For encoding A1 and T1: is the general-purpose source register, encoded in the "Rm" field. The PC can be used. Arm deprecates use of the instruction if &lt;Rd&gt; is the PC.</p>
105        
106      </td></tr><tr><td/><td><a id="sa_rm_1"/>
107        
108          
109        
110        
111          <p class="aml">For encoding T2 and T3: is the general-purpose source register, encoded in the "Rm" field.</p>
112        
113      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;shift&gt;</td><td><a id="sa_shift_1"/>
114        <p>For encoding A1 and T3: is the type of shift to be applied to the source register, 
115          encoded in
116          <q>stype</q>:
117            </p>
118        <table class="valuetable">
119          
120            <thead>
121              <tr>
122                <th class="bitfield">stype</th>
123                <th class="symbol">&lt;shift&gt;</th>
124              </tr>
125            </thead>
126            <tbody>
127              <tr>
128                <td class="bitfield">00</td>
129                <td class="symbol">LSL</td>
130              </tr>
131              <tr>
132                <td class="bitfield">01</td>
133                <td class="symbol">LSR</td>
134              </tr>
135              <tr>
136                <td class="bitfield">10</td>
137                <td class="symbol">ASR</td>
138              </tr>
139              <tr>
140                <td class="bitfield">11</td>
141                <td class="symbol">ROR</td>
142              </tr>
143            </tbody>
144          
145        </table>
146      </td></tr><tr><td/><td><a id="sa_shift"/>
147        <p>For encoding T2: is the type of shift to be applied to the source register, 
148          encoded in
149          <q>op</q>:
150            </p>
151        <table class="valuetable">
152          
153            <thead>
154              <tr>
155                <th class="bitfield">op</th>
156                <th class="symbol">&lt;shift&gt;</th>
157              </tr>
158            </thead>
159            <tbody>
160              <tr>
161                <td class="bitfield">00</td>
162                <td class="symbol">LSL</td>
163              </tr>
164              <tr>
165                <td class="bitfield">01</td>
166                <td class="symbol">LSR</td>
167              </tr>
168              <tr>
169                <td class="bitfield">10</td>
170                <td class="symbol">ASR</td>
171              </tr>
172            </tbody>
173          
174        </table>
175      </td></tr></table><table><col class="asyn-l"/><col class="asyn-r"/><tr><td>&lt;amount&gt;</td><td><a id="sa_amount_2"/>
176        
177          
178          
179          
180          
181        
182        
183          <p class="aml">For encoding A1: is the shift amount, in the range 0 to 31 (when &lt;shift&gt; = LSL), or 1 to 31 (when &lt;shift&gt; = ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR), encoded in the "imm5" field as &lt;amount&gt; modulo 32.</p>
184        
185      </td></tr><tr><td/><td><a id="sa_amount"/>
186        
187          
188          
189        
190        
191          <p class="aml">For encoding T2: is the shift amount, in the range 1 to 31 (when &lt;shift&gt; = LSL or ROR) or 1 to 32 (when &lt;shift&gt; = LSR or ASR), encoded in the "imm5" field as &lt;amount&gt; modulo 32.</p>
192        
193      </td></tr><tr><td/><td><a id="sa_amount_1"/>
194        
195          
196          
197          
198          
199        
200        
201          <p class="aml">For encoding T3: is the shift amount, in the range 0 to 31 (when &lt;shift&gt; = LSL) or 1 to 31 (when &lt;shift&gt; = ROR), or 1 to 32 (when &lt;shift&gt; = LSR or ASR), encoded in the "imm3:imm2" field as &lt;amount&gt; modulo 32.</p>
202        
203      </td></tr></table></div><div class="syntax-notes"/><h3 class="aliastable" id="">Alias Conditions</h3><table class="aliastable"><thead><tr><th>Alias</th><th>Of variant</th><th>Is preferred when</th></tr></thead><tbody><tr><td><a href="asrs_mov_r.html" title="Arithmetic Shift Right">ASRS (immediate)</a></td><td class="notfirst">T3 (MOVS, shift or rotate by value), A1 (MOVS, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; stype == '10'</span></td></tr><tr><td><a href="asrs_mov_r.html" title="Arithmetic Shift Right">ASRS (immediate)</a></td><td class="notfirst">T2</td><td class="notfirst"><span class="pseudocode">op == '10' &amp;&amp; !<a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>()</span></td></tr><tr><td><a href="asr_mov_r.html" title="Arithmetic Shift Right (immediate)">ASR (immediate)</a></td><td class="notfirst">T3 (MOV, shift or rotate by value), A1 (MOV, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; stype == '10'</span></td></tr><tr><td><a href="asr_mov_r.html" title="Arithmetic Shift Right (immediate)">ASR (immediate)</a></td><td class="notfirst">T2</td><td class="notfirst"><span class="pseudocode">op == '10' &amp;&amp; <a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>()</span></td></tr><tr><td><a href="lsls_mov_r.html" title="Logical Shift Left">LSLS (immediate)</a></td><td class="notfirst">T3 (MOVS, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; imm3:Rd:imm2 != '000xxxx00' &amp;&amp; stype == '00'</span></td></tr><tr><td><a href="lsls_mov_r.html" title="Logical Shift Left">LSLS (immediate)</a></td><td class="notfirst">A1 (MOVS, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; imm5 != '00000' &amp;&amp; stype == '00'</span></td></tr><tr><td><a href="lsls_mov_r.html" title="Logical Shift Left">LSLS (immediate)</a></td><td class="notfirst">T2</td><td class="notfirst"><span class="pseudocode">op == '00' &amp;&amp; imm5 != '00000' &amp;&amp; !<a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>()</span></td></tr><tr><td><a href="lsl_mov_r.html" title="Logical Shift Left (immediate)">LSL (immediate)</a></td><td class="notfirst">T3 (MOV, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; imm3:Rd:imm2 != '000xxxx00' &amp;&amp; stype == '00'</span></td></tr><tr><td><a href="lsl_mov_r.html" title="Logical Shift Left (immediate)">LSL (immediate)</a></td><td class="notfirst">A1 (MOV, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; imm5 != '00000' &amp;&amp; stype == '00'</span></td></tr><tr><td><a href="lsl_mov_r.html" title="Logical Shift Left (immediate)">LSL (immediate)</a></td><td class="notfirst">T2</td><td class="notfirst"><span class="pseudocode">op == '00' &amp;&amp; imm5 != '00000' &amp;&amp; <a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>()</span></td></tr><tr><td><a href="lsrs_mov_r.html" title="Logical Shift Right">LSRS (immediate)</a></td><td class="notfirst">T3 (MOVS, shift or rotate by value), A1 (MOVS, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; stype == '01'</span></td></tr><tr><td><a href="lsrs_mov_r.html" title="Logical Shift Right">LSRS (immediate)</a></td><td class="notfirst">T2</td><td class="notfirst"><span class="pseudocode">op == '01' &amp;&amp; !<a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>()</span></td></tr><tr><td><a href="lsr_mov_r.html" title="Logical Shift Right (immediate)">LSR (immediate)</a></td><td class="notfirst">T3 (MOV, shift or rotate by value), A1 (MOV, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; stype == '01'</span></td></tr><tr><td><a href="lsr_mov_r.html" title="Logical Shift Right (immediate)">LSR (immediate)</a></td><td class="notfirst">T2</td><td class="notfirst"><span class="pseudocode">op == '01' &amp;&amp; <a href="shared_pseudocode.html#impl-aarch32.InITBlock.0" title="function: boolean InITBlock()">InITBlock</a>()</span></td></tr><tr><td><a href="rors_mov_r.html" title="Rotate Right">RORS (immediate)</a></td><td class="notfirst">T3 (MOVS, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; imm3:Rd:imm2 != '000xxxx00' &amp;&amp; stype == '11'</span></td></tr><tr><td><a href="rors_mov_r.html" title="Rotate Right">RORS (immediate)</a></td><td class="notfirst">A1 (MOVS, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; imm5 != '00000' &amp;&amp; stype == '11'</span></td></tr><tr><td><a href="ror_mov_r.html" title="Rotate Right (immediate)">ROR (immediate)</a></td><td class="notfirst">T3 (MOV, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; imm3:Rd:imm2 != '000xxxx00' &amp;&amp; stype == '11'</span></td></tr><tr><td><a href="ror_mov_r.html" title="Rotate Right (immediate)">ROR (immediate)</a></td><td class="notfirst">A1 (MOV, shift or rotate by value)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; imm5 != '00000' &amp;&amp; stype == '11'</span></td></tr><tr><td><a href="rrxs_mov_r.html" title="Rotate Right with Extend">RRXS</a></td><td class="notfirst">T3 (MOVS, rotate right with extend)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; imm3 == '000' &amp;&amp; imm2 == '00' &amp;&amp; stype == '11'</span></td></tr><tr><td><a href="rrxs_mov_r.html" title="Rotate Right with Extend">RRXS</a></td><td class="notfirst">A1 (MOVS, rotate right with extend)</td><td class="notfirst"><span class="pseudocode">S == '1' &amp;&amp; imm5 == '00000' &amp;&amp; stype == '11'</span></td></tr><tr><td><a href="rrx_mov_r.html" title="Rotate Right with Extend">RRX</a></td><td class="notfirst">T3 (MOV, rotate right with extend)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; imm3 == '000' &amp;&amp; imm2 == '00' &amp;&amp; stype == '11'</span></td></tr><tr><td><a href="rrx_mov_r.html" title="Rotate Right with Extend">RRX</a></td><td class="notfirst">A1 (MOV, rotate right with extend)</td><td class="notfirst"><span class="pseudocode">S == '0' &amp;&amp; imm5 == '00000' &amp;&amp; stype == '11'</span></td></tr></tbody></table>
204    <div class="ps"><a id="execute"/><h3 class="pseudocode">Operation</h3>
205      <p class="pseudocode">if <a href="shared_pseudocode.html#impl-aarch32.ConditionPassed.0" title="function: boolean ConditionPassed()">ConditionPassed</a>() then
206    EncodingSpecificOperations();
207    constant (shifted, carry) = <a href="shared_pseudocode.html#impl-aarch32.Shift_C.4" title="function: (bits(N), bit) Shift_C(bits(N) value, SRType srtype, integer amount, bit carry_in)">Shift_C</a>(<a href="shared_pseudocode.html#impl-aarch32.R.read.1" title="accessor: bits(32) R[integer n]">R</a>[m], shift_t, shift_n, PSTATE.C);
208    constant result = shifted;
209    if d == 15 then
210        if setflags then
211            <a href="shared_pseudocode.html#impl-aarch32.ALUExceptionReturn.1" title="function: ALUExceptionReturn(bits(32) address)">ALUExceptionReturn</a>(result);
212        else
213            <a href="shared_pseudocode.html#impl-aarch32.ALUWritePC.1" title="function: ALUWritePC(bits(32) address)">ALUWritePC</a>(result);
214    else
215        <a href="shared_pseudocode.html#impl-aarch32.R.write.1" title="accessor: R[integer n] = bits(32) value">R</a>[d] = result;
216        if setflags then
217            PSTATE.N = result&lt;31&gt;;
218            PSTATE.Z = <a href="shared_pseudocode.html#impl-shared.IsZeroBit.1" title="function: bit IsZeroBit(bits(N) x)">IsZeroBit</a>(result);
219            PSTATE.C = carry;
220            // PSTATE.V unchanged</p>
221    </div>
222  <h3>Operational information</h3>
223    <p class="aml">If CPSR.DIT is 1 and this instruction does not use R15 as either its source or destination:</p>
224    <ul>
225      <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>
226      <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>
227    </ul>
228  <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">
229      Internal version only: isa v01_31, pseudocode v2024-09_rel
230      ; Build timestamp: 2024-09-26T13:26
231    </p><p class="copyconf">
232      Copyright © 2010-2024 Arm Limited or its affiliates. All rights reserved.
233      This document is Non-Confidential.
234    </p></body></html>