AMULECMD(1)

NOME
amulecmd - programma in console per controllare aMule

SINTASSI
[-h <host>] [-p <porta>] [-P <password>] [-f <percorso>] [-l <linguaggio>] { [-w] | [-c <comando>] } [--create-config-from=<percorso>]

DESCRIZIONE
amulecmd è un client in console per controllare aMule.

[ -h <host>, --host=<host> ]
    Computer dove è in esecuzione aMule (default: localhost). <host> può essere un indirizzo IP o un nome DNS.

[ -p <porta>, --port=<porta> ]
    Porta di aMule per le connessioni esterne, come impostata nelle preferenze->controllo remoto (default: 4712)

[ -P <password>, --password=<password> ]
    Password delle connessioni esterne.

[ -f <percorso>, --config-file=<percorso> ]
    Usa il file di configurazione fornito. Il file di configurazione di default è ~/.aMule/remote.conf

Non scrivere nulla nello stdout.

Mostra anche i messaggi di debug.

[ -l <linguaggio>, --locale=<linguaggio> ]
    Imposta il linguaggio del programma. Vedi anche la sezione delle NOTE per la descrizione del parametro <linguaggio> .

Scrive le opzioni della riga di comando nel file di configurazione ed esce.

[ -c <comando>, --command=<comando> ]
    Esegue il <comando> come se fosse stato immesso nel prompt di amulecmd ed esce.

[ --create-config-from=<percorso> ]
    Crea un file di configurazione basandosi sul <percorso>, che deve puntare ad un file di configurazione di aMule valido, e quindi esce.

Visualizza il numero della versione corrente.

Stampa una breve descrizione dell'utilizzo.

COMANDI
Tutti i comandi non distinguono tra maiuscolo e minuscolo.

  Add <collegamento-eD2k> | <collegamento-magnet>
Aggiunge un collegamento eD2k o un collegamento magnet. Il collegamento eD2k da aggiungere può essere:

    •   un collegamento a un file (ed2k://|file|...), sarà aggiunto alla coda di download;

    •   un collegamento a un server (ed2k://|server|...), sarà aggiunto alla lista dei server;

    •   un collegamento ad una lista di server, nel cui caso tutti i server contenuti nella lista saranno aggiunti alla lista dei server correnti.
Il collegamento magnet deve contenere l'hash eD2k e la lunghezza del file.

  Cancel <hash> | <numero>
Cancella il download specificato da <hash> o <numero>. Per ottenere il valore utilizzare show.

  Connect [ kad | ed2k | <ip|nome> ]
Connessione alla rete. Questo avvierà la connessione a tutte le reti abilitate nelle preferenze. Quando viene fornito il parametro ed2k, si connetterà solo alla rete eD2k, ai server definiti nella lista dei server. Si può anche specificare come opzione un indirizzo di server nella forma IP:Porta, per connettersi unicamente a quel server. L'indirizzo IP deve essere un indirizzo IPv4 in forma decimale puntuata, o un nome DNS risolvibile. Se fornito il parametro kad, si connetterà solo alla rete Kad. Disconnette da tutte le reti attualmente connesse, o disconnette solo dalla rete specificata.

  Download <numero>
Inizia il download di un file. Deve essere fornito il <numero> di un file dall'ultima ricerca.Esempio: `download 12' inizierà il download del file numero 12 della ricerca precedente. Disconnette da amule/amuled ed esce da amulecmd.

  Get <oggetto>
Legge e visualizza un valore delle preferenze. I valori disponibili per l'<oggetto> sono:

    BwLimits
        Legge i limiti di banda.

    IPFilter
        Legge le preferenze del filtro IP.

  Help [ <comando> ]
Visualizza una breve descrizione dell'uso. Se chiamato senza parametro, mostra una lista dei comandi disponibili. Se chiamato con il parametro <command>, mostra una breve descrizione del comando dato

  Pause <hash> | <numero>
Mette in pausa il download specificato da <hash> o <numero>. Per ottenere il valore utilizzare show.

  Priority <priorità> <hash> | <numero>
Imposta la priorità di un download specificato da <hash> o <numero>. I valori disponibili per <priorità> sono:

    Auto
        Priorità automatica.

    High
        Priorità alta.

    Low Priorità bassa.

    Normal
        Priorità normale.
Mostra i progressi di una ricerca in corso. Un sinonimo del comando exit.

  Reload <oggetto>
Ricarica un dato oggetto I valori disponibili per l'<oggetto> sono:

    Shared
        Ricarica la lista dei file condivisi.

    IPFilter
        Ricarica la tabella dei filtri IP.
Cancella il log. Mostra i risultati dell'ultima ricerca.

  Resume <hash> | <numero>
Riprende il download specificato da <hash> o <numero>. Per ottenere il valore utilizzare show.

  Cerca <tipo> <parola-chiave>
Esegue una ricerca per la data <parola-chiave>. Il tipo della ricerca e una parola chiave da cercare sono obbligatori. Esempio: `search kad amule' esegue una ricerca sulla rete kad per `amule'. Tipi di ricerca disponibili:

    Global
        Esegue una ricerca globale.

    Kad Esegue una ricerca sulla rete Kademlia.

    Local
        Esegue una ricerca locale.

  Set <oggetto>
Imposta un dato valore di preferenza. I valori disponibili per l'<oggetto> sono:

    BwLimits
        Imposta i limiti di banda.

    IPFilter
        Imposta le preferenze del filtro IP.

  Show <oggetto>
Mostra la coda di upload/download, la lista dei server o la lista dei file condivisi. I valori disponibili per l'<oggetto> sono:

    DL  Mostra la coda di download.

    Log Mostra il log.

    Servers
        Mostra la lista dei server.

    UL  Mostra la coda di upload.
Chiude il motore remoto in esecuzione (amule/amuled). Questo chiuderà anche il cliente in formato testo, siccome è inutile senza un motore in esecuzione.

  Statistics [ <numero> ]
Mostra l'albero delle statistiche. Il <numero> opzionale, nell'intervallo 0-255, può essere passato come argomento a questo comando per indicare quante righe del ramo delle versioni dei client devono essere mostrate. Indicando 0, o omettendo il parametro significa `illimitato'. Esempio: `statistics 5' mostrerà solo le prime 5 versioni per ogni tipo di client. Mostra lo stato della connessione, le velocità correnti di up/download, ecc.

NOTE

  Percorsi
Per tutte le opzioni che accettano un <percorso>, se il percorso non contiene una directory (ossia è solo un nome di file), allora si assume che esso sia presente nella directory di configurazione di aMule, ~/.aMule.

  Linguaggi
Il parametro <linguaggio> per l'opzione -l ha la forma seguente: linguaggio[_LINGUAGGIO][.codifica][@modificatore] dove linguaggio è il linguaggio primario, LINGUAGGIO è il sottotipo/territorio, codifica è l'insieme di caratteri usato e modificatore consente all'utente di selezionare una specifica istanza dei dati di localizzazione all'interno di una singola categoria. Per esempio, le stringhe seguenti sono valide:
Sebbene tutte le stringhe sopra elencate sono accettate come definizioni di linguaggio valide, codifica e modificatore sono ancora inutilizzati. In aggiunta al formato di cui sopra, si può anche specificare il nome completo del linguaggio in inglese, e quindi -l german è valido ed equivalente a -l de_DE. Quando nessun linguaggio è definito in riga di comando o nel file di configurazione, verrà usato il linguaggio di default del sistema.

FILE
~/.aMule/remote.conf

ESEMPIO
Di norma amulecmd sarà inizialmente eseguito come:

amulecmd -h nomehost -p portaEC -P passwordEC -w

o

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

In questo modo la configurazione verrà salvata in $HOME/.aMule/remote.conf, e le volte successive si dovrà solo digitare: Ma non è necessario seguire questo esempio.

SEGNALARE I BUG
Per favore segnalare i bug nel nostro forum (http://forum.amule.org/), o nel nostro bugtracker (http://bugs.amule.org/). Per favore non segnalare i bug via posta elettronica, né nella nostra mailing list né direttamente a qualunque membro del gruppo.

COPYRIGHT
aMule e tutti i programmi di utilità correlati sono distribuiti in accordo con la GNU General Public License.

VEDI ANCHE

AUTORE
Questa pagina del manuale è stata scritta da Vollstrecker <amule@vollstreckernet.de>

TRADUZIONE ITALIANA
Stefano Corti <iz0bbz@libero.it>