WOLFINFO
Section: Linux User's Manual (1)
Updated: 2002-03-21
Index
Return to Main Contents
NAME
wolfinfo - retrieve information from RtCW-servers/masters
SYNOPSIS
wolfinfo
[-hlLvV]
[host[:port]]
[-a
attempts]
[-c
color mode]
[-f
format]
[-m
master]
[-o
protocol]
[-p
port]
[-t
timeout]
DESCRIPTION
Wolfinfo
retrieves host lists from RtCW master servers or game infos
from RtCW game servers and writes it to
stdout.
If the
-l
or the
-L
flag is set
wolfinfo
contacts RtCW master servers and generates a simple game server list
from their responses - in the first case without checking these
game servers. The masters may be specified with
-m.
By default, only one master is contacted, currently
wolfmaster.idsoftware.com:27950.
Game servers given by argument are just added to the list.
This may be useful for persons prefering hostnames instead
of numbers (a master server has no clue on names).
If neither the
-l
nor the
-L
flag is set
wolfinfo
contacts the game server(s) given on the command line by
host:port
where
port
may be omitted and defaults to
27960.
If no game server is specified
wolfinfo
first contacts all masters for building an internal host list.
The output format of the game infos can be controlled by specifying a
format
with
-f.
Additionally the appearance of colored names may be
influenced by
color mode
with
-c.
When contacting game servers the minimum number of
attempts
for reaching a host and a
timeout
may be specified by
-a
and
-t,
respectively. Every game server is contatced at least
attempts
times and each time a request is sent
wolfinfo
waits
timeout
seconds for a response.
OPTIONS
- -h
-
display some helpful information (on
stdout)
and exit successfully
- -l
-
list game servers provided by master(s) without a check
- -L
-
list game servers which
replied on an info and/or status request
- -v
-
increase verbosity level (for
stderr)
by one; may be specified several times
- -V
-
display version and compilation info (on
stdout)
and exit successfully
- -a attempts
-
contact each game server at least
attempts
times if necessary (default
5)
- -c color mode
-
change the appearance of colored names;
0 = print as is;
1 = skip color escape sequences (useful in conjunction with
grep);
2 = normal colored characters (for xterms);
3 = bold colored characters (for console);
default is
2
- -f format
-
change the output format for game server infos, see
PRINT FORMAT
below
- -m master
-
use the master server
master
instead of
wolfmaster.idsoftware.com:27950;
for more than one master server, specify the flag
several times
- -o proto
-
request list for protocol number
proto
game servers from master(s) (default
58)
- -p port
-
use local port
port
(default
27960)
- -t timeout
-
wait at most
timeout
seconds for a game server response (default
2)
PRINT FORMAT
Beside normal characters (for instance '.' and 'Z') and control characters
(for instance '\t' and '\n') which are printed as specified,
the
format
string may contain special control sequences which are replaced by
suitable game server infos (as available). The following
sequences are currently supported:
- %%
-
the '%' itself
- %H
-
hostname (from internal hostlist)
- %P
-
port (from internal hostlist)
- %L
-
terminated sequence of 80 '-'
- %I
-
raw info response
- %o
-
protocol number (from info response)
- %n
-
(possibly colored) game server name (from info response)
- %m
-
map name without extension .bsp (from info response)
- %#
-
number of clients connected to game server (from info response)
- %^
-
maximum number of clients that may connect (from info response)
- %g
-
gametype (from info response)
- %s
-
gameskill (from info response)
- %f
-
friendly fire (from info response)
- %M
-
maximum number of lives (from info response)
- %u
-
tourney (from info response)
- %b
-
punk buster (from info response)
- %S
-
raw status response
- %v
-
game server version (from status response)
- %t
-
timlimit (from status response)
- %p
-
(possibly colored) player names (from status response)
RETURN VALUE
On success, 0 is returned. On error, a value >0 is returned.
ERRORS
- 1
-
a program bug has seen the light (drop me a mail)
- 2
-
the error is different from those explained above
EXAMPLES
Retrieve a listing of RtCW game servers from
wolfmaster.idsoftware.com:27950, explicitely include
the game server at absinth.dyndns.org:27960
and be very talkative:
wolfinfo
-lvvv absinth.dyndns.org |
sort
-n |
less
Print the same list but also contact the servers and skip those which couldn't be reached:
wolfinfo
-Lvvv absinth.dyndns.org |
sort
-n |
less
Generate a hostlist similar to the one from within the game:
wolfinfo
-f '%H:%P\t%n %#(%^) %m\n'
List game servers sorted by map:
wolfinfo
-f '%m\t%H:%P\t%#(%^)\n' |
sort
|
less
Find player named 'Schwanzus^Longus' with various colors (remember
that '^' is a special character for grep):
wolfinfo
-vc 1
-f '%H:%P\t%p\n' |
grep 'Schwanzus.Longus'
AUTHOR
Steffen Solyga <solyga@absinth.net>
SEE ALSO
qstat(1)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- PRINT FORMAT
-
- RETURN VALUE
-
- ERRORS
-
- EXAMPLES
-
- AUTHOR
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 13:08:46 GMT, July 30, 2010