| AMULECMD(1) | Utilitats de l'aMule | AMULECMD(1) |
NOM¶
amulecmd - programa de consola per controlar l'aMule
SINOPSI¶
amulecmd [-h <host>] [-p <port>] [-P <password>] [-f <path>] [-q] [-v] [-l <lang>] { [-w] | [-c <command>] } [--space-separated]
amulecmd [--create-config-from=<path>]
amulecmd [--version]
amulecmd [--help]
DESCRIPCIÓ¶
amulecmd és un client de consola per controlar l'aMule.
- [ -h <host>, --host=<host> ]
- Amfitrió on s'executa l'aMule (predeterminat: 127.0.0.1). <host> pot ser una adreça IP o un nom DNS
- [ -p <port>, --port=<port> ]
- Port de l'aMule per a connexions externes, tal com s'ha definit a Preferències->Controls remots (predeterminat: 4712)
- [ -P <password>, --password=<password> ]
- Contrasenya de les connexions externes.
- [ -f <path>, --config-file=<path> ]
- Fa servir el fitxer de configuració indicat. El fitxer de configuració predeterminat és ~/.aMule/remote.conf
- [ -q, --quiet ]
- No escriguis cap sortida a stdout.
- [ -v, --verbose ]
- Mode detallat: mostra també els missatges de depuració.
- [ -l <lang>, --locale=<lang> ]
- Estableix la configuració regional (idioma) del programa. Consulteu la secció NOTES per a la descripció del paràmetre <lang>.
- [ -w, --write-config ]
- Escriu les opcions de la línia d'ordres al fitxer de configuració i surt
- [ -c <command>, --command=<command> ]
- Executa <command> com si s'hagués escrit a l'indicador d'amulecmd i surt.
- [ --create-config-from=<path> ]
- Crea un fitxer de configuració basat en <path>, que ha d'apuntar a un fitxer de configuració vàlid de l'aMule, i després surt.
- [ --disable-ec-encryption ]
- No xifris l'enllaç de connexió externa. El xifratge es negocia automàticament sempre que l'aMule remot l'admet, i està activat per defecte per a totes les destinacions, locals o remotes. Si es desactiva, tot el que ve després de l'inici de sessió pot ser llegit, i modificat, per qualsevol que pugui observar la connexió.
- [ --force-zlib ]
- Força la compressió ZLIB a l'enllaç de connexió externa independentment de si la IP marcada és local. Útil quan el costat del servidor és accessible per un túnel VPN que resol a una IP de la LAN i l'heurística ometria la compressió.
- [ --space-separated ]
- Separa els camps de les ordres de llista amb espais, com feien les versions anteriors, en lloc de tabulacions. Els noms de client i de fitxer poden contenir espais, de manera que el separador de tabulació predeterminat és el que permet que un script torni a dividir una fila en els seus camps; feu-ho servir només per a scripts escrits per a la sortida antiga.
- [ --version ]
- Mostra el número de versió actual.
- [ --help ]
- Mostra una breu descripció d'ús.
ORDRES¶
Totes les ordres són insensibles a majúscules i minúscules.
Add <eD2k-link> | <magnet-link>¶
Afegeix un enllaç eD2k o un enllaç magnet al nucli.
L'enllaç eD2k que s'afegeix pot ser:
L'enllaç magnet ha de contenir el hash eD2k i la mida del fitxer.
Cancel <hash> | <number>¶
Cancel·la la baixada especificada per <hash> o <number>. Per obtenir-ne el valor, feu servir show.
Connect [ kad | ed2k | <ip|name> ]¶
Connecta a la xarxa.
Això connectarà a totes les xarxes habilitades a les preferències.
Amb el paràmetre opcional podeu especificar a quina xarxa voleu connectar. Si indiqueu una adreça de servidor en format IP:Port (on IP és una adreça IPv4 decimal amb punts o un nom DNS resoluble), l'aMule connectarà només a aquest servidor.
Disconnect [ ed2k | kad ]¶
Desconnecta de totes les xarxes a les quals esteu connectat, o desconnecta només de la xarxa especificada.
Download <number> [<id>]¶
Comença a baixar un fitxer.
Indiqueu el <number> d'un fitxer tal com el llista results, seguit opcionalment d'un <id> de cerca (tal com l'escriu search). Sense id, el número fa referència a l'última sortida de results, o a la cerca iniciada més recentment si encara no s'ha llistat res. Exemple: 'download 12' baixa el fitxer 12 dels últims resultats; 'download 12 3' baixa el fitxer 12 de la cerca 3.
Exit¶
Desconnecta d'amule/amuled i surt d'amulecmd.
Get <what>¶
Obtén i mostra el valor d'una preferència.
Valors disponibles per a <what>:
Help [ <command> ]¶
Mostra una breu descripció d'ús. Si es crida sense paràmetres, mostra una llista de les ordres disponibles. Si es crida amb <command>, mostra una breu descripció de l'ordre indicada.
Pause <hash> | <number>¶
Posa en pausa la baixada especificada per <hash> o <number>. Per obtenir-ne el valor, feu servir show.
Priority <priority> <hash> | <number>¶
Estableix la prioritat d'una baixada especificada per <hash> o <number>.
Valors disponibles per a <priority>:
Progress [<id>]¶
Mostra el progrés d'una cerca en curs. Opcionalment accepta un <id> de cerca (tal com l'escriu search); sense id, mostra la cerca iniciada més recentment.
Quit¶
Sinònim de l'ordre exit.
Reload <what>¶
Torna a carregar un objecte determinat.
Valors disponibles per a <what>:
- Torna a carregar la llista de fitxers compartits.
- IPFilter
- Torna a carregar les taules del filtre d'IP.
Reset¶
Reinicia el registre.
Results [<id>]¶
Mostra els resultats d'una cerca. Opcionalment accepta un <id> de cerca (tal com l'escriu search); sense id, mostra la cerca iniciada més recentment. El dimoni pot mantenir diverses cerques alhora, a les quals es fa referència per id.
Resume <hash> | <number>¶
Reprèn la baixada especificada per <hash> o <number>. Per obtenir-ne el valor, feu servir show.
Search <type> [<filters>] <keyword>¶
Fa una cerca de la <keyword> indicada. Per fer-ho, cal indicar un tipus de cerca i una paraula clau. Exemple: 'search kad amule' fa una cerca kad de 'amule'. Escriu un id de cerca; passeu-lo a results o progress per referir-vos a aquesta cerca. Es poden executar diverses cerques alhora, cadascuna amb el seu propi id.
Tipus de cerca disponibles:
- All
- Cerca a eD2k i Kad alhora, i fa servir la xarxa disponible si l'altra no es pot iniciar. Cal un dimoni que anunciï compatibilitat amb la cerca a totes les xarxes; els dimonis més antics retornen un error clar sense iniciar cap cerca. Exemple: 'search all amule'.
- Global
- Fa una cerca global.
- Kad
- Fa una cerca a la xarxa Kademlia.
- Local
- Fa una cerca local.
Es poden col·locar filtres opcionals abans, després o intercalats amb les paraules de cerca:
- --type <Audio|Video|Image|Doc|Pro|Arc|Iso>
- Restringeix els resultats al tipus de fitxer indicat.
- --extension <ext> (alias: --ext)
- Restringeix els resultats a una extensió de fitxer concreta (p. ex. iso, mp3).
- --avail <N> (alias: --availability)
- Nombre mínim de fonts que ha d'informar un resultat.
- --min-size <N[KMG]>
- Mida de fitxer mínima que es retorna. Els sufixos fan servir multiplicadors binaris (K = 1024, M = K×1024, G = M×1024); sense sufix vol dir bytes.
- --max-size <N[KMG]>
- Mida de fitxer màxima que es retorna. Mateixos sufixos que --min-size.
Exemple: 'search global linux iso --type Iso --min-size 100M' retorna resultats de 'linux iso' del tipus de fitxer Iso de com a mínim 100 MiB.
Set <what>¶
Estableix el valor d'una preferència.
Valors disponibles per a <what>:
Show <what>¶
Mostra la cua de pujada/baixada, la llista de servidors o la llista de fitxers compartits.
Valors disponibles per a <what>:
Shutdown¶
Atura el nucli remot en execució (amule/amuled). Això també aturarà el client de text, ja que no es pot fer servir sense un nucli en execució.
Statistics [ <number> ]¶
Mostra l'arbre d'estadístiques.
A aquesta ordre se li pot passar com a argument el <number> opcional, dins del rang 0-255, que indica quantes entrades del subarbre de versions de client s'han de mostrar. Passar-hi 0, o ometre'l, vol dir «il·limitat».
Exemple: 'statistics 5' mostrarà només les 5 versions principals de cada tipus de client.
Status¶
Mostra l'estat de la connexió, les velocitats actuals de pujada i baixada, etc.
NOTES¶
Camins¶
Per a totes les opcions que accepten un valor <path>, si el camí no conté cap part de directori (és a dir, només un nom de fitxer), es considera que és dins del directori de configuració de l'aMule, ~/.aMule.
Idiomes¶
El paràmetre <lang> de l'opció -l té la forma següent: lang[_LANG][.encoding][@modifier] on lang és l'idioma principal, LANG és un subidioma o territori, encoding és el joc de caràcters que cal fer servir i modifier permet a l'usuari seleccionar una instància concreta de dades de localització dins d'una mateixa categoria.
Per exemple, les cadenes següents són vàlides:
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro
Tot i que totes les cadenes anteriors s'accepten com a definicions d'idioma vàlides, encoding i modifier encara no s'utilitzen.
A més del format anterior, també podeu especificar els noms complets dels idiomes en anglès, de manera que -l german també és vàlid i equival a -l de_DE.
Quan no es defineix cap configuració regional, ni a la línia d'ordres ni al fitxer de configuració, es farà servir l'idioma predeterminat del sistema.
FITXERS¶
~/.aMule/remote.conf
EXEMPLE¶
Normalment amulecmd s'executarà primer així:
amulecmd -h hostname -p ECport -P ECpassword -w
o
amulecmd --create-config-from=/home/username/.aMule/amule.conf
Això desarà la configuració a $HOME/.aMule/remote.conf, i després només caldrà que escriviu:
amulecmd
Evidentment, no cal que seguiu aquest exemple.
COM INFORMAR D'ERRORS¶
Informeu dels errors al nostre fòrum (https://github.com/amule-org/amule/discussions) o al nostre sistema de seguiment d'errors (https://github.com/amule-org/amule/issues). No informeu dels errors per correu electrònic, ni a la nostra llista de correu ni directament a cap membre de l'equip.
DRETS D'AUTOR¶
L'aMule i totes les utilitats relacionades es distribueixen sota la Llicència Pública General de GNU.
VEGEU TAMBɶ
AUTOR¶
Aquesta pàgina de manual la va escriure Vollstrecker <amule@vollstreckernet.de>
| October 2026 | aMuleCmd v3.2.0 |