Skip to content

calculuswhiz/Assembly-Syntax-Definition

Repository files navigation

Sublime Text: x86 Assembly Syntax Definition (AT&T/GAS)

This is the greatest syntax definition of All Time

Sublime Text syntax definition for x86 assembly (GAS/AT&T syntax)

I do not have plans to support any other syntax type (such as Intel). Sufficient packages already exist.

Covers a lot of instructions for a lot of different cpuid flags, even if you don't have them.

Purpose: I couldn't find any good ones online, so I made one myself for my ECE391 class at UIUC. None of the ones I did find did a good job highlighting the right instructions. This is not to say that this definition is perfect, but for the purposes of your college level systems programming class, it will do just fine.

I have included some test files in the 'test/' directory of this package. Look around if you like. I even included a gdb disas dump, which I think is a good test for efficacy.

Ports to other editors

This has become somewhat of a parent-project for various ports, so here's a list of links to ports I've made:

  • Atom. Same highlighting features. It was a direct JSON->CSON conversion. No snippets.
  • Vim. Probably same highlighting features. Regex syntax was kind of hard to nail down. Might extend with snippet-like features later.
  • Gedit. It's a bit of a weaker port, but it should look reasonably close. It was a bit frustrating to write, with so little documentation around.
  • More perhaps to come later. I currently have no plans to port to Emacs. Writing major modes seems like a major pain compared to how easy it is for Vim. I also will not do Notepad++.

Installation

  • Get Sublime Text.
  • Install "Package Control": https://sublime.wbond.net/installation
  • In your Sublime window menu, go to Preferences>Package Control and type "Install".
  • Type "gasx" to find the package.
  • This has the advantage of automatic updates if a bug is caught.

Manual Install

  • Download the contents of this repo.
  • Extract/copy/Whatever-I-Don't-Care all files into your 'Packages' directory.
    • This is easily accessible from Preferences>Browse Packages...
    • You could always just git pull in the 'Packages' directory.
  • If all this has failed, you're on your own. Good luck.

Sublime should automatically take care of the syntax highlighting, so there's no need to restart.

If you feel the directions are unclear, please tell me. Or tell Dennis, so we can make fun of you later.

Pull requests and/or bug reports are always welcome.

Features (Secret Q/A):

  • Can't remember a system call number? Start with your architecture (32/64) and type the call you want (e.g. mmap, read), press tab/enter, and let the autocomplete do the rest.
    • E.g. I want to use mmap on x64. I type 64mmap, enter, and it expands to #define SYS_MMAP $9.
  • Can't remember displacement syntax? Just start typing "displace" and select the helper option in autocomplete. Then tab through the arguments.
  • How do I start a standalone assembly program? Type skel32 or skel64, autocomplete. Compiles with gcc -nostdlib.
  • How do I set up a stack frame for calling a function? Type newframe32 or newframe64.

Demo on gdb disassembly log: Demo