NOM
amuleweb - serveur Web d'aMule
SYNOPSIS
amuleweb [-h <hôte>] [-p <port>] [-P <motdepasse>] [-f <chemin>] [-q]
[-v] [-l <langue>] [-w] [-t <nom>] [-s <port>] [-u] [-U] [-z] [-Z]
[-A <motdepasse>] [-G <motdepasse>] [-a] [-d] [-L] [--no-php] [-N]
amuleweb [-f <chemin>] --create-config-from=<chemin>
amuleweb [--help] [--version]
amuleweb [--amule-config-file=<chemin>]
amuleweb prend en charge l'accès à aMule à travers un navigateur Web.
Vous pouvez le démarrer en même temps qu'amule(1), ou séparément,
n'importe quand après. Les options peuvent être indiquées à la ligne de
commande ou par l'intermédiare d'un fichier de configuration. Les
options spécifiées dans la ligne de commande ont priorité sur celles
contenues dans le fichier de configuration.
-h, --host=<hôte>
Hôte où aMule tourne (défaut: localhost). <hôte> peut être une
adresse IP ou un nom DNS.
-p, --port=<port>
Port d'aMule pour les Connexions Externes, tel que défini dans
Préférences->Contrôles à Distance (port par défaut : 4712).
-P, --password=<motdepasse>
Mot de passe pour les Connexions Externes.
-f, --config-file=<chemin>
Utiliser le fichier de configuration désigné. Le fichier de
configuration par défaut est ~/.aMule/remote.conf
-q, --quiet
N'afficher aucune sortie sur stdout. Il est utile d'utiliser -q
pour faire tourner amuleweb en service (daemon), i.e. en lançant
'amuleweb -q &'
-v, --verbose
Mode bavard - affiche aussi les messages de débogage.
-l, --locale=<langue>
Langue du logiciel. Se reporter à la section LANGAGES plus bas.
-w, --write-config
Ecrire les options de la ligne de commande dans le fichier de
configuration et quitter.
--create-config-from=<chemin>
Créer un fichier de configuration basé sur <chemin>, qui doit
pointer sur un fichier de configration d'aMule valide, et
quitter ensuite.
-t, --template=<nom>
Charger le modèle nommé <nom>. Voir aussi la section PRISE EN
CHARGE DES SKINS.
-s, --server-port=<port>
Port HTTP du serveur Web. C'est le port sur lequel votre
navigateur Web doit pointer (défaut : 4711).
-u Active UPnP.
-U <port>, --upnp-port <port>
Port UPnP.
-z, --enable-gzip
Activer la compression gzip dans les échanges HTTP pour diminuer
l'utilisation de la bande passante.
-Z, --disable-gzip
Désactiver la compression gzip (comportement par défaut).
-A, --admin-pass=<motdepasse>
Mot de passe pour un accès complet au serveur Web.
-G, --guest-pass=<motdepase>
Mot de passe pour un accès restreint au seveur Web (invité).
-a, --allow-guest
Autoriser l'accès aux invités.
-d, --deny-guest
Interdire l'accès aux invités (défaut).
-L, --load-settings
Charger/décharger les réglages du serveur Web depuis un aMule
distant. Ceci permet d'ignorer les options de la ligne de
commande et du fichier de configuration et charger celles-ci
depuis aMule. Lors de la sauvegarde des préférences celles-ci ne
seront pas sauvegardées dans le fichier de configuration, mais
vers aMule (Bien sûr, ceci ne concerne que les options qui
peuvent être configurées dans Préférences->Contrôle à Distance).
--no-php
Désactive l'interpréteur PHP (option obsolète).
-N, --no-script-cache
Recompile les pages PHP à chaque requête.
--create-config-from=<chemin>
Crée un fichier de configuration basé sur <chemin>, qui doit
indiquer un fichier de configuration valide (aMule). Puis exit.
--help Afficher l'aide d'utilisation et quitter.
--version
Afficher les informations sur la version courante et quitter.
--amule-config-file=<chemin>
Chemin vers le fichier de configuration d'aMule. NE PAS
UTILISER DIRECTEMENT! aMule utilise cette option lorsqu'il
démarre amuleweb au lancement d'aMule. Cette option provoque la
non prise en compte des options de ligne de commande et du
fichier de configuration, celles-ci étant lues dans le fichier
de configuration passé en paramètre, et induit aussi les options
-q -L.
NOTES
Chemins
Pour toutes les options prenant en paramètre un <chemin>, si le chemin
ne contient pas de répertoire (i.e. juste un nom de fichier), alors il
sera considéré comme étant dans le répertoire de configuration d'aMule,
~/.aMule.
Langages
Le paramètre de l'option -l a la forme suivante :
lang[_LANG][.codage][@spécial]
Où lang est le langage principal, LANG un sous-ensemble (langue ou
territoire), codage est le jeu de caractères à utiliser ; et spécial
"permet à l'utilisateur d'exprimer un souhait particulier au sein d'une
catégorie".
Les exemples suivants sont tous valides :
de
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro
(NdT : codage et spécial sont valides mais non encore implémentés !)
En plus du format ici indiqué, il est possible d'utiliser des noms de
langages complets (en anglais). Par exemple, -l german est égal à
-l de_DE.
PRISE EN CHARGE DES SKINS
amuleweb est capable d'afficher ses informations dans différents skins.
Ces skins sont appelés modèles. Vous pouvez dire à amuleweb de charger
un modèle spécifique par l'option de ligne de commande -t. Les modèles
sont recherchés dans deux endroits : d'abord dans ~/.aMule/webserver/
puis dans $(pkgdatadir)/webserver/ ($(pkgdatadir) est le répertoire
d'installation des données non dépendantes de l'architecture,la plupart
du temps quelque chose comme /usr/share/amule). Chaque modèle doit être
dans un sous-répertoire au nom du modèle ; ce répertoire doit contenir
tous les fichiers dont à besoin le modèle. Le fichier modèle doit avoir
comme nom aMule.tmpl.
Par exemple, le modèle par défaut (nommé 'default') se trouve dans
webserver/default/, et ce répertoire contient aMule.tmpl ainsi qu'un
grand nombre de fichiers d'images.
FICHIERS
~/.aMule/remote.conf
~/.aMule/webserver/
$(pkgdatadir)/webserver/
EXEMPLE
Typiquement amuleweb sera lancé la première fois de la façon suivante :
amuleweb -h hostname -p ECport -P ECpassword -s HTTPport -A
AdminPassword -w
ou
amuleweb --create-config-from=/home/username/.aMule/amule.conf
Cela sauvegardera les options dans $HOME/.aMule/remote.conf, et les
fois suivantes, vous n'aurez à taper que:
amuleweb
Bien sûr, vous pouvez ajouter plus ou moins d'options de ligne de
commande, ou vous pouvez aussi n'en spécifier aucune.
SIGNALEMENT DES BUGS
Reportez les bugs sur notre forum (http://forum.amule.org/), ou dans
notre bugtracker (http://bugs.amule.org/). N'utilisez ni un e-mail, ni
notre liste de diffusion ni ne reportez directement un bug à un membre
de notre équipe.
COPYRIGHT
aMule et tous les utilitaires associs sont distribus sous licence GNU
General Public License.
VOIR AUSSI
amule(1), amulecmd(1)
AUTEUR
Page man - v2.3 - Vollstrecker <amule@vollstreckernet.de>, 2010
TRADUCTION
ThePolish, 2005
Others, 2010