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

Forza la compressione ZLIB sulla connessione esterna indipendentemente dalla
    località dell'IP contattato. Utile quando il server è raggiungibile attraverso un tunnel VPN che risolve a un IP di LAN e l'euristica salterebbe altrimenti la compressione.

Visualizza il numero di versione corrente.

Visualizza una breve descrizione dell'utilizzo.

COMANDI
Tutti i comandi non distinguono tra maiuscolo e minuscolo. 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. Cancella il download specificato da <hash> o <numero>. Per ottenere il valore utilizzare show. 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. Disconnette da tutte le reti attualmente connesse, o disconnette solo dalla rete specificata. 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. 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.
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. Mette in pausa il download specificato da <hash> o <numero>. Per ottenere il valore utilizzare show. 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. 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. Riprende il download specificato da <hash> o <numero>. Per ottenere il valore utilizzare show. 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.

È possibile inserire filtri opzionali prima, dopo o intervallati alla/e parola/e chiave di ricerca:

    --type <Audio|Video|Image|Doc|Pro|Arc|Iso>
        Limita i risultati al tipo di file indicato.

    --extension <ext> (alias: --ext)
        Limita i risultati a un'estensione di file specifica (ad es. iso, mp3).

    --avail <N> (alias: --availability)
        Numero minimo di fonti che un risultato deve dichiarare.

    --min-size <N[KMG]>
        Dimensione minima del file da restituire. I suffissi usano moltiplicatori binari (K = 1024, M = K×1024, G = M×1024); senza suffisso indica byte.

    --max-size <N[KMG]>
        Dimensione massima del file da restituire. Stessi suffissi di --min-size.

Esempio: `search global linux iso --type Iso --min-size 100M' restituisce risultati per “linux iso” di tipo file Iso di almeno 100 MiB. 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.
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.

    Shared
        Mostra la lista dei file condivisi.

    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. 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 (https://github.com/amule-org/amule/discussions) o nel nostro bugtracker (https://github.com/amule-org/amule/issues). 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

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

TRADUZIONE ITALIANA
Stefano Corti <iz0bbz@libero.it>