Corresponding source of the Verilog toolchain ============================================== The six programs served in the directory above this one are a build of Icarus Verilog: ivlpp.mjs, ivlpp.wasm the preprocessor ivl.mjs, ivl.wasm the compiler, with the vvp code generator and six VPI modules linked in vvp.mjs, vvp.wasm the simulator, with the same six VPI modules linked in Each is Icarus Verilog 13.0 (tag v13_0, commit dfeee909ed9f20b4870dd93423156c0170c0e1ff) with the three patches listed below, compiled to WebAssembly with Emscripten 6.0.12 and statically linked with Emscripten's runtime libraries. The .wasm file is the program; the .mjs file is the JavaScript that loads and runs it. This directory offers their complete corresponding source from the same place the programs are served, as section 3 of the GNU General Public License allows. Licence ------- Icarus Verilog, Copyright (c) Stephen Williams and contributors. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. COPYING, in this directory, is a copy of that licence, identical to the one in the upstream source archive. The three patches and the build files below are distributed under the same terms. One linked source file, vpi/mt19937int.c, is under the GNU Lesser General Public License version 2 or later, which is compatible. Runtime libraries linked into each program ------------------------------------------ Their source is in the Emscripten 6.0.12 source archive below; each licence text is at the path shown inside it. musl libc MIT system/lib/libc/musl/COPYRIGHT libc++ Apache-2.0 WITH LLVM-exception system/lib/libcxx/LICENSE.TXT libc++abi Apache-2.0 WITH LLVM-exception system/lib/libcxxabi/LICENSE.TXT compiler-rt Apache-2.0 WITH LLVM-exception system/lib/compiler-rt/LICENSE.TXT dlmalloc public domain (CC0) system/lib/dlmalloc.c Emscripten's loader MIT or University of Illinois/ LICENSE JavaScript (.mjs) NCSA Open Source License musl: Copyright (c) 2005-2020 Rich Felker, et al. Emscripten: Copyright (c) 2010-2014 Emscripten authors, see the AUTHORS file in its archive. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. What is offered --------------- COPYING the GNU General Public License, version 2 iverilog-v13_0.tar.gz the upstream source, as GitHub serves the v13_0 tag emscripten-6.0.12.tar.gz the Emscripten source, as GitHub serves the 6.0.12 tag build/ every file that controls the build: the Dockerfile and what decides its build context, the scripts, the patches and the build's README Every object, with its sha256: --- source objects (written by verilog:source:pin) --- https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/COPYING sha256 8177f97513213526df2cf6184d8ff986c675afb514d4e68a404010521b880643 https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/.dockerignore sha256 628c5755dff050d27f0b665695c05b5be9d034546d3e72971a7d269b055381fa https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/Dockerfile sha256 5f9e38c804b36328ab7df060f97a69464706e6311f48e67213e857d8a89f361d https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/README.md sha256 b638f426362d11e10f43b7279892ec3e7c4c24e23c904ed23087be3827d5b857 https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/build-wasm.sh sha256 685c60f0ed0b6f1650f1258f80e2e16931f6a9b6331e0708b3dc0d18a1507a29 https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/build.sh sha256 c6f6b5a7f17a41e1f6302a1b0aa1b8c76d82cc97b0931d5fc2e442fbc6915d23 https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/patches/0001-builtin-module-table.patch sha256 5df9eb41b8ee4868b0094ce0eff008d1c634a42e344c739ae0db96d6359fc2d9 https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/patches/0002-ivl-builtin-target.patch sha256 a967f1cf316b9897f25bef8635e9b956b24f1169536192eadef66951c4688ed2 https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/patches/0003-builtin-vpi-loader.patch sha256 5d4a83ee95856ec5a2bfb6a78cb837508a2db996c5f3a24f7f973a7a037cca4a https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/build/post.js sha256 6eb8c5cc8215941312d4dc3dd9e9ac1c7ce6cbe1e53af8968327b1afee66b172 https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/emscripten-6.0.12.tar.gz sha256 795ef929e4dee52bf03de3742c4252bb121e742afac896378d969b5da2db86eb https://cdn.prepshotz.com/verilog/13.0-42e2625bddc8/source/iverilog-v13_0.tar.gz sha256 c897bbfa9848688982c6d5c30529fc29d68df0b9ff22ffa73bad89db73a7ce49 --- end of source objects --- How to rebuild -------------- 1. Download every file under build/ into one directory, keeping patches/ as a subdirectory of it. Below, that directory is called icarus-verilog/. 2. Put iverilog-v13_0.tar.gz in icarus-verilog/.cache/. 3. With bash, curl, sha256sum and Docker installed, run: bash icarus-verilog/build.sh build.sh checks the tarball's sha256, then builds the three programs inside the Docker image emscripten/emsdk:6.0.12@sha256:77638e6c215a65f25a704c0c831d5c2463a8c0468a58c6cb82489dbe621dfa05 (that image's compiler is Emscripten 6.0.12, the source archive above), with bison, flex and gperf at the versions the Dockerfile pins, from the dated Ubuntu archive snapshot it names. It installs the six files and their sha256 in ~/.prepshotz/verilog-toolchain/13.0/. The build is reproducible: they come out byte-identical to the six programs served here. README.md in build/ describes the build in full.