Přeskočit na hlavní obsah

Používání CLI

Pokud v dokumentaci najdete chybu nebo máte návrh, napište na fórum Mudfish (https://forums.mudfish.net).

Nevím, kolik uživatelů Mudfish tuto nabídku využije, ale pokud ji používáte, nejspíš patříte mezi pokročilé uživatele počítačů. :-) Těší mě.

Následující části obsahují více odborných pojmů, proto je čtěte pozorně.

Úvod do CLI​

Než vznikl Mudfish Launcher, bylo CLI (Command Line Interface) jediným prostředkem ladění. Dnes se Mudfish většinou nastavuje přes uživatelské rozhraní a CLI se obvykle nepoužívá.

Pro analýzu problémů, velmi pokročilé nastavení nebo zobrazení interních stavů, které nejsou dostupné v rozhraní, je však CLI stále jedinou nabízenou možností.

Připojení k CLI​

Nejprve zjistěte IP adresu a port, na kterých CLI naslouchá:

  • Přihlaste se do Mudfish.

  • Otevřete Stav → Procesy a najděte část s protokolem. Obsahuje zprávy vypisované mudfish.exe od spuštění programu až do současnosti.

  • V horní části protokolu najděte řádek [INFO] Listening the mangement console... s IP adresou a portem CLI. IP adresa je vždy místní 127.0.0.1 a port automaticky přiděluje operační systém.

Z příkazového řádku se připojte příkazem telnet k uvedené adrese a portu. Pokud je například uvedeno 127.0.0.1:35323, použijte:

   C:\> telnet 127.0.0.1 35323

   -----------------------------
   MUDFISH CLI v2.0.8
   -----------------------------

   Type 'help' for command list.
   Type 'quit' to close CLI session.

Příkazy CLI​

I drobná chyba při použití současných příkazů CLI může způsobit pád Mudfish kvůli assert fail. Vývojář totiž tuto funkci vytvořil opravdu velice vstřícně pro vývojáře…

Mudfish Core je založen na TCP/IP stacku a síťovém frameworku FreeBSD. (FreeBSD znám nejlépe… ehm…) Funkce příkazů v CLI jsou proto téměř totožné s příkazy FreeBSD a podobné je i jejich použití.

Po připojení k CLI spusťte help a zobrazíte seznam podporovaných příkazů.

   help
       arp                 Address resolution display and control
       connect             Test a connection to the remote
       help                Show this help message
       ifconfig            Configure network interface parameters
       netstat             Show network status
       ping                send ICMP ECHO_REQUEST packets to network hosts
       route               Manually manipulate the routing tables
       quit                Exit CLI interface
       sysctl              Get or set kernel state

Úplný popis jednotlivých příkazů můžete vyhledat na této stránce. S výjimkou connect by měly fungovat stejně jako ve FreeBSD 8.0 RELEASE.

Příkaz connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Příkaz zkouší navázat TCP spojení pomocí connect(2) přes virtuální rozhraní Mudfish re(4) nebo msk(4). Slouží k ladění a ověření, zda je přes Mudfish možné připojení k požadované IP adrese a portu.

Při neúspěchu vypíše chybu nebo Timeout, při úspěchu také odhad RTT.