X-Git-Url: http://git.pond.sub.org/?p=empserver;a=blobdiff_plain;f=man%2Femp_server.6;h=3a23823cb51bb5e820a4a873adaae80403fd7ba6;hp=3e3bb5c9aa0916894916d4b282f8854c10f49d86;hb=HEAD;hpb=f940413c67cdeebced3fa7ee761f0547b0d09255 diff --git a/man/emp_server.6 b/man/emp_server.6 index 3e3bb5c9a..3a23823cb 100644 --- a/man/emp_server.6 +++ b/man/emp_server.6 @@ -6,51 +6,51 @@ emp_server \- Empire server .SH SYNOPSIS .B emp_server -[ -.BI \-dhpsv -] -[ -.BI \-e " configfile" -] +[\fB\-dFhpsv\fP] +[\fB\-e\fP \fIconfigfile\fP] +[\fB\-E\fP \fIaction\fP] +[\fB\-R\fP \fIseed\fP] .if \nw \{\ .br .B emp_server -[ -.BI \-i -| -.BI \-I " service-name" -] -[ -.BI \-e " configfile" -] +[\fB\-i\fP +|\fB\-I\fP \fIservice-name\fP] +[\fB\-e\fP \fIconfigfile\fP] .br .B emp_server -[ -.BI \-r -| -.BI \-R " service-name" -]\} +[\fB\-u\fP +|\fB\-U\fP \fIservice-name\fP]\} .SH DESCRIPTION -.I emp_server +.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 make it abort when it detects an internal -error. You normally want to use 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 .BI \-e " configfile" -Use game configuration specification in -.I configfile -\&. By default, the file "econfig" in the compiled-in data directory -is used. +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 \-h +.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 @@ -61,18 +61,21 @@ Install as a Windows Service called "Empire Server". Install as a Windows Service with the specified name.\} .TP .B \-p -Threading debug mode. Implies -d. +Threading debug mode. Implies \fB-d\fR. .if \nw \{\ .TP -.B \-r -Remove the Windows Service called "Empire Server". +.B \-u +Uninstall the Windows Service called "Empire Server". .TP -.BI \-R " service-name" -Remove the Windows Service with the specified name.\} +.BI \-U " service-name" +Uninstall the Windows Service with the specified name.\} .TP .B \-s Enable thread stack checking. .TP +.B \-R " seed" +Set the seed for random function. +.TP .B \-v Print version information and exit. .SH OPERANDS @@ -83,12 +86,13 @@ deprecated. .TP .B SIGHUP Request -.I emp_server -to reopen log files. This allows proper log rotation. +.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 .BR SIGINT ", " SIGTERM Request -.I emp_server +.B emp_server to shut down immediately. \} .if \nw \{ @@ -99,7 +103,10 @@ 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 +.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 principal authors. The full list of authors is too long to -mention here. +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.