Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 1x.

     -2      Scale the window 2x.

     -3      Scale the window 3x.

     -4      Scale the window 4x.

     -5      Scale the window 5x.

     -6      Scale the window 6x.

     -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  disas-
       semble  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 deci-
       mal.
     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

     *	 Development repository

     *	 Bug tracker

     *	 Message board

FreeBSD ports 15.quarterly	  July 29, 2015 			 MGBA(6)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mgba&sektion=6&manpath=FreeBSD+Ports+15.1.quarterly>

home | help