amulecmd

NOME

amulecmd - programma in console per controllare aMule

SINTASSI

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

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

[ -q, --quiet ]

Non scrivere nulla nello stdout.

[ -v, --verbose ]

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

[ -w, --write-config ]

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.

[ -v, --version ]

Visualizza il numero di versione corrente.

[ -h, --help ]

Visualizza 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: 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. Con il parametro opzionale si può specificare a che rete connettersi. Fornendo un indirizzo di server nella forma IP:Porta (dove IP è un indirizzo IPv4 in forma decimale puntata o un nome DNS risolvibile) aMule si connetterà solo a quel server.

Disconnect [ ed2k | 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.

Exit

Disconnette da amule/amuled ed esce da amulecmd.

Get <oggetto>

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

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:

Progress

Mostra i progressi di una ricerca in corso.

Quit

Un sinonimo del comando exit.

Reload <oggetto>

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

Reset

Cancella il log.

Results

Mostra i risultati dell'ultima ricerca.

Resume <hash> | <numero>

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

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

Set <oggetto>

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

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:

Shutdown

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.

Status

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: amulecmd 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 alla GNU General Public License.

VEDI ANCHE

amule(1), amuled(1)

AUTORE

Questa pagina del manuale è stata scritta da Vollstrecker <[email protected]>

TRADUZIONE ITALIANA

Stefano Corti <[email protected]>