Next
Previous
Contents
Note: This section is not a Unix tutorial. You need to know some basic
Unix commands to compile and install xmame/xmess.
- GNU make is MANDATORY in ALL Systems, even if you use a different
compiler.
- On all platforms zlib is now needed since the core uses it.
- You are encouraged to use GNU development environment gcc, gmake gnu-
ar. Lots of problems found due to the very permissive syntax in gcc, so
if you use a strictly ANSI C compiler, you'll get lots of warnings, and
if the version of xmame/xmess is not fully debugged, compilation errors.
- Xmame compilation breaks when using egcs-1.1.x or gcc-2.95, use
-fno-strict-aliasing
to fix it. gcc-2.95.1 does work with
-fstrict-aliasing
, and gives a nice speed increase.
- See
compile-notes-section
for platform specific compiling
information.
- Download the xmame/xmess source files archive.
- 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.
- Rename the source files archive so its extension is .gz so gzip
doesn't complain. For example, change
xmame-0.34b1.1.tgz
to xmame-0.34b1.1.tar.gz
- Use gzip -d to uncompress the archive. For example, type:
gzip -d xmame-0.34b1.1.tar.gz
- Extract the files with tar. For example, type:
tar xvf xmame-0.34b1.1.tar
- 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.
- Edit the file
makefile.unix
and change the settings according
to your system. The default makefile.unix
is pre configured to run
under X11/Linux. Be careful editing this file.
If you want to build for multiple display targets you can repeat steps
8 - 11 as many times as wanted, no need todo a make clean.
- Compile xmame/xmess by typing:
make -f makefile.unix
- If the compile fails, report the problem to the author.
- To install xmame/xmess, type:
make -f makefile.unix install
*** YOU MAY NEED TO BE root TO PERFORM STEP 11 ***
- In your home directory, create a subdirectory called .xmame.
- From the top of the source tree, copy the file doc/xmamerc.dist to
the ${HOME}/.xmame/xmamerc directory. (For xmess do this for xmessrc)
- If desired copy xmamerc.dist to the global xmamerc location
as "xmamerc" (For mess copy xmamerc.dist to xmessrc).
The global xmamerc location is defined in makefile.unix.
- Edit ${HOME}/.xmame/xmamerc to match your preferences.
(For xmess edit ${HOME}/.xmess/xmessrc)
- Be sure that DISPLAY and PATH enviromment variables are
set correctly.
- Make sure your ROM images are installed.
- Start X-Windows. (Unless you compiled for a different display method
in which case you skip this step.)
- Start xmame/xmess. For example:
/usr/games/xmame.x11 dkong
- If you get an error about gz_open and a bunch of other
functions not found during linking read:
"Why do I get gz_open symbol not found while compiling?" in section 1.
- Be sure that the rompath in your xmamerc/xmessrc is correct,
see also:
"What about directories, where should I put the ROM's and
config files ?"
- Check xmamerc/xmessrc: is it configured correctly?
- Is the program in your PATH?
- The svgalib/xf86_dga build of xmame/xmess requires setuid root.
Are your permissions correct?
- Check
compile-notes-section
of this document for operating
system specific notes. You may need to do something special for your
operating system.
- Are you getting messages that you are missing files? Maybe you
are missing PROMs. See the question on PROM files in
faq-section
of this document.
- Check
faq-section
.
- See the file
known.bugs
for known problems.
- Try asking the friendly folks at the newsgroup alt.game.mame to
see if anyone else has experienced the same problem as you.
- Try mailing to the xmame mailinglist
If all else fails, send email to the current maintainer of the
xmame/xmess project. See
mail-section
for email addresses.
Next
Previous
Contents