Provided by: cyphesis-cpp_0.6.0-3ubuntu2_amd64 
NAME
cyphesis - cyphesis game server process
SYNOPSIS
/usr/bin/cyphesis [ --section:option=value... ]
DESCRIPTION
The cyphesis program implements the core world server for WorldForge.
OPTIONS
Configuration options are divided up into named sections, which need to be specified when modifying or
overriding the options. In a config file the name of a section is specified in square brackets at the
beginning of the section. On the command line the section is given at the beginning of the option
specification, as shown in the synopsis above.
SERVER OPTIONS
The following options are present in the cyphesis section of the config file, and overriden by specifying
the cyphesis section name on the command line.
directory="/path/to/server/data"
Directory where server data and scripts can be found.
Name of the top level ruleset this server should use.
Normally this directory is set at compile time, but in some rare cases it may be necessary to tell
cyphesis to use a different directory.
confdir="/path/to/server/config"
Directory where server config can be found.
Normally this directory is set at compile time, but in some rare cases it may be necessary to tell
cyphesis to use a different directory.
vardir="/path/to/server/var"
Directory where temporary files can be stored.
Normally this directory is set at compile time, but in some rare cases it may be necessary to tell
cyphesis to use a different directory.
ruleset="mason"
Ruleset name.
Name of the top level ruleset this server should use.
Rulesets are hierarchical, so it is very probable that the top level ruleset will depend on
another ruleset. In order to specify the that ruleset depends on another ruleset, a section is
required in the config file with the name of the ruleset, which contains an additional ruleset
option. On startup the server will look for dependent rulesets until it reaches a ruleset which
has no dependencies, at which point it is assumed the base ruleset has been found.
For example, the mason ruleset depends on the basic ruleset, but the basic ruleset has no
dependencies. The required configuration entries for this arrangement look like this:
[cyphesis]
ruleset="mason"
[mason]
ruleset="basic"
servername=hostname
Server name.
Name that identifies this server. If this option is ommited from the config file, and not provided
any other way, then the system hostname will be used.
tcpport=6767
Network listen port for TCP connections.
Specifies the port number to use to listen for incoming client connections.
unixport="cyphesis.sock"
Local liston socket for Unix domain connections.
Specifies the filename to use to listen for local trusted client connections.
restricted=false
Flag to control restricted mode.
If this option is true the server is run in restricted mode. This means that clients will not be
able to create new accounts, leaving account creation entirelu in the hands of the administrator.
usemetaserver=true
Flag to control use of metaserver.
If this flag is true the server registers its presence with a metaserver.
metaserver="metaserver.worldforge.org"
Hostname to use as metaserver.
The hostname is used as the address of the metaserver where the presence of this server is
registered if the usemetaserver option is enabled.
daemon=false
Flag to control daemon mode.
If this flag is true the server automatically drop into the background after startup. For
convenience the parent process will not complete until the server has completed its setup,
including reading all config information, loading all data from the database, setting up internal
data structures and setting up communications. The exit status of the parent process indicates
whether these steps were completed successfully.
useaiclient=false
Flag to control use of AI client.
If this flag is true the server does not attempt to do any AI simulation internally, and instead
relies on a specialist AI client. This feature is not yet implemented.
dbserver
Remote hostname for the PostgreSQL RDBMS.
If this setting is present the server will use a remote instance of the PostgreSQL RDBMS for its
database requirements at the hostname provided. Do not use this setting unless you need a remote
database for some reason. Specify "localhost" will cause the database module to use remote
connection even though the connection is to the local machine.
dbname="cyphesis"
Name of database to use.
This setting provides the database name the server is to use for its data. If this setting is
omitted, the name cyphesis is used.
dbuser Database account name for access.
This setting provides the username to be used to authenticate with the database. If it is not
included, the username of the user running the server is used.
dbpasswd
Database account password for access.
This setting provides the password to be used to authenticate with the database. PostgreSQL does
not usually require a password when connecting to a PostgreSQL RDBMS on the same system as the
server, when the database username to be used is the same as the user running the server. If this
is the case then the setting must be omitted from the config file.
AUTHOR
Written by Alistair Riddoch.
REPORTING BUGS
Report bugs to <general@worldforge.org>.
COPYRIGHT
Copyright 2004 Alistair Riddoch.
SEE ALSO
cyclient(6), cyphesis-tools(6), cycmd(6)
10 December 2010 CYPHESIS(6)