WESNOTHD(6)

名前
wesnothd - Battle for Wesnoth マルチプレイヤー・ネットワーク・デーモン

書式
wesnothd [-dv] [-c path] [-p port] [-t number] [-T number]
wesnothd -V

説明
Battle for Wesnoth のマルチプレイヤーゲームを管理する。 wesnoth クライアント(/query ...)や fifo を通して、サーバーがどのようなコマンドを受けつけるかについては https://www.wesnoth.org/wiki/ServerAdministration を参照。

オプション

-c path, --config path
    wesnothdが使用する設定ファイルがどこにあるかを伝える。文法については後述のサーバー設定の章を参照。サーバープロセスにSIGHUPを送ることによって設定を再読み込みすることができる。

-d, --daemon
    wesnothd をデーモンとして実行する。

-h, --help
    コマンドラインオプションで何が行えるかを表示する。

--log-level=domain1,domain2,...
    ログ領域(domain)の厳密さのレベルを設定する。 all は、どのログ領域にも対応させるために利用できる。有効なレベルは以下の通り。 error、 warning、 info、 debug。既定値では error レベルが使用され、server 領域には info が使用される。

-p port, --port port
    指定ポートにサーバーをバインドする。もしポートが指定されないなら、 15000番ポートが使用される。

-t number, --threads number
    ネットワーク I/O 用の作業スレッドの数の最大値を n に設定する。(既定値: 5、 最大: 30)

-T number, --max-threads number
    作成される作業スレッドの数の最大値を設定する。 0 が指定された場合、制限なしとなる。(既定値: 0)

-V, --version
    バージョン番号を表示して、終了する。

-v, --verbose
    よりデバッグログを有効にする。

サーバー設定

  一般的な文法：

[tag]

    key="value"

    key="value,value,..."

[/tag]

  グローバルキー:

allow_remote_shutdown
    no (既定値)に設定した場合、 fifo から来たものでない限り停止と再起動の要求は無視される。 yes に設定した場合、管理者による /query での遠隔停止を許容する。

ban_save_file
    サーバーが読み書きする（gzip 圧縮の）ファイルへの完全パスまたは相対パス。 ban はこのファイルへ保存され、サーバー開始時に再度読み込まれる。

compress_stored_rooms
    部屋ファイルが圧縮形式で読み書きされるか決定する。既定値は yes。

connections_allowed
    同じ IP から許可される接続数。 0 は無限大を意味する。(既定値: 5)

deny_unregistered_login
    user_handler に登録されていないユーザーのログインを拒否する。（デフォルト：false）

disallow_names
    サーバーによって受けつけられない名前やニックネーム。 * と ? からなるワイルドカードのパターンに対応。詳細は glob(7) を参照。既定の値(何も指定されなかった際に使用される)は *admin*,*admln*,*server*,ai,ai?,computer,human,network,player。

fifo_path
    サーバーコマンド(wesnoth からの /query ... と同じ)をエコーする fifo へのパス。指定されない場合の既定値はコンパイル時に指定されたパス(既定値: /var/run/wesnothd/socket)。

max_messages
    messages_time_period の時間内に許可されるメッセージ数。(既定値: 4)

messages_time_period
    メッセージの殺到(flood)が検出される時間周期(秒単位)。(既定値: 10 秒)

motd
    本日のメッセージ。

new_room_policy
    サーバー上で新しい部屋を立てられる者を決定する。使用可能な値は everyone と registered と admin と nobody で、それぞれ全員、登録ユーザー、管理者ユーザーに権限を与えるか、新しい部屋を立てられなくする。既定値は everyone。

passwd
    管理者権限の獲得に用いられるパスワード。(/query admin password で)

replay_save_path
    サーバーがゲームのリプレイを置くディレクトリ。(/! をつけるのを忘れないこと) 既定値の `' は wesnothd が開始したディレクトリを意味する。

restart_command
    restart コマンドで新しいサーバープロセスを開始するのにサーバーが使用するコマンド。(fifo で問題があるときのみ。)

room_save_file
    部屋情報が置かれるファイルへのパス。このファイルはサーバー開始時に読み込まれ、後で書き出される。空欄か未設定の場合は、部屋は読み込まれず保存されない。

save_replays
    サーバーが自動的にゲームのリプレイを保存するか定義する。(既定値: false)

tls_enabled
    TLSの使用を有効にする。trueの場合は、以下の3つのオプションも設定する必要がある。

tls_fullchain
    .pem形式のTLSフル証明書チェーン

tls_private_key
    .pem形式のTLS用秘密鍵

tls_dh
    .pemファイルとして生成される TLS DHパラメータ。　openssl dhparam -out filename.pem 4096 で生成する。

versions_accepted
    カンマで区切られた、サーバーに受けつけられるバージョン文字列のリスト。 * と ? からなるワイルドカードのパターンに対応。(既定値では wesnoth のバージョンに一致する)
    例: versions_accepted="*" で、どのようなバージョン文字列も受けつける。

id  ゲーム情報を保存するためにデータベース機能を使用する場合のサーバーのID。一般的には、1.16 や 1.17 のように、接続したクライアントアプリの メジャー番号.マイナー番号 で構成されるバージョン番号。

  グローバルタグ:

[redirect] 特定クライアントバージョンのリダイレクト先サーバーを指定するタグ。versions_accepted が指定されていない場合には使用されない。

    host
        リダイレクトするサーバーのアドレス。

    port
        接続するポート。

    version
        カンマで区切られた、リダイレクトするバージョンのリスト。ワイルドカードのパターンに関しては、 versions_accepted と同様に振る舞う。

[ban_time] 一時的な ban 時間の長さの短縮キーワードを定義するタグ。

    name
        ban 時間の参照に使用される名前。

    time
        時間の長さの定義。書式は %d[%s[%d%s[...]]] で %s は s (秒)、 m (分)、 h (時)、 D (日)、 M (月) または Y (年) で %d は数字。もし時間修飾子がない場合は分(m)が指定されたものとする。例: time="1D12h30m" は ban 時間が 1 日と 12 時間 30 分となる。

[proxy] プロキシとして振る舞い、接続クライアントのリクエストを指定したサーバーへと転送するよう指定するよう、サーバーに伝えるタグ。 [redirect] と同じキーを受けつける。

[user_handler] ユーザーハンドラを設定する。[user_handler] セクションが設定に存在しなければ、サーバーはニックネーム登録サービスなしで動作する。forum_user_handler の動作に必要なすべての追加テーブルはWesnothソースリポジトリの中の table_definitions.sql で確認可能。mysqlのサポートが有効化されている必要があり、cmake の場合は ENABLE_MYSQL 、scons の場合は forum_user_handler. でサポートを有効化できる。

    db_host
        データベースサーバーのホスト名

    db_name
        データベース名

    db_user
        データベースにログインするユーザーの名前

    db_password
        ユーザーのパスワード

    db_users_table
        phpbbフォーラムがユーザーデータを保存するテーブル名。<table-prefix>_users （例：phpbb3_users）である可能性が高い。

    db_extra_table
        ユーザーに関するデータをwesnothdが保存するテーブル名。

    db_game_info_table
        ゲームに関するデータをwesnothdが保存するテーブル名。

    db_game_player_info_table
        ゲーム内プレイヤーに関するデータをwesnothdが保存するテーブル名。

    db_game_modification_info_table
        ゲームで使用されるMODに関するデータをwesnothdが保存するテーブル名。

    db_user_group_table
        ユーザーグループデータをphpbbフォーラムが保存するテーブル名。<table-prefix>_user_group （例：phpbb3_user_group）である可能性が高い

    db_connection_history_table
        ログイン/ログアウトの回数を保存するためのDBテーブル名。または IP とユーザーのマッチングにも使用される。

    db_topics_table
        トピック（スレッド）情報をphpbbフォーラムが保存するテーブル名。 <table-prefix>_topics （例：phpbb3_user_group）である可能性が高い。

    db_banlist_table
        ユーザーの入室禁止データをphpbbフォーラムが保存するテーブル名。<table-prefix>_banlist （例：phpbb3_banlist）である可能性が高い。

    mp_mod_group
        モデレーション権限を持つフォーラムグループのID。

終了ステータス
サーバーが正常終了した場合は 0 を返す。コマンドラインオプションのエラーのときは 2 を返す。

著者
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> によって最初に書かれた。 岡田信人 <okyada@gmail.com> によって日本語に翻訳され、いいむらなおき <amatubu@gmail.com> によって編集された。
公式サイト: https://www.wesnoth.org/

著作権
Copyright © 2003-2024 David White <davidnwhite@verizon.net>
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.

関連項目
wesnoth(6)