]> git.pond.sub.org Git - empserver/blob - man/emp_server.6
Document signal use. Since Windows lacks real signals, it is only
[empserver] / 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 .BI \-dhpsv
11 ]
12 [
13 .BI \-e " configfile"
14 ]
15 .if \nw \{\
16 .br
17 .B emp_server
18 [
19 .BI \-i
20 |
21 .BI \-I " service-name"
22 ]
23 [
24 .BI \-e " configfile"
25 ]
26 .br
27 .B emp_server
28 [
29 .BI \-r
30 |
31 .BI \-R " service-name"
32 ]\}
33 .SH DESCRIPTION
34 .I emp_server
35 is a daemon which listens to the Empire port for players connecting to
36 the game.  For more information on the game of Empire, see the info
37 pages within the game.
38 .SH OPTIONS
39 .TP
40 .B \-d 
41 Debug mode.  This will prevent the server from forking itself into the
42 background.  It will also make it abort when it detects an internal
43 error.  You normally want to use this flag if you are running
44 .I emp_server
45 from within a debugger.
46 .TP
47 .BI \-e " configfile"
48 Use game configuration specification in 
49 .I configfile
50 \&.  By default, the file "econfig" in the compiled-in data directory
51 is used.
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 -d.
65 .if \nw \{\
66 .TP
67 .B \-r
68 Remove the Windows Service called "Empire Server".
69 .TP
70 .BI \-R " service-name"
71 Remove the Windows Service with the specified name.\}
72 .TP
73 .B \-s
74 Enable thread stack checking.
75 .TP
76 .B \-v
77 Print version information and exit.
78 .SH OPERANDS
79 Operands are ignored for backward compatibility.  Their use is
80 deprecated.
81 .if !\nw \{
82 .SH SIGNALS
83 .TP
84 .B SIGHUP
85 Request
86 .I emp_server
87 to reopen log files.  This allows proper log rotation.
88 .TP
89 .BR SIGINT ", " SIGTERM
90 Request
91 .I emp_server
92 to shut down immediately.
93 \}
94 .if \nw \{
95 .SH RESTRICTIONS
96 When using the service control manager (Services Window), the start
97 parameters are not processed.  The only parameters processed are the
98 ones supplied during service installation.  To modify the startup
99 parameters, you must remove the service and reinstall the service.\}
100 .SH BUGS
101 Please report all bugs to the Wolfpack <wolfpack@wolfpackempire.com>
102 .SH AUTHORS
103 Dave Pare, Jeff Bailey, Thomas Ruschak, Ken Stevens and Steve McClure
104 are principal authors.  The full list of authors is too long to
105 mention here.