Przejdź do głównej zawartości

Korzystanie z CLI

Jeśli znajdziesz błąd w dokumencie lub masz sugestię, napisz na forum Mudfish (https://forums.mudfish.net).

Nie wiem, ilu użytkowników Mudfish skorzysta z tego menu, ale jeśli zamierzasz to zrobić, zapewne jesteś zaawansowanym użytkownikiem komputera. :-) Miło Cię poznać.

W kolejnych sekcjach pojawia się więcej specjalistycznej terminologii, więc czytaj je uważnie.

Wprowadzenie do CLI​

Zanim powstał Mudfish Launcher, CLI (Command Line Interface) było jedynym narzędziem debugowania. Obecnie większość ustawień wykonuje się przez interfejs graficzny i zwykle nie korzysta się z CLI.

Jednak do szczegółowej analizy problemów, najbardziej zaawansowanej konfiguracji lub sprawdzania wewnętrznego stanu niedostępnego w interfejsie CLI pozostaje jedyną udostępnianą metodą.

Łączenie z CLI​

Najpierw ustal adres IP i port nasłuchu CLI:

  • Zaloguj się do Mudfish.

  • Otwórz „Stan → Procesy” (상태 → 프로세스). W sekcji informacji o logach znajdują się komunikaty mudfish.exe od uruchomienia programu do chwili obecnej.

  • Na początku logu znajdź wiersz [INFO] Listening the mangement console... Zawiera adres IP i port CLI. Adres jest zawsze lokalny, 127.0.0.1, a port automatycznie przydziela system operacyjny.

Połącz się z tym adresem i portem przez telnet w wierszu poleceń. Na przykład dla 127.0.0.1:35323:

   C:\> telnet 127.0.0.1 35323

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

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

Polecenia CLI​

Nawet drobny błąd przy używaniu obecnych poleceń CLI może spowodować błąd asercji i zakończenie Mudfish. Twórca przygotował tę funkcję baaardzo pod kątem programistów…

Mudfish Core opiera się na stosie TCP/IP i infrastrukturze sieciowej FreeBSD. (To właśnie FreeBSD znam najlepiej… ekhm…). Dlatego funkcje poleceń CLI są niemal identyczne z ich odpowiednikami w FreeBSD. Sposób użycia również jest podobny.

Po połączeniu wykonaj help, aby wyświetlić listę obsługiwanych poleceń.

   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

Pełne opisy poleceń znajdziesz w podręczniku FreeBSD. Z wyjątkiem connect powinny działać tak jak w FreeBSD 8.0 RELEASE.

Polecenie connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Polecenie próbuje nawiązać połączenie TCP connect(2) przez wirtualne interfejsy Mudfish re(4) lub msk(4). Służy do debugowania: sprawdza, czy można połączyć się z danym adresem IP i portem przez Mudfish.

Przy niepowodzeniu wyświetlany jest błąd lub przekroczenie limitu czasu; przy powodzeniu — przewidywane RTT.