forked from KolibriOS/kolibrios
128 lines
4.0 KiB
Plaintext
128 lines
4.0 KiB
Plaintext
|
|
||
|
README for Linux SVGALib Quake
|
||
|
------------------------------
|
||
|
|
||
|
Requirements:
|
||
|
|
||
|
- SVGALib 1.20 or later (/lib/libvga.so.1.2.10)
|
||
|
- libc 5.2.18 or later (5.0.9 will not work, /lib/libc.so.5.2.18)
|
||
|
- CD-ROM for CDAudio
|
||
|
- Soundcard capable of mmap'd buffers. USSLite 3.5.4 was used to build squake
|
||
|
with. Works fine on SoundBlaster 16 and Gravis Ultrasound MAX.
|
||
|
- SVGALib supported mouse (usually if it works with X, it'll work with
|
||
|
squake).
|
||
|
- Kernel 2.0.24 or later
|
||
|
- untested with 2.1 kernels, your mileage may vary
|
||
|
|
||
|
Here's the release you've been waiting for. Linux squake supports
|
||
|
320x200x256, the various modeX modes (320x400, 360x400, etc) as well as high
|
||
|
res modes if your card is supported by SVGALib. Use the Quake console command
|
||
|
vid_describemodes to list supported modes and the command vid_mode <number> to
|
||
|
change modes.
|
||
|
|
||
|
Full sound support is included. The default sound rate is 16-bit stereo,
|
||
|
11KHz. You can change this in the options section below.
|
||
|
|
||
|
Mouse works great, but SVGALib may not detect a 3-button mouse properly (it
|
||
|
will only use two buttons). Check your /etc/libvga.config (or
|
||
|
/etc/vga/libvga.config for SlackWare users).
|
||
|
|
||
|
**Version 1.1 fixes some crash bugs with the mission packs.
|
||
|
|
||
|
New Command Line Options for Linux SVGAlib Quake
|
||
|
------------------------------------------------
|
||
|
|
||
|
-mem <mb>
|
||
|
Specify memory in megabytes to allocate (default is 8MB, which should be fine
|
||
|
for most needs).
|
||
|
|
||
|
-nostdout
|
||
|
Don't do any output to stdout
|
||
|
|
||
|
-mdev <device>
|
||
|
Mouse device, default is /dev/mouse
|
||
|
|
||
|
-mrate <speed>
|
||
|
Mouse baud rate, default is 1200
|
||
|
|
||
|
-cddev <device>
|
||
|
CD device, default is /dev/cdrom
|
||
|
|
||
|
-mode <modenum>
|
||
|
Use indicated video mode
|
||
|
|
||
|
-nokdb
|
||
|
Don't initialize keyboard
|
||
|
|
||
|
-sndbits <8 or 16>
|
||
|
Set sound bit sample size. Default is 16 if supported.
|
||
|
|
||
|
-sndspeed <speed>
|
||
|
Set sound speed. Usual values are 8000, 11025, 22051 and 44100.
|
||
|
Default is 11025.
|
||
|
|
||
|
-sndmono
|
||
|
Set mono sound
|
||
|
|
||
|
-sndstereo
|
||
|
Set stereo sound (default if supported)
|
||
|
|
||
|
Installation
|
||
|
------------
|
||
|
|
||
|
Boot DOS (I know, but you need it to run the Quake install program) and
|
||
|
install Quake from your Quake CD to a DOS parition.
|
||
|
|
||
|
Boot Linux and make a directory for Quake. Copy everything from the DOS Quake
|
||
|
directory into it. i.e.:
|
||
|
(cd /dos/quake; tar cf - .) | (cd ~/quake; tar xf -)
|
||
|
|
||
|
Place squake into your Quake directory. You must make it setuid root (since
|
||
|
Quake access stuff like direct video writes, the raw keyboard mode, CD, etc).
|
||
|
Quake will setuid back to the normal user as soon as it opens these files.
|
||
|
Make Quake suid root as follows:
|
||
|
chown root squake
|
||
|
chmod 4755 squake
|
||
|
|
||
|
Run squake. I don't recommend running it as root, since all the saved
|
||
|
config.cfg files will be then owned as root. Use your normal account, unless
|
||
|
you do everything as root, then your mileage will vary.
|
||
|
|
||
|
squake may segfault if it tries to initialize your sound card and their isn't
|
||
|
one. Same with the CDROM. If it dies, try it with -nosound and/or
|
||
|
-nocdaudio. If you have a sound card it died on and you know it is
|
||
|
supported by USSLite (the driver that comes with the Linux kernel), let me
|
||
|
know and I'll take a look at it.
|
||
|
|
||
|
It should work with SCSI CDROMs, but is untested.
|
||
|
|
||
|
Full TCP/IP network support is in, including listen and dedicated server
|
||
|
modes. squake makes a nice dedicated server as you don't need the X11
|
||
|
libraries kicking around.
|
||
|
|
||
|
All of the options described in TECHINFO.TXT and MANUAL.TXT from the Quake
|
||
|
distribution will work, 'cept for stuff with vid modes and stuff.
|
||
|
|
||
|
End Notes
|
||
|
---------
|
||
|
|
||
|
Linux SVGALib Quake is *NOT* an officially supported product. Mail about it
|
||
|
will be deleted. Do not email id about this product. If you are having
|
||
|
technical difficultly, you can email me, but make sure you have the correct
|
||
|
kernel, libc, svgalib and other software versions before you email me.
|
||
|
|
||
|
Dave 'Zoid' Kirsch
|
||
|
zoid@threewave.com
|
||
|
Official Quake Unix Port Administrator
|
||
|
|
||
|
Acks
|
||
|
----
|
||
|
|
||
|
Greg Alexander <galexand@sietch.bloomington.in.us> for initial work in SVGALib
|
||
|
support.
|
||
|
Dave Taylor <ddt@crack.com> for basic Linux support.
|
||
|
id Software for Quake and making me port it. :)
|
||
|
|
||
|
Lots of people on #linux, #quake for testing.
|
||
|
|