binutils-wasm

This project is divided into several components:

• A WebAssembly version of GNU Binutils, which is available as an NPM package for use in both Node.js and browser environments. (This README is about this component)
• A command-line tool that is based on the aforementioned package. It provides a variety of platform-specific Binutils that can be used on any device supporting Node.js (work in progress).
• A static web page built on the aforementioned package that offers assembly and disassembly for multiple architectures. It's accessible directly through a web browser. (Refer to the GitHub page for more details)

Introduction

This is a WebAssembly port of GNU Assembler (GAS). It's available as an NPM package that can be used in Node.js or browser environments. The package is built using EMScripten.

Features

• Supports mainstream architectures that are supported by GNU Assembler
• Nearly identical in functionality to the original GNU Assembler

Usage

To use it, install the package from NPM and import it into your project.

npm install @binutils-wasm/gas

import loader from "@binutils-wasm/gas";

const gas = await loader("x86_64-linux-gnu");
await gas({
  print: console.log,
  printErr: console.error,
  arguments: ["-c", "a.s"],
  preRun: [
    (m) => {
      m.FS.writeFile("a.s", "movq %rax, %rbx");
    },
  ],
});

License

This project is licensed under the GPLv3 License in accordance with the license of GNU Binutils.

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 3 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.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.