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