CLI:n käyttäminen

Jos dokumentissa on virheitä tai sinulla on ehdotuksia, kirjoita Mudfish-foorumille (https://forums.mudfish.net).

En tiedä, kuinka moni Mudfish-käyttäjä tarvitsee tätä valikkoa, mutta jos käytät sitä, olet luultavasti kokenut tietokoneen käyttäjä. :-) Mukava tavata!

Seuraavissa osioissa käytetään enemmän teknisiä termejä, joten lue ne huolellisesti.

CLI:n esittely

Ennen Mudfish Launcherin kehittämistä CLI (Command Line Interface) oli ainoa vianmäärityskeino. Nykyisin asetukset tehdään pääasiassa käyttöliittymässä, joten CLI:tä ei yleensä tarvita.

CLI on kuitenkin edelleen ainoa tarjottu tapa tutkia ongelmia, tehdä kaikkein edistyneimpiä asetuksia ja nähdä sisäisiä tilatietoja, joita käyttöliittymä ei näytä.

CLI-yhteyden avaaminen

Selvitä ensin IP-osoite ja portti, jossa CLI kuuntelee:

• Kirjaudu Mudfishiin.
• Avaa ”Tila → Prosessit” ja etsi lokitieto-osio. Se sisältää mudfish.exe:n ilmoitukset ohjelman käynnistyksestä nykyhetkeen.
• Lokin alussa oleva rivi ”[INFO] Listening the mangement console...” kertoo CLI:n IP-osoitteen ja portin. IP on aina paikallinen 127.0.0.1, ja käyttöjärjestelmä valitsee portin automaattisesti.

Yhdistä osoitteeseen komentokehotteen telnet-komennolla. Jos osoite on esimerkiksi 127.0.0.1:35323, käytä seuraavaa:

   C:\> telnet 127.0.0.1 35323

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

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

CLI-komennot

Pienikin virhe CLI-komennossa voi kaataa Mudfishin assertion-virheeseen. Kehittäjä teki tästä toiminnosta todella kehittäjäystävällisen…

Mudfish Core perustuu FreeBSD:n TCP/IP-pinoon ja verkkokehykseen. (FreeBSD on minulle tutuin… köh…) Siksi CLI-komentojen toiminnot ja käyttötapa vastaavat lähes täysin FreeBSD:n komentoja.

Suorita CLI:ssä help, niin näet tuettujen komentojen luettelon.

   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

Täydet komentokuvaukset voit etsiä tästä linkistä. connect-komentoa lukuun ottamatta komentojen pitäisi toimia kuten FreeBSD 8.0 RELEASEssa.

connect-komento

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Komento yrittää muodostaa TCP connect(2) -yhteyden Mudfishin virtuaaliliitäntöjen re(4) tai msk(4) kautta. Se on tarkoitettu vianmääritykseen: sillä selvitetään, onnistuuko yhteys haluttuun IP-osoitteeseen ja porttiin Mudfishin kautta.

Epäonnistumisesta tulostetaan virhe tai Timeout-ilmoitus. Onnistumisesta näytetään myös arvioitu RTT.