Available in

(1) (1)/es (1)/fr

Contents

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 [AT] 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 [AT] ejemplo.com
−−recipient=
foo [AT] 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 [AT] liw.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 [AT] ejemplo.com, cuyo propietario sea dingo [AT] ejemplo.com, utilice la siguiente orden (todo en una línea):

enemies−of−carlotta −−name=cinefilos [AT] ejemplo.com
−−owner=dingo [AT] 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 [AT] ejemplo.com −−list

Quien quiera suscribirse a la lista ha de escribir un correo a:

cinefilos−subscribe [AT] 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 [AT] 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 [AT] 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 [AT] 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 [AT] ejemplo.com

Enviar un correo al propietario o propietarios de la lista.

aficionados−help [AT] 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 [AT] 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 [AT] 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 [AT] 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 [AT] 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 [AT] 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 [AT] 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 [AT] ejemplo.com

Los propietarios de listas también pueden desuscribir a otros usuarios.

aficionados−list [AT] 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 [AT] 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 [AT] 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 [AT] ejemplo.com

Directorio que contiene los datos relativos a la lista aficionados [AT] ejemplo.com. Excepto el fichero config de este directorio, no debe editar a mano nada de lo contenido en él.

~/.enemies−of−carlotta/aficionados [AT] 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 [AT] gulic.org y de Ricardo Cárdenes heimy [AT] gulic.org como parte de los proyectos del grupo Gulic.

COMMENTS

blog comments powered by Disqus