filename | lxdream.pod |
changeset | 700:4650d0c7f6f9 |
next | 1170:9ffc8295b414 |
author | nkeynes |
date | Sun Dec 14 07:50:48 2008 +0000 (15 years ago) |
permissions | -rw-r--r-- |
last change | Setup a 'proper' stackframe in translated blocks. This doesn't affect performance noticeably, but does ensure that a) The stack is aligned correctly on OS X with no extra effort, and b) We can't mess up the stack and crash that way anymore. Replace all PUSH/POP instructions (outside of prologue/epilogue) with ESP-rel moves to stack local variables. Finally merge ia32mac and ia32abi together, since they're pretty much the same now anyway (and thereby simplifying maintenance a good deal) |
file | annotate | diff | log | raw |
nkeynes@700 | 1 | =head1 NAME |
nkeynes@700 | 2 | |
nkeynes@700 | 3 | lxdream - A dreamcast emulator |
nkeynes@700 | 4 | |
nkeynes@700 | 5 | =head1 SYNOPSIS |
nkeynes@700 | 6 | |
nkeynes@700 | 7 | lxdream [options] [disc-image-file] [program-file] |
nkeynes@700 | 8 | |
nkeynes@700 | 9 | =head1 DESCRIPTION |
nkeynes@700 | 10 | |
nkeynes@700 | 11 | =head1 OPTIONS |
nkeynes@700 | 12 | |
nkeynes@700 | 13 | =over |
nkeynes@700 | 14 | |
nkeynes@700 | 15 | =item B<-A>, B<--audio>=I<audio-driver> |
nkeynes@700 | 16 | |
nkeynes@700 | 17 | Set the preferred audio driver. If the specified audio driver cannot start, the system |
nkeynes@700 | 18 | will try all other available drivers in the standard order. To see which drivers are |
nkeynes@700 | 19 | supported, run lxdream -A ? |
nkeynes@700 | 20 | |
nkeynes@700 | 21 | =item B<-c>, B<--config>=F<config-filename> |
nkeynes@700 | 22 | |
nkeynes@700 | 23 | Load configuration information from F<config-filename> instead of the system default |
nkeynes@700 | 24 | |
nkeynes@700 | 25 | =item B<-d>, B<--debugger> |
nkeynes@700 | 26 | |
nkeynes@700 | 27 | Launch the debugger on startup (GTK platforms only). |
nkeynes@700 | 28 | |
nkeynes@700 | 29 | =item B<-h>, B<--help> |
nkeynes@700 | 30 | |
nkeynes@700 | 31 | Print command line usage information |
nkeynes@700 | 32 | |
nkeynes@700 | 33 | =item B<-H>, B<--headless> |
nkeynes@700 | 34 | |
nkeynes@700 | 35 | Run in headless mode (no GUI or video output). This is mainly useful for testing CPU |
nkeynes@700 | 36 | functions and performance. Equivalent to -V null. |
nkeynes@700 | 37 | |
nkeynes@700 | 38 | =item B<-l>, B<--log>=I<log-level> |
nkeynes@700 | 39 | |
nkeynes@700 | 40 | Set the system log level to the specified level of verbosity, which must be one of the following options: |
nkeynes@700 | 41 | FATAL, ERROR, WARN, INFO, DEBUG, TRACE (non-case-sensitive, and only the first letter is required). The |
nkeynes@700 | 42 | default level is WARN. |
nkeynes@700 | 43 | |
nkeynes@700 | 44 | =item B<-m> B<--multiplier>=I<scale> |
nkeynes@700 | 45 | |
nkeynes@700 | 46 | Change the SH4 core clock speed using the supplied floating-point multiplier, where 1.0 |
nkeynes@700 | 47 | is full speed, 0.5 is half speed, and so on. The default is 0.5. |
nkeynes@700 | 48 | |
nkeynes@700 | 49 | =item B<-n> |
nkeynes@700 | 50 | |
nkeynes@700 | 51 | Don't start running on startup, even if a disc or program file was supplied. By default |
nkeynes@700 | 52 | the system will start automatically if a disc or program was given on the command line. |
nkeynes@700 | 53 | |
nkeynes@700 | 54 | =item B<-p> |
nkeynes@700 | 55 | |
nkeynes@700 | 56 | Start running on startup, even if no disc or program file was supplied. By default |
nkeynes@700 | 57 | the system will only start automatically if a disc or program was given on the command |
nkeynes@700 | 58 | line. |
nkeynes@700 | 59 | |
nkeynes@700 | 60 | =item B<-t>, B<--run-time>=I<seconds> |
nkeynes@700 | 61 | |
nkeynes@700 | 62 | Run the dreamcast for exactly the specified amount of time, and then terminate, ie |
nkeynes@700 | 63 | lxdream -pt 5.2 will exit after 5.2 seconds of emulated runtime. Useful for performance |
nkeynes@700 | 64 | measurements of arbitrary sections of code. |
nkeynes@700 | 65 | |
nkeynes@700 | 66 | =item B<-T>, B<--trace>=I<trace-list> |
nkeynes@700 | 67 | |
nkeynes@700 | 68 | Activate I/O region tracing for the specified list of MMIO regions. This option is only |
nkeynes@700 | 69 | available if lxdream was configured with --enable-trace. If enabled, trace-list may be |
nkeynes@700 | 70 | a comma-separated list of 1 or more of the following: ALL, ASIC, AICA0, AICA1, AICA2, AICARTC, |
nkeynes@700 | 71 | EXTDMA, PVR2, MMU, UBC, BSC, DMAC, CPG, RTC, INTC, TMU, SCI, and SCIF. |
nkeynes@700 | 72 | |
nkeynes@700 | 73 | Warning: this option implicitly sets the verbosity level to 'trace', and will generate a huge |
nkeynes@700 | 74 | amount of output. |
nkeynes@700 | 75 | |
nkeynes@700 | 76 | =item B<-u>, B<--unsafe> |
nkeynes@700 | 77 | |
nkeynes@700 | 78 | Allow unsafe dcload syscalls. Without this option, the only permitted calls are reads, writes, and |
nkeynes@700 | 79 | seeks on stdin, stdout and stderr. If you're writing your own code that uses the other syscalls, you |
nkeynes@700 | 80 | probably want to enable this. Otherwise it's safer to leave it off. |
nkeynes@700 | 81 | |
nkeynes@700 | 82 | =item B<-v>, B<--version> |
nkeynes@700 | 83 | |
nkeynes@700 | 84 | Print the lxdream version string. |
nkeynes@700 | 85 | |
nkeynes@700 | 86 | =item B<-V> I<video-driver> |
nkeynes@700 | 87 | |
nkeynes@700 | 88 | Set the preferred video driver. If the specified video driver cannot start, the system |
nkeynes@700 | 89 | will exit with an error. To see the available video drivers, run lxdream -V ? |
nkeynes@700 | 90 | |
nkeynes@700 | 91 | =item B<-x> |
nkeynes@700 | 92 | |
nkeynes@700 | 93 | Disable the SH4 translator and run in pure emulation mode. Generally you only want to do this for testing |
nkeynes@700 | 94 | purposes (ie if you think you've found a translator bug) as it's much slower this way. |
nkeynes@700 | 95 | |
nkeynes@700 | 96 | =back |
nkeynes@700 | 97 | |
nkeynes@700 | 98 | =head1 FILES |
nkeynes@700 | 99 | |
nkeynes@700 | 100 | =over |
nkeynes@700 | 101 | |
nkeynes@700 | 102 | =item B<$HOME/.lxdreamrc> |
nkeynes@700 | 103 | |
nkeynes@700 | 104 | Default user configuration file. This will be created at startup if it doesn't |
nkeynes@700 | 105 | already exist, unless an alternative file is specified with -c. |
nkeynes@700 | 106 | |
nkeynes@700 | 107 | =back |
nkeynes@700 | 108 | |
nkeynes@700 | 109 | =head1 COPYRIGHT |
nkeynes@700 | 110 | |
nkeynes@700 | 111 | Copyright 2005-2008 Nathan Keynes <nkeynes@lxdream.org> |
nkeynes@700 | 112 | |
nkeynes@700 | 113 | This program is free software; you can redistribute it and/or modify |
nkeynes@700 | 114 | it under the terms of the GNU General Public License as published by |
nkeynes@700 | 115 | the Free Software Foundation; either version 2 of the License, or |
nkeynes@700 | 116 | (at your option) any later version. |
nkeynes@700 | 117 | |
nkeynes@700 | 118 | =cut |
.