nkeynes@700: =head1 NAME nkeynes@700: nkeynes@1170: lxdream - A Dreamcast emulator nkeynes@700: nkeynes@700: =head1 SYNOPSIS nkeynes@700: nkeynes@700: lxdream [options] [disc-image-file] [program-file] nkeynes@700: nkeynes@700: =head1 DESCRIPTION nkeynes@700: nkeynes@1170: Emulates the Sega Dreamcast console. Lxdream can run games either from disc image files, from progam files or from CD-ROM discs. nkeynes@1170: nkeynes@700: =head1 OPTIONS nkeynes@700: nkeynes@700: =over nkeynes@700: nkeynes@1170: =item B<-a>, B<--aica>=I nkeynes@1170: nkeynes@1170: Run the AICA SPU only, with the supplied program. nkeynes@1170: nkeynes@1170: =item B<-A>, B<--audio>=I nkeynes@700: nkeynes@700: Set the preferred audio driver. If the specified audio driver cannot start, the system nkeynes@700: will try all other available drivers in the standard order. To see which drivers are nkeynes@700: supported, run lxdream -A ? nkeynes@700: nkeynes@1170: =item B<-b>, B<--biosless> nkeynes@1170: nkeynes@1170: Do not load the BIOS rom on startup, even if one is configured. nkeynes@1170: nkeynes@1170: =item B<-c>, B<--config>=I nkeynes@1170: nkeynes@1170: Load configuration information from B instead of the system default nkeynes@700: nkeynes@700: =item B<-d>, B<--debugger> nkeynes@700: nkeynes@700: Launch the debugger on startup (GTK platforms only). nkeynes@700: nkeynes@1170: =item B<-f>, B<--fullscreen> nkeynes@1170: nkeynes@1170: Use this option to start the program in fullscreen mode. nkeynes@1170: nkeynes@1170: =item B<-g>, B<--gdb-sh4>=I nkeynes@1170: nkeynes@1170: Start the GDB remote server on B for SH4. nkeynes@1170: nkeynes@1170: =item B<-G>, B<--gdb-arm>=I nkeynes@1170: nkeynes@1170: Start the GDB remote server on B for ARM. nkeynes@1170: nkeynes@700: =item B<-h>, B<--help> nkeynes@700: nkeynes@700: Print command line usage information nkeynes@700: nkeynes@700: =item B<-H>, B<--headless> nkeynes@700: nkeynes@700: Run in headless mode (no GUI or video output). This is mainly useful for testing CPU nkeynes@700: functions and performance. Equivalent to -V null. nkeynes@700: nkeynes@1170: =item B<-l>, B<--log>=I nkeynes@700: nkeynes@700: Set the system log level to the specified level of verbosity, which must be one of the following options: nkeynes@700: FATAL, ERROR, WARN, INFO, DEBUG, TRACE (non-case-sensitive, and only the first letter is required). The nkeynes@700: default level is WARN. nkeynes@700: nkeynes@1170: =item B<-m>, B<--multiplier>=I nkeynes@700: nkeynes@700: Change the SH4 core clock speed using the supplied floating-point multiplier, where 1.0 nkeynes@700: is full speed, 0.5 is half speed, and so on. The default is 0.5. nkeynes@700: nkeynes@700: =item B<-n> nkeynes@700: nkeynes@700: Don't start running on startup, even if a disc or program file was supplied. By default nkeynes@700: the system will start automatically if a disc or program was given on the command line. nkeynes@700: nkeynes@700: =item B<-p> nkeynes@700: nkeynes@700: Start running on startup, even if no disc or program file was supplied. By default nkeynes@700: the system will only start automatically if a disc or program was given on the command nkeynes@700: line. nkeynes@700: nkeynes@1170: =item B<-t>, B<--run-time>=I nkeynes@700: nkeynes@700: Run the dreamcast for exactly the specified amount of time, and then terminate, ie nkeynes@700: lxdream -pt 5.2 will exit after 5.2 seconds of emulated runtime. Useful for performance nkeynes@700: measurements of arbitrary sections of code. nkeynes@700: nkeynes@1170: =item B<-T>, B<--trace>=I nkeynes@700: nkeynes@700: Activate I/O region tracing for the specified list of MMIO regions. This option is only nkeynes@700: available if lxdream was configured with --enable-trace. If enabled, trace-list may be nkeynes@700: a comma-separated list of 1 or more of the following: ALL, ASIC, AICA0, AICA1, AICA2, AICARTC, nkeynes@700: EXTDMA, PVR2, MMU, UBC, BSC, DMAC, CPG, RTC, INTC, TMU, SCI, and SCIF. nkeynes@700: nkeynes@700: Warning: this option implicitly sets the verbosity level to 'trace', and will generate a huge nkeynes@700: amount of output. nkeynes@700: nkeynes@700: =item B<-u>, B<--unsafe> nkeynes@700: nkeynes@700: Allow unsafe dcload syscalls. Without this option, the only permitted calls are reads, writes, and nkeynes@700: seeks on stdin, stdout and stderr. If you're writing your own code that uses the other syscalls, you nkeynes@700: probably want to enable this. Otherwise it's safer to leave it off. nkeynes@700: nkeynes@700: =item B<-v>, B<--version> nkeynes@700: nkeynes@700: Print the lxdream version string. nkeynes@700: nkeynes@1170: =item B<-V> B nkeynes@700: nkeynes@700: Set the preferred video driver. If the specified video driver cannot start, the system nkeynes@700: will exit with an error. To see the available video drivers, run lxdream -V ? nkeynes@700: nkeynes@700: =item B<-x> nkeynes@700: nkeynes@700: Disable the SH4 translator and run in pure emulation mode. Generally you only want to do this for testing nkeynes@700: purposes (ie if you think you've found a translator bug) as it's much slower this way. nkeynes@700: nkeynes@700: =back nkeynes@700: nkeynes@700: =head1 FILES nkeynes@700: nkeynes@700: =over nkeynes@700: nkeynes@700: =item B<$HOME/.lxdreamrc> nkeynes@700: nkeynes@700: Default user configuration file. This will be created at startup if it doesn't nkeynes@700: already exist, unless an alternative file is specified with -c. nkeynes@700: nkeynes@700: =back nkeynes@700: nkeynes@1170: =head1 AUTHOR nkeynes@1170: nkeynes@1170: Nathan Keynes nkeynes@1170: nkeynes@700: =head1 COPYRIGHT nkeynes@700: nkeynes@1170: Copyright 2005-2011 Nathan Keynes nkeynes@700: nkeynes@700: This program is free software; you can redistribute it and/or modify nkeynes@700: it under the terms of the GNU General Public License as published by nkeynes@700: the Free Software Foundation; either version 2 of the License, or nkeynes@700: (at your option) any later version. nkeynes@700: nkeynes@700: =cut