table of contents
- unstable 1:3.1.0-2
| 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 imprima mensagens em stdout.
- [ -v, --verbose ]
- 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>.
- [ -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 ]
- Separate the fields of the list commands with spaces, as earlier versions did, instead of tabs. Client names and file names may contain spaces, so the default tab separator is what lets a script split a row back into its fields; use this only for scripts written against the older output.
- [ --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>¶
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.
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 pesquisa. Opcionalmente, aceita um <id> de pesquisa (conforme exibido por search); sem um id, mostra a pesquisa iniciada mais recentemente. Várias pesquisas 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 pesquisa pela <palavra-chave> fornecida. Um tipo de pesquisa e uma palavra-chave são obrigatórios para realizar esta operação. Exemplo: 'search kad amule' realiza uma pesquisa na rede kad por 'amule'. Exibe um id de pesquisa; passe-o para results ou progress para acessar essa pesquisa. Várias pesquisas podem ser executadas ao mesmo tempo, cada uma com seu próprio id.
Tipos de busca disponíveis:
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: '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>
| September 2026 | aMuleCmd v3.1.0 |