296 lines
10 KiB
Groff
296 lines
10 KiB
Groff
.\" 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 2022 wesnothd "Bitva o Wesnoth\ – síťový server pro hru více hráčů"
|
||
.
|
||
.SH NÁZEV
|
||
.
|
||
wesnothd\ – Bitva o \fBWesnoth\fP\ – síťový server pro hru více hráčů
|
||
.
|
||
.SH POUŽITÍ
|
||
.
|
||
\fBwesnothd\fP [\|\fB\-dvw\fP\|] [\|\fB\-c\fP \fIcesta\fP\|] [\|\fB\-p\fP \fIport\fP\|]
|
||
.br
|
||
\fBwesnothd\fP \fB\-V\fP
|
||
.
|
||
.SH POPIS
|
||
.
|
||
Součást Bitvy o Wesnoth spravující hry více hráčů. Na
|
||
https://www.wesnoth.org/wiki/ServerAdministration lze nalézt příkazy, které
|
||
server akceptuje, a to jak přes fifo, tak přímo od klienta wesnoth.
|
||
.
|
||
.SH VOLBY
|
||
.
|
||
.TP
|
||
\fB\-c\ \fP\fIcesta\fP\fB,\ \-\-config\fP\fI\ cesta\fP
|
||
specifikuje cestu, kde má wesnothd hledat konfigurační soubor. Syntaxe
|
||
souboru je popsána v sekci \fBKONFIGURACE SERVERU\fP níže. Konfiguraci je možno
|
||
znovu načíst posláním SIGHUP procesu serveru.
|
||
.TP
|
||
\fB\-d, \-\-daemon\fP
|
||
spouští wesnothd jako démona.
|
||
.TP
|
||
\fB\-h, \-\-help\fP
|
||
zobrazuje nápovědu k volbám příkazové řádky.
|
||
.TP
|
||
\fB\-\-log\-\fP\fIúroveň\fP\fB=\fP\fIoblast1\fP\fB,\fP\fIoblast2\fP\fB,\fP\fI...\fP
|
||
nastavuje úroveň závažnosti pro oblasti zaznamenávání. Pro zahrnutí všech
|
||
oblastí zaznamenávání lze použít \fBall\fP. Dostupné úrovně: \fBerror\fP,\ \fBwarning\fP,\ \fBinfo\fP,\ \fBdebug\fP. Výchozí použitá úroveň je \fBerror\fP a\ pro
|
||
oblast \fBserver\fP je to \fBinfo\fP.
|
||
.TP
|
||
\fB\-p\ \fP\fIport\fP\fB,\ \-\-port\fP\fI\ port\fP
|
||
server použije daný port. Pokud není určen, bude použit port \fB15000\fP.
|
||
.TP
|
||
\fB\-V, \-\-version\fP
|
||
zobrazí verzi wesnothd a skončí.
|
||
.TP
|
||
\fB\-v, \-\-verbose\fP
|
||
zapíná výpis rozšířených logovacích informací.
|
||
.
|
||
.SH "KONFIGURACE SERVERU"
|
||
.
|
||
.SS "Obecná syntaxe je:"
|
||
.
|
||
.P
|
||
[\fIznačka\fP]
|
||
.IP
|
||
\fIklíč\fP="\fIhodnota\fP"
|
||
.IP
|
||
\fIklíč\fP="\fIhodnota\fP,\fIhodnota\fP,..."
|
||
.P
|
||
[/\fIznačka\fP]
|
||
.
|
||
.SS "Globální klíče:"
|
||
.
|
||
.TP
|
||
\fBallow_remote_shutdown\fP
|
||
Při nastavení na \fBno\fP (výchozí) jsou požadavky shut_down a restart
|
||
ignorovány, pokud nepocházejí z fifo. Při nastavení \fByes\fP může správce
|
||
vzdáleně vypnout server pomocí /query.
|
||
.TP
|
||
\fBban_save_file\fP
|
||
Plná či relativní cesta k souboru (komprese gzip), jenž může server číst a
|
||
přepisovat. Do tohoto souboru jsou ukládány zákazy přístupu (ban) a načítány
|
||
při spuštění.
|
||
.TP
|
||
\fBconnections_allowed\fP
|
||
Počet povolených spojení z\ jedné IP adresy. \fB0\fP znamená nekonečno. (výchozí
|
||
hodnota: \fB5\fP)
|
||
.TP
|
||
\fBdeny_unregistered_login\fP
|
||
Zda bránit uživatelům, kteří nejsou registrováni použitým \fBuser_handler\fP,
|
||
aby se přihlásili. (výchozí hodnota: false)
|
||
.TP
|
||
\fBdisallow_names\fP
|
||
Jména/přezdívky, jež server nepřijímá. Podporovány jsou zástupné znaky \fB*\fP
|
||
a\ \fB?\fP. Pro více podrobností viz \fBglob\fP(7). Výchozí hodnoty (použité, když
|
||
není nic určeno) jsou:
|
||
\fB*admin*,*admln*,*moderator*,*server*,ai,ai?,computer,human,network,player\fP.
|
||
.TP
|
||
\fBfifo_path\fP
|
||
Cesta k\ fifo, do níž můžeš posílat příkazy serveru (stejně jako pomocí
|
||
/query z\ klienta). Pokud není zadána, použije se cesta určená při
|
||
kompilaci. (výchozí hodnota: \fB/var/run/wesnothd/socket\fP)
|
||
.TP
|
||
\fBid\fP
|
||
Identifikátor serveru při použití databázových funkcí pro uložení informací
|
||
o\ hře. Obvykle je to major.minor verze přípustných klientů, jako třeba 1.16
|
||
nebo 1.17.
|
||
.TP
|
||
\fBmax_messages\fP
|
||
Přípustný počet zpráv během \fBmessages_time_period\fP. (výchozí hodnota: \fB4\fP)
|
||
.TP
|
||
\fBmessages_time_period\fP
|
||
Doba (ve vteřinách), během které se zjišťuje zahlcení zprávami. (výchozí
|
||
hodnota: \fB10\fP vteřin)
|
||
.TP
|
||
\fBmotd\fP
|
||
Zpráva dne.
|
||
.TP
|
||
\fBpasswd\fP
|
||
Heslo pro získání administrátorských práv. (Přes \fB/query admin \fP\fIpassword\fP.)
|
||
.TP
|
||
\fBreplay_save_path\fP
|
||
Adresář, do nějž server ukládá záznamy her. (Nezapomeň na / na konci!)
|
||
Výchozí hodnotou je `', což znamená adresář, v\ němž byl wesnothd spuštěn.
|
||
.TP
|
||
\fBrestart_command\fP
|
||
Příkaz, který server použije pro spuštění nového procesu sebe sama při
|
||
příkazu \fBrestart\fP. (Lze nastavit pouze přes fifo. Více viz
|
||
\fBallow_remote_shutdown\fP.)
|
||
.TP
|
||
\fBsave_replays\fP
|
||
Určuje, zda bude server automaticky ukládat záznamy her. (výchozí hodnota:
|
||
\fBfalse\fP)
|
||
.TP
|
||
\fBtls_enabled\fP
|
||
Povolit použití protokolu TLS. Je\-li \fBtrue\fP, je třeba nastavit také
|
||
následující tři klíče.
|
||
.TP
|
||
\fBtls_fullchain\fP
|
||
Úplný řetěz důvěry (certifikátů) pro TLS ve formátu PEM.
|
||
.TP
|
||
\fBtls_private_key\fP
|
||
Soukromý klíč pro TLS ve formátu PEM.
|
||
.TP
|
||
\fBtls_dh\fP
|
||
Parametry DH pro TLS jako soubor ve formátu PEM. Vytvořte pomocí příkazu
|
||
\fBopenssl dhparam \-out jmeno_souboru.pem 4096\fP.
|
||
.TP
|
||
\fBversions_accepted\fP
|
||
Seznam čárkou oddělených řetězců verzí, které server přijímá. Podporovány
|
||
jsou zástupné znaky \fB*\fP a\ \fB?\fP. (výchozí hodnotou je příslušná verze hry
|
||
wesnoth)
|
||
.br
|
||
Příklad: \fBversions_accepted="*"\fP přijímá jakýkoli řetězec verze.
|
||
.
|
||
.SS "Globální značky:"
|
||
.
|
||
.P
|
||
\fB[redirect]\fP Značka pro zadání serveru, na který se mají přesměrovat určité
|
||
verze klientů. Nepoužije se, pokud není nastaven klíč \fBversions_accepted\fP.
|
||
.RS
|
||
.TP
|
||
\fBhost\fP
|
||
Adresa serveru pro přesměrování.
|
||
.TP
|
||
\fBport\fP
|
||
Port, na kterém poslouchá vzdálený wesnothd.
|
||
.TP
|
||
\fBversion\fP
|
||
Seznam čárkou oddělených řetězců verzí Wesnothu, pro které jsou požadavky
|
||
přesměrovány na tento vzdálený server. Obdobný zápis jako u
|
||
\fBversions_accepted\fP.
|
||
.RE
|
||
.P
|
||
\fB[ban_time]\fP Tag umožňující definovat klíčová slova pro délky zákazů
|
||
přístupu (ban).
|
||
.RS
|
||
.TP
|
||
\fBname\fP
|
||
Název pro období.
|
||
.TP
|
||
\fBtime\fP
|
||
Definice doby trvání. Formát je %d[%s[%d%s[...]]] kde %s je "s" (sekundy),
|
||
"m" (minuty), "h" (hodiny), "D" (dny), "M" (měsíce) nebo "Y" (roky) a %d je
|
||
číslo. Pokud není zadán druh délky, jsou předpokládány minuty (m). Například
|
||
\fBtime="1D12H30m"\fP představuje zákaz pro jeden den, 12 hodin a 30 minut.
|
||
.RE
|
||
.P
|
||
\fB[proxy]\fP Značka říkající serveru, aby se choval jako proxy a přesměrovával
|
||
na určený server klientské požadavky. Akceptuje stejné klíče jako
|
||
\fB[redirect]\fP.
|
||
.RE
|
||
.P
|
||
\fB[user_handler]\fP Konfiguruje obsluhu uživatelů. Pokud v\ konfiguraci oddíl
|
||
\fB[user_handler]\fP chybí, server poběží bez jakékoli služby pro registraci
|
||
přezdívek. Všechny další tabulky, které jsou třeba, aby pracoval
|
||
\fBforum_user_handler\fP, lze najít v\ table_definitions.sql v\ repozitáři
|
||
zdrojových kódů Wesnothu. Vyžaduje zapnutou podporu mysql. Pro cmake je to
|
||
\fBENABLE_MYSQL\fP a\ pro scons je to \fBforum_user_handler.\fP
|
||
.RS
|
||
.TP
|
||
\fBdb_host\fP
|
||
Název hostitele databázového serveru
|
||
.TP
|
||
\fBdb_name\fP
|
||
Název databáze
|
||
.TP
|
||
\fBdb_user\fP
|
||
Název uživatele pro přihlášení k\ databázi
|
||
.TP
|
||
\fBdb_password\fP
|
||
Heslo tohoto uživatele
|
||
.TP
|
||
\fBdb_users_table\fP
|
||
Název tabulky, do které tvé phpBB fórum ukládá svá data o
|
||
uživatelích. S\ největší pravděpodobností to bude
|
||
<table\-prefix>_users (např. phpbb3_users).
|
||
.TP
|
||
\fBdb_extra_table\fP
|
||
Název tabulky, do které bude wesnothd ukládat svá vlastní data
|
||
o\ uživatelích.
|
||
.TP
|
||
\fBdb_game_info_table\fP
|
||
Název tabulky, do které bude wesnothd ukládat svá vlastní data o\ hrách.
|
||
.TP
|
||
\fBdb_game_player_info_table\fP
|
||
Název tabulky, do které bude wesnothd ukládat svá vlastní data o\ hráčích ve
|
||
hře.
|
||
.TP
|
||
\fBdb_game_content_info_table\fP
|
||
Název tabulky, do které bude wesnothd ukládat svá vlastní data o\ herním
|
||
obsahu (scénáři/éře/modifikacích) použitém ve hře.
|
||
.TP
|
||
\fBdb_user_group_table\fP
|
||
Název tabulky, do které tvé phpBB fórum ukládá svá data o\ skupinách
|
||
uživatelů. S\ největší pravděpodobností to bude
|
||
<table\-prefix>_user_group (např. phpbb3_user_group).
|
||
.TP
|
||
\fBdb_tournament_query\fP
|
||
SQL dotaz na vyhledání turnajů, které se mají vypsat při přihlášení. Měl by
|
||
vrátit \fBnázev\fP, \fBstav\fP a \fBurl\fP turnaje.
|
||
.TP
|
||
\fBdb_connection_history_table\fP
|
||
Název tabulky pro ukládání časů přihlášení a\ odhlášení. Je také použita pro
|
||
párování IP adres s\ uživateli a\ naopak.
|
||
.TP
|
||
\fBdb_topics_table\fP
|
||
Název tabulky, do které tvé phpBB fórum ukládá své informace o\ tématech
|
||
(vláknech). Nejpravděpodobněji to bude <table\-prefix>_topics
|
||
(např. phpbb3_topics).
|
||
.TP
|
||
\fBdb_banlist_table\fP
|
||
Název tabulky, do které tvé phpBB fórum ukládá svá data o\ zablokovaných
|
||
uživatelích. Nejspíše to bude <table\-prefix>_banlist
|
||
(např. phpbb3_banlist).
|
||
.TP
|
||
\fBmp_mod_group\fP
|
||
Identifikátor skupiny fóra, o\ které se předpokládá, že má oprávnění
|
||
k\ moderování.
|
||
.RE
|
||
.
|
||
.SH "NÁVRATOVÝ KÓD"
|
||
.
|
||
Když byl server řádně ukončen, je hodnota návratového kódu 0. Návratová
|
||
hodnota\ 2 ukazuje na chybu ve volbách příkazového řádku.
|
||
.
|
||
.SH AUTOŘI
|
||
.
|
||
Vytvořil David White <davidnwhite@verizon.net>. Upravili Nils
|
||
Kneuper <crazy\-ivanovic@gmx.net>, ott <ott@gaon.net>,
|
||
Soliton <soliton@sonnenkinder.org> a\ Thomas Baumhauer
|
||
<thomas.baumhauer@gmail.com>. Tuto manuálovou stránku původně
|
||
vytvořil Cyril Bouthors <cyril@bouthors.org>.
|
||
.br
|
||
Navštiv oficiální domovskou stránku: https://www.wesnoth.org/
|
||
.
|
||
.SH COPYRIGHT
|
||
.
|
||
Copyright \(co 2003–2024 David White <davidnwhite@verizon.net>
|
||
.br
|
||
Toto je svobodný software; je licencován pod licencí GPL verze 2, tak jak je
|
||
publikována nadací Free Software Foundation. Tento program je bez záruky, a
|
||
to i co se týká obchodovatelnosti a použitelnosti.
|
||
.
|
||
.SH "VIZ TAKÉ"
|
||
.
|
||
\fBwesnoth\fP(6)
|
||
|