Provided by:
freeciv-server_2.1.3-1_i386 
NAME
civserver - The server for the Freeciv game
SYNOPSIS
civserver [ -a|--auth ] [ -b|--bind address ] [ -d|--debug level_number
] [ -e|--exit-on-end ] [ -f|--file filename ] [ -G|--Guests ] [
-g|--gamelog filename ] [ -h|--help ] [ -l|--log filename ] [
-M|--Metaserver address ] [ -m|--meta ] [ -N|--Newusers ] [ -p|--port
port ] [ -q|--quitidle time ] [ -r|--read filename ] [ -S|--Serverid id
] [ -s|--saves directory ] [ -v|--version ]
DESCRIPTION
Freeciv is a free turn-based multiplayer strategy game, in which each
player becomes the leader of a civilization, fighting to obtain the
ultimate goal: To become the greatest civilization.
Players of Civilization II® by Microprose® should feel at home, since
one aim of Freeciv is to have compatible rules.
Freeciv is maintained by an international team of coders and
enthusiasts, and is easily one of the most fun and addictive network
games out there!
This is the server program used to establish a Freeciv server - See
also civclient(6)
This manual page only lists the command line arguments. For details of
the directives necessary to configure civserver see the Server Manual
which can be found at http://www.freeciv.org/ as well as the
documentation which is part of the Freeciv distribution.
OPTIONS
The following options are accepted on the command line of the server.
They may not be combined; that is, "civserver -fp savegame.sav 5557"
will not work, instead you would need to enter "civserver -f
savegame.sav -p 5557". All options have a short form (single hyphen and
single letter) and a long form (double hyphen and a complete word);
their effects are identical.
-a, --auth
Enables server authentication and allows access to registered
players only.
-b address, --bind address
Sets the address on which the server will listen for clients.
-d level_number, --debug level_number
Sets the amount of debugging information to be logged in the
file named by the -l option. Acceptable values for the
level_number are:
0 for fatal messages only.
1 for fatal and error messages.
2 for fatal, error and normal messages.
3 for fatal, error, normal, and verbose messages.
-e, --exit-on-end
When a game ends, exit instead of restarting.
-f filename, --file filename
Loads a saved game (filename) into the server before
initialization, instead of starting a new game. This is for
reloading saved games, or for loading scenarios. The
distribution comes with such scenarios, typically stored in
/usr/local/share/freeciv/scenario:
· british-isles-85x80-v2.80.sav
· earth-160x90-v2.sav
· earth-80x50-v2.sav
· europe-200x100-v2.sav
· hagworld-120x60-v1.2.sav
· iberian-peninsula-136x100-v1.0.sav
-G, --Guests
Allow guests to login as ’guest’ when authentication is enabled.
-g filename, --gamelog filename
Defines a log file, filename, to be produced during processing.
This is a game progress log of game-related events recording the
activities of the players.
-h, --help
Prints out a description of the command line options and exits.
-l filename, --log filename
Defines a log file, filename, to be produced during processing.
Use the -d option to set how much is logged. By default, fatal
and normal messages are printed to standard output. With a log
file, such messages go to the log instead.
-M address, --Metaserver address
Specifies the address of the metaserver to send your server’s
information to.
-m, --meta
Directs the server to communicate with a metaserver, a place
where Freeciv servers can publish their presence. Freeciv
clients consult the metaserver to offer users a selection of
games to join. By default the standard Freeciv metaserver is
used. You may specify an alternate metaserver with the -M
option.
-N, --Newusers
Allow new users to login and be registered in the players base
if authentication is enabled.
-p port, --port port
Specifies the TCP port number to which clients will connect;
players must know this number to be able to connect if they are
not to use the default of 5556 decimal. You may need to use this
if 5556 is not available for your use on your system, or if you
would like to run multiple servers on the same system.
-q time, --quitidle time
Quits if no players are present for the specified time, in
seconds, and restarts a new server.
-r filename, --read filename
Specifies a file, filename, of server commands which the server
will automatically read and process, as if you had typed them in
at the server’s prompt. The distribution comes with a few
examples that set options to be similar to Civilization I® and
Civilization II® . The files are named civ1.serv and civ2.serv,
and are typically found at /usr/local/share/freeciv/.
-S, --Serverid id
Sets the server id.
-s directory, --saves directory
Specifies the directory to place save game files created by the
server. This is especially useful when you’re running more than
one server on the same system, as it inhibits your servers from
clobbering other’s save game files.
-v, --version
Causes the server to display its version number and exit.
EXAMPLES
civserver --file oldgame.sav --port 2244
Starts a server on port 2244, loading the save game file
oldgame.sav.
civserver -g gamelog -l logfile -r script -f oldgame.sav.gz -p 2244
Starts a server on port 2244, loading the save game file
oldgame.sav.gz. Game related events are written to gamelog,
other logging information is written to logfile. When the server
starts, it immediately executes the commands contained in
script.
civserver -m -a -q 60 -p 2244 -d 2 -l logfile -r script -s ~/saves
Starts a server on port 2244 with authentication enabled and
communicates its existence to the standard Freeciv metaserver.
Fatal, error, and normal messages are written to logfile. When
the server starts it immediately executes the commands contained
in script. Save game files are stored in the ~/saves directory.
When there are no users on the server for 60 seconds, the server
will restart.
COMMANDS
You may enter commands into the server at any time, either before or
during the running of a game.
Type "help" or "help help" for starters.
FILES
The Freeciv server requires the following files in the Freeciv data
directory, which is /usr/local/share/freeciv by default:
· default/buildings.ruleset
· default/cities.ruleset
· default/game.ruleset
· default/governments.ruleset
· default/nations.ruleset
· default/techs.ruleset
· default/terrain.ruleset
· default/units.ruleset
These are the default rule sets used for the game. Alternate sets of
rules can be used by placing them in a separate directory and using the
rulesetdir command to change your server’s ruleset directory.
Type help rulesetdir for more information.
ENVIRONMENT
The Freeciv server accepts these environment variables:
FREECIV_CAPS
A string containing a list of "capabilities" provided by the
server. The compiled-in default should be correct for most
purposes, but if you are familiar with the capability facility
in the source you may use it to enforce some constraints between
clients and server.
FREECIV_COMPRESSION_LEVEL
Sets the compression level.
FREECIV_DATA_ENCODING
Sets the data encoding (used for data files, savegames, and
network strings).
FREECIV_INTERNAL_ENCODING
Sets the internal encoding (used for GUI strings).
FREECIV_LOCAL_ENCODING
Sets the local encoding (used for terminal output).
FREECIV_MULTICAST_GROUP
Sets the multicast group (for the LAN tab).
FREECIV_PATH
A colon separated list of directories pointing to the freeciv
data directory. By default freeciv looks in the following
directories, in order, for any data files: the current
directory; the "data" subdirectory of the current directory; the
subdirectory ".freeciv" in the user’s home directory; and the
directory where the files are placed by running "make install".
HOME Specifies the user’s home directory.
http_proxy
Set this variable accordingly when using a proxy.
LANG or LANGUAGE
Sets the language and locale on some platforms.
LC_ALL or LC_CTYPE
Similar to LANG (see documentation for your system).
USER Specifies the username of the current user.
BUGS
Please report bugs to http://bugs.freeciv.org/
MORE INFO
The Freeciv homepage is located at http://www.freeciv.org/
Updates and new info is first posted there.
AUTHORS
The Freeciv Team <freeciv-dev AT freeciv.org>.
This manpage was originally put together by Florian Ernst
<florian_ernst AT gmx.net> using the Server Manual and the comments in
the sourcecode. It was updated by Ben Bettin <bwbettin AT gmail.com> to
add new features, integrate information from the website’s online
documentation, and for slight formatting adjustments. Feel free to use
it as you wish.
SEE ALSO
civclient(6) and the Server Manual on the Freeciv homepage.
January 29th 2005 FREECIV(6)