https://github.com/scottgriv/assembly-welcome
Welcome to my GitHub! (In Assembly and Binary).
https://github.com/scottgriv/assembly-welcome
assembly assembly-language assembly-language-programming assembly-x86 assembly-x86-64 binary
Last synced: about 2 months ago
JSON representation
Welcome to my GitHub! (In Assembly and Binary).
- Host: GitHub
- URL: https://github.com/scottgriv/assembly-welcome
- Owner: scottgriv
- License: unlicense
- Created: 2023-08-11T04:00:49.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-09T04:05:56.000Z (5 months ago)
- Last Synced: 2025-03-28T18:32:28.777Z (2 months ago)
- Topics: assembly, assembly-language, assembly-language-programming, assembly-x86, assembly-x86-64, binary
- Language: Assembly
- Homepage:
- Size: 385 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---------------
Assembly Welcome Program
Assembly Welcome Program is a simple program that prints a welcome message to the console.
---------------
## Table of Contents
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Assembling the Program](#assembling-the-program)
- [Linking the Object File](#linking-the-object-file)
- [Running the Program](#running-the-program)
- [Troubleshooting](#troubleshooting)
- [License](#license)
- [Credits](#credits)
## Getting Started
This section will guide you through the steps to get the assembly program up and running on your machine.
### Prerequisites
Before you begin, ensure you have the following installed:
- NASM (Netwide Assembler): For assembling the `.asm` file.
- A Linux environment: The program is designed to run on Linux.
- A text editor: To view or modify the source code.
### Assembling the Program
1. Open Terminal: Open your terminal in the directory where your `.asm` file is located.
2. Assemble the Code: Use NASM to assemble the `.asm` file.
3. Since the file is named `welcome.asm`, the command will be:
```bash
nasm -f elf32 welcome.asm -o myprogram.o
```
This command creates an object file named `myprogram.o`.
### Linking the Object File
1. Link the Object File: Next, link the object file to create an executable. The following command links `myprogram.o` to create an executable named `myprogram`:
```bash
ld -m elf_i386 -s -o myprogram myprogram.o
```
`-m elf_i386` specifies that the program is for 32-bit architecture.
### Running the Program
1. Execute the Program: Run the program by typing:
```bash
./myprogram
```
Upon execution, the program will display the message defined in the .data section of your assembly code.
### Troubleshooting
- If you encounter permission issues while executing, you may need to change the permissions of the executable using `chmod +x myprogram`.
- Ensure that the NASM syntax matches the version you are using, as there might be slight differences in syntax across different versions.
# Resources
- [Assembly Language](https://en.wikipedia.org/wiki/Assembly_language)
- [Assembly Language Tutorial](https://www.tutorialspoint.com/assembly_programming/index.htm)
## License
This project is released under the terms of **The Unlicense**, which allows you to use, modify, and distribute the code as you see fit.
- [The Unlicense](https://choosealicense.com/licenses/unlicense/) removes traditional copyright restrictions, giving you the freedom to use the code in any way you choose.
- For more details, see the [LICENSE](LICENSE) file in this repository.
## Credits
**Author:** [Scott Grivner](https://github.com/scottgriv)
**Email:** [[email protected]](mailto:[email protected])
**Website:** [scottgrivner.dev](https://www.scottgrivner.dev)
**Reference:** [Main Branch](https://github.com/scottgriv/assembly-welcome)
---------------
