MGBA(6) - Linux man page online | Games

Game Boy Advance emulator.

July 29, 2015
MGBA(6) BSD Games Manual MGBA(6)


mgba — Game Boy Advance emulator


mgba [-123456dfg] [-b biosfile] [-c cheatfile] [-l loglevel] [-p patchfile] [-s n] [-v moviefile] file


mgba is a Game Boy Advance emulator. The options are as follows: -1 Scale the window 1×. -2 Scale the window 2×. -3 Scale the window 3×. -4 Scale the window 4×. -5 Scale the window 5×. -6 Scale the window 6×. -b biosfile, --bios biosfile Specify a BIOS file to use during boot. If this flag is omitted, mgba will use the BIOS specified in the configuration file, or a high‐level emulated BIOS if none is specified. -c cheatfile, --cheats cheatfile Apply cheat codes from cheatfile. -d Start emulating via the command‐line debugger. -f Start the emulator full‐screen. -g Start a gdb(1) session. By default the session starts on port 2345. -l loglevel Log messages during emulation to stdout. loglevel is a bitmask defining which types of messages to log: · 1 – fatal errors · 2 – errors · 4 – warnings · 8 – informative messages · 16 – debugging messages · 32 – stub messages for unimplemented features · 256 – in‐game errors · 512 – software interrupts · 1024 – emulator status messages · 2048 – serial I/O messages The default is to log warnings, errors, fatal errors, and status messages. -p patchfile, --patch patchfile Specify a patch file in BPS, IPS, or UPS format. -s n, --frameskip n Skip every n frames. -v moviefile, --movie moviefile Play back a movie of recording input from moviefile.


The default controls are as follows: A x B z L a R s Start ⟨Enter⟩ Select ⟨Backspace⟩ Load state F1–F9 Save state ⟨Shift⟩‐F1–F9 Frame advance ⟨Ctrl⟩‐n


When mgba is run with the -d option, the command‐line debugger is enabled. It supports the following commands: b[reak] address b[reak]/a address b[reak]/t address Set a breakpoint – ARM (‘/a’), Thumb (‘/t’), or the current CPU mode – at address. c[ontinue] Continue execution. d[elete] address Delete a breakpoint at address. dis[asm] [address [count]] dis[asm]/a [address [count]] dis[asm]/t [address [count]] dis[assemble] [address [count]] dis[assemble]/a [address [count]] dis[assemble]/t [address [count]] Disassemble count instructions starting at address, as ARM (‘/a’), Thumb (‘/t’), or the current CPU mode. If count is not specified, only disassemble the instruction at address. If address is not specified, only disassemble the current address. h[elp] Print help. i[nfo] status Print the current contents of general‐purpose registers and the current program state reg‐ ister, and disassemble the current instruction. n[ext] Execute the next instruction. p[rint] value ... p[rint]/t value ... p[rint]/x value ... Print one or more values as binary (‘/t’), hexadecimal (‘/x’), or decimal. q[uit] Quit the emulator. reset Reset the emulation. r/1 address r/2 address r/4 address Read a byte (‘/1’), halfword (‘/2’), or word (‘/4’) from address. w[atch] address Set a watchpoint at address. w/1 address data w/2 address data w/4 address data Write data as a byte (‘/1’), halfword (‘/2’), or word (‘/4’) to address. w/r register data Write data as a word to register. x/1 address [count] x/2 address [count] x/4 address [count] Examine count bytes (‘/1’), halfwords (‘/2’), or words (‘/4’) from address. If count is not specified, examine 16 bytes, 8 halfwords, or 4 words.


XDG_CONFIG_HOME The location where mgba will look for the configuration directory. If not set, ~/.config is used.


$XDG_CONFIG_HOME/mgba/config.ini Default mgba(6) configuration file. portable.ini If this file exists in the current directory, mgba will read config.ini from the current directory instead of $XDG_CONFIG_HOME/mgba.


Jeffrey Pfau <>


· mGBA homepage: · Development repository: · Bug tracker: · Message board:
BSD July 29, 2015 BSD
This manual Reference Other manuals
mgba(6) referred by mgba-qt(6)
refer to gdb(1)
Download raw manual
Index BSD Games Manual (+53) BSD (+3984) № 6 (+1346)
Go top