wesnoth/doc/man/zh_CN/wesnothd.6

.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
.\"
.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH WESNOTHD 6 2009 wesnothd 韦诺之战多人游戏服务器
.
.SH 命名
.
wesnothd \- 韦诺之战 \fBWesnoth\fP 多人游戏服务器
.
.SH 摘要
.
\fBwesnothd\fP [\|\fB\-dv\fP\|] [\|\fB\-c\fP \fIpath\fP\|] [\|\fB\-p\fP \fIport\fP\|] [\|\fB\-t\fP
\fInumber\fP\|] [\|\fB\-T\fP \fInumber\fP\|]
.br
\fBwesnothd\fP \fB\-V\fP
.
.SH 描述
.
管理韦诺之战多人游戏。查看http://www.wesnoth.org/wiki/ServerAdministration
获取服务器接受的命令列表。客户端使用/query 或 fifo 会显示这一列表。
.
.SH 选项
.
.TP 
\fB\-c\ \fP\fIpath\fP\fB,\ \-\-config\fP\fI\ path\fP
指定wesnothd查找配置文件的目录。查看下面的\fBSERVER CONFIG\fP通过发送SIGHUP信号给服务进程可以重新装载配置文件。
.TP 
\fB\-d, \-\-daemon\fP
以守护进程方式(daemon)运行wesnothd
.TP 
\fB\-h, \-\-help\fP
显示命令行选项的作用
.TP 
\fB\-\-log\-\fP\fIlevel\fP\fB=\fP\fIdomain1\fP\fB,\fP\fIdomain2\fP\fB,\fP\fI...\fP
设置日志记录的级别.\fBall\fP用来匹配任意日志域(log domain)级别。可选的级别有：\fBerror\fP,\ \fBwarning\fP,\
\fBinfo\fP,\ \fBdebug\fP。默认的级别是\fBerror\fP，对\fB服务器\fP域默认级别是\fBinfo\fP。
.TP 
\fB\-p\ \fP\fIport\fP\fB,\ \-\-port\fP\fI\ port\fP
绑定服务到指定的端口。如果不指定端口将使用\fB15000\fP端口。
.TP 
\fB\-t\ \fP\fInumber\fP\fB,\ \-\-threads\fP\fI\ number\fP
设置网络I/O的最大挂起线程数(waiting worker threads)为n (默认值为\fB5\fP，\ 最大为\ \fB30\fP)。
.TP 
\fB\-T\ \fP\fInumber\fP\fB,\ \-\-max\-threads\fP\fI\ number\fP
设置允许创建的最大正常线程数(worker threads)。如果设置为\fB0\fP则不限制线程数（默认值：\fB0\fP）
.TP 
\fB\-V, \-\-version\fP
显示版本号并退出
.TP 
\fB\-v, \-\-verbose\fP
开启调试日志记录
.
.SH "SERVER CONFIG"
.
.SS "The general syntax is:"
.
.P
[\fItag\fP]
.IP
\fIkey\fP="\fIvalue\fP"
.IP
\fIkey\fP="\fIvalue\fP,\fIvalue\fP,..."
.P
[/\fItag\fP]
.
.SS "Global keys:"
.
.TP 
\fBallow_remote_shutdown\fP
If set to \fBno\fP (default), shut_down and restart requests are ignored unless
they come from the fifo.  Set it to \fByes\fP to allow remote shutdown via a
/query by an administrator.
.TP 
\fBban_save_file\fP
一个服务器可读可写的（经gzip压缩的）文件的完整路径或相对路径。封禁信息会自动保存在这个文件，并在服务器重启时读取。
.TP 
\fBcompress_stored_rooms\fP
Determines whether the rooms file should be read and written to in
compressed form. Defaults to \fByes\fP.
.TP 
\fBconnections_allowed\fP
同一IP允许的连接数。\fB0\fP 表示无限制。(默认值：\fB5\fP)
.TP 
\fBdisallow_names\fP
Names/nicks that are not accepted by the server. \fB*\fP and \fB?\fP from wildcard
patterns are supported. See \fBglob\fP(7)  for more details.  Default values
(used if nothing is specified) are:
\fB*admin*,*admln*,*server*,ai,ai?,computer,human,network,player\fP.
.TP 
\fBfifo_path\fP
The path to the fifo you can echo server commands into (same as /query
\&... from wesnoth).  If not specified defaults to the compile\-time path
(default: \fB/var/run/socket/wesnothd/socket\fP).
.TP 
\fBmax_messages\fP
\fBmessages_time_period\fP中允许存在的消息数。 (默认值: \fB4\fP)
.TP 
\fBmessages_time_period\fP
消息泛滥(message flooding)检测时间间隔(秒)。 (默认值: \fB10\fP 秒)
.TP 
\fBmotd\fP
当日新闻
.TP 
\fBnew_room_policy\fP
Determines who can create new rooms on the server. Available values are
\fBeveryone\fP, \fBregistered\fP, \fBadmin\fP and \fBnobody\fP, and give the permission
respectively to everyone, registered users, admin users or disables new room
creation. Default value is \fBeveryone\fP.
.TP 
\fBpasswd\fP
The password used to gain admin privileges (via \fB/query admin
\fP\fIpassword\fP).
.TP 
\fBreplay_save_path\fP
存放游戏录像的目录。(必须以/结尾!)默认为`'(空),也就是wesnothd 启动时的目录。
.TP 
\fBrestart_command\fP
The command that the server uses to start a new server process via the
\fBrestart\fP command. (Can only be issued via the fifo. See the
\fBallow_remote_shutdown\fP setting.)
.TP 
\fBroom_save_file\fP
Path to a file where the room info should be stored. This file is read on
server startup and written to later. If empty or not set, rooms are not
loaded and not saved.
.TP 
\fBsave_replays\fP
设置服务器是否自动保存游戏录像。(默认值: \fBfalse\fP)
.TP 
\fBversions_accepted\fP
A comma separated list of version strings to be accepted by the server. \fB*\fP
and \fB?\fP from wildcard patterns are supported.  (defaults to the
corresponding wesnoth version)
.br
例如: \fBversions_accepted="*"\fP 允许所有版本连接。
.TP  
\fBuser_handler\fP
The name of the user handler to use. Currently available user handlers are
\fBforum\fP (to connect wesnothd to a phpbb forum database) and \fBsample\fP (a
sample implementation of the user handler interface, if you use this on
anything real you are insane). The default value is \fBforum\fP. You must also
add a \fB[user_handler]\fP section, see below.
.
.SS "Global tags:"
.
.P
\fB[redirect]\fP 服务器用来重定向特定客户端版本的标签。
.RS
.TP 
\fBhost\fP
重定向到的服务器地址
.TP 
\fBport\fP
连接端口
.TP 
\fBversion\fP
用逗号分隔的需要重定向的版本号列表。同样可以使用`*'和`?'通配符。
.RE
.P
\fB[ban_time]\fP 这个标签定义一些常用的封禁时间长度的关键字。
.RS
.TP 
\fBname\fP
给封禁时间起一个名字
.TP 
\fBtime\fP
The time length definition.  The format is: %d[%s[%d%s[...]]] where %s is s
(seconds), m (minutes), h (hours), D (days), M (months) or Y (years) and %d
is a number.  If no time modifier is given minutes (m) are assumed.
Example: \fBtime="1D12h30m"\fP results in a ban time of 1 day, 12 hours and 30
minutes.
.RE
.P
\fB[proxy]\fP 这个标签告诉服务器扮演代理服务器角色，把用户连接重定向到另一台服务器。与\fB[redirect]\fP接受一样的参数。
.RE
.P
\fB[user_handler]\fP Configures the user handler. Available keys vary depending
on which user handler is set with the \fBuser_handler\fP key. If no
\fB[user_handler]\fP section is present in the configuration the server will
run without any nick registration service.
.RS
.TP  
\fBdb_host\fP
(如果用户处理单元设置为 forum) 数据库服务器的主机名
.TP  
\fBdb_name\fP
(如果用户处理单元设置为 forum) 数据库名
.TP  
\fBdb_user\fP
(如果用户处理单元设置为 forum) 数据库登录用户名
.TP  
\fBdb_password\fP
(如果用户处理单元设置为 forum) 数据库登录密码
.TP  
\fBdb_users_table\fP
(如果用户处理单元设置为 forum) phpbb 论坛中存放用户数据的表名。很可能是<table\-prefix>_users
(例如phpbb3_users)。
.TP  
\fBdb_extra_table\fP
(for user_handler=forum) The name of the table in which wesnothd will save
its own data about users. You will have to create this table manually, e.g.:
\fBCREATE TABLE <table\-name>(username VARCHAR(255) PRIMARY KEY,
user_lastvisit INT UNSIGNED NOT NULL DEFAULT 0, user_is_moderator TINYINT(4)
NOT NULL DEFAULT 0);\fP
.TP  
\fBuser_expiration\fP
(如果用户处理单元设置为 sample) 注册昵称失效时间(天数)。
.RE
.P
\fB[mail]\fP 设置一个SMTP服务器,通过它用户处理单元可以发送邮件。目前只在sample 用户处理单元中使用。
.RS
.TP  
\fBserver\fP
邮件服务器的主机名
.TP  
\fBusername\fP
登录到邮件服务器的用户名。
.TP  
\fBpassword\fP
这个用户的密码。
.TP  
\fBfrom_address\fP
"回复到"邮件地址
.TP  
\fBmail_port\fP
邮件服务器的端口。默认值位5。
.
.SH 作者
.
由 David White <davidnwhite@verizon.net>编写。经 Nils Kneuper
<crazy\-ivanovic@gmx.net>, ott <ott@gaon.net>, Soliton
<soliton.de@gmail.com> 和 Thomas Baumhauer
<thomas.baumhauer@gmail.com>. 修改。这个帮助页最早由Cyril Bouthors
<cyril@bouthors.org>编写。
.br
访问官方网站: http://www.wesnoth.org/
以及Wesnoth中文网站：http://www.wesnoth.cn
.
.SH COPYRIGHT
.
Copyright \(co 2003\-2009 David White <davidnwhite@verizon.net>
.br
这是一个自由软件；使用由FSF发布的GPL v2协议授权。原文如下：This is Free Software; this software is
licensed under the GPL version 2, as published by the Free Software
Foundation.  There is NO warranty; not even for MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.There is NO warranty; not even for MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.
.
.SH 参见
.
\fBwesnoth\fP(6), \fBwesnoth_editor\fP(6)