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	 omit-
	       ted,  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 sta-
	       tus 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  en-
       abled.  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 spec-
	 ified,	only disassemble the current address.
       h[elp]
	 Print help.
       i[nfo]
       status
	 Print the current contents of general-purpose registers and the  cur-
	 rent 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	direc-
	       tory.  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/

FreeBSD	ports 15.0		 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.0>

home | help