Skip to content

GDB extension that adds an 'assemble' command, which assembles ARM one-line instructions and data.

License

Notifications You must be signed in to change notification settings

SantiagoRomani/gdb_arm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gdb_arm

Inline assembler of ARM assembly instructions and data directives for gdb:
assemble is a user command extension for assembling ARM instructions right in gdb’s console.
This command is implemented in python 2.7. Its source code is allocated within the ´inline-assembly´ directory.

Purpose

I created this command to allow ARM learners to type machine language instructions (and data directives) directly in the gdb’s console.
assemble transforms a single assembly line (typed after the command) into machine-level bytes, and copies those bytes into the memory space of the ARM simulator managed by the arm-eabi-gdb debugger.
After byte insertion, one should be able to test how those instructions work by executing them with regular gdb commands (stepi, nexti, continue, etc.).
This way, it is possible to check out the behavior of tiny programs or single instructions quickly, avoiding the burden of the full development process (creating a project, creating a source file, defining segments and main routine, assembling and linking, loading the executable, etc.).

Related

The interested machine language learners can look for much more elaborated user commands intended for enhancing native gdb’s functionality. Namely, one can check out the following github projects: GEF, gdb-dashboard or pwngdb. I think GEF is the only one that allows assembling ARM code inside gdb, though.
One can also find other environments specifically designed to learn ARM machine language, such as VisUAL or gdbgui.
However, my goal is much more modest, since I just wanted the assembly command, so I decided to build my own lightweight gdb’s python extension.

Requisites

To run the python scripts that make the assembly, you will need a version of arm-eabi-gdb compiled with the python flag enabled, pointing to a Python 2.7 installation in your hard drive. I also recommend enabling the gdb’s textual user interface (TUI), but it is not mandatory.
Unfortunately, I found that latest gdb versions can NOT execute fresh ARM instructions inserted with the assemble command. I only was able to exec fresh instructions with version 7.3.1 (or older), but perhaps it would also work in newer versions with a proper gdb configuration, I don’t know.
Finally, you’ll need to load (and start) any ´.elf´ program into gdb before you can insert new ARM data and instructions. For this purpose, I've included a file called ´dummy.elf´ in the ´resources´ directory of this repo, which is an ARM executable containing a mere sequence of 15 nop instructions (mov r0, r0) followed by an infinite loop.

Installation

You must copy the ´inline-assembly´ directory into your gdb's python directory (´<gdb's binary directory>/../share/gdb/python´).
To enable the new assemble command, you must type the following command in gdb's console:

(gdb) source <path>/install_assemble.gdb

where <path> must be a valid path to file ´install_assemble.gdb´, available in top level of this repo.
You can copy it into any directory of your convenience. The ideal place would be the gdb's system init directory, e.g. ´<gdb's binary directory>/../share/gdb/system-gdbinit´, so that gdb will automatically load it every time it starts. However, I couldn't make it work, despite I set up the proper gdb's compilation flag for setting up the system init directory (?).
A workaround for an automatic installation of the assemble command can be to insert the previous sourcing command into your local ´.gdbinit´ file.
Besides, you will have to modify the following python instruction in the ´install_assemble.gdb´ file:

sys.path[0] = 'c:\\URV\\bmde\\devkitPro\\insight\\share\\gdb\\python\\inline-assembly'

The path shown in previous source code is pointing to my local installation of gdb's python directory, but you must include your own path so that Python can find the bunch of scripts that conform the assemble command.

Usage

(gdb) assemble ADDRESS INSTRUCTION

You can also use shortcuts for assemble, like assem or as.
For ADDRESS, you can type any hexadecimal value that fits in 32 bits, such as 0x82FC, or you can simply type > for assembling into next memory address after last assembled instruction or data.
For INSTRUCTION, you can type any data directive or ARM instruction recognized by the GNU GAS assembler.
Examples:

(gdb) as 0x200 .byte 34, -1, 0x6A, 'h', 89
(gdb) as > .hword 0b10010011101010, 35921
(gdb) assem 0x8000 add r0, pc, lsr #2
(gdb) assem > eorhi r8, #0b011000
(gdb) assemble > umull r4, r5, r8, r3
(gdb) as 0x8018 cmp r5, r6, asr r2
(gdb) as > bne 0x802C
(gdb) as > ldsh r12, [sp, #0x80]
(gdb) as > ldr r4, =0x8BE45002
(gdb) as > strgtb r0, [lr, r2, lsl #3]

To check the assembly, you can use gdb commands like disassemble ADDRESS or x /i ADDRESS. If your gdb is TUI enabled, you can also view the machine language code in a curses-driven window, but you must update its content by moving the view around (e.g., pressing any arrow key) after the inline assembly.
Next screenshot shows previous example instructions assembled gdb’s ARM simulator memory and displayed with TUI asm window:
gdb_screenshot.

Releases

No releases published

Packages

No packages published