Перейти до основного вмісту

Використання CLI

Якщо ви знайшли помилку в документі або маєте пропозицію, напишіть на форумі Mudfish (https://forums.mudfish.net).

Не знаю, скільки користувачів Mudfish скористаються цим меню, але якщо ви його використовуєте, то, мабуть, добре знаєте комп’ютери. :-) Радий знайомству.

У наступних розділах буде більше спеціальної термінології, тому читайте уважно.

Про CLI​

До появи Mudfish Launcher CLI (Command Line Interface) був єдиним засобом налагодження. Тепер більшість налаштувань виконується через інтерфейс, тож CLI використовують рідше.

Проте для аналізу проблем, найтонших налаштувань або перегляду внутрішнього стану, недоступного через інтерфейс, наразі немає іншого способу, крім CLI.

Підключення до CLI​

Спочатку потрібно дізнатися IP-адресу й порт, які прослуховує CLI:

  • Увійдіть до Mudfish.

  • Відкрийте «Стан → Процес» і знайдіть розділ журналу. Він містить повідомлення mudfish.exe від запуску до поточного моменту.

  • На початку журналу знайдіть рядок [INFO] Listening the mangement console... — він указує IP/PORT CLI. IP завжди локальний, 127.0.0.1, а порт автоматично призначає ОС.

У командному рядку підключіться до цієї адреси й порту командою telnet. Наприклад, для 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.

Команди CLI​

Наразі навіть невелика помилка в командах CLI може спричинити assert fail і завершення Mudfish. Розробник зробив цю функцію ду-у-уже зручною саме для розробників...

Mudfish Core побудовано на TCP/IP-стеку й мережевій інфраструктурі FreeBSD (бо саме FreeBSD я знаю найкраще... кхм...). Тому команди CLI за функціями та способом використання майже такі самі, як у FreeBSD.

Після підключення виконайте help, щоб переглянути список підтримуваних команд.

   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

Повний опис кожної команди можна знайти за цим посиланням. За винятком connect, вони мають працювати так само, як у FreeBSD 8.0 RELEASE.

Команда connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Команда намагається встановити TCP-з’єднання connect(2) через віртуальні інтерфейси Mudfish (re(4) або msk(4)). Вона призначена для налагодження — перевірки, чи можна з’єднатися з потрібними IP і PORT через Mudfish.

У разі невдачі відображається помилка або Timeout; у разі успіху — очікуване значення RTT.