JASM Assembler

A modern, user-friendly x86_64 assembler for Linux.

Features

Simple, intuitive syntax
Support for most x86_64 instructions
ELF and raw binary output formats
Fast compilation times
Comprehensive error messages

Installation

Building from Source

Clone the repository:

git clone https://github.com/jotrorox/jasm.git
cd jasm

Build the project:

cc -o nob nob.c
./nob --type Release

The build system supports different build types:

Debug: Includes debugging symbols and ASAN (Address Sanitizer)
Release: Optimized build with maximum performance
Verbose: Includes additional warnings and debug information

Additional build options:

--verbose: Show detailed build information
--output <dir>: Specify output directory (default: build)
--clean: Clean the build directory
--verbose: Show verbose output
--quiet: Suppress output
--cc <path>: Specify the C compiler (default: cc)
--help: Show help message

System Requirements

Linux x86_64
A C compiler (cc in your path)

Usage

Basic usage:

jasm input.jasm [output]

Options:

-h, --help: Display help message
-v, --verbose: Enable verbose output
-V, --version: Display version information
-f, --format <format>: Specify output format (elf, bin)

Examples

Hello World

# Example: Print "Hello, world!" to stdout
data msg "Hello, World!\n"

# sys_write(stdout, msg, 14)
mov rax, 1       # sys_write
mov rdi, 1       # stdout
mov rsi, msg     # message
mov rdx, 14      # length
call

# sys_exit(0)
mov rax, 60      # sys_exit
mov rdi, 0       # status
call

Documentation

For detailed documentation, visit our documentation website.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Johannes (Jotrorox) Müller

README