README.md

Learn x86 Assembly on a Mac

• Are you trying to read x86-64 Assembly Language Programming with Ubuntu?
• Are you on a Mac?
• This Repo's for You

Setup

1. Install Homebrew if you don't already have it
2. brew cask install docker
3. Run make hello.test

How It Works

The Makefile sets up a Docker container running the appropriate version of Ubuntu for you to follow along with Jorgensen's book. The yasm, ld, and gdb commands are all executed inside the container, but you can still edit your source files (and see the output!) from your Mac. Thanks to Docker's adoption of Apple's Hypervisor, we don't actually have to acknowledge that there's a virtual machine here! 🎉

Doing Your Own Thing

1. Write your program in whatever.s
2. Write your GDB Script in whatever.gdb
3. Run make whatever.test

Pro Tips

• In Calculator.app, press ⌘3 to open "Programmer Mode" (Hex conversions and bitwise arithmetic).

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.