From 332c858f02daeb24e275b52b1907b9f64f51c35c Mon Sep 17 00:00:00 2001
From: Fabio Scotto di Santolo <fabio.scottodisantolo@gmail.com>
Date: Wed, 2 Jul 2025 12:43:08 +0200
Subject: [PATCH] Initial commit

---
 README.md      | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++
 helloworld.asm | 25 +++++++++++++++++++
 2 files changed, 92 insertions(+)
 create mode 100755 README.md
 create mode 100644 helloworld.asm

diff --git a/README.md b/README.md
new file mode 100755
index 0000000..99b94ce
--- /dev/null
+++ b/README.md
@@ -0,0 +1,67 @@
+# 🧠 Assembly x86 Examples (32-bit) - Intel Syntax
+
+This repository contains a collection of simple **x86 32-bit assembly examples**, written using **Intel syntax**. These examples are meant to help you learn and experiment with low-level programming concepts on the x86 architecture.
+
+## 🛠 Toolchain Used
+
+- **Assembler:** [NASM (Netwide Assembler)](https://www.nasm.us/)
+- **Linker:** `ld` (GNU Linker)
+- **Target OS:** Linux (x86)
+
+## ▶️ How to Compile and Run
+
+Make sure you have `nasm` and `ld` installed. On Debian/Ubuntu:
+
+```bash
+sudo apt update
+sudo apt install nasm
+```
+
+### Compile
+
+```bash
+nasm -f elf32 file.asm -o file.o
+ld -m elf_i386 file.o -o file
+```
+
+### Run
+
+```bash
+./file
+```
+
+### Full Example
+
+```bash
+nasm -f elf32 hello_world.asm -o hello_world.o
+ld -m elf_i386 hello_world.o -o hello_world
+./hello_world
+```
+
+## 📚 Intel Syntax
+
+All source files use **Intel syntax**, where the **destination operand comes first**. For example:
+
+```asm
+mov eax, 1        ; Load 1 into eax
+mov ebx, eax      ; Copy eax into ebx
+mov ecx, [ebx]    ; Load into ecx the value at memory address stored in ebx
+```
+
+## 🧩 Requirements
+
+- 32-bit architecture or compatibility with `elf32`
+- Linux or a compatible environment with `nasm` + `ld`
+- Optional: QEMU or Docker for emulation on pure 64-bit systems
+
+## 📝 License
+
+This project is licensed under the **MIT License**. Feel free to study, modify, and reuse the code.
+
+## 🤝 Contributing
+
+Contributions, improvements, or new demos are welcome! Open an issue or a pull request 🚀
+
+---
+
+> Made with ❤️ for low-level enthusiasts.
diff --git a/helloworld.asm b/helloworld.asm
new file mode 100644
index 0000000..122bf0c
--- /dev/null
+++ b/helloworld.asm
@@ -0,0 +1,25 @@
+;; This is a simple Hello World assembly x86
+;;
+;; Author:  Fabio Scotto di Santolo
+;; Date:    02/07/2025
+
+global _start
+
+section .text:
+_start:
+    ; write text in stdout
+    mov eax, 0x04       ; syscall write
+    mov ebx, 1          ; stdout
+    mov ecx, message
+    mov edx, message_length
+    int 0x80
+
+    ; call exit syscall
+    mov eax, 0x01      ; syscall exit
+    mov ebx, 0x00      ; exit code
+    int 0x80
+
+section .data:
+    message: db "Hello World!", 0xA
+    message_length equ $-message
+