Scroll to navigation

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:

  • un enllaç de fitxer (ed2k://|file|...), que s'afegirà a la cua de baixades;
  • un enllaç de servidor (ed2k://|server|...), que s'afegirà a la llista de servidors;
  • un enllaç de llista de servidors, cas en què tots els servidors de la llista s'afegiran a la llista de servidors.

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>:

Obtén els límits d'amplada de banda.
Obtén les preferències de l'IPFilter.

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>:

Prioritat automàtica.
Prioritat alta.
Prioritat baixa.
Prioritat normal.

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.
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:

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'.
Fa una cerca global.
Fa una cerca a la xarxa Kademlia.
Fa una cerca local.

Es poden col·locar filtres opcionals abans, després o intercalats amb les paraules de cerca:

Restringeix els resultats al tipus de fitxer indicat.
Restringeix els resultats a una extensió de fitxer concreta (p. ex. iso, mp3).
Nombre mínim de fonts que ha d'informar un resultat.
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.
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>:

Estableix els límits d'amplada de banda.
Estableix les preferències de l'IPFilter.

Show <what>

Mostra la cua de pujada/baixada, la llista de servidors o la llista de fitxers compartits.

Valors disponibles per a <what>:

Mostra la cua de baixades.
Mostra el registre.
Mostra la llista de servidors.
Mostra la llista de fitxers compartits.
Mostra la cua de pujades.

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_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É

amule(1), amuled(1)

AUTOR

Aquesta pàgina de manual la va escriure Vollstrecker <amule@vollstreckernet.de>

October 2026 aMuleCmd v3.2.0