mgba(6)

NAME

mgba – Game Boy Advance emulator

SYNOPSIS

mgba [-123456dfg] [-b biosfile] [-C option=value] [-c cheatfile] [-l loglevel] [-p patchfile] [-s n] [-t statefile] file

DESCRIPTION

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 option=value, --config option=value

Override the given config option with value.

-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

• 64 – in‐game errors

  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.

-t statefile, --savestate statefile

Load initial game state from statefile.

CONTROLS

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

DEBUGGER

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 register, 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.

ENVIRONMENT

XDG_CONFIG_HOME

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

FILES

$XDG_CONFIG_HOME/mgba/config.ini

Default mgba 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.

AUTHORS

Jeffrey Pfau ⟨[email protected]⟩

HOMEPAGE

• mGBA homepage: https://mgba.io/

• Development repository: https://github.com/mgba-emu/mgba

• Bug tracker: https://github.com/mgba-emu/mgba/issues

• Message board: https://forums.mgba.io/