Table of Contents

Name

tms - A Master Server for Torque game engines

Synopsis

tms [options]

Description

The Torque Master Server tms is a meeting place for Torque game servers and clients. When a Torque game server is started, it sends continuous heartbeats to the master server containing information about the game type it offers, if a password is needed to connect etc. A game client can query the master server with a game type and receives a list of matching servers. A game client can then connect to one of those returned servers.

Notes

Command line options have a higher priority than config file options!

Options

Generic

--version (-v)
Shows the program version
--help (-h)
Show a list of possible program options

Networking

--address (-a) <ip>
Listen on IP address <ip>
--port (-p) <port>
Listen on port <port>

Execution

--configfile (-c) <file>
Use parameters from config file <file>
--daemonuser (-d) <user>
Make the master server a daemon that runs as user <user>. Logging to file and console will be disabled.
--purge (-u) <int>
When <int> = 1, the SQLite database will be purged on start. The defaults is 0: Don’t purge and use the stored servers.

Logging

--logfile (-f) <file>
Log to file <file>. This option is disabled when the master server is run as daemon.
--loglevel (-o) <int>
Possible values for <int> are 1 for normal logging and 2 for more verbose logging. Defaults is 1 (normal logging).
--syslog (-s) <host>
Enables logging to either a local or remote syslog server <host> on UDP port 514.

Execution timer

--exec (-e) <file>
Execute script or program <file> every 5 (default) minutes. Following values will be passed to the script or program on execution:
- The current Unix/POSIX time
- The number of current servers
- The number of current players (total on all servers)
- The number of current bots (total on all servers)

See option --execinterval below on how to change the execution interval.

--execinterval (-t) <int>
The interval <int> in minutes for the execution of an external script or program. Defaults to 5 minutes. See option --exec above to get more information about executing a script or program.

Server list

--interval (-i) <int>
The interval <int> in seconds after which dead servers will be removed from the server list. Defaults to 120 seconds.
--lifetime (-l) <int>
The lifetime <int> when servers are considered dead (didn’t send a heartbeat). Defaults to 180 seconds.

Author

This manpage was written by Stefan (Shaderman) Greven <torquemaster@shaderman.com>.

Table of Contents