Annotation of uae/config.h, revision 1.1.1.3

1.1       root        1:  /* 
                      2:   * UAE - The Un*x Amiga Emulator
                      3:   * 
                      4:   * User configuration options
                      5:   *
1.1.1.2   root        6:   * Copyright 1995, 1996 Bernd Schmidt
1.1       root        7:   */
                      8: 
                      9: /*
1.1.1.2   root       10:  * Please note: Many things are configurable with command line parameters,
                     11:  * and you can put anything you can pass on the command line into a 
                     12:  * configuration file ~/.uaerc. Please read the documentation for more
                     13:  * information.
1.1       root       14:  */
                     15: 
                     16: /*
1.1.1.3 ! root       17:  * This variable was introduced because a program could do a Bcc from
        !            18:  * whithin chip memory to a location whitin expansion memory. With a
        !            19:  * pointer variable the program counter would point to the wrong location.
        !            20:  * With this variable unset the program counter is always correct, but
        !            21:  * programs will run slower (about 4%).
        !            22:  * Usually, you'll want to have this defined.
        !            23:  */
        !            24: #define USE_POINTER
        !            25: 
        !            26: /*
        !            27:  * The blitter emulator contains a few optimizations. You can choose one out
        !            28:  * five methods.
        !            29:  * 0: Old uae-0.1 style blitter. Slow.
        !            30:  * 2: This is the most reliable one.
        !            31:  * 3: This tries to do 32 bit accesses when possible. It will not work on
        !            32:  *    most RISC chips (expect to see bus errors)
        !            33:  * 4: Like 2, but the blitter finishes instantly. May lead to 
        !            34:  *    incompatibilities, since some programs depend on the blitter delay.
        !            35:  * 5: Like 3, but the blitter finishes instantly.
        !            36:  * I recommend methods 4 and 5 only for Workbench based applications, although
        !            37:  * well-written games should have no problems with these.
        !            38:  */
        !            39: #define FAST_BLITTER 2
        !            40: 
        !            41: /*
        !            42:  * CPU level: 0 = 68000, 1 = 68010, 2 = 68020/68881
        !            43:  * If configured for 68020, the emulator will be a little slower.
        !            44:  * Proper 68020 support is new in this version, but it ought to be reasonably
        !            45:  * stable.
        !            46:  */
        !            47: #define CPU_LEVEL 0
        !            48: 
        !            49: /*
1.1.1.2   root       50:  * Define this when you are compiling UAE for the first time. If it works, you
                     51:  * can try to undefine it to get (much) better performance. It does not seem
                     52:  * to work on all machines, though.
1.1       root       53:  */
1.1.1.2   root       54: #define DONT_WANT_SHM
1.1       root       55: 
                     56: /*
1.1.1.2   root       57:  * If you are running UAE over the network on a remote X server, this can
                     58:  * boost performance quite a bit. It can even boost performance on a 
                     59:  * non-networked system.
                     60: #define LOW_BANDWIDTH
1.1       root       61:  */
                     62: 
                     63: /*
1.1.1.2   root       64:  * When these two are enabled, a subset of the ECS features is emulated.
                     65:  * Actually, it's only the chip identification and big blits. This may be
                     66:  * enough to persuade some ECS programs to run.
                     67:  * DON'T enable SuperHires or Productivity modes. They are not emulated,
                     68:  * and will look very messy. NTSC doesn't work either.
1.1       root       69:  */
1.1.1.2   root       70: #define ECS_AGNUS
                     71: #define ECS_DENISE
1.1       root       72: 
1.1.1.3 ! root       73: /*
        !            74:  * If you don't have any sound hardware, or if you don't want to use it, then
        !            75:  * this option may make the emulator a little faster. I don't really know
        !            76:  * whether it's worthwhile, so if you have any results with this one, tell
        !            77:  * me about it.
        !            78: #define DONT_WANT_SOUND
        !            79:  */
        !            80: 
        !            81: /*
        !            82:  * If you don't care about games, this may make the CPU emulator run faster,
        !            83:  * but it will take longer to complete one frame. For UltraSparc owners this
        !            84:  * may be a good way to lower the key repeat rate.
        !            85: #define FASTER_CPU
        !            86:  */
        !            87: 
        !            88: /*
        !            89:  * When USE_COMPILER is defined, a m68k->i386 instruction compiler will be
        !            90:  * used. This is experimental. It has only been tested on a Linux/i386 ELF
        !            91:  * machine, although it might work on other i386 Unices.
        !            92:  * This is supposed to speed up application programs. It will not work very
        !            93:  * well for hardware bangers like games and demos, in fact it will be much
        !            94:  * slower. It can also be slower for some applications and/or benchmarks.
        !            95:  * It needs a lot of tuning. Please let me know your results with this.
        !            96:  * The second define, RELY_ON_LOADSEG_DETECTION, decides how the compiler 
        !            97:  * tries to detect self-modifying code. If it is not set, the first bytes
        !            98:  * of every compiled routine are used as checksum before executing the
        !            99:  * routine. If it is set, the UAE filesystem will perform some checks to 
        !           100:  * detect whether an executable is being loaded. This is less reliable
        !           101:  * (it won't work if you don't use the harddisk emulation, so don't try to
        !           102:  * use floppies or even the RAM disk), but much faster.
        !           103: #define USE_COMPILER
        !           104: #define RELY_ON_LOADSEG_DETECTION
        !           105:  */
        !           106: 
1.1.1.2   root      107: /***************************************************************************
1.1.1.3 ! root      108:  * Operating system specific options
        !           109:  */
        !           110: 
        !           111: /*
        !           112:  * Define this if you have the AF System and want sound in UAE.
        !           113:  * You also have to set the right paths in the Makefile.
        !           114: #define AF_SOUND
        !           115:  */
        !           116: 
        !           117: /*
        !           118:  * Define this if you have a Solaris box with sound hardware
        !           119: #define SOLARIS_SOUND
1.1       root      120:  */
                    121: 
                    122: /*
                    123:  * Define if you have installed the Linux sound driver and if you have read
                    124:  * the section about sound in the README.
1.1.1.3 ! root      125:  * Enable sound at run-time by passing the -S parameter with a value >= 2.
1.1       root      126: #define LINUX_SOUND
                    127:  */
                    128: 
                    129: /*
                    130:  * Try defining this if you don't get steady sound output. 
                    131: #define LINUX_SOUND_SLOW_MACHINE
                    132:  */
                    133: 
                    134: /***************************************************************************
                    135:  * Support for broken software. These options are set to default values
                    136:  * that are reasonable for most uses. You should not need to change these.
                    137:  */
                    138: 
                    139: /*
                    140:  * Some STUPID programs access a longword at an odd address and expect to
                    141:  * end up at the routine given in the vector for exception 3.
1.1.1.2   root      142:  * (For example, Katakis does this). And yes, I know it's legal, but it's dumb
                    143:  * anyway.
1.1       root      144:  * If you leave this commented in, memory accesses will be faster,
                    145:  * but some programs may fail for an obscure reason.
                    146:  */
                    147: #define NO_EXCEPTION_3
                    148: 
                    149: /*
                    150:  * If you want to see the "Hardwired" demo, you need to define this.
                    151:  * Otherwise, it will say "This demo don't like Axel" - apparently, Axel
                    152:  * has a 68040.
                    153: #define WANT_SLOW_MULTIPLY
                    154:  */
                    155: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.