.TH EMP_SERVER 6
-.UC
+.\" Note: Options specific to the native Windows port are suppressed
+.\" unless you format with non-zero number register w, e.g. by
+.\" supplying -rw1 to nroff.
.SH NAME
emp_server \- Empire server
.SH SYNOPSIS
.B emp_server
-[
-.BI \-dhps
-]
-[
-.BI \-D\ datadir
-]
-[
-.BI \-e\ configfile
-]
-[
-.IR name
-]
+[\fB\-dFhpsv\fP]
+[\fB\-e\fP \fIconfigfile\fP]
+[\fB\-E\fP \fIaction\fP]
+[\fB\-R\fP \fIseed\fP]
+.if \nw \{\
.br
+.B emp_server
+[\fB\-i\fP
+|\fB\-I\fP \fIservice-name\fP]
+[\fB\-e\fP \fIconfigfile\fP]
+.br
+.B emp_server
+[\fB\-u\fP
+|\fB\-U\fP \fIservice-name\fP]\}
.SH DESCRIPTION
-.I emp_server
-is a demon which listens to the Empire port for players connecting to
-the game. When a player connects, a thread is created for that player
-within the server. For more information on the game of Empire, see
-the
-.I info
+.B emp_server
+is a daemon which listens to the Empire port for players connecting to
+the game. For more information on the game of Empire, see the info
pages within the game.
.SH OPTIONS
.TP
-.B \-d
+.B \-d
Debug mode. This will prevent the server from forking itself into the
-background. It will also cause the server to dump core if it crashes.
-You must run with this flag if you are running
-.I emp_server
+background. Implies -E abort. You normally want to use this flag if
+you are running
+.B emp_server
from within a debugger.
.TP
-.B \-h
-Help. Print a usage line showing the command line options.
+.BI \-e " configfile"
+Use game configuration in \fIconfigfile\fR.
+.TP
+.BI \-E " action"
+What to do on recoverable internal error ("oops"): \fBabort\fP,
+\fBcrash\-dump\fP (but continue), \fBnothing\fP (default).
+.ie \nw \fBcrash-dump\fP is not implemented for Windows.
+.el \fBcrash-dump\fP works by aborting a fork of the server process.
+.TP
+.B \-F
+Force
+.B emp_server
+to start even when game state looks bad. Risks crashes and further
+corruption; use this only for attempting to fix up problems. Better
+make a backup first, and lock out players.
+.TP
+.B \-h
+Help. Print brief usage information and exit.
+.if \nw \{\
+.TP
+.B \-i
+Install as a Windows Service called "Empire Server".
+.TP
+.BI \-I " service-name"
+Install as a Windows Service with the specified name.\}
.TP
.B \-p
-Lwp Print mode. This is used for debugging lwp-threads.
+Threading debug mode. Implies \fB-d\fR.
+.if \nw \{\
+.TP
+.B \-u
+Uninstall the Windows Service called "Empire Server".
+.TP
+.BI \-U " service-name"
+Uninstall the Windows Service with the specified name.\}
.TP
.B \-s
-Lwp stack check mode. This will report if any of the lwp thread stack
-spaces overflow. It forces lwp print mode on.
+Enable thread stack checking.
+.TP
+.B \-R " seed"
+Set the seed for random function.
.TP
-.BI \-D\ datadir
-causes the server to use the data files in
-.I datadir
+.B \-v
+Print version information and exit.
+.SH OPERANDS
+Operands are ignored for backward compatibility. Their use is
+deprecated.
+.if !\nw \{
+.SH SIGNALS
.TP
-.BI \-e\ configfile
-causes the server to use the game configuration specification in
-.I configfile
-(by default, the file "econfig" in the data directory is used)
+.B SIGHUP
+Request
+.B emp_server
+to reopen log files and reload its configuration. This allows proper
+log rotation. Only the update schedule is reloaded at this time.
.TP
-.IR name
-This argument does nothing. It is used by scripts to locate the
-server to kill it.
+.BR SIGINT ", " SIGTERM
+Request
+.B emp_server
+to shut down immediately.
+\}
+.if \nw \{
+.SH RESTRICTIONS
+When using the service control manager (Services Window), the start
+parameters are not processed. The only parameters processed are the
+ones supplied during service installation. To modify the startup
+parameters, you must remove the service and reinstall the service.\}
.SH BUGS
Please report all bugs to the Wolfpack <wolfpack@wolfpackempire.com>
+.SH "SEE ALSO"
+\fIempire\fR(6), \fIempsched\fR(6), \fIfairland\fR(6), \fIfiles\fR(6),
+\fIpconfig\fR(6).
.SH AUTHORS
-Dave Pare, Jeff Bailey, Thomas Ruschak, Ken Stevens and Steve McClure
- are principle authors.
-The list of secondary authors is too long to mention.
+Dave Pare, Jeff Bailey, Thomas Ruschak, Ken Stevens, Steve McClure and
+Markus Armbruster are principal authors. The full list of authors is
+too long to include here.
projects / empserver / blobdiff