Ga naar hoofdinhoud

De CLI gebruiken

Meld fouten in de documentatie of suggesties op het Mudfish-forum: https://forums.mudfish.net.

Waarschijnlijk zullen maar weinig Mudfish-gebruikers dit menu nodig hebben. Als je deze functie gebruikt, ben je vermoedelijk een gevorderde computergebruiker. Welkom! :-)

De volgende onderdelen bevatten meer vaktermen; lees ze zorgvuldig.

Over de CLI​

Voordat Mudfish Launcher bestond, was de CLI (Command Line Interface) het enige hulpmiddel voor foutopsporing. Tegenwoordig worden de meeste instellingen via de gebruikersinterface gemaakt en is de CLI meestal niet nodig.

De CLI blijft echter de enige beschikbare manier om bepaalde problemen te analyseren, zeer gespecialiseerde instellingen te maken en interne statussen te bekijken die de gebruikersinterface niet toont.

Verbinding maken met de CLI​

Zoek eerst het IP-adres en de poort waarop de CLI luistert:

  • Meld je aan bij Mudfish.
  • Open 'Status → Processen'. Het onderdeel 'Loggegevens' bevat de meldingen die mudfish.exe vanaf het starten tot nu heeft uitgevoerd.
  • Bovenaan het logboek staat een regel met '[INFO] Listening the mangement console...'. Hier vind je het CLI-IP-adres en de poort. Het IP-adres is altijd het lokale 127.0.0.1; het besturingssysteem wijst de poort automatisch toe.

Maak vervolgens via telnet in de opdrachtprompt verbinding met dit adres en deze poort. Voor 127.0.0.1:35323 doe je dat bijvoorbeeld zo:

   C:\> telnet 127.0.0.1 35323

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

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

CLI-commando's​

Zelfs een kleine fout bij een CLI-commando kan momenteel een assertion failure veroorzaken waardoor Mudfish stopt. De ontwikkelaar heeft deze functie namelijk bijzonder ontwikkelaarsgericht gemaakt...

Mudfish Core is gebouwd op de TCP/IP-stack en het netwerkframework van FreeBSD. (Dat is het systeem waarmee de ontwikkelaar het meest vertrouwd is.) Daarom lijken de functies en het gebruik van de CLI-commando's sterk op die van FreeBSD.

Voer na het verbinden het commando help uit om de beschikbare commando's te zien:

   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

Uitgebreide beschrijvingen per commando vind je via de FreeBSD-handleidingen. Met uitzondering van connect zouden de commando's hetzelfde moeten werken als in FreeBSD 8.0 RELEASE.

Het commando connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Dit commando probeert via de virtuele Mudfish-interfaces, re(4) of msk(4), een TCP connect(2)-verbinding te maken. Het is bedoeld voor foutopsporing: je controleert ermee of een bepaald IP-adres en een bepaalde poort via Mudfish bereikbaar zijn.

Bij mislukking verschijnt een fout- of timeoutmelding. Bij succes wordt ook de geschatte RTT getoond.