310 lines
11 KiB
Groff
310 lines
11 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 2021 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\-dv\fP\|] [\|\fB\-c\fP \fIcesta\fP\|] [\|\fB\-p\fP \fIport\fP\|] [\|\fB\-t\fP
|
||
\fIpočet_vláken\fP\|] [\|\fB\-T\fP \fIpočet_vláken\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\-t,\ \fP\fIpočet\fP\fB,\ \-\-threads\fP\fI\ počet\fP
|
||
nastavuje nejvyšší počet pracovních vláken čekajících na vstupně\-výstupní
|
||
síťové operace. (výchozí hodnota: \fB5\fP,\ maximum:\ \fB30\fP)
|
||
.TP
|
||
\fB\-T,\ \fP\fIpočet\fP\fB,\ \-\-max\-threads\fP\fI\ počet\fP
|
||
nastavuje nejvyšší počet pracovních vláken, který bude vytvořen. Při
|
||
nastavení na \fB0\fP nebude žádné omezení. (výchozí hodnota: \fB0\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
|
||
\fBcompress_stored_rooms\fP
|
||
Určuje, zda je soubor s místnostmi čten a zapisován jako
|
||
komprimovaný. Výchozí hodnotou je \fByes\fP.
|
||
.TP
|
||
\fBconnections_allowed\fP
|
||
Počet povolených spojení z\ jedné IP adresy. \fB0\fP znamená nekonečno. (výchozí
|
||
hodnota: \fB5\fP)
|
||
.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*,*server*,ai,ai?,computer,human,network,player\fP.
|
||
.TP
|
||
\fBfifo_path\fP
|
||
Cesta k\ fifo, do níž můžete 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
|
||
\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
|
||
\fBnew_room_policy\fP
|
||
Určuje, kdo může vytvářet na serveru nové místnosti. Dostupné hodnoty
|
||
zahrnují \fBeveryone\fP, \fBregistered\fP, \fBadmin\fP a\ \fBnobody\fP\ – místnosti pak
|
||
může vytvářet každý, registrovaní uživatelé, pouze správci nebo
|
||
nikdo. Výchozí hodnota je \fBeveryone\fP.
|
||
.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
|
||
\fBroom_save_file\fP
|
||
Cesta k souboru, v němž jsou ukládány informace o místnostech. Tento soubor
|
||
je načten při spuštění serveru a poté přepisován. Pokud je prázdný nebo není
|
||
nastaven, ukládání a načítání místností nebude aktivní.
|
||
.TP
|
||
\fBsave_replays\fP
|
||
Určuje, zda bude server automaticky ukládat záznamy her. (výchozí hodnota:
|
||
\fBfalse\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.
|
||
.TP
|
||
\fBuser_handler\fP
|
||
Název handleru uživatelů, jenž má být použit. V tuto chvíli jsou dostupné
|
||
handlery \fBforum\fP (propojení s databází phpbb) a \fBsample\fP (vzorová
|
||
implementace rozhraní, prakticky nepoužitelná). Výchozí hodnota je
|
||
\fBforum\fP. Handler musí být dále konfigurován v sekci \fB[user_handler]\fP \- viz
|
||
níže.
|
||
.
|
||
.SS "Globální značky:"
|
||
.
|
||
.P
|
||
\fB[redirect]\fP Značka udávající server, na který bude přesměrován požadavek
|
||
pro konkrétní verzi klienta.
|
||
.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ů. Dostupné klíče se liší
|
||
podle toho, jaká obsluha uživatelů je klíčem \fBuser_handler\fP
|
||
nastavena. 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.
|
||
.RS
|
||
.TP
|
||
\fBdb_host\fP
|
||
(pro user_handler=forum) Název hostitele databázového serveru
|
||
.TP
|
||
\fBdb_name\fP
|
||
(pro user_handler=forum) Název databáze
|
||
.TP
|
||
\fBdb_user\fP
|
||
(pro user_handler=forum) Název uživatele pro přihlášení k databázi
|
||
.TP
|
||
\fBdb_password\fP
|
||
(pro user_handler=forum) Heslo tohoto uživatele
|
||
.TP
|
||
\fBdb_users_table\fP
|
||
(pro user_handler=forum) 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
|
||
(pro user_handler=forum) Název tabulky, do které bude wesnothd ukládat svá
|
||
vlastní data o\ uživatelích. Tuto tabulku budeš muset vytvořit ručně.
|
||
.TP
|
||
\fBdb_game_info_table\fP
|
||
(pro user_handler=forum) Název tabulky, do které bude wesnothd ukládat svá
|
||
vlastní data o\ hrách.
|
||
.TP
|
||
\fBdb_game_player_info_table\fP
|
||
(pro user_handler=forum) Název tabulky, do které bude wesnothd ukládat svá
|
||
vlastní data o\ hráčích ve hře.
|
||
.TP
|
||
\fBdb_game_modification_info_table\fP
|
||
(pro user_handler=forum) Název tabulky, do které bude wesnothd ukládat svá
|
||
vlastní data o\ modifikacích použitých ve hře.
|
||
.TP
|
||
\fBdb_user_group_table\fP
|
||
(pro user_handler=forum) 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
|
||
\fBmp_mod_group\fP
|
||
(pro user_handler=forum) Identifikátor skupiny fóra, o\ které se předpokládá,
|
||
že má oprávnění k\ moderování.
|
||
.TP
|
||
\fBuser_expiration\fP
|
||
(pro user_handler=sample) Čas, po němž vyprší platnost registrovaného
|
||
uživatelského jména (dny).
|
||
.RE
|
||
.P
|
||
\fB[mail]\fP Konfiguruje SMTP server skrz nějž je možno odesílat poštu
|
||
uživatelského handleru. V tuto chvíli jej používá pouze vzorový handler.
|
||
.RS
|
||
.TP
|
||
\fBserver\fP
|
||
Název hostitele poštovního serveru
|
||
.TP
|
||
\fBusername\fP
|
||
Název uživatele pro přihlášení k\ poštovnímu serveru.
|
||
.TP
|
||
\fBpassword\fP
|
||
Heslo tohoto uživatele.
|
||
.TP
|
||
\fBfrom_address\fP
|
||
Adresa pro odpověď na tvůj mail.
|
||
.TP
|
||
\fBmail_port\fP
|
||
Port, na němž běží emailový server. Výchozí hodnota 25.
|
||
.
|
||
.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štivte oficiální stránky: https://www.wesnoth.org/
|
||
.
|
||
.SH COPYRIGHT
|
||
.
|
||
Copyright \(co 2003\-2021 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)
|