Passa al contenuto principale

Utilizzo della CLI

Se trovi errori nella documentazione o hai suggerimenti, lascia un messaggio nel forum Mudfish (https://forums.mudfish.net).

Non sappiamo quanti utenti Mudfish utilizzeranno questo menu, ma se lo fai probabilmente sei un utente esperto. :-) Benvenuto!

Nelle sezioni seguenti compaiono termini più tecnici: leggile con attenzione.

Introduzione alla CLI​

Prima della creazione di Mudfish Launcher, la CLI (Command Line Interface) era l’unico strumento di debug. Oggi, dato che la configurazione avviene principalmente tramite interfaccia grafica, la maggior parte degli utenti non la utilizza.

La CLI resta però l’unico metodo disponibile per analizzare alcuni problemi di Mudfish, accedere alle impostazioni più specialistiche e consultare stati interni non visibili nell’interfaccia.

Accesso alla CLI​

Per accedere devi conoscere l’indirizzo IP e la porta su cui la CLI è in ascolto. Per trovarli:

  • Effettua il login a Mudfish.
  • Apri "Stato → Processi" (상태 → 프로세스). La sezione "Informazioni di log" contiene i messaggi prodotti da mudfish.exe dall’avvio fino al momento attuale.
  • Nella parte iniziale del log, la riga "[INFO] Listening the mangement console..." indica IP e porta della CLI. L’IP è sempre l’indirizzo locale 127.0.0.1, mentre la porta viene assegnata automaticamente dal sistema operativo.

Dal prompt dei comandi, usa telnet per connetterti a quell’IP e porta. Ad esempio, se viene indicato 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.

Comandi della CLI​

Anche un piccolo errore nei comandi CLI può attualmente provocare un’asserzione fallita e arrestare Mudfish. Lo sviluppatore ha progettato questa funzione proprio a misura di sviluppatore...

Mudfish Core è basato sullo stack TCP/IP e sul framework di rete di FreeBSD: è il sistema con cui lo sviluppatore ha maggiore familiarità... Di conseguenza, le funzioni dei comandi CLI sono quasi identiche a quelle di FreeBSD, così come il loro utilizzo.

Dopo l’accesso alla CLI, esegui help per visualizzare i comandi attualmente supportati.

   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

Per una descrizione completa dei singoli comandi, cercali a questo indirizzo. Tranne connect, dovrebbero comportarsi come in FreeBSD 8.0 RELEASE.

Comando connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Questo comando tenta una connessione TCP connect(2) attraverso le interfacce virtuali di Mudfish, re(4) o msk(4). Serve al debug, per verificare se sia possibile raggiungere un determinato IP e una determinata porta tramite Mudfish.

Se la connessione fallisce, viene mostrato un errore o un timeout; se riesce, viene indicato anche l’RTT stimato.