table of contents
| AMULECMD(1) | utilitários aMule | AMULECMD(1) |
NOME¶
amulecmd - Programa baseado em console para controlar o aMule
SINOPSE¶
amulecmd [-h <anfitrião>] [-p <porta>] [-P <senha>] [-f <path>] [-q] [-v] [-l <língua>] { [-w] | [-c <comando>] } [--space-separated]
amulecmd [--create-config-from=<caminho>]
amulecmd [--version]
amulecmd [--help]
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
- [ -q, --quiet ]
- Não imprimir nenhuma saída em stdout.
- [ -v, --verbose ]
- Ser detalhado - mostrar também as mensagens de depuração.
- [ -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>.
- [ -w, --write-config ]
- 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.
- [ --disable-ec-encryption ]
- Não criptografe o link de Conexões Externas. A criptografia é negociada automaticamente sempre que o aMule remoto suportá-la, e está ligada por padrão para todos os destinos, locais ou remotos. Desligá-la deixa tudo legível após o login, e modificável por qualquer um capaz de observar a conexão.
- [ --force-zlib ]
- 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.
- [ --space-separated ]
- Separar os campos da lista de comandos com espaços, como faziam as versões anteriores, ao invés de tabs. Nomes de clientes e nomes de arquivos podem conter espaços, deste modo o padrão de separador com tab é o que permite a um script separar uma linha de volta em seus campos; use isto apenas para scripts escritos contra a saída antiga.
- [ --version ]
- Mostra o número de versão atual.
- [ --help ]
- Imprime uma descrição de uso curta.
COMANDOS¶
Todos os comandos são insensíveis a maiúsculas e minúsculas.
Add <eD2k-link> | <magnet-link>¶
Adiciona um link eD2k ou link magnético ao núcleo.
O link eD2k a ser adicionado pode ser:
O link magnético precisa conter o hash eD2k e o tamanho do arquivo.
Cancel <hash> | <number>¶
Cancela o download especificado por <hash> ou <number>. Para pegar o valor, use show.
Connect [ kad | ed2k | <ip|name> ]¶
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.
Disconnect [ ed2k | kad ]¶
Desconectar de todas as redes que estiver conectado ou apenas desconectar da rede especificada.
Download <number> [<id>]¶
Começar a baixar um arquivo.
Dê o <numero> de um arquivo como listado em resultados, opcionalmente seguido por um <id> de busca (tal como impresso por busca). Sem um id, o número se refere à última saída resultados, ou à busca iniciada mais recentemente se nada foi listado ainda. Exemplo: 'download 12' baixa o arquivo 12 do último resultado; 'download 12 3' baixa o arquivo 12 da busca 3.
Exit¶
Desconecta do amule/amuled e sai de amulecmd.
Get <what>¶
Obter e mostrar o valor da preferência selecionada.
Valores disponíveis para <qual>:
Help [ <command> ]¶
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.
Pause <hash> | <number>¶
Pausa o download especificado por <hash> ou <numero>. Para pegar o número use show.
Priority <priority> <hash> | <number>¶
Configura a prioridade de um download especificado por <hash> ou <numero>.
Valores disponíveis para <prioridade>:
Progress [<id>]¶
Mostra o progresso de uma busca em andamento. Opcionalmente pega uma busca <id> (tal como impressa por search); sem id, mostra a busca iniciada mais recentemente.
Quit¶
Um sinônimo para o comando exit.
Reload <what>¶
Recarrega um objeto dado.
Valores disponíveis para <qual>:
- Recarregar a lista de arquivos compartilhados.
- IPFilter
- Recarrega as tabelas de filtragem de IP.
Reset¶
Apaga o log.
Results [<id>]¶
Mostra os resultados de uma busca. Opcionalmente, aceita um <id> de busca (conforme exibido por search); sem um id, mostra a busca iniciada mais recentemente. Várias buscas podem ser mantidas no daemon ao mesmo tempo e acessadas por id.
Resume <hash> | <number>¶
Retoma o download especificado por <hash> ou <numero>. Para pegar o valor, use show.
Search <type> [<filters>] <keyword>¶
Realiza uma busca pela <palavra-chave> fornecida. Um tipo de busca e uma palavra-chave são obrigatórios para realizar esta operação. Exemplo: 'search kad amule' realiza uma busca na rede kad por 'amule'. Exibe um id de busca; passe-o para results ou progress para acessar essa busca. Várias buscas podem ser executadas ao mesmo tempo, cada uma com seu próprio id.
Tipos de busca disponíveis:
- All
- Buscas nas redes eD2k e Kad juntas, usando a próxima rede disponível se a outra não conseguir iniciar. Requer um daemon propagando suporte de "Todas as buscas"; daemons antigos retornam um erro sem iniciar uma busca. Exemplo: 'search all amule'.
- 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)
- Restringe os resultados a uma extensão de arquivo específica (p.ex. 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: 'search global linux iso --type Iso --min-size 100M' retorna resultados para 'linux iso' do tipo de arquivo Iso com no mínimo 100 MiB.
Set <what>¶
Configura um dado valor de preferência.
Valores disponíveis para <qual>:
Show <what>¶
Mostra a fila de upload/download, lista de servidores or lista de arquivos compartilhados.
Valores disponíveis para <qual>:
Shutdown¶
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.
Statistics [ <number> ]¶
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 devem ser mostradas. Passar 0 ou omitir significa 'ilimitado'.
Exemplo: 'statistics 5' vai mostrar apenas as 5 versões mais altas para cada tipo de cliente.
Status¶
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:
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro
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:
amulecmd
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>
| October 2026 | aMuleCmd v3.2.0 |