ARMAGETRONAD-DEDICATED(6) Games Manual ARMAGETRONAD-DEDICATED(6)NAME
armagetronad-dedicated - an Armagetron Advanced dedicated game server
SYNOPSIS
/etc/init.d/armagetronad-dedicated start|stop|restart|force-reload|status
armagetronad-dedicated [-h, --help] [-v, --version] [--doc] [--fastforward] [--benchmark] [--record] [--playback]
DESCRIPTION
The Armagetron Advanced dedicated server runs from an initscript -- to enable running it on boot, edit /etc/default/armagetronad-dedicated.
The server program will read default settings from /etc/armagetronad/settings_dedicated.cfg. Modifications and custom server settings
should be implemented in the file /etc/armagetronad/settings_custom.cfg.
To edit configuration on-the-fly or make time-sensitive temporary changes, it's best to log onto the server from the armagetronad client
and log on as an administrator (using the password set in the server configuration). Console input is not available when running the server
as a daemon.
Before each round is started, the file /etc/armagetronad/everytime.cfg is read; it may be useful to use this for things like randomly
changing maps or other quickly changing settings.
OPTIONS
Note: Only options that are relevant for invoking armagetron-dedicated via the command line (and not the initscript) are documented here.
See armagetronad-dedicated --help for a complete reference.
-h, --help
Show help message.
-v, --version
Print version number.
--doc Print documentation for all console commands. These are also configuration settings for config files.
--fastforward TIME
Lets time run very fast until the given time is reached.
--benchmark
Renders frames as they were recorded.
--record FILENAME
Creates a DEBUG recording while running.
--playback FILENAME
Plays back a DEBUG recording.
FILES
/etc/armagetronad/settings_dedicated.cfg
SEE ALSO armagetronad(6)
Armagetron Advanced is documented fully by the provided HTML docs, found under /usr/share/doc/armagetronad-common/html/.
A thorough guide to running a server can be found on the Armagetron Advanced wiki: http:wiki.armagetronad.netindex.phpServer_Administra-
tion_Guide and: http:wiki.armagetronad.netindex.phpAdvanced_Server_Administration_Guide
AUTHOR
Armagetron Advanced was written by Manuel Moos <z-man@users.sourceforge.net> and the Armagetron Advanced development team.
This manual page was adapted from the original HTML version by Marcelo E. Magallon <mmagallo@debian.org> (and later Christine Spang
<spang@mit.edu>), for the Debian GNU/Linux system (but may be used by others).
February 08, 2007 ARMAGETRONAD-DEDICATED(6)
Check Out this Related Man Page
MPD-SIMA(1) mpd-sima User Manual MPD-SIMA(1)NAME
mpd-sima - mpd-sima will try to maintain some titles ahead in your play list following different policies.
SYNOPSIS
mpd-sima [--daemon] [--config=conf_file] [--var_dir=var_directory] [--pid=pid_file] [--log=log_file] [--host=mpd_host]
[--mpd_port=mpd_port] [--new-version]
mpd-sima [--var_dir=var_directory] [--create-db>]
mpd-sima [{-h | --help} | --version]
DESCRIPTION
This manual page documents briefly the mpd-sima commands.
At start up default configuration is first overridden by user configuration in mpd_sima.cfg (see the section called "FILES") and finally
command lines options are honored. For instance you can override default MPD_HOST set in defaults (localhost) or in your configuration file
with -S my_mpd_server option. For default configuration see the section called "CONFIGURATION".
EXAMPLE
Launch as a system service (daemon).
Here follows an example on how to launch mpd-sima as a service on your system, not attach to regular user configuration/database.
mpd-sima --daemon --conf=/etc/mpd_sima.cfg --var_dir=/var/cache/mpd-sima/ --pid=/var/run/mpd-sima.pid --log=/var/log/mpd-sima.log
Launch in user land
Launching mpd-sima from/whithin your user acount is easy, you can simply call mpd-sima from your shell or one of the following command:
Background execution (daemonise), log in the specified file, save pid:
mpd-sima --daemon --pid=$HOME/var/run/mpd-sima.pid --log=$HOME/var/log/mpd-sima.log
Foreground execution, connect my.mpd.server.org, log to std(out|err):
mpd-sima --host=my.mpd.server.org
OPTIONS
The program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included
below.
-h, --help
Print help and exit.
--version
Print version and exit.
--daemon
Start as a daemon. Log redirected to /dev/null, usually setting --log and --pid options in daemon mode are a good idea to monitor/stop
the process.
-p pid_file, --pid=pid_file
Use the specific file pid_file to store pid to.
Default is not to store pid info.
-l log_file, --log=log_file
Use the specific file log_file to log messages to.
Default is to log to stdout/stderr.
-c conf_file, --config=conf_file
Use the specific file conf_file to set up configuration instead of looking for the default user configuration file.
Default is to look for $XDG_CONFIG_HOME/mpd_sima/mpd_sima.cfg. Concerning this file see also the section called "FILES".
Pay attention: Because you load a specific configuration file from command line interface does not mean it will override others options
pass to mpd_sima. In other words launching with -P 6666 will override port setting whatever the configuration file your using, default
or command line specified.
--var_dir=var_directory
Use the specific path var_directory to look for (or create) var files (ie. database) instead of looking at the default user data
location.
Default is to look in $XDG_DATA_HOME/mpd_sima/. Concerning $XDG_DATA_HOME see also the section called "FILES"
--create-db
Create the database and exit. Uses folder specified with --var_dir or default directory.
Default is to use $XDG_DATA_HOME/mpd_sima/. Concerning $XDG_DATA_HOME see also the section called "FILES"
-S mpd_host, --host=mpd_host
Use the specific host mpd_host as MPD server.
mpd_host can be an IP or a fully qualified domain name as long as your system can resolve it. This overrides MPD_HOST environment
variable.
Default is localhost.
See also the section called "ENVIRONMENT".
-P mpd_port, --port=mpd_port
Use the specific port number mpd_port on MPD server. This overrides MPD_PORT environment variable.
Default is 6600.
See also the section called "ENVIRONMENT"
--new-version
Check and log for new version at start up (issue a warning).
FILES
${XDG_CONFIG_HOME}/mpd_sima/mpd_sima.cfg
The per-user configuration file. Usually XDG_CONFIG_HOME is set to ${HOME}/.config.
${XDG_DATA_HOME}/mpd_sima/sima.db
SQLite database. Usually XDG_DATA_HOME is set to ${HOME}/.local/share.
ENVIRONMENT
MPD_HOST, MPD_PORT
mpd-sima will look for MPD_HOST and MPD_PORT to override built-in configuration (set to "localhost:6600").
mpd-sima expects MPD_HOST syntax as documented in mpc manual, cf. mpc(1).
To use a password, provide a value of the form "password@host".
CONFIGURATION
mpd_sima.cfg
mpd_sima.cfg is read if present. Otherwise built-in defaults are used. An example should be provided in the tarball within
doc/examples/mpd_sima.cfg. On Debian system please look in /usr/share/doc/mpd-sima.
DEFAULTS
Default is to look for MPD server at localhost:6600 (or MPD_HOST/MPD_PORT env. var. if set).
The default behavior is to add one track, this track is to be chosen among titles from artists similar to the artist of the currently
played track. MPD_sima will add one track when the play list is one track long.
To change these defaults, use the configuration file mpd_sima.cfg
BUGS
The upstream BTS can be found at http://codingteam.net/project/sima/bugs.
FEEDBACK
The maintainer would be more than happy to ear from you, don't hesitate to send feedback on the forge, via the upstream BTS, the forum or
the chat room, all available on the forge at http://codingteam.net/project/sima.
XMPP users are welcome to join the dedicated chat room at sima@conference.codingteam.net.
SEE ALSO mpc(1), mpd(1), mpd-sima.cfg(5)
/usr/share/doc/mpd-sima/
AUTHOR
Jack Kaliko <efrim@azylum.org>
Wrote this man page and is currently leading MPD_sima project.
COPYRIGHT
Copyright (C) 2009-2012 Jack Kaliko
This manual page was written for the Debian system (and may be used by others).
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3
published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
mpd-sima 02/17/2012 MPD-SIMA(1)