Saltar para o conteúdo principal

Utilizar a CLI

Se encontrar um erro neste documento ou tiver sugestões, deixe uma mensagem nos fóruns do Mudfish: https://forums.mudfish.net.

Poucos utilizadores precisarão deste menu. Se está a utilizá-lo, provavelmente tem conhecimentos avançados de informática. :-) Bem-vindo!

As secções abaixo podem conter termos mais técnicos, por isso leia-os com atenção.

Introdução à CLI​

Antes da criação do Mudfish Launcher, a CLI (Command Line Interface) era o único meio de depuração. Atualmente, a maioria das configurações é feita pela interface gráfica, pelo que a CLI é menos utilizada.

Ainda assim, a CLI é o único meio disponível para realizar certas análises, aplicar configurações muito específicas e consultar estados internos que não aparecem na interface gráfica.

Aceder à CLI​

Para aceder à CLI, identifique primeiro o IP e a porta em que está à escuta. Siga estes passos.

  • Inicie sessão no Mudfish.

  • Abra «Estado → Processo» e procure a secção de registos. Contém as mensagens produzidas por mudfish.exe desde o arranque até ao momento atual.

  • Perto do início do registo, procure a linha «[INFO] Listening the mangement console...». Esta indica o IP e a porta da CLI. O IP é sempre 127.0.0.1, e o sistema operativo atribui a porta automaticamente.

Na linha de comandos, utilize telnet para se ligar a esse IP e porta. Por exemplo, se aparecer 127.0.0.1:35323, utilize:

   C:\> telnet 127.0.0.1 35323

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

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

Comandos da CLI​

Um pequeno erro num comando da CLI pode provocar uma falha de asserção e terminar o Mudfish. Esta interface foi concebida sobretudo para o programador.

O Mudfish Core baseia-se na pilha TCP/IP e na infraestrutura de rede do FreeBSD, o sistema com que o autor está mais familiarizado. Por isso, os comandos da CLI e a sua utilização são muito semelhantes aos do FreeBSD.

Depois de aceder à CLI, execute help para consultar os comandos disponíveis.

   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

Se precisar de uma explicação completa de cada comando, pode pesquisá-lo em ligação. Excetuando o comando connect, deverá funcionar da mesma forma que o FreeBSD 8.0 RELEASE.

Comando connect​

   connect
   usage: connect ip port

   connect 68.180.206.184 80
   connection was good (RTT 0.156 secs)

Este comando tenta estabelecer uma ligação TCP com connect(2) através das interfaces virtuais re(4) ou msk(4) do Mudfish. Serve para depurar a ligação a um determinado IP e porta através do serviço.

Se a ligação falhar, aparece um erro ou uma mensagem de timeout. Se funcionar, é também apresentado o RTT estimado.