Next Previous Contents

2. Compiling, Setting Up and Starting Xmame/Xmess

Note: This section is not a Unix tutorial. You need to know some basic Unix commands to compile and install xmame/xmess.

2.1 Requirements

2.2 Follow these steps to compile xmame/xmess

  1. See Compile Notes for Specific Operating Systems for platform specific compiling information.
  2. See Display subsystem specific comments and notes for special display methods information.
  3. Download the xmame/xmess source files archive.
  4. Move the xmame/xmess source files archive to a suitable work directory. When you extract the archive, sub directories will be created under the work directory.
  5. Rename the source files archive so its extension is .gz, so that gzip doesn't complain. For example, change xmame-0.34b1.1.tgz to xmame-0.34b1.1.tar.gz
  6. Use gzip -d to uncompress the archive. For example, type:
    gzip -d xmame-0.34b1.1.tar.gz
     
    
  7. Extract the files with tar. For example, type:
    tar xvf xmame-0.34b1.1.tar
     
    
  8. After extracting the archive, change to the subdirectory created by the extraction process. For example, after extracting the xmame-0.34b1.1.tar archive, a directory named xmame-0.34b1.1 is created. Change to it. This directory is the top of the source tree.
  9. Copy makefile.unix to Makefile, the distributed Makefile is used for development and is not a good starting point!
  10. Edit the Makefile and change the settings according to your system. The default makefile.unix is preconfigured to run under X11/Linux. Be careful editing this file.
  11. Compile xmame/xmess by typing:
    make
     
    
  12. If the compile fails, report the problem to the author.
  13. *** YOU MAY NEED TO BE root TO PERFORM THIS STEP *** To install xmame/xmess, type:
    make install
     
    
  14. If you want you can now build xmame/xmess for another target/display method, otherwise skip to the next step.
    1. If you want to also build for another target repeat repeat the "make" and "make install" steps adding "TARGET=<target>" to the make command for example:
      make TARGET=mess
      make install
        
      
    2. If you want to also build for another display method repeat the "make" and "make install" steps adding "DISPLAY_METHOD=<method>" to the make command for example:
      make DISPLAY_METHOD=svgalib
      make install
        
      
    3. You can also combine the 2 above for example:
      make TARGET=mess DISPLAY_METHOD=svgalib
      make install
        
      
  15. In your home directory, create a subdirectory called .xmame.
  16. From the top of the source tree, copy the file doc/xmamerc.dist to the ${HOME}/.xmame/ directory. (For xmess do this for xmessrc)
  17. If desired, copy xmamerc.dist to the global xmamerc location as "xmamerc" (for xmess, copy xmamerc.dist to xmessrc). The global xmamerc location is defined in the Makefile.
  18. Edit ${HOME}/.xmame/xmamerc to match your preferences. (For xmess, edit ${HOME}/.xmess/xmessrc)
  19. Be sure that the DISPLAY and PATH environment variables are set correctly.
  20. Make sure your ROM images are installed.
  21. Start the X-Window System. (Unless you compiled for a different display method in which case you skip this step.)
  22. Start xmame/xmess. For example:
    /usr/games/xmame.x11 dkong
     
    

2.3 If you have problems compiling, installing and starting xmame/xmess...

If all else fails, send email to the current maintainer of the xmame/xmess project. See Mail for contact information.

2.4 Compile Notes for Specific Operating Systems

Linux i386

Linux i386 is the platform I (Hans) use, so xmame should compile without any hassles on Linux i386. (Note: The same is true for Lawrence Gold.)

Some bugs have been found and worked around when using gcc27x, please use egcs if available. If more gcc bugs popup, egcs will be made mandatory, but I hope that won't be necessary.

It has been reported that some SoundBlaster AWE32 and VIA-82cxxx (onboard) cards do not correctly manage get_freespace(). If so, you'll get some audio_ioctl() calls failed messages in console, and if everything goes right a message that xmame/xmess is falling back to timer based audio. If this doesn't happen and sound isn't right, try forcing timer-based audio by starting xmame/xmess with -timer.

SB64/128PCI cards (Ensoniq 137x-based cards) also do not correctly manage get_freespace(). Unfortunately, this doesn't result in failed ioctl's; instead, they just ignore the calls. Xmame tries to autodetect this and to fall back to timer-based audio. If this doesn't happen and sound isn't right, try forcing timer based audio by starting xmame/xmess with -timer.

Some have reported success using ALSA with OSS emulation (see http://www.alsa-project.org/). If you experience the above problems, this would certainly be worth a try.

Also, I've tested sound using the PC-Speaker driver module. It works!! But it needs -timer. Again, it should do this automagically, but you know what to do if it doesn't.

Distribution-Specific Comments:

Linux PowerPC

Linux PowerPC should work from now on. Here's an email from Andreas Varga sid@skater.htu.tuwien.ac.at, the Linux/PowerPC maintainer, describing the necessary steps:

Required changes to compile xmame 0.34b3.1 on Linux/PowerPC with SVGALIB

Makefile:

Required changes to compile xmame 0.34b3.1 on Linux/PowerPC with X11

Makefile:

Another thing... sound is not working, because sound drivers support is currently under development in Linux/PPC kernels...there is an old driver that is a hacked Soundblaster driver, and newer 2.1.1xx kernels have a sound drivers based on Amiga DMA sound drivers... Once this issues are settled there should be a full OSS-compatible driver... sound should work then...

I can't speak about Joystick support...

The original Linux/PPC target changes in the Makefile were done by me, but there are some other changes required to get it to compile... Starting from October I will have some more time to work on this, and I'll keep you updated...

Cheers, Andreas

IRIX

Use the generic unix arch for those machines that have no sound support installed (xmame/xmess uses the dmedia package or the newer AL package on IRIX systems).

Silicon Graphics provides several native compilers. xmame/xmess has been compiled and tested with the normal cc. There were some problems with this when using -n32 for new style 32bit code. It does work when using -o32 for oldstyle 32 bit code. It should now also work with -n32 which is much faster.

The use of DCC is not recommended (anymore) since it's a C++ compiler and thus won't even compile xmame/xmess out of the box due to uncasted mallocs. Changing all these mallocs would be crazy, esp. since they are not only in the osd part, but also in the core which is not under our control. Besides that, mame is normal C, so please compile it with a normal C compiler.

Some problems have been reported using the GNU linker. It's recommended that you use the native one.

HPUX

Use the generic unix arch. In HP-UX, gcc and gnu-make are MANDATORY.

ULTRIX

Use the generic unix arch.

Notes received from Danny dboxhoor@iso.vilspa.esa.es

VERY IMPORTANT!!!

The xmame/xmess CPU emulators access memory through pointers which are sometimes cast to illegal addresses - as far as the MIPS CPU is concerned. The Ultrix operating system is aware of that and fixes this "unaligned data access".

Depending on your system setup, lots of warnings are generated for certain games. Fortunately these messages can be disabled by executing the command "uac p 0" in the same shell where xmame/xmess will be running.

UPDATE: The new -DALIGN_INTS switch in the makefile fixes these unaligned accesses in the source which is probably a lot faster than hot fixing them in the kernel segfault handler.

Use gnu make.

Compile with the `c89' compiler. Though `gcc' has no problems with compiling and optimizing xmame/xmess, the resulting `c89' executable is faster on an empty machine (read: xmame can use all cpu & memory without competing with other high priority processes), so you can set `frameskip' to 1.

When compiling with `c89 -O2' don't forget to also use `-Olimit 1000'. If 1000 is not enough, the compiler will tell you to increase it.

SunOS & Solaris

There are 2 relevant architecture options available in the makefile:

    ARCH = generic : use this for old SunOs running on Sparcs,
                     but a Sparc running Solaris will usually
                     handle this option too.
    ARCH = solaris : this is the one you should use for Sparcs
                     running Solaris.        

Currently sound is not supported under sunos. The solaris arch does support audio.

If you are using Sun's OpenWindows implementation of X11, then make sure that the X11INC and X11LIB variables in the X11 Options section of the makefile are set properly. (There are already entries for the standard OpenWin directory there that you can uncomment.)

Of course, if you are compiling for X11 then you need to set these variables properly, no matter what implementation of X11 you are using! :)

If you are using Sun's SunPro cc compiler, then the following optimisation flags have been reported to be good:

    OPTFLAGS    = -fast -xO4 -native

Finally, there has been a case of the xmame compilation processes breaking over the "ar" program. Most Solaris installations will include a set of utilities that conform to the XPG4 standard, usually in the "/usr/xpg4/bin" directory. The XPG4 version of "ar" should be avoided like the plague. Ensure that the "/usr/ccs/bin" appears in your path before the "/usr/xpg4/bin" directory and everything should go smoothly.

PLEASE NOTE : There is currently not much support for SunOS/Solaris. If you have any trouble, try to fix it yourself. If you succeed, send a message to the mailing list detailing what you did. If you don't succeed, send a message anyway and someone _may_ be able to help you. Either way, this is the only way that problems with xmame on SunOS/Solaris will get fixed.

Openstep

You must use the OpenStep gnumake, not make. You must also use the NeXT/Apple cc rather than gcc. Also use only the optimisation options as recommended for OpenStep in the makefile, others will cause the resulting executable to crash. The OpenStep assembler on i386 architectures is incompatible with the mame assembler CPU cores and thus you must use the C versions (Use i386-noasm instead of i386 when compiling for i386).

The supplied complier is based on gcc 2.7.2.1 which will not compile src/profiler.c without crashing. To get around this you must turn off + optimisation when this crash occurs, re-make to compile this file only, then stop the make, re-enable optimisation, and continue.

On an OpenStep keyboard the functions keys do not all operate as expected. Using the command key in conjuction with a number key generates the equivalent function key within xmame, with 0, - and = + representing F10, F11 and F12 resepectively. Also note that the ALT + keys cannot be mapped. As most games tend to use this as the default fire button it is exteremly useful to remap this globally the first time you run xmame.


Next Previous Contents