~ubuntu-branches/ubuntu/hardy/openarena/hardy-backports

« back to all changes in this revision

Viewing changes to code/unix/LinuxSupport/index.html

  • Committer: Bazaar Package Importer
  • Author(s): Bruno "Fuddl" Kleinert
  • Date: 2007-01-20 12:28:09 UTC
  • Revision ID: james.westby@ubuntu.com-20070120122809-2yza5ojt7nqiyiam
Tags: upstream-0.6.0
Import upstream version 0.6.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head>
 
2
  <title>Linux Quake III Arena Known issues</title></head>
 
3
 
 
4
<body text="#000000" bgcolor="#ffffff">
 
5
<font size="+2"><b>Linux Quake III Arena Known issues</b></font><br>
 
6
<i>Known issues and frequently asked questions - 1.32b</i><br>
 
7
<br>
 
8
<a href="mailto:ttimo@idsoftware.com">TTimo</a><br>
 
9
<i>Changes history</i><br>
 
10
2004.2.20 Last update<br>
 
11
2001.6.18 Initial version
 
12
<hr size="1"><br>
 
13
<font size="+1">Current topics</font>
 
14
<ul>
 
15
  <li><a href="#install">Installation instructions</a></li>
 
16
  <li><a href="#setupfiles">What do I do with a .x86.run file?</a></li>
 
17
  <li><a href="#glibc">The setup crashes with <i>Segmentation fault "$setup" "$@" 2>/dev/null</i></a></li>
 
18
  <li><a href="#bsd">Installation on BSD</a></li>
 
19
  <li><a href="#auth">CLIENT_UNKNOWN_TO_AUTH</a></li>
 
20
  <li><a href="#pk3">Sys_Error: Couldn't load default.cfg / Sys_Error: FS_FreeFile(
 
21
NULL )</a></li>
 
22
  <li><a href="#setupbug29h">I get <i>./setup.sh {: ==: binary operator expected</i>
 
23
when running the setup?</a></li>
 
24
  <li><a href="#hints">The game doesn't start, I have performance problems,
 
25
etc.</a></li>
 
26
  <li><a href="#aureal">Aureal sound drivers</a></li>
 
27
  <li><a href="#nosound">The sound doesn't work / sound crashes</a></li>
 
28
  <li><a href="#discuss">Where can I report bugs and discuss about linux
 
29
Quake III Arena?</a></li>
 
30
  <li><a href="#gameso">The *.so files are not in the setups? (<i>cgamei386.so
 
31
qagamei386.so uii386.so</i>)</a></li>
 
32
  <li><a href="#vm_game">I get <i>Sys_Error: Sys_LoadDll(..) failed dlopen()
 
33
completely!</i> when running quake3?</a></li>
 
34
  <li><a href="#3dnow">I have an AMD CPU and a kernel 2.4.*, Quake III Arena
 
35
is slowing down to a complete stop after a while?</a></li>
 
36
  <li><a href="#gamma">How do I set up the gamma correction?</a></li>
 
37
  <li><a href="#browser">Servers don't show up in the ingame browser</a></li>
 
38
  <li><a href="#libsafe">Detected an attempt to write across stack boundary</a></li>
 
39
  <li><a href="#libmesa">libMesaVoodooGL.so</a></li>
 
40
  <li><a href="#UDPwide">Running a LAN dedicated server with multiple network
 
41
interfaces</a></li>
 
42
  <li><a href="#64bits">Setup and execution on 64 bits CPUs</a></li>
 
43
  <li><a href="#links">Links</a></li>
 
44
</ul>
 
45
<hr size="1"><font size="+1"><a name="install"><b>Installation instructions</b></a></font>
 
46
<a name="install"><br>
 
47
</a>
 
48
<p><a name="install">Linux Quake III Arena is using a graphical installer
 
49
(based on Loki software's </a><a href="http://www.icculus.org/loki_setup/">Setup Graphic Installer
 
50
</a>). However, since it's a Point Release, you need a retail CD-ROM of  Quake
 
51
III Arena to perform a complete installation (and optionally your Quake III:
 
52
Team Arena CD-ROM). This process is documented in the <a href="http://zerowing.idsoftware.com/linux/q3a/INSTALL">INSTALL</a>file
 
53
(this file is also in the setups, it's default location is /usr/local/games/quake3/INSTALL
 
54
.. you can run the PR setup and read it to finish the installation afterwards).</p>
 
55
<font size="+1"><a name="setupfiles"><b>What do I do with a .x86.run file?</b></a></font>
 
56
<a name="setupfiles"><br>
 
57
</a>
 
58
<p>Those are setup files, meant to be executed. They
 
59
come with graphical  installation UI or console installation, depending on
 
60
what's available on your system. You may need to <i>chmod +x file.x86.run</i>
 
61
to make them executable.</p>
 
62
<font size="+1"><a name="glibc"><b>The setup crashes with <i>Segmentation fault "$setup" "$@" 2>/dev/null</i></b></a></font>
 
63
<p>This is happening on glibc 2.3 systems such as RedHat 9 and Suze. The text mode installer will crash. If you can do a graphical installation, make sure you have Gtk1 installed and avoid the text installer altogether.
 
64
If you are doing a remote installation (such as a dedicated server through ssh), you need to use a newer text mode installer. Run the installer with <i>--keep</i> to extract the files 
 
65
(look for a <i>setup*</i> directory in the current directory for the extracted setup). 
 
66
Then replace <i>setup.data/bin/Linux/x86/setup</i> by <a href="http://zerowing.idsoftware.com/linux/setup-RH9/setup">this newer version</a>. Run <i>setup.sh</i> at top level and things should work fine.</p>
 
67
<p>
 
68
<b>Update</b>: Turns out this solution is working for RTCW and ET, but not for Q3 (because the last q3 setup uses an older version of the installer). Will update a specific solution for Q3 'soon'.
 
69
</p>
 
70
<font size="+1"><a name="bsd"><b>Installation on
 
71
BSD</b></a></font><a name="bsd"><br>
 
72
</a>
 
73
<p><a name="bsd">The linux binaries will run fine on the BSD family (FreeBSD,
 
74
NetBSD and OpenBSD) with the linux binary compatibility software. However
 
75
if you are getting the  error message <i>ELF binary type "0" not known</i>
 
76
while installing or trying to run the binaries, that means you need to run
 
77
<i>brandelf</i> on the files.</a></p>
 
78
<p><a name="bsd">If it's a setup problem, proceed with the following steps:
 
79
</a></p>
 
80
<pre><a name="bsd">./linuxq3apoint-1.31.x86.run --keep<br>brandelf -t Linux setup.tmp/setup.data/bin/FreeBSD/x86/setup<br>cd setup.tmp<br>sh ./setup.sh<br></a></pre>
 
81
<p><a name="bsd">The --keep option will extract the files and leave them
 
82
somewhere below your current directory. Depending on the game (Q3 or RTCW)
 
83
and the setup version, your mileage may vary (setup.tmp or another directory).</a></p>
 
84
<p><a name="bsd">The game binaries might need to be brandelf'ed too, with
 
85
a command such as</a></p>
 
86
<pre><a name="bsd">brandelf -t Linux /usr/local/games/quake3/quake3.x86<br></a></pre>
 
87
<a name="bsd"></a><font size="+1"><a name="auth"><b>CLIENT_UNKNOWN_TO_AUTH</b></a></font>
 
88
<a name="auth"><br>
 
89
</a>
 
90
<p><a name="auth">Graeme Devine recently updated his <i>.plan</i> with very
 
91
complete </a><a href="http://www.webdog.org/cgi-bin/finger.plm?id=279&amp;time=20011210020942" target="_new">information about CLIENT_UNKNOWN_TO_AUTH errors</a>.</p>
 
92
<p>
 
93
See some additional information from the <a href="http://www.gameadmins.com/modules.php?name=Mail_List">gameadmins.com mailing list</a>:
 
94
</p> 
 
95
<pre>If the server you are playing on and the auth server don't see you as the
 
96
same IP (for instance you are trying to play on a public internet server
 
97
that's on your LAN, and your internet access is using NAT), then it won't
 
98
work.
 
99
 
 
100
It used to work in 1.31, and it doesn't in 1.32. PunkBuster requires
 
101
reliable auth of the players. What you can do:
 
102
 
 
103
- run a server with sv_strictauth 0 and you'll be able to join your
 
104
server. This will be the same behaviour as 1.31
 
105
 
 
106
- connect to a server on the internet before you connect to your local
 
107
server (this will trigger your IP into the cache of the auth server for
 
108
15mn and let you in to your local server).
 
109
 
 
110
- setup two NATs, one for your client one for your server and make sure
 
111
your server and Id's auth see the same IP. (this one ain't for network
 
112
setup newbies)
 
113
</pre>
 
114
<font size="+1"><a name="pk3"><b>Sys_Error: Couldn't load default.cfg / Sys_Error:
 
115
FS_FreeFile( NULL )</b></a></font><br>
 
116
<p>If you get one of these errors after installing Quake III Arena or Return
 
117
To Castle Wolfenstein, it means that the engine didn't find all the required
 
118
.pk3 files. Either you didn't copy them, or you copied them to the wrong
 
119
place. Check the INSTALL instructions for the game for more details, make
 
120
sure they are in baseq3/ for quake3 (missionpack/ for TA files) and main/
 
121
for Return To Castle Wolfenstein.</p>
 
122
<font size="+1"><a name="setupbug29h"><b>I get <i>./setup.sh {: ==: binary
 
123
operator expected</i> when running the setup?</b></a></font><a name="setupbug29h"><br>
 
124
</a>
 
125
<p><a name="setupbug29h">This is a known issue to 1.29h setups and prior.
 
126
It happens on systems with bash  version &lt; 2.*. There are several solutions:<br>
 
127
- Upgrade bash to something more recent and run the setup again - Run the
 
128
setup with the --keep option. It will fail but it will leave a <i>setup-full</i>
 
129
directory. You can then copy the files manually from that dir. - Once you
 
130
used the --keep option above, you can edit setup.sh and replace  occurences
 
131
of == by =. Then run setup.sh and the installer will execute.</a></p>
 
132
<a name="setupbug29h"></a><font size="+1"><a name="hints"><b>The game doesn't
 
133
start, I have performance problems, etc.</b></a></font><br>
 
134
<p>The first thing to do is to check on the forums and various FAQs (this
 
135
one, but  there are others. See the <a href="#links">links</a>). The Quake3World
 
136
forums have a great search function.</p>
 
137
<p>Before reporting the problem to <a href="mailto:ttimo@idsoftware.com">me</a>
 
138
make sure it's an issue with the game, and not an issue with your  OS/OpenGL/sound
 
139
configuration. Common OS issues are listed in this FAQ. You should make sure
 
140
you have OpenGL configured correctly (by checking if <i>gears</i>is running
 
141
for instance, and how well it runs). And see if non-Id linux games are running
 
142
fine too.</p>
 
143
<p>When you are going to report a bug, first make sure you are using the
 
144
latest version of the game. Include the game version in your report.</p>
 
145
<p>Include general information about your OS:<br>
 
146
</p>
 
147
<ul>
 
148
  <li>Motherboard brand, CPU type, RAM</li>
 
149
  <li>distribution name and version</li>
 
150
  <li>kernel / OS info (from <i>uname -a</i>)</li>
 
151
  <li>libc version (<i>ls -l /lib/libc.so.*</i>)<br>
 
152
 please specify if you can if the libc is your distribution's standard
 
153
version, or if you compiled yourself, and what binary target was used (x86,
 
154
or AMD, i686 etc.)</li>
 
155
</ul>
 
156
<p>If it's a problem with the client, send the output of <i>glxinfo</i>.</p>
 
157
<p>If you have an nvidia board, send the output of <i>cat /proc/nv/card0</i>
 
158
</p>
 
159
<p>Send output of the run:<br>
 
160
run the game with <i>+set developer 1</i> option, and send the output. You
 
161
can do something like <i>quake3 +set developer 1 &amp;&gt;q3run.log</i>.</p>
 
162
<p>If it's a crash, you can send a backtrace of the game running  through
 
163
<i>gdb</i>.</p>
 
164
<p>You can also send a log of the game running with <i>strace</i>:</p>
 
165
<pre>cd /usr/local/games/quake3<br>strace -o ~/strace.log ./quake3.x86<br></pre>
 
166
<p>NOTE: please <b>avoid</b> sending me the <i>strace</i> of <i>/usr/local/games/quake3/quake3</i>,
 
167
which is a shell script wrapper and probably no interest to your problem.
 
168
</p>
 
169
<font size="+1"><a name="aureal"><b>Aureal sound drivers</b></a></font><a name="aureal"><br>
 
170
</a>
 
171
<p><a name="aureal">It seems that some versions of the Aureal sound drivers
 
172
don't work right with Q3. Last I heard, a kernel upgrade to 2.4.17 + Aureal
 
173
1.1.3, and/or using the  old 1.1.1 drivers from </a><a href="http://aureal.sourceforge.net/" target="_new">Aureal's website</a>fixed
 
174
the problem.</p>
 
175
<p>If you need to know more about this, have a look at this <a href="http://www.quake3world.com/ubb/Forum15/HTML/001348.html" target="_new">Q3W forum thread</a>.</p>
 
176
<font size="+1"><a name="nosound"><b>The sound doesn't work / sound crashes</b></a></font><br>
 
177
<p>The first thing to check is that it is actually a sound related.  Run
 
178
the game with <i>+set s_initsound 0</i> and see what happens.  All problems
 
179
reported so far about sound turned out to be OS/drivers.  Listed below:</p>
 
180
<p>On some Mandrake distributions:<br>
 
181
Check if you are running the enlightenment sound daemon (esd). With <i>ps
 
182
aux | grep esd</i>for instance. It is a multiplexer for /dev/dsp, and might
 
183
block use of /dev/dsp by Quake III Arena. You can disable esd with <i>esdctl
 
184
stop</i> (as root).</p>
 
185
<p><b><a href="http://www.linux-mandrake.com/">Mandrake 8</a></b>'s default
 
186
sound drivers seem broken, installing the <a href="http://www.alsa-project.org/" target="_new">Alsa drivers</a> or the
 
187
 <a href="http://www.opensound.com/">http://www.opensound.com</a>  drivers
 
188
fixes the problem.</p>
 
189
<p>Some beta <a href="http://www.alsa-project.org/" target="_new">Alsa drivers</a>
 
190
have  been reported to crash with Q3. Non-beta ones are fine.</p>
 
191
<p>VIA chipset and AC97 driver:<br>
 
192
This combination is known to have various issues. They have been fixed in
 
193
recent drivers (thanks to Arne Schmitz for the heads up):<br>
 
194
</p>
 
195
<pre>http://sourceforge.net/projects/gkernel has got the up to date version of <br>the AC97 kernel driver. The current version can be found here:<br><br>http://prdownloads.sourceforge.net/gkernel/via82cxxx-1.1.15.tar.gz<br><br>It has working mmap sound, so Q3 shouldn't be a problem any more.<br></pre>
 
196
(thanks to Arne Schmitz for the heads up)<p></p>
 
197
 
 
198
<font size="+1"><a name="discuss"><b>Where can I report bugs and discuss about linux Quake III
 
199
Arena?</b></a></font><a name="discuss"><br>
 
200
</a>
 
201
<p><a name="discuss">Reports bugs to </a><a href="mailto:bugs@idsoftware.com">bugs@idsoftware.com</a>. If you are pretty
 
202
sure this is a linux-only issue, you can shorten the loop by emailing <a href="mailto:ttimo@idsoftware.com">ttimo@idsoftware.com</a> directly.</p>
 
203
<p>You will find the discussion forums for linux Quake III Arena on <a href="http://www.quake3world.com/cgi-bin/forumdisplay.cgi?action=topics&amp;forum=*nix+Discussion&amp;number=15&amp;DaysPrune=30&amp;LastLogin=">
 
204
Quake3World forums</a>. There is for sure a lot of other places to talk about
 
205
linux Quake III Arena, but this is the one we read regularly to track bugs
 
206
and common issues.</p>
 
207
<font size="+1"><a name="gameso"><b>The *.so files are not in the setups?
 
208
(<i>cgamei386.so qagamei386.so uii386.so</i>)</b></a></font><a name="gameso"><br>
 
209
</a>
 
210
<p><a name="gameso">If you still have <i>baseq3/*.so</i> and <i>missionpack/*.so</i>
 
211
files, then those come from the earlier 1.27g beta installation and you should
 
212
REMOVE them. They were provided in 1.27g to go around a bug in the VM code,
 
213
which made win32 VMs incompatible with linux. This problem has been fixed
 
214
and the two files are no longer required.</a></p>
 
215
<p><a name="gameso">If you are upgrading from 1.27g, it is likely that your
 
216
<i>q3config.cfg</i> files are set to use the native libraries (*.so files)
 
217
instead of the bytecode. Run quake3 with the following options to set things
 
218
right:<br>
 
219
<i>quake3 +set vm_game 2 +set vm_cgame 2 +set vm_ui 2</i></a></p>
 
220
<a name="gameso"></a><font size="+1"><a name="vm_game"><b>I get <i>Sys_Error:
 
221
Sys_LoadDll(..) failed dlopen() completely!</i>when running quake3?</b></a></font><a name="vm_game"><br>
 
222
</a>
 
223
<p><a name="vm_game">Try running quake3 with the following options:<br>
 
224
<i>quake3 +set vm_game 2 +set vm_cgame 2 +set vm_ui 2</i><br>
 
225
You should also read the </a><a href="#gameso">above answer</a>.</p>
 
226
<font size="+1"><a name="3dnow"><b>I have an AMD CPU and a kernel 2.4.*,
 
227
Quake III Arena is slowing down to a complete stop after a while?</b></a></font><br>
 
228
<p>It seems the 3DNow! copy routines have issues with the southbridge chip
 
229
in the KT133A, this results in performances degrading while playing for a
 
230
while. Re-compile your kernel without 3DNow! instructions to avoid the problem,
 
231
and wait for newer kernels with better support for 3DNow! / KT133A.</p>
 
232
<font size="+1"><a name="gamma"><b>How do I set up the gamma correction?</b></a></font><br>
 
233
<p>Starting with 1.29h, you can set the gamma correction with the brightness
 
234
slider in the graphical menu (under setup). On some older systems which don't
 
235
have the appropriate XFree86 extensions, you might have to set <b>r_gamma</b>
 
236
manually from the console, and issue a <b>vid_restart</b> command.</p>
 
237
<font size="+1"><a name="browser"><b>Servers don't show up in the ingame
 
238
browser</b></a></font>
 
239
<p>The reason for this has not been clearly identified yet, seems to be related
 
240
to upgrade from older versions. Deleting ~/.q3a/baseq3/q3config.cfg fixes
 
241
the problem (you will have to reconfigure your bindings)</p>
 
242
<font size="+1"><a name="libsafe"><b>Detected an attempt to write across
 
243
stack boundary</b></a></font>
 
244
<p>If Quake III Arena exits with the error "Detected an attempt to write
 
245
across stack boundary", this probably means that you are running libsafe
 
246
on this system. Quake III Arena is compiled with some options that confuse
 
247
libsafe, you should disable it before running. See <a href="http://www.mudos.org/?faq" target="_new">this page</a> for more details.
 
248
</p>
 
249
<font size="+1"><a name="libmesa"><b>libMesaVoodooGL.so</b></a></font>
 
250
<p>The GL driver for Voodoo cards (libMesaVoodoGL.so) used to be distributed
 
251
in older Q3 setups. <b>This is no longer the case.</b> If you have this .so
 
252
in your Quake III Arena directory (<i>/usr/local/games/quake3</i>), you should
 
253
remove it. Any recent/decent linux distribution should support your Voodoo
 
254
card out of the box, otherwise it is recommended that you setup  XFree 4.*
 
255
and the correct DRI infrastructure for it.</p>
 
256
<font size="+1"><a name="UDPwide"><b>Running a LAN dedicated server with
 
257
multiple network interfaces</b></a></font>
 
258
<p>A LAN dedicated server will use the <i>net_ip</i> cvar to identify the
 
259
NIC it is going to use (default is "localhost"). As it only opens one socket,
 
260
it is not possible to have a server broadcast it's packets on all the NICs.
 
261
This can be a problem if the server is serving games for a LAN and runs several
 
262
NICs to access the various sub networks.<br>
 
263
</p>
 
264
<p>The following Linux kernel patch (2.4.19) was provided by Rogier Mulhujzen
 
265
and John Tobin, it will force broadcasts to be emitted on all interfaces:<br>
 
266
<a href="http://zerowing.idsoftware.com/linux/q3a/udp_wide_broadcast.patch">udp_wide_broadcast.patch</a><br>
 
267
<a href="http://zerowing.idsoftware.com/linux/q3a/udp_wide_README.txt">udp_wide_README.txt</a><br>
 
268
The equivalent <a href="http://www.bsdchicks.com/patches/">patch for FreeBSD</a>
 
269
is available too.<br>
 
270
 </p>
 
271
<font size="+1"><a name="64bits"><b>Setup and execution on 64 bits CPUs</b></a></font><br>
 
272
<p>If you are running Linux on a 64 bit CPU (such as AMD's Opteron), and if your system is backwards compatible so that it can execute 32 bits x86 binaries, then the regular Quake III Arena binaries should work (your mileage may vary).</p>
 
273
<p>It's likely that the installer scripts will get confused though, and will refuse to install giving you an error: "This installation doesn't support glibc-2.1 on Linux / unknown". You will have to extract the game files manually by passing --keep on the command line when running the setup script. Once the files are unpacked, you will need to copy them manually to /usr/local/games. You probably want to have a working installation to refer to while doing this. This also applies to RTCW and ET</p>
 
274
<font size="+1"><a name="links"><b>Links</b></a></font><br>
 
275
<p>The <a href="http://www.icculus.org/lgfaq" target="_new">Linux Gamer's
 
276
faq</a> is a very good resource for general Linux Gaming topics.</p>
 
277
<p>Also at <a href="http://www.icculus.org/" target="_new">icculus.org</a>,
 
278
the <a href="http://www.icculus.org/lgfaq/loki/q3faq.html" target="_new">old
 
279
Q3 FAQ from Loki Software</a>.</p>
 
280
<p><a href="http://www.quake3world.com/ubb/Forum15/HTML/000529.html">Quake3World's
 
281
linux FAQ</a></p>
 
282
<br>
 
283
</body></html>