AMULECMD(1)

NOME
amulecmd - Programa baseado em console para controlar o aMule

SINOPSE
[-h <anfitrião>] [-p <porta>] [-P <senha>] [-f <path>] [-l <língua>] { [-w] | [-c <comando>] } [--create-config-from=<caminho>]

DESCRIÇÃO
amulecmd é um cliente de console para controlar o aMule.

[ -h <anfitrião>, --host=<anfitrião> ]
    Anfitrião onde o aMule está rodando (padrão: 127.0.0.1). <anfitrião> pode ser um endereço IP ou um nome de DNS

[ -p <porta>, --port=<porta> ]
    Porta do aMule para conexões externas, conforme configurado em Preferências->Controles Remotos (padrão: 4712)

[ -P <senha>, --password=<senha> ]
    Senha das Conexões Externas.

[ -f <caminho>, --config-file=<caminho> ]
    Use o arquivo de configuração dado. O arquivo de configuração padrão é ~/.aMule/remote.conf

Não imprima mensagens em stdout.

Seja verborrágico - mostre até as mensagens de debug.

[ -l <língua>, --locale=<língua> ]
    Configura o local do programa (linguagem). Veja a seção NOTAS para a descrição do parâmetro <lang>.

Escrever as opções da linha de comando para o arquivo de configuração e sair

[ -c <commando>, --command=<commando> ]
    Executar <command> como se fosse digitado no prompt do amulecmd e sair.

[ --create-config-from=<caminho> ]
    Criar arquivo de configuração baseado em <path>, que precisa apontar para um arquivo válido de configuração do aMule, e então sair.

Força compressão ZLIB no link de Conexões Externas independente da
    localidade IP-discada. Útil quando o lado do servidor for alcançável com um túnel VPN que resolve para um IP de LAN e a heurística iria pular a compressão.

Mostra o número de versão atual.

Imprime uma descrição de uso curta.

COMANDOS
Todos os comandos são insensíveis a maiúsculas e minúsculas. Adiciona um link eD2k ou link magnético ao núcleo. O link eD2k a ser adicionado pode ser:

    •   um link de arquivo (ed2k://|file|...), ele será adicionado à fila de download;

    •   um link de servidor (ed2k://|server|...), ele será adicionado à lista de servidores;

    •   um link de lista de servidores, no qual todos os servidores na lista serão adicionados à lista de servidores.
O link magnético precisa conter o hash eD2k e o tamanho do arquivo. Cancela o download especificado por <hash> ou <number>. Para pegar o valor, use show. Conectar à rede. Isto vai conectar à todas as redes que estiverem habilitadas nas preferências. Com o parâmetro opcional você pode especificar a que rede conectar. Ao dar um endereço de servidor na forma IP:Porta (onde IP é um endereço IPv4 ou um nome de DNS resolvível) o aMule vai conectar apenas a este servidor. Desconectar de todas as redes que estiver conectado ou apenas desconectar da rede especificada. Começar a baixar um arquivo. O <numero> de um arquivo da última busca tem que ser dado. Exemplo: `download 12' começará a baixar o arquivo com o número 12 da última busca. Desconecta do amule/amuled e sai de amulecmd. Obter e mostrar o valor da preferência selecionada. Valores disponíveis para <qual>:

    BwLimits
        Obter limites de largura de banda.

    IPFilter
        Pegar preferências de IPFilter.
Imprime uma descrição de uso curta. Se chamado sem parâmetros, mostra a lista dos comandos disponíveis. Se chamado com <command>, mostra uma descrição curta do comando dado. Pausa o download especificado por <hash> ou <numero>. Para pegar o número use show. Configura a prioridade de um download especificado por <hash> ou <numero>. Valores disponíveis para <prioridade>:

    Auto
        Prioridade automática.

    High
        Alta prioridade.

    Low Baixa prioridade.

    Normal
        Prioridade normal.
Mostra o progresso de uma busca em andamento. Um sinônimo para o comando exit. Recarrega um objeto dado. Valores disponíveis para <qual>:

    Shared
        Recarregar a lista de arquivos compartilhados.

    IPFilter
        Recarrega as tabelas de filtragem de IP.
Apaga o log. Mostra os resultados da última busca. Retoma o download especificado por <hash> ou <numero>. Para pegar o valor, use show. Faz uma busca pela <palavra chave> dada. Um tipo de busca e uma palavra chave são mandatórias para fazer isso. Exemplo: `search kad amule' executa uma busca kad por `amule'. Tipos de busca disponíveis:

    Global
        Executa uma busca global.

    Kad Executa uma busca na rede Kademlia.

    Local
        Executa uma busca local.

Filtros opcionais podem ser colocado antes, depois ou intercalados com as palavras chaves de busca:

    --type <Audio|Video|Image|Doc|Pro|Arc|Iso>
        Restringir os resultados ao tipo de arquivo dado.

    --extension <ext> (alias: --ext)
        Restringir os resultados ao tipo específico de extensão. (e.g. iso, mp3).

    --avail <N> (alias: --availability)
        Número mínimo de fontes que um resultado tem que reportar.

    --min-size <N[KMG]>
        Menor tamanho de arquivo a ser retornado. Os sufixos usam multiplicadores binários (K = 1024, M = K×1024, G = M×1024); sem sufixos significa bytes.

    --max-size <N[KMG]>
        Maior tamanho de arquivo a ser retornado. Mesmos sufixos que --min-size.

Exemplo: `earch global linux iso --type Iso --min-size 100M' retorna resultados para “linux iso” do tipo de arquivo Iso com no mínimo 100 MiB. Configura um dado valor de preferência. Valores disponíveis para <qual>:

    BwLimits
        Ajusta a limitação de largura de banda.

    IPFilter
        Configura preferências de IPFilter.
Mostra a fila de upload/download, lista de servidores or lista de arquivos compartilhados. Valores disponíveis para <qual>:

    DL  Mostrar fila de download.

    Log Mostrar o log.

    Servers
        Mostrar a lista de servidores.

    Shared
        Mostrar a lista de arquivos compartilhados.

    UL  Mostrar fila de upload.
Desliga o núcleo rodando remotamente (amule/amuled). Isto também desligará o cliente modo texto, já que este é inútil sem um núcleo rodando. Mostra a árvore de estatísticas. O <numero> opcional na faixa de 0-255 pode ser passado como argumento para este comando, que diz quantas entradas da sub-árvore de versão do cliente deve ser mostrada. Passar 0 ou omitir significa `ilimitado'. Exemplo: `statistics 5' vai mostrar apenas as 5 versões mais altas para cada tipo de cliente. Mostrar o estado das conexões, velocidades atuais de upload/download, etc.

NOTAS

  Caminhos
Para todas as opções que recebem um valor <path>, se o path não contém uma parte de diretório (i.e. apenas o nome de arquivo), então é considerado estar debaixo do diretório de configuração do aMule, ~/.aMule.

  Línguas
O parâmetro <lang> da opção -l tem a seguinte forma: lang[_LANG][.encoding][@modifier] onde lang é a linguagem principal, LANG é a sub-lingua/território, encoding é o conjunto de caracteres a ser utilizado e modifier permite ao usuário selecionar uma instância específica dos dados de localização dentro de uma única categoria. Por exemplo, as seguintes strings são válidas:
Apesar de todas as strings acima serem aceitas como definições de línguas válidas, encoding e modifier não são utilizados ainda. Além do formato acima, você pode também especificar nomes completos de linguagens em Inglês - deste modo -l german também é válido e é igual a -l de_DE. Quando nenhum local está definido, seja na linha de comando ou no arquivo de configuração, a linguagem padrão do sistema será utilizada.

ARQUIVOS
~/.aMule/remote.conf

EXEMPLO
Tipicamente, amulecmd será inicialmente rodado assim:

amulecmd -h nome do anfitrião -p porta EC -P senha EC -w

ou

amulecmd --create-config-from=/home/username/.aMule/amule.conf

Estes savarão as configurações em $HOME/.aMule/remote.conf, e posteriormente você só precisa digitar: Claro, você não precisa seguir este exemplo.

RELATANDO BUGS
Por favor, relate bugs ou em nosso forum (https://github.com/amule-org/amule/discussions), ou em nosso bugtracker (https://github.com/amule-org/amule/issues). Por favor, não relate bugs por e-mail, nem para nossa lista de e-mail, nem diretamente para qualquer membro do time.

DIREITOS DE CÓPIA
aMule e todos os seus utilitários relacionados são distribuídos sob a licença geral pública GNU.

VEJA TAMBÉM

AUTOR
Esta manpage foi escrita por Vollstrecker <amule@vollstreckernet.de>