npm - koffi - Versions diffs - 2.1.0-beta.1 → 2.1.0-beta.2 - Mend

koffi 2.1.0-beta.1 → 2.1.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (99) hide show

package/CMakeLists.txt +1 -1
package/ChangeLog.md +17 -0
package/build/qemu/2.1.0-beta.2/koffi_darwin_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_darwin_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_freebsd_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_freebsd_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_freebsd_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_linux_arm32hf.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_linux_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_linux_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_linux_riscv64hf64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_linux_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_openbsd_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_openbsd_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_win32_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_win32_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.2/koffi_win32_x64.tar.gz +0 -0
package/doc/functions.md +67 -1
package/doc/templates/badges.html +1 -2
package/doc/types.md +100 -147
package/package.json +1 -1
package/src/abi_arm32.cc +166 -2
package/src/abi_arm64.cc +195 -2
package/src/abi_riscv64.cc +106 -2
package/src/abi_x64_sysv.cc +113 -3
package/src/abi_x64_win.cc +112 -2
package/src/abi_x86.cc +155 -4
package/src/call.cc +199 -0
package/src/ffi.cc +50 -18
package/src/ffi.hh +12 -0
package/build/qemu/2.1.0-beta.1/koffi_darwin_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_darwin_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_freebsd_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_freebsd_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_freebsd_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_linux_arm32hf.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_linux_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_linux_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_linux_riscv64hf64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_linux_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_openbsd_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_openbsd_x64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_win32_arm64.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_win32_ia32.tar.gz +0 -0
package/build/qemu/2.1.0-beta.1/koffi_win32_x64.tar.gz +0 -0
package/doc/dist/html/.buildinfo +0 -4
package/doc/dist/html/_sources/benchmarks.md.txt +0 -137
package/doc/dist/html/_sources/changes.md.txt +0 -161
package/doc/dist/html/_sources/contribute.md.txt +0 -127
package/doc/dist/html/_sources/functions.md.txt +0 -355
package/doc/dist/html/_sources/index.rst.txt +0 -39
package/doc/dist/html/_sources/memory.md.txt +0 -32
package/doc/dist/html/_sources/platforms.md.txt +0 -31
package/doc/dist/html/_sources/start.md.txt +0 -100
package/doc/dist/html/_sources/types.md.txt +0 -588
package/doc/dist/html/_static/_sphinx_javascript_frameworks_compat.js +0 -134
package/doc/dist/html/_static/basic.css +0 -932
package/doc/dist/html/_static/bench_linux.png +0 -0
package/doc/dist/html/_static/bench_windows.png +0 -0
package/doc/dist/html/_static/custom.css +0 -22
package/doc/dist/html/_static/debug.css +0 -69
package/doc/dist/html/_static/doctools.js +0 -264
package/doc/dist/html/_static/documentation_options.js +0 -14
package/doc/dist/html/_static/file.png +0 -0
package/doc/dist/html/_static/jquery-3.6.0.js +0 -10881
package/doc/dist/html/_static/jquery.js +0 -2
package/doc/dist/html/_static/language_data.js +0 -199
package/doc/dist/html/_static/minus.png +0 -0
package/doc/dist/html/_static/perf_linux_20220623.png +0 -0
package/doc/dist/html/_static/perf_linux_20220623_2.png +0 -0
package/doc/dist/html/_static/perf_windows_20220623.png +0 -0
package/doc/dist/html/_static/perf_windows_20220623_2.png +0 -0
package/doc/dist/html/_static/plus.png +0 -0
package/doc/dist/html/_static/pygments.css +0 -252
package/doc/dist/html/_static/scripts/furo-extensions.js +0 -0
package/doc/dist/html/_static/scripts/furo.js +0 -3
package/doc/dist/html/_static/scripts/furo.js.LICENSE.txt +0 -7
package/doc/dist/html/_static/scripts/furo.js.map +0 -1
package/doc/dist/html/_static/searchtools.js +0 -531
package/doc/dist/html/_static/skeleton.css +0 -296
package/doc/dist/html/_static/styles/furo-extensions.css +0 -2
package/doc/dist/html/_static/styles/furo-extensions.css.map +0 -1
package/doc/dist/html/_static/styles/furo.css +0 -2
package/doc/dist/html/_static/styles/furo.css.map +0 -1
package/doc/dist/html/_static/underscore-1.13.1.js +0 -2042
package/doc/dist/html/_static/underscore.js +0 -6
package/doc/dist/html/benchmarks.html +0 -572
package/doc/dist/html/changes.html +0 -668
package/doc/dist/html/contribute.html +0 -404
package/doc/dist/html/functions.html +0 -657
package/doc/dist/html/genindex.html +0 -254
package/doc/dist/html/index.html +0 -360
package/doc/dist/html/memory.html +0 -347
package/doc/dist/html/objects.inv +0 -0
package/doc/dist/html/platforms.html +0 -372
package/doc/dist/html/search.html +0 -262
package/doc/dist/html/searchindex.js +0 -1
package/doc/dist/html/start.html +0 -385
package/doc/dist/html/types.html +0 -1097

package/doc/dist/html/contribute.html DELETED Viewed

@@ -1,404 +0,0 @@
-<!doctype html>
-<html class="no-js" lang="en">
-  <head><meta charset="utf-8"/>
-    <meta name="viewport" content="width=device-width,initial-scale=1"/>
-    <meta name="color-scheme" content="light dark"><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
-<link rel="index" title="Index" href="genindex" /><link rel="search" title="Search" href="search" /><link rel="next" title="Changelog" href="changes" /><link rel="prev" title="Benchmarks" href="benchmarks" />
-    <meta name="generator" content="sphinx-5.0.1, furo 2022.06.04.1"/>
-        <title>Contributing - Koffi</title>
-      <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
-    <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=40978830699223671f4072448e654b5958f38b89" />
-    <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?digest=30d1aed668e5c3a91c3e3bf6a60b675221979f0e" />
-    <link rel="stylesheet" type="text/css" href="_static/custom.css" />
-<style>
-  body {
-    --color-code-background: #f8f8f8;
-  --color-code-foreground: black;
-  --color-brand-primary: #FF6600;
-  --color-brand-content: #FF6600;
-  }
-  @media not print {
-    body[data-theme="dark"] {
-      --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
-  --color-brand-primary: #FF6600;
-  --color-brand-content: #FF6600;
-    }
-    @media (prefers-color-scheme: dark) {
-      body:not([data-theme="light"]) {
-        --color-code-background: #202020;
-  --color-code-foreground: #d0d0d0;
-  --color-brand-primary: #FF6600;
-  --color-brand-content: #FF6600;
-      }
-    }
-  }
-</style></head>
-  <body>
-    <script>
-      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
-    </script>
-<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
-  <symbol id="svg-toc" viewBox="0 0 24 24">
-    <title>Contents</title>
-    <svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 1024 1024">
-      <path d="M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z"/>
-    </svg>
-  </symbol>
-  <symbol id="svg-menu" viewBox="0 0 24 24">
-    <title>Menu</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
-      <line x1="3" y1="12" x2="21" y2="12"></line>
-      <line x1="3" y1="6" x2="21" y2="6"></line>
-      <line x1="3" y1="18" x2="21" y2="18"></line>
-    </svg>
-  </symbol>
-  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
-    <title>Expand</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
-      <polyline points="9 18 15 12 9 6"></polyline>
-    </svg>
-  </symbol>
-  <symbol id="svg-sun" viewBox="0 0 24 24">
-    <title>Light mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
-      <circle cx="12" cy="12" r="5"></circle>
-      <line x1="12" y1="1" x2="12" y2="3"></line>
-      <line x1="12" y1="21" x2="12" y2="23"></line>
-      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
-      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
-      <line x1="1" y1="12" x2="3" y2="12"></line>
-      <line x1="21" y1="12" x2="23" y2="12"></line>
-      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
-      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
-    </svg>
-  </symbol>
-  <symbol id="svg-moon" viewBox="0 0 24 24">
-    <title>Dark mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
-      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
-      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
-    </svg>
-  </symbol>
-  <symbol id="svg-sun-half" viewBox="0 0 24 24">
-    <title>Auto light/dark mode</title>
-    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
-      stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-shadow">
-      <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
-      <circle cx="12" cy="12" r="9" />
-      <path d="M13 12h5" />
-      <path d="M13 15h4" />
-      <path d="M13 18h1" />
-      <path d="M13 9h4" />
-      <path d="M13 6h1" />
-    </svg>
-  </symbol>
-</svg>
-<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
-<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
-<label class="overlay sidebar-overlay" for="__navigation">
-  <div class="visually-hidden">Hide navigation sidebar</div>
-</label>
-<label class="overlay toc-overlay" for="__toc">
-  <div class="visually-hidden">Hide table of contents sidebar</div>
-</label>
-<div class="page">
-  <header class="mobile-header">
-    <div class="header-left">
-      <label class="nav-overlay-icon" for="__navigation">
-        <div class="visually-hidden">Toggle site navigation sidebar</div>
-        <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
-      </label>
-    </div>
-    <div class="header-center">
-      <a href="index"><div class="brand">Koffi</div></a>
-    </div>
-    <div class="header-right">
-      <div class="theme-toggle-container theme-toggle-header">
-        <button class="theme-toggle">
-          <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
-          <svg class="theme-icon-when-auto"><use href="#svg-sun-half"></use></svg>
-          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
-          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
-        </button>
-      </div>
-      <label class="toc-overlay-icon toc-header-icon" for="__toc">
-        <div class="visually-hidden">Toggle table of contents sidebar</div>
-        <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
-      </label>
-    </div>
-  </header>
-  <aside class="sidebar-drawer">
-    <div class="sidebar-container">
-      <div class="sidebar-sticky"><a class="sidebar-brand" href="index">
-  <span class="sidebar-brand-text">Koffi</span>
-</a><form class="sidebar-search-container" method="get" action="search" role="search">
-  <input class="sidebar-search" placeholder=Search name="q" aria-label="Search">
-  <input type="hidden" name="check_keywords" value="yes">
-  <input type="hidden" name="area" value="default">
-</form>
-<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
-  <ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="platforms">Requirements</a></li>
-<li class="toctree-l1"><a class="reference internal" href="start">Quick start</a></li>
-<li class="toctree-l1"><a class="reference internal" href="types">Data types</a></li>
-<li class="toctree-l1"><a class="reference internal" href="functions">Functions</a></li>
-<li class="toctree-l1"><a class="reference internal" href="memory">Memory usage</a></li>
-<li class="toctree-l1"><a class="reference internal" href="benchmarks">Benchmarks</a></li>
-<li class="toctree-l1 current current-page"><a class="current reference internal" href="#">Contributing</a></li>
-<li class="toctree-l1"><a class="reference internal" href="changes">Changelog</a></li>
-</ul>
-</div>
-<div style="text-align: center; margin-top: 2em;">
-    <a href="https://www.npmjs.com/package/koffi"><img src="https://img.shields.io/badge/NPM-2.0.1-brightgreen" alt="NPM"/></a>
-    <a href="https://github.com/Koromix/luigi/tree/master/koffi"><img src="https://img.shields.io/badge/GitHub-Koffi-ff6600" alt="GitHub"/></a>
-</div>
-</div>
-      </div>
-    </div>
-  </aside>
-  <div class="main">
-    <div class="content">
-      <div class="article-container">
-        <a href="#" class="back-to-top muted-link">
-          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
-          </svg>
-          <span>Back to top</span>
-        </a>
-        <div class="content-icon-container">
-          <div class="theme-toggle-container theme-toggle-content">
-            <button class="theme-toggle">
-              <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
-              <svg class="theme-icon-when-auto"><use href="#svg-sun-half"></use></svg>
-              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
-              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
-            </button>
-          </div>
-          <label class="toc-overlay-icon toc-content-icon" for="__toc">
-            <div class="visually-hidden">Toggle table of contents sidebar</div>
-            <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
-          </label>
-        </div>
-        <article role="main">
-          <section id="contributing">
-<h1>Contributing<a class="headerlink" href="#contributing" title="Permalink to this heading">#</a></h1>
-<section id="bugs-and-feature-requests">
-<h2>Bugs and feature requests<a class="headerlink" href="#bugs-and-feature-requests" title="Permalink to this heading">#</a></h2>
-<p>Use the official repository (named Luigi, because this is a monorepo containing multiple projects) for bugs, ideas and features requests.</p>
-<p>Go here: <a class="reference external" href="https://github.com/Koromix/luigi/">https://github.com/Koromix/luigi/</a></p>
-</section>
-<section id="build-from-source">
-<h2>Build from source<a class="headerlink" href="#build-from-source" title="Permalink to this heading">#</a></h2>
-<p>We provide prebuilt binaries, packaged in the NPM archive, so in most cases it should be as simple as <code class="docutils literal notranslate"><span class="pre">npm</span> <span class="pre">install</span> <span class="pre">koffi</span></code>. If you want to hack Koffi or use a specific platform, follow the instructions below.</p>
-<p>Start by cloning the repository with <a class="reference external" href="https://git-scm.com/">Git</a>:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span>git clone https://github.com/Koromix/luigi
-<span class="linenos">2</span><span class="nb">cd</span> luigi/koffi
-</pre></div>
-</div>
-<p>As said before, this is a monorepository containg multiple projects, hence the name.</p>
-<section id="windows">
-<h3>Windows<a class="headerlink" href="#windows" title="Permalink to this heading">#</a></h3>
-<p>First, make sure the following dependencies are met:</p>
-<ul class="simple">
-<li><p>The “Desktop development with C++” workload from <a class="reference external" href="https://visualstudio.microsoft.com/downloads/">Visual Studio 2022 or 2019</a> or the “C++ build tools” workload from the <a class="reference external" href="https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022">Build Tools</a>, with the default optional components.</p></li>
-<li><p><a class="reference external" href="https://cmake.org/">CMake meta build system</a></p></li>
-<li><p><a class="reference external" href="https://nodejs.org/">Node.js</a> 12 or later</p></li>
-</ul>
-<p>Once this is done, run this command <em>from the test or the benchmark directory</em> (depending on what you want to build):</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span><span class="nb">cd</span> koffi/test <span class="c1"># or cd koffi/benchmark</span>
-<span class="linenos">2</span>node ../../cnoke/cnoke.js
-</pre></div>
-</div>
-</section>
-<section id="other-platforms">
-<h3>Other platforms<a class="headerlink" href="#other-platforms" title="Permalink to this heading">#</a></h3>
-<p>Make sure the following dependencies are met:</p>
-<ul class="simple">
-<li><p><code class="docutils literal notranslate"><span class="pre">gcc</span></code> and <code class="docutils literal notranslate"><span class="pre">g++</span></code> &gt;= 8.3 or newer</p></li>
-<li><p>GNU Make 3.81 or newer</p></li>
-<li><p><a class="reference external" href="https://cmake.org/">CMake meta build system</a></p></li>
-<li><p><a class="reference external" href="https://nodejs.org/">Node.js</a> 12 or later</p></li>
-</ul>
-<p>Once this is done, run this command <em>from the test or the benchmark directory</em> (depending on what you want to build):</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span><span class="nb">cd</span> koffi/test <span class="c1"># or cd koffi/benchmark</span>
-<span class="linenos">2</span>node ../../cnoke/cnoke.js
-</pre></div>
-</div>
-</section>
-</section>
-<section id="running-tests">
-<h2>Running tests<a class="headerlink" href="#running-tests" title="Permalink to this heading">#</a></h2>
-<p>Koffi is tested on multiple architectures using emulated (accelerated when possible) QEMU machines. First, you need to install qemu packages, such as <code class="docutils literal notranslate"><span class="pre">qemu-system</span></code> (or even <code class="docutils literal notranslate"><span class="pre">qemu-system-gui</span></code>) on Ubuntu.</p>
-<p>These machines are not included directly in this repository (for license and size reasons), but they are available here: <a class="reference external" href="https://koromix.dev/files/machines/">https://koromix.dev/files/machines/</a></p>
-<p>For example, if you want to run the tests on Debian ARM64, run the following commands:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span><span class="nb">cd</span> luigi/koffi/qemu/
-<span class="linenos">2</span>wget -q -O- https://koromix.dev/files/machines/qemu_debian_arm64.tar.zst <span class="p">|</span> zstd -d <span class="p">|</span> tar xv
-<span class="linenos">3</span>sha256sum -c --ignore-missing registry/sha256sum.txt
-</pre></div>
-</div>
-<p>Note that the machine disk content may change each time the machine runs, so the checksum test will fail once a machine has been used at least once.</p>
-<p>And now you can run the tests with:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span>node qemu.js <span class="nb">test</span> <span class="c1"># Several options are available, use --help</span>
-</pre></div>
-</div>
-<p>And be patient, this can be pretty slow for emulated machines. The Linux machines have and use ccache to build Koffi, so subsequent build steps will get much more tolerable.</p>
-<p>By default, machines are started and stopped for each test. But you can start the machines ahead of time and run the tests multiple times instead:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span>node qemu.js start <span class="c1"># Start the machines</span>
-<span class="linenos">2</span>node qemu.js <span class="nb">test</span> <span class="c1"># Test (without shutting down)</span>
-<span class="linenos">3</span>node qemu.js <span class="nb">test</span> <span class="c1"># Test again</span>
-<span class="linenos">4</span>node qemu.js stop <span class="c1"># Stop everything</span>
-</pre></div>
-</div>
-<p>You can also restrict the test to a subset of machines:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span><span class="c1"># Full test cycle</span>
-<span class="linenos">2</span>node qemu.js <span class="nb">test</span> debian_x64 debian_i386
-<span class="linenos">3</span>
-<span class="linenos">4</span><span class="c1"># Separate start, test, shutdown</span>
-<span class="linenos">5</span>node qemu.js start debian_x64 debian_i386
-<span class="linenos">6</span>node qemu.js <span class="nb">test</span> debian_x64 debian_i386
-<span class="linenos">7</span>node qemu.js stop
-</pre></div>
-</div>
-<p>Finally, you can join a running machine with SSH with the following shortcut, if you need to do some debugging or any other manual procedure:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span>node qemu.js ssh debian_i386
-</pre></div>
-</div>
-<p>Each machine is configured to run a VNC server available locally, which you can use to access the display, using KRDC or any other compatible viewer. Use the <code class="docutils literal notranslate"><span class="pre">info</span></code> command to get the VNC port.</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="linenos">1</span>node qemu.js info debian_x64
-</pre></div>
-</div>
-</section>
-<section id="todo-list">
-<h2>Todo list<a class="headerlink" href="#todo-list" title="Permalink to this heading">#</a></h2>
-<p>The following features and improvements are planned, not necessarily in that order:</p>
-<ul class="simple">
-<li><p>Optimize passing of structs and arrays (avoid setting named properties one by one? separate HFA-specific helper functions?)</p></li>
-<li><p>Automate Windows/AArch64 (qemu) and macOS/AArch64 (how? … thanks Apple) tests</p></li>
-<li><p>Create a real-world example, using several libraries (Raylib, SQLite, libsodium) to illustrate various C API styles</p></li>
-<li><p>Add simple struct type parser</p></li>
-<li><p>Add more ways to manually encode and decode various types to and from byte arrays</p></li>
-<li><p>Add support for unions</p></li>
-<li><p>Port Koffi to PowerPC (POWER9+) ABI</p></li>
-<li><p>Fix assembly unwind and CFI directives for better debugging experience</p></li>
-</ul>
-</section>
-<section id="code-style">
-<h2>Code style<a class="headerlink" href="#code-style" title="Permalink to this heading">#</a></h2>
-<p>Koffi is programmed in a mix of C++ and assembly code (architecture-specific code). It uses <a class="reference external" href="https://github.com/nodejs/node-addon-api">node-addon-api</a> (C++ N-API wrapper) to interact with Node.js.</p>
-<p>My personal preference goes to a rather C-like C++ style, with careful use of templates (mainly for containers) and little object-oriented programming. I strongly prefer tagged unions and code locality over inheritance and virtual methods. Exceptions are disabled.</p>
-</section>
-</section>
-        </article>
-      </div>
-      <footer>
-        <div class="related-pages">
-          <a class="next-page" href="changes">
-              <div class="page-info">
-                <div class="context">
-                  <span>Next</span>
-                </div>
-                <div class="title">Changelog</div>
-              </div>
-              <svg><use href="#svg-arrow-right"></use></svg>
-            </a>
-          <a class="prev-page" href="benchmarks">
-              <svg><use href="#svg-arrow-right"></use></svg>
-              <div class="page-info">
-                <div class="context">
-                  <span>Previous</span>
-                </div>
-                <div class="title">Benchmarks</div>
-              </div>
-            </a>
-        </div>
-        <div class="bottom-of-page">
-          <div class="left-details">
-            <div class="copyright">
-                Copyright &#169; 2022, Niels Martignène
-            </div>
-            Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
-            <a href="https://github.com/pradyunsg/furo">Furo</a>
-          </div>
-          <div class="right-details">
-            <div class="icons">
-            </div>
-          </div>
-        </div>
-      </footer>
-    </div>
-    <aside class="toc-drawer">
-      <div class="toc-sticky toc-scroll">
-        <div class="toc-title-container">
-          <span class="toc-title">
-            Contents
-          </span>
-        </div>
-        <div class="toc-tree-container">
-          <div class="toc-tree">
-            <ul>
-<li><a class="reference internal" href="#">Contributing</a><ul>
-<li><a class="reference internal" href="#bugs-and-feature-requests">Bugs and feature requests</a></li>
-<li><a class="reference internal" href="#build-from-source">Build from source</a><ul>
-<li><a class="reference internal" href="#windows">Windows</a></li>
-<li><a class="reference internal" href="#other-platforms">Other platforms</a></li>
-</ul>
-</li>
-<li><a class="reference internal" href="#running-tests">Running tests</a></li>
-<li><a class="reference internal" href="#todo-list">Todo list</a></li>
-<li><a class="reference internal" href="#code-style">Code style</a></li>
-</ul>
-</li>
-</ul>
-          </div>
-        </div>
-      </div>
-    </aside>
-  </div>
-</div><script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
-    <script src="_static/jquery.js"></script>
-    <script src="_static/underscore.js"></script>
-    <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
-    <script src="_static/doctools.js"></script>
-    <script src="_static/scripts/furo.js"></script>
-    </body>
-</html>