git.pond.sub.org Git - empserver/blob - man/emp_server.6

   1 .TH EMP_SERVER 6
   2 .\" Note: Options specific to the native Windows port are suppressed
   3 .\" unless you format with non-zero number register w, e.g. by
   4 .\" supplying -rw1 to nroff.
   5 .SH NAME
   6 emp_server \- Empire server
   7 .SH SYNOPSIS
   8 .B emp_server
   9 [\fB\-dFhpsv\fP]
  10 [\fB\-e\fP \fIconfigfile\fP]
  11 [\fB\-E\fP \fIaction\fP]
  12 [\fB\-R\fP \fIseed\fP]
  13 .if \nw \{\
  14 .br
  15 .B emp_server
  16 [\fB\-i\fP
  17 |\fB\-I\fP \fIservice-name\fP]
  18 [\fB\-e\fP \fIconfigfile\fP]
  19 .br
  20 .B emp_server
  21 [\fB\-u\fP
  22 |\fB\-U\fP \fIservice-name\fP]\}
  23 .SH DESCRIPTION
  24 .B emp_server
  25 is a daemon which listens to the Empire port for players connecting to
  26 the game.  For more information on the game of Empire, see the info
  27 pages within the game.
  28 .SH OPTIONS
  29 .TP
  30 .B \-d
  31 Debug mode.  This will prevent the server from forking itself into the
  32 background.  Implies -E abort.  You normally want to use this flag if
  33 you are running
  34 .B emp_server
  35 from within a debugger.
  36 .TP
  37 .BI \-e " configfile"
  38 Use game configuration in \fIconfigfile\fR.
  39 .TP
  40 .BI \-E " action"
  41 What to do on recoverable internal error ("oops"): \fBabort\fP,
  42 \fBcrash\-dump\fP (but continue), \fBnothing\fP (default).
  43 .ie \nw \fBcrash-dump\fP is not implemented for Windows.
  44 .el \fBcrash-dump\fP works by aborting a fork of the server process.
  45 .TP
  46 .B \-F
  47 Force
  48 .B emp_server
  49 to start even when game state looks bad.  Risks crashes and further
  50 corruption; use this only for attempting to fix up problems.  Better
  51 make a backup first, and lock out players.
  52 .TP
  53 .B \-h
  54 Help.  Print brief usage information and exit.
  55 .if \nw \{\
  56 .TP
  57 .B \-i
  58 Install as a Windows Service called "Empire Server".
  59 .TP
  60 .BI \-I " service-name"
  61 Install as a Windows Service with the specified name.\}
  62 .TP
  63 .B \-p
  64 Threading debug mode.  Implies \fB-d\fR.
  65 .if \nw \{\
  66 .TP
  67 .B \-u
  68 Uninstall the Windows Service called "Empire Server".
  69 .TP
  70 .BI \-U " service-name"
  71 Uninstall the Windows Service with the specified name.\}
  72 .TP
  73 .B \-s
  74 Enable thread stack checking.
  75 .TP
  76 .B \-R " seed"
  77 Set the seed for random function.
  78 .TP
  79 .B \-v
  80 Print version information and exit.
  81 .SH OPERANDS
  82 Operands are ignored for backward compatibility.  Their use is
  83 deprecated.
  84 .if !\nw \{
  85 .SH SIGNALS
  86 .TP
  87 .B SIGHUP
  88 Request
  89 .B emp_server
  90 to reopen log files and reload its configuration.  This allows proper
  91 log rotation.  Only the update schedule is reloaded at this time.
  92 .TP
  93 .BR SIGINT ", " SIGTERM
  94 Request
  95 .B emp_server
  96 to shut down immediately.
  97 \}
  98 .if \nw \{
  99 .SH RESTRICTIONS
 100 When using the service control manager (Services Window), the start
 101 parameters are not processed.  The only parameters processed are the
 102 ones supplied during service installation.  To modify the startup
 103 parameters, you must remove the service and reinstall the service.\}
 104 .SH BUGS
 105 Please report all bugs to the Wolfpack <wolfpack@wolfpackempire.com>
 106 .SH "SEE ALSO"
 107 \fIempire\fR(6), \fIempsched\fR(6), \fIfairland\fR(6), \fIfiles\fR(6),
 108 \fIpconfig\fR(6).
 109 .SH AUTHORS
 110 Dave Pare, Jeff Bailey, Thomas Ruschak, Ken Stevens, Steve McClure and
 111 Markus Armbruster are principal authors.  The full list of authors is
 112 too long to include here.