Provided by:
enemies-of-carlotta_1.2.1-1_all 
NAME
enemies-of-carlotta - sencillo gestor de listas de correo
SYNOPSIS
enemies-of-carlotta [opciones] [direcciones]
DESCRIPCIÓN
enemies-of-carlotta es un gestor sencillo para listas de correo. Si no
sabe qué es un gestor de listas de correo, es mejor que aprenda lo que
son, antes de intentar usar uno concreto. Por desgracia, no hay
espacio para eso en una página de manual.
Enemies of Carlotta mantiene todos los datos sobre las listas de correo
en un directorio llamado ~/.enemies-of-carlotta . Se creará
automáticamente en cuanto usted cree la primera lista. Tendrá que
hacer arreglos a mano para que el gestor de listas pueda procesar los
mensajes. Los detalles varÃan de un servidor de correo a otro. Para
qmail y Postfix, véase más adelante.
Cada lista tiene uno o más propietarios, que también moderan
suscripciones o incluso algunos o todos los envÃos a la lista. En
listas sin moderación alguna, el propietario de la lista es el
responsable de contestar las dudas acerca de la lista. En listas con
moderación completa, tienen que aprobar cada mensaje, antes de que éste
pueda enviarse a la lista. En listas con la opción posting=auto, los
mensajes de los suscriptores se envÃan automáticamente a la lista, y
los moderadores tienen que aprobar el resto de mensajes.
OPCIONES
--name=lista@ejemplo.com
Especifica sobre qué lista ha de actuar la orden especificada.
Casi todas las restantes opciones precisan que especifique antes
el nombre de la lista con la opción antedicha. Con las opciones
--edit, --subscribe, --unsubscribe, y --list , el nombre puede
abreviarse quitando el signo @ y el dominio que le sigue.
--create
Crear una lista nueva. Ha de especificar al menos un
propietario con la opción --owner.
--owner=dirección
Al crear una lista, especifica un propietario de la lista.
--language=código-idioma
Establece el código de idioma que se usa para buscar plantillas.
El código deberÃa estar vacÃo (opción por defecto, es decir
inglés), o un código de dos letras como fi o es.
--cleaning-woman
Se encarga de las direcciones de rebote y hace otras limpiezas
varias. Ha de ejecutar periódicamente enemies-of-carlotta
--cleaning-woman , algo asà como una vez por hora. Efectuará
una limpieza de todas sus listas.
--destroy
Eliminar la lista.
--edit Modificar la configuración de la lista.
--subscription=tipo
Al crear una lista, establece su modo de suscripción a free
(libre) o bien moderated (moderado). Úselo con --edit, o con
--create.
--posting=tipo
Al crear una lista, establece su modo de envÃo de mensajes a
free (libre), auto (auto), o bien moderated (moderado). Úselo
con --edit, o con --create.
--archived=yes-o-no
Especifica si los mensajes de la lista deben archivarse en el
directorio archive-box en el directorio de la lista que a su vez
existe dentro del directorio ~/.enemies-of-carlotta . Utilice
yes o bien no.
--mail-on-subscription-changes=yes-o-no
¿DeberÃa notificarse a los dueños de la lista cuando alguien se
suscribe o desuscribe de ella? Use yes o no. Por defecto es
no.
--mail-on-forced-unsubscription=yes-o-no
¿DeberÃa notificarse a los dueños de la lista cuando se elimina
a alguien de la lista forzosamente por exceso de rebotes? Use
yes o no. Por defecto es no.
--list Muestra los suscriptores de una lista de correo.
--subscribe
Añade suscriptores a una lista de correo. Los argumentos que no
son opciones, son las direcciones que hay que suscribir a la
lista. Observe que las direcciones que se añadan mediante este
procedimiento no recibirán una confirmación de suscripción, sino
que se las suscribirá directamente.
--unsubscribe
Elimina suscriptores de una lista de correo. Los argumentos que
no son opciones, son las direcciones que hay que desuscribir de
la lista. Observe que las direcciones que se eliminen mediante
este procedimiento no recibirán una confirmación de
desuscripción, sino que se las eliminará directamente.
--incoming
Encargarse de un mensaje que se recibe por la entrada estándar.
La dirección del remitente del envoltorio SMTP (envelope sender
address) debe especificarse mediante la variable de entorno
SENDER , y la dirección del destinatario del envoltorio SMTP
(SMTP envelope recipient address) debe especificarse en la
variable de entorno RECIPIENT . (qmail y Postfix lo hacen
automáticamente).
--skip-prefix=cadena
Antes de analizar la dirección del destinatario para ver a qué
lista se refiere, eliminar cadena de su comienzo. Esta
caracterÃstica ayuda en el caso de los dominios virtuales de
qmail y Postfix; véase más arriba.
--domain=nombre.dominio
Antes de analizar la dirección del destinatario para ver a qué
lista se refiere, sustituir la parte del dominio por
nombre.dominio. Esta caracterÃstica es útil en el caso de los
dominios virtuales de Postfix.
--is-list
¿Se refiere la lista especificada en la opción --name a una
lista válida? Devuelve un estado de salida de cero (éxito) si
es válida, o un estado de uno (fallo) si no es válida.
--sendmail=ruta-hasta-el-programa
Utilice ruta-hasta-el-programa en lugar de /usr/sbin/sendmail
para enviar correo por medio de una interfaz de lÃnea de
órdenes. Nótese que la orden alternativa debe seguir las
convenciones de la interfaz de lÃnea de órdenes sendmail.
--smtp-server=nombre.de.servidor
Enviar el correo usando el servidor SMTP nombre.de.servidor
(puerto 25). El server ha de estar configurado para permitir
que la lista pueda efectuar la retransmisión de correo a través
de él. Nótese que la opción por defecto es usar la interfaz de
lÃnea de órdenes. Esta opción de enviar por SMTP sólo se
utilizará si la especifica explÃcitamente.
--qmqp-server=nombredemaquina
Enviar correo usando el servidor QMQP que hay en nombredemaquina
(puerto 628). El servidor debe estar configurado para permitir
que la máquina de la lista reenvÃe correo a través suyo. Tenga
en cuenta que por defecto se usa una interfaz de lÃnea de
órdenes para el envÃo; sólo se utilizará QMQP si especifica esta
opción.
--moderate
Forzar la moderación de mensajes para un mensaje dado, incluso
si va a ir a parar a una lista de mensajes donde se puede envÃar
libremente. Puede usar esta opción para el filtrado de correo
electrónico no solicitado (spam): sus mensajes entrantes pasan
por el filtro de spam que usted especifique y si el mensaje
califica como spam, se solicita la moderación del mensaje por
parte de una persona.
--post Forzar el envÃo de un mensaje entrante a una lista dada, incluso
si va a ir a parar a una lista que tenga el envÃo moderado.
Puede usar esta opción cuando hay una comprobación externa de si
un correo es aceptable en una lista; por ejempo, si dispone de
un comprobador de firmas digitales.
--quiet
De forma predeterminada, los mensajes de registro de depuración
se envÃan al flujo de salida de error estándar. Con esta
opción, se anula dicho comportamiento.
--sender=foo@ejemplo.com
--recipient=foo@ejemplo.com
Estas dos opciones se usan junto a --incoming y --is-list para
imponerse a las variables de entorno SENDER y RECIPIENT,
respectivamente.
--get Obtiene los valores de una o más variables de configuración. El
nombre de las variables se da en la lÃnea de órdenes tras las
opciones. Cada valor se imprime en una lÃnea aparte.
--set Establece los valores de una o más variables de configuración.
Los nombres y valores se dan en la lÃnea de órdenes tras las
opciones y separadas por signos ’igual’ ("="). Por ejemplo, lo
siguiente establecerÃa el finlandés como idioma de una lista:
enemies-of-carlotta --name=foo@bar --set language=fi
--version
Muestra la versión del programa.
--show-lists
Muestra las listas conocidas para enemies-of-carlotta.
CONFIGURACIÓN
Cada lista está representada por un directorio, que recibe el nombre de
la lista, y que está dentro de ~/.enemies-of-carlotta. Dicho
directorio contiene varios ficheros y directorios, que se describen más
abajo. En general, no es necesario tocarlos para nada. Sin embargo,
determinadas configuraciones, un tanto esotéricas, sólo pueden
establecerse editando a mano el fichero de configuración de la lista.
config El fichero de configuración de la lista. Su contenido se
describe más abajo.
subscribers
Base de datos de suscriptores. Cada lÃnea contiene un grupo de
suscriptores, siendo los cinco primeros campos delimitados por
espacios el identificador del grupo, el estado la marca temporal
de cuándo se creó el grupo, la marca temporal de cuándo cambió
su estado de ’ok’ a ’bounced’ (rebotado), y el identificador de
la devolución (bounce).
archive-box
Mensajes de la lista archivados.
bounce-box
Grupos de mensajes rebotados (bounce) y que no están en estado
’ok’.
headers-to-add
Cabeceras a añadir a los mensajes enviados a esta lista. Se
copian al principio de cualquier cabecera existente exactamente
tal como estén en el fichero, tras haber añadido las cabeceras
de la lista ("List-ID", etc) y eliminado las mencionadas en
headers-to-remove .
headers-to-remove
Estas cabeceras se eliminan de los mensajes enviados a la lista.
moderation-box
Mensajes en espera de aprobación por parte del moderador.
subscription-box
Solicitudes de suscripción y desuscripción en espera de
confirmación por parte del usuario.
templates
Directorio que contiene plantillas (opcionales) especÃficas a la
lista. Si existe este directorio, se buscan las plantillas allÃ
antes de ir en busca de plantillas globales. Un fichero vacÃo
indica que el mensaje correspondiente no será enviado. Esto
puede usarse, por ejemplo, para desactivar los mensajes «espere
por la moderación» en determinadas listas.
plugins
Directorio que contiene plugins. Son archivos fuente en Python
que carga EoC automáticamente al arrancar. Los plugins pueden
variar la manera en que opera EoC.
El fichero config tiene un formato palabra_clave=valor :
[list]
owners = liw@liw.iki.fi
archived = no
posting = free
subscription = free
mail-on-subscription-changes = yes
mail-on-forced-unsubscribe = yes
language = es
Las palabras clave archived, posting, y subscription corresponden a las
opciones de su mismo nombre. Otras palabras clave son:
owners Lista de las direcciones de los propietarios. EspecifÃquelas
con la opción --owner .
moderators
Lista de las direcciones de los moderadores. EspecifÃquelas con
la opción --moderator .
mail-on-subscription-changes
Especifica si hay que mandar un correo a los propietarios de la
lista cada vez que un usuario se suscribe o se desuscribe.
mail-on-forced-unsubscribe
Especifica si hay que mandar un correo a los propietarios de la
lista cada vez que un usuario es dado de baja por excesivo
rebote de mensajes.
ignore_bounce
Los rebotes son ignorados en esta lista. Útil por ejemplo si la
lista debe tener una lista fija de suscriptores.
language
Sufijo para las plantillas, para permitir el suporte de
múltiples lenguas. (Si language tiene el valor "es", entonces a
la plantilla llamada "aficionados" se la busca en primer lugar
como "aficionados.es".)
pristine-headers
No usar codificación MIME para las cabeceras. Establecer a "yes"
para no hacerlo, cualquier otra cosa (incluyendo vacÃo o sin
establecer) significa que se utilizará la codificación.
EJEMPLOS
Para crear una lista llamada cinefilos@ejemplo.com, cuyo propietario
sea dingo@ejemplo.com, utilice la siguiente orden (todo en una lÃnea):
enemies-of-carlotta --name=cinefilos@ejemplo.com
--owner=dingo@ejemplo.com --create
Observe que debe configurar su servidor de correo en concreto
para que el correo llegue a la lista.
Para qmail y postfix, véase infra.
To see the subscribers on that list:
enemies-of-carlotta --name=cinefilos@ejemplo.com --list
Quien quiera suscribirse a la lista ha de escribir un correo a:
cinefilos-subscribe@ejemplo.com
QMAIL
Con qmail, para conseguir que el correo entrante sea procesado por
Enemies of Carlotta, tiene que crear dos ficheros .qmail-extension por
cada lista. Por ejemplo, si su nombre de usuario es pepe y quiere
ejecutar la lista pepe-aficionados, ha de crear dos ficheros,
.qmail-aficionados y .qmail-aficionados-default, que contengan la lÃnea
|enemies-of-carlotta --incoming
Si tiene configurado un dominio virtual, ejemplo.com, y los correos se
entregan vÃa /var/qmail/control/virtualdomains a pepe-ejemplodotcom ,
los ficheros se llamarÃan .qmail-ejemplodotcom-aficionados y
.qmail-ejemplodotcom-aficionados-default y contendrÃan
|enemies-of-carlotta --incoming
--skip-prefix=pepe-ejemplodotcom-
(todo en una lÃnea, claro, por si acaso su lector de páginas de manual
formatea la orden anterior en varias lÃneas).
POSTFIX
Con postfix, ha de configurar un fichero .forward que contenga
"|procmail -p"
y además un fichero .procmailrc que contenga
:0
* ? enemies-of-carlotta --name=$RECIPIENT --is-list
| enemies-of-carlotta --incoming
Para usar Enemies of Carlotta con un dominio virtual de Postfix, ha de
configurar un mapa virtual de expresiones regulares , que tÃpicamente
está en /etc/postfix/virtual_regexp (añada virtual_maps =
regexp:/etc/postfix/virtual_regexp a su fichero /etc/postfix/main.cf
para activar esta carcterÃstica). El fichero de expresiones regulares
ha de hacer cosas extrañas para conservar la dirección del
destinatario. Añada lo siguiente al fichero de expresiones regulares:
/^su.dominio.virtual$/ dummy
/^(sulista|sulista-.*)@(su.dominio.virtual)$/ pepe+virtual-$1
(Lo anterior estaba en dos lÃneas). Utilize pepe-virtual en lugar del
anterior si el recipient_delimiter de su Postfix está configurado para
usar un signo menos en vez de más. Luego, en su fichero .procmailrc
añada la opción --skip-prefix=pepe-virtual- y también
--domain=your.virtual.domain para las dos llamadas a
enemies-of-carlotta.
(SÃ, nosotros también pensamos que estas configuraciones son demasiado
complicadas).
ÓRDENES PARA EL CORREO
Los usuarios y los propietarios de las listas utilizan Enemies of
Carlotta a través del correo electrónico, usando para ello direcciones
a modo de órdenes, como por ejemplo aficionados-subscribe@ejemplo.com.
He aquà una lista de todas las órdenes que pueden usar tanto usuarios
como propietarios de listas de correo. En todos estos ejemplos, el
nombre de la lista de correo es aficionados@ejemplo.com.
Órdenes a través de correo que pueden usar todos
Estas órdenes están pensadas para el uso general. No precisan de
ningún privilegio especial.
aficionados@ejemplo.com
Enviar correo a todos los suscritos a la lista. El mensaje
pueden haberlo aprobado previamente de forma manual los
administradores de la lista, que están facultados para rechazar
los mensajes.
aficionados-owner@ejemplo.com
Enviar un correo al propietario o propietarios de la lista.
aficionados-help@ejemplo.com
Enviar un correo a esta dirección hace que el gestor de listas
de correo nos devuelva un correo con la ayuda existente sobre la
lista en cuestión.
aficionados-subscribe@ejemplo.com
EnvÃe un mensaje a esta dirección para suscribirse a la lista.
El gestor de listas de correo le responderá con una confirmación
de suscripción. No se le suscribirá a la lista a menos que
responda a la petición de confirmación. De esta forma, un
usuario malicioso no podrá poner su dirección en una o en muchas
listas de correo.
aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
Esta es una manera alternativa de la dirección de suscripción.
Si desea suscribirse a la lista de correo con una dirección
distinta a aquella desde la que envÃa el mensaje, utilice esta
modalidad. En este caso, la dirección para suscribirse es
pepe@ejemplo.com. Nótese que la petición de confirmación se
envÃa a Pepe, puesto que es su dirección la que va a añadirse a
la lista.
aficionados-unsubscribe@ejemplo.com
Para desuscribirse de una lista, envÃe un correo a esta
dirección desde la dirección que desea desuscribir de la lista.
De nuevo recibirá una petición de confirmación, para evitar que
un usuario malicioso le desuscriba de una lista de correo contra
su voluntad.
aficionados-unsubscribe-pepe=ejemplo.com@ejemplo.com
Para desuscribir a Pepe, use esta dirección. De nuevo, es Pepe
quien recibirá la petición de confirmación.
Órdenes a través de correo que pueden usar los propietarios de las listas
Se trata de órdenes que pueden usar los propietarios de listas para
administrar su lista.
aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
Si un propietario de una lista envÃa un correo a la dirección
anterior, él recibirá la petición de confirmación, y no Pepe.
Generalmente es mejor que los usuarios se suscriban ellos
mismos, pero a veces los propietarios de listas pueden desear
esta caracterÃstica, cuando tienen permiso de la persona
afectada y quieren resultar más útiles.
aficionados-unsubscribe-pepe=ejemplo.com@ejemplo.com
Los propietarios de listas también pueden desuscribir a otros
usuarios.
aficionados-list@ejemplo.com
Para ver quién está en la lista, envÃe un correo a esta
dirección. Sólo funciona si la dirección del remitente del
correo coincide con un propietario de la lista. La dirección
"sender address" se usa a nivel del protocolo SMTP, y no es la
del encabezamiento "From:"
aficionados-setlist@ejemplo.com
Esta orden permite al propietario de una lista especificar de
una sola vez toda la lista de suscriptores. Es equivalente a
utilizar montones y montones de órdenes -subscribe y
-unsubscribe, sólo que menos tedioso. Todo el que resulte
añadido a la lista recibe un mensaje de bienvenida, y todo el
que quede eliminado de la lista recibe un mensaje de despedida.
aficionados-setlistsilently@ejemplo.com
Semejante a -setlist, pero no se envÃan mensajes ni de
bienvenida, ni de despedida.
PLUGINS
Enemies of Carlotta admite plugins. Si no sabe programar en Python,
probablemente se puede saltar esta sección.
Un plugin es un módulo de Python (fichero con un sufijo .py en el
nombre), situado en el directorio ~/.enemies-of-carlotta/plugins . Los
plugins se cargan automáticamente durante el arranque, si la versión
declarada de su interfaz se ajusta con la implementada por Enemies of
Carlotta. La versión de la interfaz se declara en la variable global
del módulo PLUGIN_INTERFACE_VERSION.
Los plugin pueden definir funciones que serán invocadas desde los
lugares apropiados del código EoC. Por el momento, la única función de
enganche (hook) disponible es send_mail_to_subscribers_hook, que puede
manipular un mensaje antes de que sea enviado a los suscriptores. La
función debe parecerse a esto:
def send_mail_to_subscribers_hook(list, text):
El argumento list es una referencia al objeto MailingList que
corresponde a la lista en cuestión, y text es el texto completo del
mensaje de correo en su forma actual. La función debe devolver el
nuevo contenido del mensaje de correo.
FICHEROS
~/.enemies-of-carlotta
Aquà están todos los ficheros relacionados con sus listas de
correo.
~/.enemies-of-carlotta/secret
Contraseña secreta que se usa para generar direcciones firmadas
para comprobación de rebotes de correo y verificación de
suscripción.
~/.enemies-of-carlotta/aficionados@ejemplo.com
Directorio que contiene los datos relativos a la lista
aficionados@ejemplo.com. Excepto el fichero config de este
directorio, no debe editar a mano nada de lo contenido en él.
~/.enemies-of-carlotta/aficionados@ejemplo.com/config
Fichero de configuración de la lista de correo. Quizá tenga que
editar este fichero a mano si desea cambiar el estado de
moderación de la lista o sus propietarios.
VÉASE TAMBIÉN
Visite la página de Enemies of Carlotta alojada en
http://www.iki.fi/liw/eoc/.
La traducción de esta página ha corrido a cargo de Iván Juanes
kerberos@gulic.org y de Ricardo Cárdenes heimy@gulic.org como
parte de los proyectos del grupo Gulic.
ENEMIES-OF-CARLOTTA(1)