Salta al contingut principal

Ús de la CLI

Si trobeu errors al document o teniu suggeriments, deixeu un missatge al fòrum de Mudfish (https://forums.mudfish.net).

No sabem quants usuaris de Mudfish faran servir aquest menú, però, si l'utilitzeu, probablement sou usuaris avançats d'ordinadors. :-) Encantats de saludar-vos.

Els apartats següents poden contenir força terminologia tècnica; llegiu-los amb atenció.

Introducció a la CLI​

Abans que existís Mudfish Launcher, la CLI (Command Line Interface) era l'única eina de depuració. Actualment, la majoria de configuracions es fan des de la interfície gràfica i gairebé no cal passar per la CLI.

Tanmateix, continua sent l'únic mitjà disponible per analitzar problemes, aplicar els ajustos més especialitzats i consultar estats interns que la interfície gràfica no mostra.

Connectar-se a la CLI​

Per connectar-vos-hi, primer cal conèixer l'adreça IP i el port on escolta la CLI. Per trobar-los:

  • Inicieu sessió a Mudfish.

  • Aneu a «Estat → Processos». Hi trobareu l'apartat d'informació dels registres, que conté els missatges emesos per mudfish.exe des de l'inici del programa fins al moment actual.

  • A la part superior del registre, cerqueu la línia que comença per [INFO] Listening the mangement console... Aquesta línia conté la IP i el port de la CLI. La IP sempre és l'adreça local 127.0.0.1 i el sistema operatiu assigna automàticament el port.

Ara podeu connectar-vos a aquesta IP i port amb telnet des de l'indicador d'ordres. Per exemple, si hi figura 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.

Ordres de la CLI​

Actualment, fins i tot un petit error en utilitzar les ordres de la CLI pot provocar una fallada d'asserció i tancar Mudfish. Quan el desenvolupador va crear aquesta funció, la va fer mooooolt orientada als desenvolupadors...

Mudfish Core està basat en la pila TCP/IP i el marc de xarxa de FreeBSD. (És el sistema que el desenvolupador coneix millor... ehem...) Per això, les funcions de les ordres de la CLI són gairebé idèntiques a les de FreeBSD, i l'ús també és semblant.

Un cop connectats a la CLI, executeu help per veure la llista d'ordres disponibles:

   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

Si necessiteu una descripció completa de cada ordre, cerqueu-la en aquest enllaç. Excepte connect, haurien de funcionar igual que a FreeBSD 8.0 RELEASE.

Ordre connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Aquesta ordre intenta establir una connexió TCP connect(2) a través de les interfícies virtuals de Mudfish, re(4) o msk(4). És una eina de depuració per comprovar si es pot connectar a una IP i un port determinats mitjançant Mudfish.

Si la connexió falla, mostra un error o un missatge de temps d'espera esgotat. Si funciona, també mostra l'RTT estimat.