<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>compiler/rustc_codegen_cranelift/Readme.md - fork/rust @ master</title>
<meta name="description" content="compiler/rustc_codegen_cranelift/Readme.md in fork/rust at master.">
<meta property="og:title" content="compiler/rustc_codegen_cranelift/Readme.md - fork/rust @ master">
<meta property="og:description" content="compiler/rustc_codegen_cranelift/Readme.md in fork/rust at master.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="master" data-tip="3bcad65fbf67b6edf87c949531fbc13435882e6b">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/rust</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/rust</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">bors</span><span class="commit-message" data-commit="3bcad65fbf67b6edf87c949531fbc13435882e6b">Auto merge of #103046 - JanBeh:PR_clarify_cmp_terminology, r=workingjubilee</span><span class="snapshot-sha sha" data-commit="3bcad65fbf67b6edf87c949531fbc13435882e6b">3bcad65fbf6</span><time datetime="2023-10-05T15:24:54+00:00" title="2023-10-05 15:24:54 +0000">2023-10-05</time></p>
<header class="topbar"><details class="switcher"><summary>master</summary><div class="menu"><strong>branches</strong><a class="current" href="/fork/rust/ref/master/">master</a><strong>tags</strong><a href="/fork/rust/ref/1.39.0/">1.39.0</a><a href="/fork/rust/ref/1.40.0/">1.40.0</a><a href="/fork/rust/ref/1.41.0/">1.41.0</a><a href="/fork/rust/ref/1.41.1/">1.41.1</a><a href="/fork/rust/ref/1.42.0/">1.42.0</a><a href="/fork/rust/ref/1.43.0/">1.43.0</a><a href="/fork/rust/ref/1.43.1/">1.43.1</a><a href="/fork/rust/ref/1.44.0/">1.44.0</a><a class="all" href="/fork/rust/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/rust/">rust</a> / <a href="/fork/rust/ref/master/tree/compiler/">compiler</a> / <a href="/fork/rust/ref/master/tree/compiler/rustc_codegen_cranelift/">rustc_codegen_cranelift</a> / <span class="cur">Readme.md</span></nav>
<span class="view-stats"><span>4.9 KiB</span><span>103 lines</span></span><span class="actions"><a class="raw" href="/fork/rust/raw/62eaef359af924666824d4fb379a013ff00ffa5c/compiler/rustc_codegen_cranelift/Readme.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Cranelift codegen backend for rust</h1>
<p>The goal of this project is to create an alternative codegen backend for the rust compiler based on <a href="https://github.com/bytecodealliance/wasmtime/blob/main/cranelift">Cranelift</a>.
This has the potential to improve compilation times in debug mode.
If your project doesn't use any of the things listed under "Not yet supported", it should work fine.
If not please open an issue.</p>
<h2>Building and testing</h2>
<pre class="language-bash"><a-o>$</a-o><a-f> </a-f><a-pr>git</a-pr> clone https://github.com/bjorn3/rustc_codegen_cranelift
<a-o>$</a-o><a-f> </a-f><a-pr>cd</a-pr> rustc_codegen_cranelift
<a-o>$</a-o> <a-f>./y.sh</a-f> prepare
<a-o>$</a-o> <a-f>./y.sh</a-f> build</pre>
<p>To run the test suite replace the last command with:</p>
<pre class="language-bash"><a-o>$</a-o> <a-f>./test.sh</a-f></pre>
<p>For more docs on how to build and test see <a href="/fork/rust/ref/master/blob/compiler/rustc_codegen_cranelift/build_system/usage.txt">build_system/usage.txt</a> or the help message of <code>./y.sh</code>.</p>
<h2>Precompiled builds</h2>
<p>Alternatively you can download a pre built version from the <a href="https://github.com/bjorn3/rustc_codegen_cranelift/releases/tag/dev">releases</a> page.
Extract the <code>dist</code> directory in the archive anywhere you want.
If you want to use <code>cargo clif build</code> instead of having to specify the full path to the <code>cargo-clif</code> executable, you can add the <code>bin</code> subdirectory of the extracted <code>dist</code> directory to your <code>PATH</code>.
(tutorial <a href="https://stackoverflow.com/a/44272417">for Windows</a>, and <a href="https://unix.stackexchange.com/questions/26047/how-to-correctly-add-a-path-to-path/26059#26059">for Linux/MacOS</a>).</p>
<h2>Usage</h2>
<p>rustc_codegen_cranelift can be used as a near-drop-in replacement for <code>cargo build</code> or <code>cargo run</code> for existing projects.</p>
<p>Assuming <code>$cg_clif_dir</code> is the directory you cloned this repo into and you followed the instructions (<code>y.sh prepare</code> and <code>y.sh build</code> or <code>test.sh</code>).</p>
<p>In the directory with your project (where you can do the usual <code>cargo build</code>), run:</p>
<pre class="language-bash"><a-o>$</a-o><a-f> $cg_clif_dir/dist/cargo-clif</a-f> build</pre>
<p>This will build your project with rustc_codegen_cranelift instead of the usual LLVM backend.</p>
<p>For additional ways to use rustc_codegen_cranelift like the JIT mode see <a href="/fork/rust/ref/master/blob/compiler/rustc_codegen_cranelift/docs/usage.md">usage.md</a>.</p>
<h2>Building and testing with changes in rustc code</h2>
<p>This is useful when changing code in <code>rustc_codegen_cranelift</code> as part of changing <a href="https://github.com/rust-lang/rust/">main Rust repository</a>.
This can happen, for example, when you are implementing a new compiler intrinsic.</p>
<p>Instruction below uses <code>$RustCheckoutDir</code> as substitute for any folder where you cloned Rust repository.</p>
<p>You need to do this steps to successfully compile and use the cranelift backend with your changes in rustc code:</p>
<ol>
<li><code>cd $RustCheckoutDir</code></li>
<li>Run <code>python x.py setup</code> and choose option for compiler (<code>b</code>).</li>
<li>Build compiler and necessary tools: <code>python x.py build --stage=2 compiler library/std src/tools/rustdoc src/tools/rustfmt</code>
<ul>
<li>(Optional) You can also build cargo by adding <code>src/tools/cargo</code> to previous command.</li>
</ul>
</li>
<li>Copy exectutable files from <code>./build/host/stage2-tools/&lt;your hostname triple&gt;/release</code>
to <code>./build/host/stage2/bin/</code>. Note that you would need to do this every time you rebuilt <code>rust</code> repository.</li>
<li>Copy cargo from another toolchain: <code>cp $(rustup which cargo) .build/&lt;your hostname triple&gt;/stage2/bin/cargo</code>
<ul>
<li>Another option is to build it at step 3 and copy with other executables at step 4.</li>
</ul>
</li>
<li>Link your new <code>rustc</code> to toolchain: <code>rustup toolchain link stage2 ./build/host/stage2/</code>.</li>
<li>(Windows only) compile the build system: <code>rustc +stage2 -O build_system/main.rs -o y.exe</code>.</li>
<li>You need to prefix every <code>./y.sh</code> (or <code>y</code> if you built <code>build_system/main.rs</code> as <code>y</code>) command by <code>rustup run stage2</code> to make cg_clif use your local changes in rustc.</li>
</ol>
<ul>
<li><code>rustup run stage2 ./y.sh prepare</code></li>
<li><code>rustup run stage2 ./y.sh build</code></li>
<li>(Optional) run tests: <code>rustup run stage2 ./y.sh test</code></li>
</ul>
<ol start="9">
<li>Now you can use your cg_clif build to compile other Rust programs, e.g. you can open any Rust crate and run commands like <code>$RustCheckoutDir/compiler/rustc_codegen_cranelift/dist/cargo-clif build --release</code>.</li>
</ol>
<h2>Configuration</h2>
<p>See the documentation on the <code>BackendConfig</code> struct in <a href="/fork/rust/ref/master/blob/compiler/rustc_codegen_cranelift/src/config.rs">config.rs</a> for all
configuration options.</p>
<h2>Not yet supported</h2>
<ul>
<li>Inline assembly (<a href="https://github.com/bytecodealliance/wasmtime/issues/1041">no cranelift support</a>)
<ul>
<li>On UNIX there is support for invoking an external assembler for <code>global_asm!</code> and <code>asm!</code>.</li>
</ul>
</li>
<li>SIMD (<a href="https://github.com/bjorn3/rustc_codegen_cranelift/issues/171">tracked here</a>, <code>std::simd</code> fully works, <code>std::arch</code> is partially supported)</li>
<li>Unwinding on panics (<a href="https://github.com/bytecodealliance/wasmtime/issues/1677">no cranelift support</a>, <code>-Cpanic=abort</code> is enabled by default)</li>
</ul>
<h2>License</h2>
<p>Licensed under either of</p>
<ul>
<li>Apache License, Version 2.0 (<a href="/fork/rust/ref/master/blob/compiler/rustc_codegen_cranelift/LICENSE-APACHE">LICENSE-APACHE</a> or
http://www.apache.org/licenses/LICENSE-2.0)</li>
<li>MIT license (<a href="/fork/rust/ref/master/blob/compiler/rustc_codegen_cranelift/LICENSE-MIT">LICENSE-MIT</a> or
http://opensource.org/licenses/MIT)</li>
</ul>
<p>at your option.</p>
<h3>Contribution</h3>
<p>Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you shall be dual licensed as above, without any
additional terms or conditions.</p>
</section><div class="code-panel"><pre class="code src" data-hl="compiler/rustc_codegen_cranelift/Readme.md"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"># Cranelift codegen backend for rust</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">The goal of this project is to create an alternative codegen backend for the rust compiler based on [Cranelift](https://github.com/bytecodealliance/wasmtime/blob/main/cranelift).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">This has the potential to improve compilation times in debug mode.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">If your project doesn't use any of the things listed under &quot;Not yet supported&quot;, it should work fine.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text">If not please open an issue.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text">## Building and testing</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text">```bash</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text">$ git clone https://github.com/bjorn3/rustc_codegen_cranelift</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text">$ cd rustc_codegen_cranelift</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text">$ ./y.sh prepare</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text">$ ./y.sh build</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text">```</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text">To run the test suite replace the last command with:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text">```bash</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text">$ ./test.sh</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text">```</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text">For more docs on how to build and test see [build_system/usage.txt](build_system/usage.txt) or the help message of `./y.sh`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text">## Precompiled builds</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text">Alternatively you can download a pre built version from the [releases] page.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text">Extract the `dist` directory in the archive anywhere you want.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text">If you want to use `cargo clif build` instead of having to specify the full path to the `cargo-clif` executable, you can add the `bin` subdirectory of the extracted `dist` directory to your `PATH`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text">(tutorial [for Windows](https://stackoverflow.com/a/44272417), and [for Linux/MacOS](https://unix.stackexchange.com/questions/26047/how-to-correctly-add-a-path-to-path/26059#26059)).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text">[releases]: https://github.com/bjorn3/rustc_codegen_cranelift/releases/tag/dev</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text">## Usage</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text">rustc_codegen_cranelift can be used as a near-drop-in replacement for `cargo build` or `cargo run` for existing projects.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text">Assuming `$cg_clif_dir` is the directory you cloned this repo into and you followed the instructions (`y.sh prepare` and `y.sh build` or `test.sh`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text">In the directory with your project (where you can do the usual `cargo build`), run:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text">```bash</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text">$ $cg_clif_dir/dist/cargo-clif build</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text">```</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text">This will build your project with rustc_codegen_cranelift instead of the usual LLVM backend.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text">For additional ways to use rustc_codegen_cranelift like the JIT mode see [usage.md](docs/usage.md).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text">## Building and testing with changes in rustc code</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text">This is useful when changing code in `rustc_codegen_cranelift` as part of changing [main Rust repository](https://github.com/rust-lang/rust/).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text">This can happen, for example, when you are implementing a new compiler intrinsic.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text">Instruction below uses `$RustCheckoutDir` as substitute for any folder where you cloned Rust repository.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text">You need to do this steps to successfully compile and use the cranelift backend with your changes in rustc code:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text">1. `cd $RustCheckoutDir`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text">2. Run `python x.py setup` and choose option for compiler (`b`).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text">3. Build compiler and necessary tools: `python x.py build --stage=2 compiler library/std src/tools/rustdoc src/tools/rustfmt`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text">   * (Optional) You can also build cargo by adding `src/tools/cargo` to previous command.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text">4. Copy exectutable files from `./build/host/stage2-tools/&lt;your hostname triple&gt;/release`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text">to `./build/host/stage2/bin/`. Note that you would need to do this every time you rebuilt `rust` repository.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text">5. Copy cargo from another toolchain: `cp $(rustup which cargo) .build/&lt;your hostname triple&gt;/stage2/bin/cargo`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text">   * Another option is to build it at step 3 and copy with other executables at step 4.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text">6. Link your new `rustc` to toolchain: `rustup toolchain link stage2 ./build/host/stage2/`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text">7. (Windows only) compile the build system: `rustc +stage2 -O build_system/main.rs -o y.exe`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text">8. You need to prefix every `./y.sh` (or `y` if you built `build_system/main.rs` as `y`) command by `rustup run stage2` to make cg_clif use your local changes in rustc.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text">  * `rustup run stage2 ./y.sh prepare`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text">  * `rustup run stage2 ./y.sh build`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text">  * (Optional) run tests: `rustup run stage2 ./y.sh test`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text">9. Now you can use your cg_clif build to compile other Rust programs, e.g. you can open any Rust crate and run commands like `$RustCheckoutDir/compiler/rustc_codegen_cranelift/dist/cargo-clif build --release`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text">## Configuration</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text">See the documentation on the `BackendConfig` struct in [config.rs](src/config.rs) for all</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text">configuration options.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text">## Not yet supported</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text">* Inline assembly ([no cranelift support](https://github.com/bytecodealliance/wasmtime/issues/1041))</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text">    * On UNIX there is support for invoking an external assembler for `global_asm!` and `asm!`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text">* SIMD ([tracked here](https://github.com/bjorn3/rustc_codegen_cranelift/issues/171), `std::simd` fully works, `std::arch` is partially supported)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text">* Unwinding on panics ([no cranelift support](https://github.com/bytecodealliance/wasmtime/issues/1677), `-Cpanic=abort` is enabled by default)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text">## License</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text">Licensed under either of</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text">  * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text">    http://www.apache.org/licenses/LICENSE-2.0)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text">  * MIT license ([LICENSE-MIT](LICENSE-MIT) or</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text">    http://opensource.org/licenses/MIT)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text">at your option.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text">### Contribution</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text">Unless you explicitly state otherwise, any contribution intentionally submitted</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text">for inclusion in the work by you shall be dual licensed as above, without any</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text">additional terms or conditions.</span></span></pre></div></div>
</main>
</body>
</html>
