<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>nativeGen/Instruction.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a> <a name="line-2"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Instruction</span> <span class='hs-layout'>(</span> <a name="line-3"></a> <span class='hs-conid'>RegUsage</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <a name="line-4"></a> <span class='hs-varid'>noUsage</span><span class='hs-layout'>,</span> <a name="line-5"></a> <span class='hs-conid'>NatCmm</span><span class='hs-layout'>,</span> <a name="line-6"></a> <span class='hs-conid'>NatCmmTop</span><span class='hs-layout'>,</span> <a name="line-7"></a> <span class='hs-conid'>NatBasicBlock</span><span class='hs-layout'>,</span> <a name="line-8"></a> <span class='hs-conid'>Instruction</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <a name="line-9"></a><span class='hs-layout'>)</span> <a name="line-10"></a> <a name="line-11"></a><span class='hs-keyword'>where</span> <a name="line-12"></a> <a name="line-13"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Reg</span> <a name="line-14"></a> <a name="line-15"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>BlockId</span> <a name="line-16"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Cmm</span> <a name="line-17"></a> <a name="line-18"></a><a name="RegUsage"></a><span class='hs-comment'>-- | Holds a list of source and destination registers used by a</span> <a name="line-19"></a><a name="RegUsage"></a><span class='hs-comment'>-- particular instruction. </span> <a name="line-20"></a><a name="RegUsage"></a><span class='hs-comment'>--</span> <a name="line-21"></a><a name="RegUsage"></a><span class='hs-comment'>-- Machine registers that are pre-allocated to stgRegs are filtered</span> <a name="line-22"></a><a name="RegUsage"></a><span class='hs-comment'>-- out, because they are uninteresting from a register allocation</span> <a name="line-23"></a><a name="RegUsage"></a><span class='hs-comment'>-- standpoint. (We wouldn't want them to end up on the free list!) </span> <a name="line-24"></a><a name="RegUsage"></a><span class='hs-comment'>--</span> <a name="line-25"></a><a name="RegUsage"></a><span class='hs-comment'>-- As far as we are concerned, the fixed registers simply don't exist</span> <a name="line-26"></a><a name="RegUsage"></a><span class='hs-comment'>-- (for allocation purposes, anyway).</span> <a name="line-27"></a><a name="RegUsage"></a><span class='hs-comment'>--</span> <a name="line-28"></a><a name="RegUsage"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>RegUsage</span> <a name="line-29"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>RU</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Reg</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Reg</span><span class='hs-keyglyph'>]</span> <a name="line-30"></a> <a name="line-31"></a><a name="noUsage"></a><span class='hs-comment'>-- | No regs read or written to.</span> <a name="line-32"></a><span class='hs-definition'>noUsage</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>RegUsage</span> <a name="line-33"></a><span class='hs-definition'>noUsage</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>RU</span> <span class='hs-conid'>[]</span> <span class='hs-conid'>[]</span> <a name="line-34"></a> <a name="line-35"></a> <a name="line-36"></a><a name="NatCmm"></a><span class='hs-comment'>-- Our flavours of the Cmm types</span> <a name="line-37"></a><a name="NatCmm"></a><span class='hs-comment'>-- Type synonyms for Cmm populated with native code</span> <a name="line-38"></a><a name="NatCmm"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>NatCmm</span> <span class='hs-varid'>instr</span> <a name="line-39"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GenCmm</span> <a name="line-40"></a> <span class='hs-conid'>CmmStatic</span> <a name="line-41"></a> <span class='hs-keyglyph'>[</span><span class='hs-conid'>CmmStatic</span><span class='hs-keyglyph'>]</span> <a name="line-42"></a> <span class='hs-layout'>(</span><span class='hs-conid'>ListGraph</span> <span class='hs-varid'>instr</span><span class='hs-layout'>)</span> <a name="line-43"></a> <a name="line-44"></a><a name="NatCmmTop"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>NatCmmTop</span> <span class='hs-varid'>instr</span> <a name="line-45"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GenCmmTop</span> <a name="line-46"></a> <span class='hs-conid'>CmmStatic</span> <a name="line-47"></a> <span class='hs-keyglyph'>[</span><span class='hs-conid'>CmmStatic</span><span class='hs-keyglyph'>]</span> <a name="line-48"></a> <span class='hs-layout'>(</span><span class='hs-conid'>ListGraph</span> <span class='hs-varid'>instr</span><span class='hs-layout'>)</span> <a name="line-49"></a> <a name="line-50"></a> <a name="line-51"></a><a name="NatBasicBlock"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>NatBasicBlock</span> <span class='hs-varid'>instr</span> <a name="line-52"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GenBasicBlock</span> <span class='hs-varid'>instr</span> <a name="line-53"></a> <a name="line-54"></a> <a name="line-55"></a> <a name="line-56"></a> <a name="line-57"></a><span class='hs-comment'>-- | Common things that we can do with instructions, on all architectures.</span> <a name="line-58"></a><span class='hs-comment'>-- These are used by the shared parts of the native code generator,</span> <a name="line-59"></a><span class='hs-comment'>-- specifically the register allocators.</span> <a name="line-60"></a><span class='hs-comment'>--</span> <a name="line-61"></a><span class='hs-keyword'>class</span> <span class='hs-conid'>Instruction</span> <span class='hs-varid'>instr</span> <span class='hs-keyword'>where</span> <a name="line-62"></a> <a name="line-63"></a> <span class='hs-comment'>-- | Get the registers that are being used by this instruction.</span> <a name="line-64"></a> <span class='hs-comment'>-- regUsage doesn't need to do any trickery for jumps and such. </span> <a name="line-65"></a> <span class='hs-comment'>-- Just state precisely the regs read and written by that insn. </span> <a name="line-66"></a> <span class='hs-comment'>-- The consequences of control flow transfers, as far as register</span> <a name="line-67"></a> <span class='hs-comment'>-- allocation goes, are taken care of by the register allocator.</span> <a name="line-68"></a> <span class='hs-comment'>--</span> <a name="line-69"></a> <span class='hs-varid'>regUsageOfInstr</span> <a name="line-70"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <a name="line-71"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>RegUsage</span> <a name="line-72"></a> <a name="line-73"></a> <a name="line-74"></a> <span class='hs-comment'>-- | Apply a given mapping to all the register references in this</span> <a name="line-75"></a> <span class='hs-comment'>-- instruction.</span> <a name="line-76"></a> <span class='hs-varid'>patchRegsOfInstr</span> <a name="line-77"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <a name="line-78"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Reg</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Reg</span><span class='hs-layout'>)</span> <a name="line-79"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>instr</span> <a name="line-80"></a> <a name="line-81"></a> <a name="line-82"></a> <span class='hs-comment'>-- | Checks whether this instruction is a jump/branch instruction. </span> <a name="line-83"></a> <span class='hs-comment'>-- One that can change the flow of control in a way that the </span> <a name="line-84"></a> <span class='hs-comment'>-- register allocator needs to worry about. </span> <a name="line-85"></a> <span class='hs-varid'>isJumpishInstr</span> <a name="line-86"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-87"></a> <a name="line-88"></a> <a name="line-89"></a> <span class='hs-comment'>-- | Give the possible destinations of this jump instruction.</span> <a name="line-90"></a> <span class='hs-comment'>-- Must be defined for all jumpish instructions.</span> <a name="line-91"></a> <span class='hs-varid'>jumpDestsOfInstr</span> <a name="line-92"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>BlockId</span><span class='hs-keyglyph'>]</span> <a name="line-93"></a> <a name="line-94"></a> <a name="line-95"></a> <span class='hs-comment'>-- | Change the destination of this jump instruction.</span> <a name="line-96"></a> <span class='hs-comment'>-- Used in the linear allocator when adding fixup blocks for join</span> <a name="line-97"></a> <span class='hs-comment'>-- points.</span> <a name="line-98"></a> <span class='hs-varid'>patchJumpInstr</span> <a name="line-99"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <a name="line-100"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>BlockId</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>BlockId</span><span class='hs-layout'>)</span> <a name="line-101"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>instr</span> <a name="line-102"></a> <a name="line-103"></a> <a name="line-104"></a> <span class='hs-comment'>-- | An instruction to spill a register into a spill slot.</span> <a name="line-105"></a> <span class='hs-varid'>mkSpillInstr</span> <a name="line-106"></a> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Reg</span> <span class='hs-comment'>-- ^ the reg to spill</span> <a name="line-107"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-comment'>-- ^ the current stack delta</span> <a name="line-108"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-comment'>-- ^ spill slot to use</span> <a name="line-109"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>instr</span> <a name="line-110"></a> <a name="line-111"></a> <a name="line-112"></a> <span class='hs-comment'>-- | An instruction to reload a register from a spill slot.</span> <a name="line-113"></a> <span class='hs-varid'>mkLoadInstr</span> <a name="line-114"></a> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Reg</span> <span class='hs-comment'>-- ^ the reg to reload.</span> <a name="line-115"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-comment'>-- ^ the current stack delta</span> <a name="line-116"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-comment'>-- ^ the spill slot to use</span> <a name="line-117"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>instr</span> <a name="line-118"></a> <a name="line-119"></a> <span class='hs-comment'>-- | See if this instruction is telling us the current C stack delta</span> <a name="line-120"></a> <span class='hs-varid'>takeDeltaInstr</span> <a name="line-121"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <a name="line-122"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span> <a name="line-123"></a> <a name="line-124"></a> <span class='hs-comment'>-- | Check whether this instruction is some meta thing inserted into </span> <a name="line-125"></a> <span class='hs-comment'>-- the instruction stream for other purposes.</span> <a name="line-126"></a> <span class='hs-comment'>--</span> <a name="line-127"></a> <span class='hs-comment'>-- Not something that has to be treated as a real machine instruction</span> <a name="line-128"></a> <span class='hs-comment'>-- and have its registers allocated.</span> <a name="line-129"></a> <span class='hs-comment'>--</span> <a name="line-130"></a> <span class='hs-comment'>-- eg, comments, delta, ldata, etc. </span> <a name="line-131"></a> <span class='hs-varid'>isMetaInstr</span> <a name="line-132"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <a name="line-133"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-134"></a> <a name="line-135"></a> <a name="line-136"></a> <a name="line-137"></a> <span class='hs-comment'>-- | Copy the value in a register to another one.</span> <a name="line-138"></a> <span class='hs-comment'>-- Must work for all register classes.</span> <a name="line-139"></a> <span class='hs-varid'>mkRegRegMoveInstr</span> <a name="line-140"></a> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Reg</span> <span class='hs-comment'>-- ^ source register</span> <a name="line-141"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Reg</span> <span class='hs-comment'>-- ^ destination register</span> <a name="line-142"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>instr</span> <a name="line-143"></a> <a name="line-144"></a> <span class='hs-comment'>-- | Take the source and destination from this reg -> reg move instruction</span> <a name="line-145"></a> <span class='hs-comment'>-- or Nothing if it's not one</span> <a name="line-146"></a> <span class='hs-varid'>takeRegRegMoveInstr</span> <a name="line-147"></a> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>instr</span> <a name="line-148"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Reg</span><span class='hs-layout'>,</span> <span class='hs-conid'>Reg</span><span class='hs-layout'>)</span> <a name="line-149"></a> <a name="line-150"></a> <span class='hs-comment'>-- | Make an unconditional jump instruction.</span> <a name="line-151"></a> <span class='hs-comment'>-- For architectures with branch delay slots, its ok to put</span> <a name="line-152"></a> <span class='hs-comment'>-- a NOP after the jump. Don't fill the delay slot with an</span> <a name="line-153"></a> <span class='hs-comment'>-- instruction that references regs or you'll confuse the </span> <a name="line-154"></a> <span class='hs-comment'>-- linear allocator.</span> <a name="line-155"></a> <span class='hs-varid'>mkJumpInstr</span> <a name="line-156"></a> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>BlockId</span> <a name="line-157"></a> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>instr</span><span class='hs-keyglyph'>]</span> <a name="line-158"></a> <a name="line-159"></a> </pre></body> </html>