NÁZEV¶

Bitva o Wesnoth - síťový server pro hru více hráčů

POUŽITͶ

wesnothd [-dv] [-c cesta] [-p port] [-t počet_vláken] [-T počet_vláken] wesnothd -V

POPIS¶

Součást Bitvy o Wesnoth spravující hry více hráčů. Na http://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.

VOLBY¶

-c cesta, --config cesta

specifikuje cestu, kde má wesnothd hledat konfigurační soubor. Syntaxe souboru je popsána v sekci KONFIGURACE SERVERU níže. Konfiguraci je možno znovu načíst posláním SIGHUP procesu serveru.

-d, --daemon

spouští wesnothd jako démona.

-h, --help

zobrazuje nápovědu k parametrům příkazové řádky.

--log-level=kategorie1,kategorie2,...

nastavuje úroveň závažnosti pro jednotlivé kategorie. all znamená, že budou vypisovány všechny kategorie. Dostupné kategorie: error,  warning, info, debug. Implicitně je aktivována kategorie error a pro kategorii server také info.

-p port, --port port

určuje, který port má server používat. Implicitní hodnota je 15000.

-t, počet, --threads počet

nastavuje limit pro počet nečinných vláken čekajících na síťová spojení (implicitně: 5, max: 30).

-T, počet, --max-threads počet

nastavuje nejvyšší počet vláken, které wesnothd vytvoří; 0 znamená bez omezení (implicitně: 0).

-V, --version

zobrazí verzi wesnothd a skončí.

-v, --verbose

zapíná výpis rozšířených logovacích informací.

KONFIGURACE SERVERU¶

Obecná syntaxe je:¶

[ značka]

klíč="hodnota"

klíč="hodnota,hodnota,..."

[/ značka]

Globální klíče:¶

allow_remote_shutdown

Při nastavení na no (výchozí), požadavky shut_down a restart jsou ignorovány, pokud nepocházejí z fifo. Při nastavení yes může správce vzdáleně vypnout server pomocí /query.

ban_save_file

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í.

compress_stored_rooms

Určuje, zda je soubor s místnostmi čten a zapisován jako komprimovaný. Výchozí hodnota yes.

connections_allowed

Počet povolených spojení z jedné IP adresy. 0 znamená nekonečno. (implicitně 5)

disallow_names

Jména/přezdívky, které nejsou serverem akceptována. Je možno použít metaznaky * a ?. Více viz. glob(7). Implicitní hodnota je: *admin*,*admln*,*server*,ai,ai?,computer,human,network,player.

fifo_path

Cesta k fifo, do nějž můžete posílat příkazy serveru (stejně jako pomocí /query z klienta). Pokud není explicitně určena, je použita výchozí hodnota určená při kompilaci (běžně /var/run/socket/wesnothd/socket).

max_messages

Maximální počet zpráv, které jsou přijaty během messages_time_period. (implicitně 4)

messages_time_period

Časová perioda (ve vteřinách), po které se nuluje počítadlo přijatých zpráv. (implicitně 10 sekund)

motd

Zpráva dne.

new_room_policy

Určuje, kdo může vytvářet na serveru nové místnosti. Dostupné hodnoty zahrnují everyone, registered, admin a nobody - místosti pak může vytvářet každý, registrovaní uživatelé, pouze správci nebo nikdo. Výchozí hodnota je everyone.

passwd

Heslo pro získání administrátorských práv. (Přes /query admin password.)

replay_save_path

Adresář, do nějž server ukládá záznamy her (nezapomeňte na / na konci!). Výchozí hodnota je `', neboli adresář v němž byl server spuštěn.

restart_command

Příkaz, který server použije pro spuštění nového procesu sebe sama při příkazu restart. (Lze nastavit pouze přes fifo. Více viz allow_remote_shutdown.)

room_save_file

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í.

save_replays

Určuje, zda bude server automaticky ukládat záznamy her (výchozí hodnota: false).

versions_accepted

Seznam čárkou oddělených řetězců verzí Wesnothu, které jsou serverem akceptovány. Je možno použít zástupné znaky * a ?. Implicitní hodnota odpovídá příslušné verzi wesnothu.

 

Příklad: versions_accepted="*" akceptuje všechny verze.

user_handler

Název handleru uživatelů, jenž má být použit. V tuto chvíli jsou dostupné handlery forum (propojení s databází phpbb) a sample (vzorová implementace rozhraní, prakticky nepoužitelná). Výchozí hodnota je forum. Handler musí být dále konfigurován v sekci [user_handler] - viz níže.

Globální značky:¶

[redirect] Značka udávající server, na který bude přesměrován požadavek pro konkrétní verzi klienta. [ban_time] Tag umožňující definovat klíčová slova pro délky zákazů přístupu (ban). [proxy] 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 [redirect]. [user_handler] Konfiguruje uživatelský handler. Dostupné klíče se liší podle toho, který handler je použit - nastaveno klíčem user_handler. Pokud není v konfiguraci nalezena žádná sekce [user_handler], server poběží bez služeb správy přezdívek. [mail] 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.

NÁVRATOVÝ STATUS¶

Status normálního ukončení, tedy když se server korektně vypne, je 0. Návratový status 2 pak signalizuje chybu při zpracování nějaké volby z příkazového řádku.

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 manovou stránku původně vytvořil Cyril Bouthors <cyril@bouthors.org>. Překlad Oto 'tapik' Buchta <tapik@buchtovi.cz> a Vladimír Slávik <slavik.vladimir@seznam.cz>. Navštivte oficiální stránky: http://www.wesnoth.org/

COPYRIGHT¶

Copyright © 2003-2013 David White <davidnwhite@verizon.net> 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.

VIZ TAKɶ

wesnoth(6).