Scroll to navigation

AMULECMD(1) Outils d'aMule AMULECMD(1)

NOM

amulecmd - Programme de contrôle d'aMule en mode texte

SYNOPSIS

amulecmd [-h <hôte>] [-p <port>] [-P <motdepasse>] [-f <chemin>] [-q] [-v] [-l <lang>] { [-w] | [-c <commande>] } [--space-separated]

amulecmd [--create-config-from=<chemin>]

amulecmd [--version]

amulecmd [--help]

DESCRIPTION

amulecmd est un client en mode texte pour contrôler aMule.

[ -h <hôte>, --host=<hôte> ]
Hôte où aMule fonctionne (par défaut : 127.0.0.1). <hôte> peut être une adresse IP ou un nom DNS.
[ -p <port>, --port=<port> ]
Port d'aMule pour les Connexions Externes, tel que défini dans Préférences->Contrôles à Distance (par défaut: 4712)
[ -P <motdepasse>, --password=<motdepasse> ]
Mot de passe des connexions externes.
[ -f <chemin>, --config-file=<chemin> ]
Utiliser le fichier de configuration désigné. Le fichier de configuration par défaut est ~/.aMule/remote.conf
[ -q, --quiet ]
Ne pas afficher de sortie sur stdout.
[ -v, --verbose ]
Mode bavard - afficher aussi les messages de débogage.
[ -l <lang>, --locale=<lang> ]
Définit les paramètres régionaux (langue). Voir la section NOTES pour la description du paramètre <lang>.
[ -w, --write-config ]
Écrire les options de la ligne de commande sur le fichier de configuration et quitter
[ -c <commande>, --command=<commande> ]
Exécuter la <commande> comme si elle avait été entrée dans l'invite de commande d'amulecmd et quitter.
[ --create-config-from=<chemin> ]
Créer un fichier de configuration basé sur <chemin>, qui doit pointer sur un fichier de configuration d'aMule valide, et quitter ensuite.
[ --disable-ec-encryption ]
Ne pas chiffrer le lien de Connexion externe. Le chiffrement est négocié automatiquement chaque fois que le programme aMule distant le prend en charge, et est activé par défaut pour chaque destination, locale ou distante. Désactiver cette option laisse tout après l'ouverture de session lisible et modifiable pour tout un chacun qui serait capable d'observer la connexion.
[ --force-zlib ]
Forcer la compression ZLIB sur le lien Connexion Externe quelle que soit l'adresse IP de destination. Utile lorsque le serveur est accessible via un tunnel VPN qui se résout en une adresse IP du réseau local et que l'heuristique ignorerait autrement la compression.
[ --space-separated ]
Séparez les champs des commandes de liste avec des espaces, comme les versions précédentes le faisaient, au lieu d'utiliser des tabulations. Les noms des clients et les noms des fichiers peuvent contenir des espaces, donc le séparateur de tabulation par défaut est ce qui permet à un script de diviser une ligne en ses champs ; utilisez-le uniquement pour les scripts écrits pour l'ancienne sortie.
[ --version ]
Affiche le numéro de la version actuelle.
[ --help ]
Affiche une courte description d'utilisation.

COMMANDES

Toutes les commandes sont insensibles à la casse.

Add <eD2k-link> | <magnet-link>

Ajoute un lien eD2k ou magnet au noyau.

Le lien eD2k à ajouter peut être :

  • un lien fichier (ed2k://|fichier|…), il sera ajouté à la file des téléchargements ;
  • un lien serveur (ed2k://|serveur|…), il sera ajouté à la liste des serveurs ;
  • un lien de liste de serveurs, dans ce cas tous les serveurs dans la liste seront ajoutés à la liste des serveurs.

Le lien magnet doit contenir le hachage eD2k et la longueur du fichier.

Cancel <hash> | <number>

Annule le téléchargement spécifié par le <hachage> ou le <numéro>. Pour obtenir la valeur utiliser show.

Connect [ kad | ed2k | <ip|name> ]

Se connecter au réseau.

Cela connectera à tous les réseaux qui sont activés dans les préférences.

Avec le paramètre optionnel, vous pouvez spécifier le réseau pour se connecter. Donner une adresse de serveur sous la forme IP:Port (où IP est soit une adresse décimale IPv4 ou un nom DNS résolvable) aMule se connectera à ce serveur uniquement.

Disconnect [ ed2k | kad ]

Déconnecter de tous les réseaux dont vous êtes connecté, ou juste déconnecter d'un réseau spécifié.

Download <number>

Commencer à télécharger un fichier.

Le <numéro> d'un fichier à partir de la dernière recherche doit être donné. Exemple : 'download 12' va commencer à télécharger le fichier avec le numéro 12 de la recherche précédente.

Exit

Déconnecter d'amule/amuled et quitter amulecmd.

Get <what>

Obtenir et afficher une valeur de préférence.

Valeurs disponibles pour <quoi>:

Obtenir les limites de bande passante.
Obtenir les préférences de filtrage IP.

Help [ <command> ]

Affiche une courte description d'utilisation. S'il est appelé sans paramètre, il affiche une liste des commandes disponibles. Lorsqu'il est appelé avec la <commande>, il affiche une courte description de la commande donnée.

Pause <hash> | <number>

Interrompt le téléchargement spécifié par le <hachage> ou le <numéro>. Pour obtenir la valeur utiliser show.

Priority <priority> <hash> | <number>

Définir la priorité d'un téléchargement spécifié par le <hachage> ou le <numéro>.

Valeurs disponibles pour la <priorité> :

Priorité automatique.
Priorité haute.
Priorité basse.
Priorité normale.

Progress [<id>]

Affiche la progression d'un recherche en cours. Prend éventuellement un <id> de recherche (tel qu'affiché par search) ; sans identifiant, affiche la recherche démarrée le plus récemment.

Quit

Un synonyme de la commande exit.

Reload <what>

Recharge un objet donné.

Valeurs disponibles pour <quoi>:

Recharger la liste des fichiers partagés.
Recharger les tables de filtre d'IP.

Reset

Réinitialiser le journal.

Results [<id>]

Vous affiche les résultats d'une recherche. Prend éventuellement un <id> de recherche (tel qu'affiché par search) ; sans identifiant, affiche la recherche démarrée le plus récemment. Plusieurs recherches peuvent être conservées sur le démon en même temps et gérées par identifiant.

Resume <hash> | <number>

Reprend le téléchargement spécifié par le <hachage> ou le <numéro>. Pour obtenir la valeur utiliser show.

Search <type> [<filters>] <keyword>

Effectue une recherche sur <mot-clef> donné. Un type de recherche et un mot-clef de recherche sont obligatoires pour le faire. Exemple : 'search kad amule' effectue une recherche kad pour 'amule'. Affiche un identifiant de recherche ; transmettez-le à results ou bien à progress pour cibler cette recherche. Plusieurs recherches peuvent être exécutées simultanément, chacune ayant son identifiant.

Types de recherche disponibles :

Effectue une recherche globale.
Effectue une recherche sur le réseau Kademlia.
Effectue une recherche locale.

Des filtres facultatifs peuvent être placés avant, après ou intercalés avec le(s) mot(s)-clé(s) de recherche :

Restreindre les résultats au type de fichier indiqué.
Restreindre les résultats à une extension de fichier spécifique (par ex. iso, mp3).
Nombre minimum de sources qu'un résultat doit indiquer.
Taille minimale du fichier à renvoyer. Les suffixes utilisent des multiplicateurs binaires (K = 1024, M = K×1024, G = M×1024) ; l'absence de suffixe signifie octets.
Taille maximale du fichier à renvoyer. Mêmes suffixes que --min-size.

Exemple : 'search global linux iso --type Iso --min-size 100M' renvoie des résultats pour 'linux iso' de type de fichier Iso d'au moins 100 MiB.

Set <what>

Définit une valeur compte tenu des préférences.

Valeurs disponibles pour <quoi>:

Définir les limites de bande passante.
Définir les préférences de filtrage d'IP.

Show <what>

Montre la file d'attente des envois/réceptions, la liste des serveurs ou la liste des fichiers partagés.

Valeurs disponibles pour <quoi>:

Montrer la file d'attente des réceptions.
Afficher le journal.
Afficher la liste des serveurs.
Afficher la liste des fichiers partagés.
Montrer la file d'attente des envois.

Shutdown

Arrêt du noyau distant exécutant (amule/amuled). Cela arrêtera aussi le client en mode texte, car il est inutilisable sans un noyau en cours d'exécution.

Statistics [ <number> ]

Afficher l'arbre des statistiques.

Le <chiffre> optionnel dans l'intervalle 0-255 peut être transmis comme argument à cette commande, ce qui indique le nombre d'entrées de la sous-arborescence de la version du client qui doit être affiché. Indiquer 0 ou bien l'omettre signifie « illimité ».

Exemple : « statistics 5 » n'affichera que les 5 versions les plus utilisées pour chaque type de client.

Status

Afficher l'état de la connexion, et la vitesse actuelle d'émission/réception, etc.

NOTES

Chemins

Pour toutes les options prenant en paramètre un <chemin>, si le chemin ne contient pas de répertoire (c'est-à-dire juste un nom de fichier), alors il sera considéré comme étant dans le répertoire de configuration d'aMule, ~/.aMule.

Langues

Le paramètre <lang> pour -l l'option a la forme suivante : lang[_LANG][.encoding][@modifier] où lang est la langue principale, LANG est le dialecte, encoding est le jeu de caractères défini à utiliser et modifier permet à l'utilisateur de sélectionner une instance spécifique des données de localisation dans une seule catégorie.

Par exemple, les chaînes de caractères suivantes sont valables :

de
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro

Bien que toutes les chaînes ci-dessus soient acceptées comme des définitions de langue valide, encoding et modifier ne sont pas encore utilisés.

En plus du format ci-dessus, vous pouvez également spécifier des noms entiers de langue en anglais - ainsi -l german est également valide et équivaut à -l de_DE.

Si aucun paramètre régional n'est défini, ni sur la ligne de commande ni dans le fichier de configuration, la langue par défaut du système sera utilisée.

FICHIERS

~/.aMule/remote.conf

EXEMPLE

Typiquement amulecmd sera lancée la première fois ainsi :

amulecmd -h nom de l'hôte -p port EC -P mot de passe EC -w

ou

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

Cela sauvegardera les options dans $HOME/.aMule/remote.conf, et il suffira de taper plus tard :

amulecmd

Bien sûr, vous n'avez pas à suivre cet exemple.

RAPPORTER DES BOGUES

Veuillez rapporter les bogues sur notre forum (https://github.com/amule-org/amule/discussions), ou sur notre traqueur de bogues (https://github.com/amule-org/amule/issues). Veuillez ne pas rapporter les bogues par e-mail, sur notre liste de diffusion ou directement aux membres de l'équipe.

COPYRIGHT

aMule et tous ses outils sont distribués sous la Licence publique générale GNU.

VOIR ÉGALEMENT

amule(1), amuled(1)

AUTEUR

Cette page de manuel a été écrite par Vollstrecker <amule@vollstreckernet.de>

October 2026 aMuleCmd v3.1.0