table of contents
| 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 :
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>:
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é> :
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.
- IPFilter
- 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 :
Des filtres facultatifs peuvent être placés avant, après ou intercalés avec le(s) mot(s)-clé(s) de recherche :
- --type <Audio|Video|Image|Doc|Pro|Arc|Iso>
- Restreindre les résultats au type de fichier indiqué.
- --extension <ext> (alias: --ext)
- Restreindre les résultats à une extension de fichier spécifique (par ex. iso, mp3).
- --avail <N> (alias: --availability)
- Nombre minimum de sources qu'un résultat doit indiquer.
- --min-size <N[KMG]>
- 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.
- --max-size <N[KMG]>
- 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>:
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>:
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.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¶
AUTEUR¶
Cette page de manuel a été écrite par Vollstrecker <amule@vollstreckernet.de>
| October 2026 | aMuleCmd v3.1.0 |