.\" Relecture Gérard Delafond
.TH ENEMIES-OF-CARLOTTA 1
.SH NOM
enemies-of-carlotta \- un gestionnaire de listes de diffusion simple
.SH SYNOPSIS
.B enemies-of-carlotta 
.IR "" [ options "] [" adresses ]
.SH "DESCRIPTION"
.B enemies-of-carlotta
est un gestionnaire de listes de diffusion simple.
Si vous ne savez pas ce qu'est un gestionnaire de listes de diffusion, vous
devez commencez par apprendre de quoi il s'agit avant de vouloir vous en 
servir.
.PP
Enemies of Carlotta conserve toutes les données des listes dans le répertoire
.I ~/.enemies-of-carlotta.
Il sera créé automatiquement lorsque vous créerez votre première liste.
Vous devez vous arranger manuellement pour que les courriels soient traités
par le gestionnaire de liste de diffusion.
Les détails peuvent varier d'un système à l'autre.
Pour QMail et Postfix, regardez ci-dessous.
.PP
Chaque liste possède un ou plusieurs propriétaires, qui modèrent également
les inscriptions, ou bien certains messages, voire tous.
Sur les listes non modérées, les propriétaires de la liste sont chargés de
répondre aux questions au sujet de la liste.
Sur les liste totalement modérées, ils doivent approuver chaque message
avant qu'il ne soit envoyé sur la liste.
Sur les liste où
.IR posting=auto ,
les messages des abonnés sont automatiquement envoyés à la liste, et les
modérateurs n'ont pas besoin d'approuver que les messages qui ne 
proviennent pas des abonnés.
.SH OPTIONS
.\" ---------------------------------------------------------------
.TP
.BR --name= foo@example.com
Précise la liste sur laquelle la commande doit être effectuée.
La plupart des options restantes nécessitent que vous précisiez
le nom de la liste avec cette option.
Avec les options --edit, --subscribe, --unsubscribe, et --list,
le nom peut être abrégé en enlevant le signe @ et le domaine.
.\" ---------------------------------------------------------------
.TP
.BI --create
Créer une nouvelle liste de diffusion
Vous devez précisez au moins un propriétaire à l'aide de 
.BR --owner .
.\" ---------------------------------------------------------------
.TP
.BI --owner= adresse
Indique la liste des propriétaires lorsque la liste est créée.
.\" ---------------------------------------------------------------
.TP
.B --cleaning-woman
Règle les problèmes des messages qui n'ont pas pu être délivrés et
nettoie également quelques autres éléments.
Vous devez lancer
.B "enemies-of-carlotta --cleaning-woman"
périodiquement.
Cela nettoiera l'ensemble de vos listes de diffusion.
.\" ---------------------------------------------------------------
.TP
.BI --destroy
Détruit la liste.
.\" ---------------------------------------------------------------
.TP
.BI --edit
Modifie la configuration de la liste.
.\" ---------------------------------------------------------------
.TP
.BI --subscription= type
Lors de la création d'une liste, définit le mode d'abonnement à 
.I free
(libre) ou 
.IR moderated
(modéré).
Utilisez-le avec
.BR --edit ,
ou
.BR --create .
.\" ---------------------------------------------------------------
.TP
.BI --posting= type
Lors de la création d'une liste, définit le mode d'envoi à 
.IR free ,
(libre)
.IR auto ,
(automatique)
ou
.IR moderated
(modéré).
Utilisez-le avec
.BR --edit ,
ou
.BR --create .
.\" ---------------------------------------------------------------
.TP
.BI --archived= yes-ou-no
Les messages à destination de la liste doivent-ils être archivés sous
la forme d'une
.B archive-box
ou d'un répertoire dans le répertoire dans liste 
.B "~/.enemies-of-carlotta"
.
Utilisez 
.I yes
(oui) ou 
.IR no
(non).
.\" ---------------------------------------------------------------
.TP
.BI --list
Liste l'ensemble des abonnés à une liste de diffusion.
.\" ---------------------------------------------------------------
.TP
.BI --subscribe
Ajoute des abonnés à la liste.
Les arguments qui ne sont pas des options sont les adresses qui doivent
être abonnées. Notez que les adresses ajoutées de cette manière ne 
recevront pas de demande de confirmation d'abonnement.
.\" ---------------------------------------------------------------
.TP
.BI --unsubscribe
Enlève un abonné de la liste.
Les arguments qui ne sont pas des options sont les adresses qui doivent
être désabonnées. Notez que les adresses enlevées de cette manière ne
recevront pas de demande de confirmation de désabonnement.
.\" ---------------------------------------------------------------
.TP
.B --incoming
Traite un message entrant sur l'entrée standard.
L'enveloppe SMTP qui précise l'adresse de l'expéditeur doit être
précisée par la variable d'environnement
.I SENDER
et l'enveloppe SMTP qui précise l'adresse du destinataire doit être
précisée par la variable d'environnement
.I RECIPIENT
(QMail et Postfix traitent cela automatiquement.)
.\" ---------------------------------------------------------------
.TP
.BI --skip-prefix= chaîne
Avant d'analyser l'adresse de destination pour regarder à quelle liste
le message est destiné, ce paramètre permet d'enlever
.I chaîne
depuis son début.
C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix,
voyez ci-dessous.
.\" ---------------------------------------------------------------
.TP
.BI --domain= nom.domaine
Avant d'analyser l'adresse de destination pour voir à quelle liste le message
est destiné, remplace le nom de domaine par
.IR nom.domaine .
C'est utilisé pour traiter les domaines virtuels dans QMail et Postfix.
.\" ---------------------------------------------------------------
.TP
.BI --is-list
L'adresse précisée par
.B --name
fait-elle référence à un nom de liste valide\ ?
Cela retourne le code d'erreur zéro (succès) si c'est le cas, ou un (échec)
dans le cas contraire.
.\" ---------------------------------------------------------------
.TP
.BI --sendmail= chemin
Utilise
.I chemin
au lieu de 
.B /usr/sbin/sendmail
Pour envoyer des courriels via une interface en ligne de commande.
Notez que la commande doit respecter l'interface de la ligne de commande
sendmail.
.\" ---------------------------------------------------------------
.TP
.BI --smtp-server= hôte
Envoi les courriels en utilisant le serveur 
.I hôte
(port 25).
Le serveur doit être configuré pour permettre à la machine sur laquelle
fonctionne la liste de l'utiliser pour relais.
Notez que par défaut, c'est l'interface en ligne de commande qui est utilisée.
L'envoi au moyen de SMTP n'est utilisé que si vous utilisez cette option.
.\" ---------------------------------------------------------------
.TP
.BI --moderate
Force un message entrant à être modéré, même s'il est envoyé à une liste
où l'envoi est libre.
Cela peut être utilisé pour filtrer le spam\ :
Vos messages entrants peuvent être filtrés par n'importe quel système de 
filtrage des courriels, dès lors qu'un message semble être du spam,
vous pouvez demander qu'il soit modéré par une personne humaine.
.\" ---------------------------------------------------------------
.TP
.BI --quiet
Par défaut, les messages de débogage des journaux sont envoyés sur 
l'erreur standard.
Avec cette option, il ne le sont plus.
.\" ---------------------------------------------------------------
.SH CONFIGURATION
Chaque liste est représentée par un répertoire, nommé d'après le nom de
la liste, sous le répertoire 
.IR ~/.enemies-of-carlotta .
Ce répertoire contient plusieurs fichiers et répertoires, qui sont décrits
ci-dessous.
En général, il n'est pas nécessaire de toucher à ces répertoires.
Cependant, certaines configurations ésotériques peuvent uniquement être
faites en éditant le fichier de configuration de la liste.
.TP
.B config
Le fichier de configuration de la liste.
Le contenu est décrit ci-dessous.
.TP
.B subscribers
La base de données des abonnés.
Chaque ligne contient un groupe d'abonné, dont les cinq premiers
espaces délimitent les champs qui sont les identifiants des groupes,
le statut, le timestamp de la date de création du groupe, le timestamp
pour les retours de courriel en cas d'échec, il peut varier de «\ ok\ »
à «\ bonced\ », et l'identifiant du message de retour en cas d'échec.
.TP
.B archive-box
Les messages archivés.
.TP
.B bounce-box
Groupes de messages qui n'ont pu être délivrés et qui sont dans le
statut «\ ok\ ».
.TP
.B moderation-box
Messages en attente d'approbation du modérateur.
.TP
.B subscription-box
Requêtes d'abonnement de désabonnement en attente de confirmation de la
part de l'utilisateur.
.PP
le fichier 
.B config
possède des
.IR mot-clé = value
format\ :
.PP
.RS
.nf
[list]
owners = liw@liw.iki.fi
archived = no
posting = free
subscription = free
mail-on-subscription-changes = yes
mail-on-forced-unsubscribe = yes
language = fi
.fi
.RE
.PP
Les mots clés
.BR archived , 
.BR posting ,
et
.B subscription 
correspondent aux options qui portent les mêmes noms.
Les autres mots-clés sont\ :
.TP
.B owners
Liste les adresses des propriétaires. Définissez-la à l'aide de
l'option
.I --owner.
.TP
.B mail-on-subscription-changes
Les propriétaires doivent-ils recevoir un avertissement lorsqu'un utilisateur
s'abonne ou se désabonne\ ?
.TP
.B mail-on-forced-unsubscribe
Les propriétaires doivent-ils recevoir un avertissement lorsqu'une personne
est enlevée de la liste car trop de courriels ne lui sont pas parvenus\ ?
.TP
.B language
Suffixe pour les templates, pour permettre le support de plusieurs
langues
(Si 
.I language
est défini à «\ fr\ », alors la template nommée «\ foo\ » est d'abord
recherchée comme «\ foo.fr\ ».)
.\" ---------------------------------------------------------------
.SH EXEMPLES
Pour créer une liste nommée
.IR moviefans@example.com ,
dont le propriétaire est
.IR ding@example.com ,
utilisez la commande suivante (tout sur la même ligne)\ :
.sp 1
.RS
enemies-of-carlotta --name=ding@example.com --create
.RE
.PP
Pour voir la liste de tous les abonnés à cette liste\ :
.sp 1
.RS
enemies-of-carlotta --name=moviefans@example.com --list
.RE
.PP
Les personnes qui souhaitent être abonnées à la liste doivent
envoyer un courriel à
.sp 1
.RS
moviefans-subscribe@example.com
.RE
.SH QMAIL
Dans Qmail, pour faire en sorte que le courrier entrant soit traité
par Enemies of Carlotta, vous avez besoin de créer quelques fichiers
.I .qmail-extension
par liste.
Par exemple, si votre nom d'utilisateur est joe et que vous souhaitez
utiliser la liste de diffusion joe-fans, vous devrez créer les
fichiers
.I .qmail-fans
et
.IR .qmail-fans-default ,
qui contiennent
.sp 1
.RS
|"enemies-of-carlotta --incoming"
.RE
.PP
Si vous utilisez un domaine virtuel, example.com, et que les 
courriels sont délivrés via
.I /var/qmail/control/virtualdomains à joe-exampledotcom, 
les fichiers seront nommés
.I .qmail-exampledotcom-fans
et
.I .qmail-exampledotcom-fans-default
et ils contiendront
.sp 1
.RS
|"enemies-of-carlotta --incoming 
.br
--skip-prefix=joe-exampledotcom-"
.RE
.sp 1
(l'ensemble sur la même ligne, il va de soi).
.SH POSTFIX
Avec Postfix, vous devrez configurer un fichier
.I .forward
contenant
.sp 1
.RS
"|procmail -p"
.RE
.sp 1
et un fichier
.I .procmailrc
contenant
.sp 1
.RS
:0
.br
* ? enemies-of-carlotta --name=$RECIPIENT --is-list
.br
| enemies-of-carlotta --incoming
.RE
.PP
Pour utiliser Enemies of Carlotta avec un domaine virtuel Postfix,
vous devrez mettre en place une
.I «\ carte virtuelle d'expressions rationnelles\ »,
généralement 
.I /etc/postfix/virtual_regexp
(ajoutez
.I "virtual_maps = regexp:/etc/postfix/virtual_regexp"
dans votre fichier
.I /etc/postfix/main.cf
pour l'activer).
Le fichier d'expressions rationnelles a besoin de faire des choses
horribles pour conserver l'adresse de destination.
Ajoutez ce qui suit dans le fichier d'expressions rationnelles\ :
.sp 1
.RS
/^your\.virtual\.domain$/ dummy
.br
/^(yourlist|yourlist-.*)@(your\.virtual\.domain)$/ joe-virtual-$1
.RE
.sp 1
(Ça fait deux lignes.)
Ensuite dans votre fichier,
.I .procmailrc, 
ajoutez les options
.I "--skip-prefix=joe-virtual-"
et
.I --domain=your.virtual.domain
pour les deux appels à 
.BR enemies-of-carlotta .
.PP
(Oui, je aussi trouve que ces choses là sont trop compliquées)
.SH FICHIERS
.TP
.I ~/.enemies-of-carlotta
L'ensemble des fichiers en rapports avec vos listes de diffusion.
.TP
.I ~/.enemies-of-carlotta/secret
Les mots de passe secrets utilisés pour générer des adresses signées pour
le contrôle des couriels d'échec et la validation de l'abonnement.
.TP
.I ~/.enemies-of-carlotta/foo@example.com
Le répertoire contient les données appartenant à la liste de diffusion
foo@example.com.
À l'exception du fichier de 
.I config
qui se trouve dans ce répertoire, vous ne devriez pas éditer autre chose 
à la main
.TP
.I ~/.enemies-of-carlotta/foo@example.com/config
Fichier de configuration pour la liste de diffusion.
Vous aurez peut-être besoin de l'éditer à la main si vous souhaitez 
apporter des changement en ce qui concerne la modération ou bien les 
propriétaires de la liste.
.SH "VOIR AUSSI"
Vous serez peut-être intéressé de visiter 
la page d'accueil d'
.I «\ Enemies of Carlotta\ »
à l'adresse
.IR http://www.iki.fi/liw/eoc/ .
.SH "TRADUCTION"
Pierre Machard <pmachard@tuxfamily.org>, 2003