Provided by: enemies-of-carlotta_1.2.6-4_all bug

NOM

       enemies-of-carlotta - Gestionnaire simple de listes de diffusion

SYNOPSIS

       enemies-of-carlotta [options] [adresses]

DESCRIPTION

       enemies-of-carlotta est un gestionnaire simple de listes de diffusion.

       Enemies  of  Carlotta  conserve  toutes  les donnees des listes dans le
       repertoire ~/.enemies-of-carlotta. Celui-ci sera  cree  automatiquement
       lors  de la creation de la premiere liste.  Le traitement des courriels
       par le gestionnaire de listes doit  etre  configure  manuellement.  Les
       details  peuvent  varier d'un systeme a l'autre. Pour QMail et Postfix,
       voir ci-dessous.

       Chaque liste  possede  un  ou  plusieurs  proprietaires,  qui  moderent
       egalement  les  inscriptions ou certains messages, voire tous.  Sur les
       listes non moderees, les proprietaires de  la  liste  sont  charges  de
       repondre  aux questions concernant la liste.  Sur les listes totalement
       moderees, ils doivent approuver chaque  message  avant  qu'il  ne  soit
       envoye  sur  la liste.  Sur les liste ou posting=auto, les messages des
       abonnes sont automatiquement envoyes a la  liste,  et  les  moderateurs
       n'ont  besoin  d'approuver  que les messages qui ne proviennent pas des
       abonnes.

OPTIONS

       --name=foo@example.com
              preciser la liste sur laquelle la commande doit etre  effectuee.
              La  plupart  des  options doivent etre accompagnees du nom de la
              liste  concernee.  Avec   les   options   --edit,   --subscribe,
              --unsubscribe  et --list, le nom peut etre abrege en enlevant le
              signe @ et le domaine.

       --create
              creer une nouvelle liste de diffusion. Au moins un  proprietaire
              doit etre precise a l'aide de --owner.

       --owner=adresse
              ajouter un proprietaire a la liste lors de sa creation

       --moderator=adresse
              ajouter  un  moderateur a la liste lors de sa creation ou de son
              edition

       --language=code-de-la-langue
              configurer le code de  la  langue  utilise  pour  recuperer  les
              fichiers modeles. Le code peut etre vide (l'anglais sera utilise
              par defaut) ou compose de deux lettres comme fr ou es.

       --cleaning-woman
              gerer  les  adresses  invalides  et  nettoyer  quelques   autres
              elements. La commande  enemies-of-carlotta --cleaning-woman doit
              etre lancee periodiquement,  comme  une  fois  par  heure,  pour
              nettoyer l'ensemble des listes de diffusion.

       --destroy
              detruire une liste

       --edit modifier la configuration d'une liste

       --subscription=type
              definir  le  mode  d'abonnement  a  free  (libre)  ou  moderated
              (modere) lors  de  la  creation  de  la  liste.  A  utiliser  en
              combinaison avec --edit ou --create.

       --posting=type
              definir  le  mode  d'envoi a free (libre), auto (automatique) ou
              moderated (modere). A utiliser en  combinaison  avec  --edit  ou
              --create.

       --archived=yes-ou-no
              definir  si  les messages de la liste doivent etre archives dans
              le  sous-repertoire  archive-box  du  repertoire  de  la  liste,
              lui-meme  present  dans  le  repertoire  ~/.enemies-of-carlotta.
              Utiliser yes (oui) ou no (non).

       --mail-on-subscription-changes=yes-ou-no
              definir si les proprietaires de la liste  doivent  etre  avertis
              lors  d'un  abonnement ou d'un desabonnement. Utiliser yes (oui)
              ou no (non). La valeur par defaut est no.

       --mail-on-forced-unsubscription=yes-ou-no
              definir si les proprietaires de la liste  doivent  etre  avertis
              lorsque quelqu'un est retire de la liste en raison d'une adresse
              trop souvent invalide. Utiliser yes (oui) ou no (non). La valeur
              par defaut est no.

       --ignore-bounce=yes-ou-no
              definir  si  les  renvois  pour  adresse  invalide  doivent etre
              ignores. Utiliser yes (oui) ou no (non). La  valeur  par  defaut
              est no.

       --list lister l'ensemble des abonnes a une liste.

       --subscribe
              ajouter  des  abonnes  a la liste. Les arguments qui ne sont pas
              des options sont les adresses a abonner. Les  adresses  ajoutees
              de cette facon ne recevront pas de demande de confirmation.

       --unsubscribe
              enlever  des  abonnes de la liste. Les arguments qui ne sont pas
              des  options  sont  les  adresses  a  desabonner.  Les  adresses
              enlevees  de  cette  maniere  ne  recevront  pas  de  demande de
              confirmation.

       --incoming
              traiter un message entrant sur l'entree standard.  L'adresse  de
              l'expediteur  de  l'enveloppe  SMTP  doit  etre  precisee par la
              variable d'environnement SENDER et l'adresse du destinataire  de
              l'enveloppe   SMTP   doit   etre   precisee   par   la  variable
              d'environnement  RECIPIENT.  (QMail  et  Postfix  traitent  cela
              automatiquement.)

       --skip-prefix=cha^ine
              retirer  cha^ine  du  debut  de l'adresse de destination avant de
              l'analyser  pour  determiner  a  quelle  liste  le  message  est
              destine.  Ceci  permet  le traitement des domaines virtuels avec
              QMail et Postfix, voir ci-dessous.

       --domain=nom.du.domaine
              remplacer le nom de domaine par nom.du.domaine dans l'adresse de
              destination  pour  determiner  a  quelle  liste  le  message est
              destine. Ceci permet le traitement des  domaines  virtuels  avec
              QMail et Postfix.

       --is-list
              determiner si l'adresse indiquee par --name fait reference a une
              liste valide. Le code de sortie zero (succes)  est  retourne  si
              c'est le cas, un (echec) dans le cas contraire.

       --sendmail=chemin
              utiliser  chemin  au lieu de /usr/sbin/sendmail pour envoyer des
              courriels via une interface en ligne de commande. Cette commande
              doit respecter l'interface de la ligne de commande sendmail.

       --smtp-server=h^ote
              envoyer  les  courriels  en  utilisant  le serveur SMTP sur h^ote
              (port 25). Le serveur doit etre configure pour  permettre  a  la
              machine  sur  laquelle  fonctionne  la liste de l'utiliser comme
              relais.  Par  defaut,  l'interface  en  ligne  de  commande  est
              utilisee. L'envoi par SMTP n'est utilise qu'avec cette option.

       --qmqp-server=h^ote
              envoyer  les  courriels  en  utilisant  le serveur QMQP sur h^ote
              (port 628). Le serveur doit etre configure pour permettre  a  la
              machine  sur  laquelle  fonctionne  la liste de l'utiliser comme
              relais.  Par  defaut,  l'interface  en  ligne  de  commande  est
              utilisee. L'envoi par QMQP n'est utilise qu'avec cette option.

       --moderate
              forcer  un message entrant a etre modere, meme s'il est envoye a
              une liste ou l'envoi est libre.  Cela  peut  etre  utilise  pour
              filtrer  les  courriers  indesirables :  les  messages  entrants
              peuvent etre filtres par n'importe quel systeme de filtrage  des
              courriels ;  des lors qu'un message semble etre indesirable, une
              moderation par un humain peut etre demandee.

       --post forcer un message entrant a etre envoye, meme s'il est envoye  a
              une  liste  ou  l'envoi  est  modere.  Cela  peut  etre  utilise
              lorsqu'une verification  externe  a  lieu  pour  definir  si  le
              courriel  est  acceptable sur la liste, par exemple en verifiant
              les signatures electroniques.

       --quiet
              ne pas envoyer les messages de  debogage  des  journaux  sur  la
              sortie  d'erreur  standard,  contrairement  au  comportement par
              defaut.

       --sender=foo@example.com

       --recipient=foo@example.com
              ecraser  les  variables  d'environnement  SENDER  et   RECIPIENT
              respectivement,  a  utiliser  en  combinaison avec --incoming et
              --is-list.

       --get  obtenir  les   valeurs   d'une   ou   plusieurs   variables   de
              configuration.  Le nom des variables est indique sur la ligne de
              commande apres les options. Chaque valeur est affichee  sur  une
              ligne separee.

       --set  configurer   les   valeurs   d'une  ou  plusieurs  variables  de
              configuration. Les noms et valeurs sont donnes sur la  ligne  de
              commande  apres  les  options  et separes par un signe d'egalite
              (<< = >>). Par exemple, la commande suivante  configurerait  une
              liste  en  francais :  enemies-of-carlotta  --name=foo@bar --set
              language=fr

       --version
              afficher la version du programme

       --show-lists
              lister les listes connues de enemies-of-carlotta

CONFIGURATION

       Chaque liste est representee par un repertoire, nomme d'apres le nom de
       la  liste,  sous  le  repertoire  ~/.enemies-of-carlotta. Ce repertoire
       contient plusieurs  fichiers  et  repertoires  decrits  ci-dessous.  En
       general,  il  n'est  pas  necessaire  de  toucher  a  ces  repertoires.
       Cependant, certaines configurations esoteriques peuvent uniquement etre
       faites en editant le fichier de configuration de la liste.

       config Fichier  de  configuration  de  la  liste. Le contenu est decrit
              ci-dessous.

       subscribers
              Base de donnees des abonnes. Chaque  ligne  contient  un  groupe
              d'abonnes,  dont les cinq premiers espaces delimitent les champs
              qui sont l'identifiant du groupe, l'etat, la date de creation du
              groupe, la date du message de retour qui a fait passer l'etat de
              la liste  de  << ok >>  a  << bounced >>,  et  l'identifiant  du
              message de retour.

       archive-box
              Messages archives.

       bounce-box
              Groupes  des  messages  de  retour  qui  ne sont pas dans l'etat
              << ok >>.

       headers-to-add
              En-tetes a ajouter aux courriels envoyes  a  la  liste.  Ceux-ci
              sont  copies  aux  debuts des en-tetes existants exactement tels
              qu'ils sont dans ce fichier, apres que les en-tetes de la  liste
              (comme  << List-ID >>)  ont  ete  ajoutes et que ceux mentionnes
              dans headers-to-remove ont ete retires.

       headers-to-remove
              En-tetes a retirer des messages envoyes a la liste.

       moderation-box
              Messages en attente d'approbation du moderateur.

       subscription-box
              Requetes  d'abonnement  et  de  desabonnement  en   attente   de
              confirmation de la part de l'utilisateur.

       templates
              Repertoires  qui contiennent les modeles specifiques a une liste
              (optionnel). Les  modeles  seront  recherches  d'abord  dans  ce
              repertoire,  s'il  existe, puis dans les repertoires du systeme.
              Un fichier vide signifie que le message  correspondant  ne  doit
              pas etre envoye. Cela peut etre utilise par exemple pour activer
              uniquement  pour  certaines  listes   les   messages   du   type
              << veuillez attendre la moderation de votre message >>.

       plugins
              Repertoires contenant des grephons, a savoir des fichiers source
              en Python qui sont charges automatiquement par EoC au demarrage.
              Ces grephons peuvent modifier le comportement d'EoC.

       Le fichier config possede un format de type mot-cl'e=valeur :

              [list]
              owners = liw@liw.iki.fi
              archived = no
              posting = free
              subscription = free
              mail-on-subscription-changes = yes
              mail-on-forced-unsubscribe = yes
              language = fr

       Les  mots  cles  archived,  posting,  et subscription correspondent aux
       options qui portent les memes noms. Les autres mots-cles sont :

       owners Liste des adresses  des  proprietaires,  definie  avec  l'option
              --owner.

       moderators
              Liste  des  adresses  des  moderateurs,  definie  avec  l'option
              --moderator.

       mail-on-subscription-changes
              Valeur definissant si les  proprietaires  doivent  etre  avertis
              lorsqu'un utilisateur s'abonne ou se desabonne.

       mail-on-forced-unsubscribe
              Valeur  definissant si les proprietaires doivent etre avertis si
              quelqu'un est retire  d'une  liste  suite  a  une  adresse  trop
              souvent invalide.

       ignore_bounce
              Valeur definissant si les messages de retour sont ignores sur la
              liste. Utilise par exemple lorsque la  liste  devrait  avoir  un
              nombre stable d'abonnes.

       language
              Suffixe pour les modeles, pour permettre la gestion de plusieurs
              langues. (Si language est defini a  << fr >>,  alors  le  modele
              << foo >>   est   d'abord   recherche   en   tant   que   modele
              << foo.fr >>.)

       pristine-headers
              Valeur definissant si  les  en-tetes  doivent  etre  encodes  au
              format MIME. Si la valeur vaut << yes >>, l'encodage aura lieu.

EXEMPLES

       Creer  une liste nommee moviefans@example.com, dont le proprietaire est
       ding@example.com (tout sur la meme ligne) :

              enemies-of-carlotta --name=moviefans@example.com
              --owner=ding@example.com --create

       Le systeme de messagerie doit etre  configure  pour  que  ces  messages
       arrivent  sur  la  liste (et a ses adresses de commande). Pour Qmail et
       Postfix, voir ci-dessous.

       Afficher la liste de tous les abonnes a cette liste :

              enemies-of-carlotta --name=moviefans@example.com --list

       Les personnes voulant s'abonner a la liste doivent envoyer un  courriel
       a

              moviefans-subscribe@example.com

QMAIL

       Avec  Qmail,  pour  faire  en  sorte  que les courriels entrants soient
       traites par Enemies of  Carlotta,  quelques  fichiers  .qmail-extension
       sont  necessaires  pour  chaque  liste.  Par exemple, si joe est un nom
       d'utilisateur, pour initialiser la liste de  diffusion  joe-fans,  deux
       fichiers  doivent  etre crees : .qmail-fans et .qmail-fans-default, qui
       contiendront

              |enemies-of-carlotta --incoming

       Si les  messages  a  destination  d'un  domaine  virtuel,  example.com,
       delivres via /var/qmail/control/virtualdomains a joe-exampledotcom, les
       fichiers      seront      nommes      .qmail-exampledotcom-fans      et
       .qmail-exampledotcom-fans-default et contiendront


              |enemies-of-carlotta --incoming --skip-prefix=joe-exampledotcom-
       (tout sur la meme ligne).

POSTFIX

       Avec Postfix, un fichier .forward contenant

              "|procmail -p"

       sera necessaire, ainsi qu'un fichier .procmailrc contenant

              :0
              * ? enemies-of-carlotta --name=$RECIPIENT --is-list
              | enemies-of-carlotta --incoming

       Pour  utiliser Enemies of Carlotta avec un domaine virtuel Postfix, une
       carte  virtuelle  d'expressions   rationnelles   generalement   appelee
       /etc/postfix/virtual_regexp  devra  etre creee (pour l'activer, ajouter
       virtual_maps  =  regexp:/etc/postfix/virtual_regexp  dans  le   fichier
       /etc/postfix/main.cf).   Le  fichier  d'expressions  rationnelles  doit
       faire des choses horribles pour conserver l'adresse de destination.  Il
       faut donc ajouter :

              /^your.virtual.domain$/ dummy
              /^(yourlist|yourlist-.*)@(your.virtual.domain)$/ joe+virtual-$1

       Soit  deux  lignes.  Si  recipient_delimiter pour Postfix est configure
       avec un moins au lieu d'un plus, utiliser joe-virtual. Ensuite dans  le
       fichier  .procmailrc, ajouter les options --skip-prefix=joe-virtual- et
       --domain=your.virtual.domain     pour     les     deux     appels     a
       enemies-of-carlotta.

       Ces manipulations restent complexes.

COMMANDES PAR MESSAGE

       Les  utilisateurs  et  proprietaires  utilisent Enemies of Carlotta par
       courriel   en   utilisant    des    adresses    de    commande    comme
       foo-subscribe@example.com.  Voici  une  liste de toutes les adresses de
       commande accessibles aux utilisateurs et proprietaires. Dans  tous  ces
       exemples, le nom de la liste de diffusion sera foo@example.com.

   Commandes par message accessibles `a tout le monde
       Ces  commandes  peuvent  servir  a  tout le monde et ne demandent aucun
       privilege special.

       foo@example.com
              Envoie un courriel a tous les abonnes. Le message peut  avoir  a
              etre  approuve  d'abord par les moderateurs de la liste, qui ont
              aussi le pouvoir de le rejeter.

       foo-owner@example.com
              Envoie un courriel au(x) proprietaire(s) de la liste.

       foo-help@example.com
              Retourne en reponse a ce courriel un message contenant l'aide de
              la liste.

       foo-subscribe@example.com
              Inscrit  l'auteur  du  courriel  a  la liste. Le gestionnaire de
              listes repondra en  demandant  une  confirmation.  L'inscription
              n'aura  lieu  qu'en  cas  de  reponse  a cette demande. De cette
              maniere, les personnes malveillantes ne  peuvent  ajouter  votre
              adresse sur une ou beaucoup de listes de diffusion.

       foo-subscribe-joe=example.com@example.com
              Inscrit  joe@example.com  a  la liste. Pour inscrire une adresse
              differente de  celle  utilisee  pour  la  demande  d'abonnement,
              utiliser  cette forme. La demande de confirmation sera envoyee a
              joe@example.com puisque cette adresse seulement sera  abonnee  a
              la liste.

       foo-unsubscribe@example.com
              Desinscrit  l'auteur  du  courriel de la liste. Encore une fois,
              une demande de confirmation sera envoyee  pour  eviter  que  des
              personnes malveillantes desinscrivent d'autres personnes.

       foo-unsubscribe-joe=example.com@example.com
              Desinscrit  joe@example.com  de la liste. Encore une fois, cette
              derniere adresse recevra la demande de confirmation.

   Commandes par message pour les propri'etaires de la liste.
       Les commandes suivantes peuvent  etre  utilisees  pour  administrer  la
       liste.

       foo-subscribe-joe=example.com@example.com
              Si  un proprietaire envoie un courriel de ce type, il recevra la
              demande de confirmation a la place de  joe@example.com.  Il  est
              souvent  preferable  de  laisser  les gens s'inscrire eux-memes,
              mais parfois cela peut  etre  utile  que  le  proprietaire  s'en
              occupe.

       foo-unsubscribe-joe=example.com@example.com
              Les   proprietaires   peuvent   egalement  desinscrire  d'autres
              personnes.

       foo-list@example.com
              Retourne la liste des abonnes a la liste. Cela ne marche que  si
              l'adresse  de  l'expediteur est celle de l'un des proprietaires.
              L'adresse de l'expediteur est celle utilisee au niveau  SMTP  et
              non celle dans l'en-tete From:.

       foo-setlist@example.com
              Permet  a  un proprietaire de configurer la liste des abonnes en
              un  seul  coup.  Cela  correspond  a  une  suite  de   commandes
              -subscribe  et  -unsubscribe, mais en plus simple. Tous ceux qui
              seront ajoutes a la liste recevront  un  message  de  bienvenue,
              alors que ceux qui seront retires recevront un message d'adieu.

       foo-setlistsilently@example.com
              Commande  similaire  a -setlist, sans les envois des messages de
              bienvenue et d'adieu.

GREPHONS

       Enemies of Carlotta accepte des grephons. Des connaissances  en  Python
       sont necessaires pour comprendre cette section.

       Un grephon est un module Python (un fichier avec un suffixe .py), place
       dans le repertoire ~/.enemies-of-carlotta/plugins.  Les  grephons  sont
       charges  automatiquement  au  demarrage,  si  la  version  declaree  de
       l'interface correspond a celle utilisee par  Enemies  of  Carlotta.  La
       version   de   l'interface   est   declaree  par  la  variable  globale
       PLUGIN_INTERFACE_VERSION du module.

       Les grephons peuvent definir des fonctions d'ancrage  appelees  au  bon
       endroit dans le code d'EoC. Pour le moment, la seule fonction d'ancrage
       est send_mail_to_subscribers_hook, qui peut modifier un courriel  avant
       qu'il ne soit envoye aux abonnes. La fonction devrait ressembler a :

            def send_mail_to_subscribers_hook(list, text):

       L'argument  list est une reference a l'objet MailingList qui correspond
       a la liste concernee, et text est le  texte  complet  du  courriel  tel
       qu'il  existe  actuellement.  La  fonction devrait retourner le nouveau
       contenu de ce courriel.

FICHIERS

       ~/.enemies-of-carlotta
              Ensemble des fichiers en rapport avec les listes de diffusion.

       ~/.enemies-of-carlotta/secret
              Mots de passe secrets utilises pour generer des adresses signees
              pour  le  controle  des  messages de retour et la validation des
              abonnements.

       ~/.enemies-of-carlotta/foo@example.com
              Repertoire contenant les  donnees  appartenant  a  la  liste  de
              diffusion  foo@example.com.   A l'exception du fichier de config
              qui se trouve  dans  ce  repertoire,  rien  ne  devrait  etre  a
              modifier.

       ~/.enemies-of-carlotta/foo@example.com/config
              Fichier  de configuration pour la liste de diffusion. Ce fichier
              devra etre edite pour modifier les options de moderation ou  les
              proprietaires de la liste.

VOIR AUSSI

       Page web d'<< Enemies of Carlotta >> : http://www.iki.fi/liw/eoc/.

TRADUCTION

       Pierre Machard <pmachard@tuxfamily.org>, 2003
       Thomas Huriaux <thomas.huriaux@gmail.com>, 2005

                                                        ENEMIES-OF-CARLOTTA(1)