diff options
Diffstat (limited to 'enemies-of-carlotta.1.fr')
| -rw-r--r-- | enemies-of-carlotta.1.fr | 421 |
1 files changed, 421 insertions, 0 deletions
diff --git a/enemies-of-carlotta.1.fr b/enemies-of-carlotta.1.fr new file mode 100644 index 0000000..4797929 --- /dev/null +++ b/enemies-of-carlotta.1.fr @@ -0,0 +1,421 @@ +.\" 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 |