Man page - mgba(6)
Packages contains this manual
Manual
MGBA (6) Games Manual 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 value s 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 < jeffrey@endrift.com >
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/ Debian July 29, 2015 MGBA (6)