1------+
2 NAME |
3------+-----------------------------------------------------------------
4
5 wmQStat - monitor various Internet game servers
6
7---------+
8 CREDITS |
9---------+--------------------------------------------------------------
10
11Written by:
12
13 Alexey Dokuchaev (danfe@regency.nsu.ru)
14
15Additional credits go to (in alphabetical order by last name):
16
17 Dave Clark (clarkd@skynet.ca)
18 Antoine Nulle (warp@xs4all.nl)
19 Martijn Pieterse (pieterse@xs4all.nl)
20 Artem Yusipov (artem@alawar.com)
21
22----------+
23 SYNOPSIS |
24----------+-------------------------------------------------------------
25
26 wmqstat [option(s) ...]
27
28-------------+
29 DESCRIPTION |
30-------------+----------------------------------------------------------
31
32wmQStat is a dockable front-end to qstat by Steve Jankowski, a popular
33command-line monitor of lots of Internet game servers, i.e. Quake/W/2/3,
34Hexen2/W, HL/CS/HL2, Tribes/2, RtCW, Unreal/UT200x, Heretic2, Descent3,
35DOOM III, FarCry, to name a few (this list is by far not complete).
36
37It takes list of servers (type and address) to monitor from the
38configuration file (~/.wmqstat by default) and reports current map,
39number of connected clients, and players' names with their frags (or
40ping) in a neat LCD fashion (much like wminet dockapp, which had been
41taken as a base for creating wmqstat). Servers are switched by left
42clicking on active display area, frags or ping mode is selected by
43right clicking, respectively. The list of players is scrollable with
44a mouse wheel.
45
46It should compile and run flawlessly under FreeBSD (both -STABLE and
47-CURRENT), NetBSD, Linux (probably any distro), and Solaris; may be
48something else. Feel free to port to more platforms, and report the
49results! ;-)
50
51Supported window managers include WindowMaker, AfterStep, as well as
52BlackBox, FluxBox, and Waimea. Rumors were that FVWM can eat it too.
53
54------+
55 BUGS |
56------+-----------------------------------------------------------------
57
58Currently, the following issues are considered bugs:
59
60 - If you supply some inherently wrong arguments to qstat it will
61 keep trying and trying to stat that server. Even if qstat had
62 returned an exit code of -1, it will not give up. This is because
63 there is no easy and clean way to obtain exit code that program
64 returned from popen(), at least none that I'm aware of.
65
66 - FLAG_PLAYER_TEAMS and alike are not supported. Only FFA servers
67 currently, sorry. (Any takers?)
68
69 - No manpage. ;-)
70
71If you happen to find any bugs in wmqstat, please send a detailed
72bug report to danfe@regency.nsu.ru. If you can code, you could try
73fix it yourself, and submit patches back!
74
75------------+
76 LEGAL CRAP |
77------------+-----------------------------------------------------------
78
79Copyright (c) 2003-2005 Alexey Dokuchaev. All rights reserved.
80
81Redistribution and use in source and binary forms, with or without
82modification, are permitted provided that the following conditions
83are met:
841. Redistributions of source code must retain the above copyright
85 notice, this list of conditions and the following disclaimer.
862. Redistributions in binary form must reproduce the above copyright
87 notice, this list of conditions and the following disclaimer in
88 the documentation and/or other materials provided with the
89 distribution.
90
91THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS''
92AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
93THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS
95BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
96CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
97SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
98BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
99WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
100OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
101IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
102