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