alien-arena-server — wrapper script to run an Alien Arena dedicated server.

Synopsis

alien-arena-server [OPTIONS] [PARAMETERS]...
Available options.
[-h|--help] [-q|--quiet] [-s|--service] [-k|--kill] [-Q|--query] [-r|--rcon]

Description

This manual page documents briefly the alien-arena-server command.

alien-arena-server is a wrapper script used for running and maintaining Alien Arena dedicated servers. It calls other scripts ('launch-server', 'kill-runaway-crded', 'svstat', and 'rcon') depending on which option is chosen. It also calls the 'crded' binary itself if -q, --quiet, or no option is used.

Options

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.
-h, --help
Show summary of options.
-q, --quiet
Disable console output. Only used when calling the 'crded' binary itself.
-s <configfile>, --service <configfile>
Calls 'launch-server', which is a shell script designed to emulate running crded as a persisant service under linux using a server configuration file <configfile>.

/usr/share/games/alien-arena/arena/server.cfg is a suitable <configfile> that is already installed with the alien-arena-data package. <configfile> can be specified as a path inside the .alien-arena directory which is a directory inside your home directory <$HOME/.alien-arena>. <configfile> can also be specified by its full path in this system.
-k, --kill
Calls 'kill-runaway-crded', which is a shell script to kill all dedicated server processes. Useful when a server session was started with -s or --service option.
-Q, --query
Calls 'svstat' which is a ruby script that will query local servers and produce some nice output for server admins.
-r <server:port> password <commandstring>, --rcon <server:port> password <commandstring>
Calls 'rcon' which is a ruby script that sends rcon commands to servers. <server:port> is the IP address and port number of the server. "password" is the password on the server. <commandstring> is any rcon commands to pass to the server.

Parameters

[PARAMETERS] could be any parameter that can be passed to the script that will be called or the binary 'crded'. For example, when using the -s or --service option, <configfile> is a parameter. Below is a list of the available parameters for each option.
-s, --service [PARAMETERS]
<configfile> - Any acceptable server configuration file such as /usr/share/games/alien-arena/arena/server.cfg.
-r, --rcon [PARAMETERS]
<server:port> password <commandstring> - <server:port> is the IP address and port number of the server. "password" is the password on the server. <commandstring> is any rcon commands to pass to the server.
When calling the 'crded' binary itself, any series of console codes can be passed to it. Alien Arena uses Quake 2 based console codes. A listing of these codes can be found <http://console.planetquake.gamespy.com/commands/quake_2.html>. Most of the codes described at this webpage will work for Alien Arena.

Author

See the copyright </usr/share/doc/alien-arena-server/copyright> for contributers to Alien Arena.