Provided by:
enemies-of-carlotta_1.2.6-4_all 
NAME
enemies-of-carlotta - sencillo gestor de listas de correo
SYNOPSIS
enemies-of-carlotta [opciones] [direcciones]
DESCRIPCI'ON
enemies-of-carlotta es un gestor sencillo para listas de correo. Si no
sabe que 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 pagina de manual.
Enemies of Carlotta mantiene todos los datos sobre las listas de correo
en un directorio llamado ~/.enemies-of-carlotta . Se creara
automaticamente en cuanto usted cree la primera lista. Tendra que
hacer arreglos a mano para que el gestor de listas pueda procesar los
mensajes. Los detalles varian de un servidor de correo a otro. Para
qmail y Postfix, vease mas adelante.
Cada lista tiene uno o mas propietarios, que tambien moderan
suscripciones o incluso algunos o todos los envios a la lista. En
listas sin moderacion alguna, el propietario de la lista es el
responsable de contestar las dudas acerca de la lista. En listas con
moderacion completa, tienen que aprobar cada mensaje, antes de que este
pueda enviarse a la lista. En listas con la opcion posting=auto, los
mensajes de los suscriptores se envian automaticamente a la lista, y
los moderadores tienen que aprobar el resto de mensajes.
OPCIONES
--name=lista@ejemplo.com
Especifica sobre que lista ha de actuar la orden especificada.
Casi todas las restantes opciones precisan que especifique antes
el nombre de la lista con la opcion 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 opcion --owner.
--owner=direcci'on
Al crear una lista, especifica un propietario de la lista.
--language=c'odigo-idioma
Establece el codigo de idioma que se usa para buscar plantillas.
El codigo deberia estar vacio (opcion por defecto, es decir
ingles), o un codigo de dos letras como fi o es.
--cleaning-woman
Se encarga de las direcciones de rebote y hace otras limpiezas
varias. Ha de ejecutar periodicamente enemies-of-carlotta
--cleaning-woman , algo asi como una vez por hora. Efectuara
una limpieza de todas sus listas.
--destroy
Eliminar la lista.
--edit Modificar la configuracion de la lista.
--subscription=tipo
Al crear una lista, establece su modo de suscripcion a free
(libre) o bien moderated (moderado). Uselo con --edit, o con
--create.
--posting=tipo
Al crear una lista, establece su modo de envio de mensajes a
free (libre), auto (auto), o bien moderated (moderado). Uselo
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
cDeberia notificarse a los duenos 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
cDeberia notificarse a los duenos 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
Anade 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 anadan mediante este
procedimiento no recibiran una confirmacion de suscripcion, sino
que se las suscribira 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 recibiran una confirmacion de
desuscripcion, sino que se las eliminara directamente.
--incoming
Encargarse de un mensaje que se recibe por la entrada estandar.
La direccion del remitente del envoltorio SMTP (envelope sender
address) debe especificarse mediante la variable de entorno
SENDER , y la direccion del destinatario del envoltorio SMTP
(SMTP envelope recipient address) debe especificarse en la
variable de entorno RECIPIENT . (qmail y Postfix lo hacen
automaticamente).
--skip-prefix=cadena
Antes de analizar la direccion del destinatario para ver a que
lista se refiere, eliminar cadena de su comienzo. Esta
caracteristica ayuda en el caso de los dominios virtuales de
qmail y Postfix; vease mas arriba.
--domain=nombre.dominio
Antes de analizar la direccion del destinatario para ver a que
lista se refiere, sustituir la parte del dominio por
nombre.dominio. Esta caracteristica es util en el caso de los
dominios virtuales de Postfix.
--is-list
cSe refiere la lista especificada en la opcion --name a una
lista valida? Devuelve un estado de salida de cero (exito) si
es valida, o un estado de uno (fallo) si no es valida.
--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 linea de
ordenes. Notese que la orden alternativa debe seguir las
convenciones de la interfaz de linea de ordenes 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 retransmision de correo a traves
de el. Notese que la opcion por defecto es usar la interfaz de
linea de ordenes. Esta opcion de enviar por SMTP solo se
utilizara si la especifica explicitamente.
--qmqp-server=nombredemaquina
Enviar correo usando el servidor QMQP que hay en nombredemaquina
(puerto 628). El servidor debe estar configurado para permitir
que la maquina de la lista reenvie correo a traves suyo. Tenga
en cuenta que por defecto se usa una interfaz de linea de
ordenes para el envio; solo se utilizara QMQP si especifica esta
opcion.
--moderate
Forzar la moderacion de mensajes para un mensaje dado, incluso
si va a ir a parar a una lista de mensajes donde se puede enviar
libremente. Puede usar esta opcion para el filtrado de correo
electronico 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 moderacion del mensaje por
parte de una persona.
--post Forzar el envio de un mensaje entrante a una lista dada, incluso
si va a ir a parar a una lista que tenga el envio moderado.
Puede usar esta opcion cuando hay una comprobacion 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 depuracion
se envian al flujo de salida de error estandar. Con esta
opcion, 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 mas variables de configuracion. El
nombre de las variables se da en la linea de ordenes tras las
opciones. Cada valor se imprime en una linea aparte.
--set Establece los valores de una o mas variables de configuracion.
Los nombres y valores se dan en la linea de ordenes tras las
opciones y separadas por signos 'igual' ("="). Por ejemplo, lo
siguiente estableceria el finlandes como idioma de una lista:
enemies-of-carlotta --name=foo@bar --set language=fi
--version
Muestra la version del programa.
--show-lists
Muestra las listas conocidas para enemies-of-carlotta.
CONFIGURACI'ON
Cada lista esta representada por un directorio, que recibe el nombre de
la lista, y que esta dentro de ~/.enemies-of-carlotta. Dicho
directorio contiene varios ficheros y directorios, que se describen mas
abajo. En general, no es necesario tocarlos para nada. Sin embargo,
determinadas configuraciones, un tanto esotericas, solo pueden
establecerse editando a mano el fichero de configuracion de la lista.
config El fichero de configuracion de la lista. Su contenido se
describe mas abajo.
subscribers
Base de datos de suscriptores. Cada linea contiene un grupo de
suscriptores, siendo los cinco primeros campos delimitados por
espacios el identificador del grupo, el estado la marca temporal
de cuando se creo el grupo, la marca temporal de cuando cambio
su estado de 'ok' a 'bounced' (rebotado), y el identificador de
la devolucion (bounce).
archive-box
Mensajes de la lista archivados.
bounce-box
Grupos de mensajes rebotados (bounce) y que no estan en estado
'ok'.
headers-to-add
Cabeceras a anadir a los mensajes enviados a esta lista. Se
copian al principio de cualquier cabecera existente exactamente
tal como esten en el fichero, tras haber anadido 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 aprobacion por parte del moderador.
subscription-box
Solicitudes de suscripcion y desuscripcion en espera de
confirmacion por parte del usuario.
templates
Directorio que contiene plantillas (opcionales) especificas a la
lista. Si existe este directorio, se buscan las plantillas alli
antes de ir en busca de plantillas globales. Un fichero vacio
indica que el mensaje correspondiente no sera enviado. Esto
puede usarse, por ejemplo, para desactivar los mensajes <<espere
por la moderacion>> en determinadas listas.
plugins
Directorio que contiene plugins. Son archivos fuente en Python
que carga EoC automaticamente 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. Especifiquelas
con la opcion --owner .
moderators
Lista de las direcciones de los moderadores. Especifiquelas con
la opcion --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. Util por ejemplo si la
lista debe tener una lista fija de suscriptores.
language
Sufijo para las plantillas, para permitir el suporte de
multiples 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 codificacion MIME para las cabeceras. Establecer a "yes"
para no hacerlo, cualquier otra cosa (incluyendo vacio o sin
establecer) significa que se utilizara la codificacion.
EJEMPLOS
Para crear una lista llamada cinefilos@ejemplo.com, cuyo propietario
sea dingo@ejemplo.com, utilice la siguiente orden (todo en una linea):
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, vease 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 linea
|enemies-of-carlotta --incoming
Si tiene configurado un dominio virtual, ejemplo.com, y los correos se
entregan via /var/qmail/control/virtualdomains a pepe-ejemplodotcom ,
los ficheros se llamarian .qmail-ejemplodotcom-aficionados y
.qmail-ejemplodotcom-aficionados-default y contendrian
|enemies-of-carlotta --incoming
--skip-prefix=pepe-ejemplodotcom-
(todo en una linea, claro, por si acaso su lector de paginas de manual
formatea la orden anterior en varias lineas).
POSTFIX
Con postfix, ha de configurar un fichero .forward que contenga
"|procmail -p"
y ademas 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 tipicamente
esta en /etc/postfix/virtual_regexp (anada virtual_maps =
regexp:/etc/postfix/virtual_regexp a su fichero /etc/postfix/main.cf
para activar esta carcteristica). El fichero de expresiones regulares
ha de hacer cosas extranas para conservar la direccion del
destinatario. Anada lo siguiente al fichero de expresiones regulares:
/^su.dominio.virtual$/ dummy
/^(sulista|sulista-.*)@(su.dominio.virtual)$/ pepe+virtual-$1
(Lo anterior estaba en dos lineas). Utilize pepe-virtual en lugar del
anterior si el recipient_delimiter de su Postfix esta configurado para
usar un signo menos en vez de mas. Luego, en su fichero .procmailrc
anada la opcion --skip-prefix=pepe-virtual- y tambien
--domain=your.virtual.domain para las dos llamadas a
enemies-of-carlotta.
(Si, nosotros tambien pensamos que estas configuraciones son demasiado
complicadas).
'ORDENES PARA EL CORREO
Los usuarios y los propietarios de las listas utilizan Enemies of
Carlotta a traves del correo electronico, usando para ello direcciones
a modo de ordenes, como por ejemplo aficionados-subscribe@ejemplo.com.
He aqui una lista de todas las ordenes 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.
'Ordenes a trav'es de correo que pueden usar todos
Estas ordenes estan pensadas para el uso general. No precisan de
ningun 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 estan 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 direccion hace que el gestor de listas
de correo nos devuelva un correo con la ayuda existente sobre la
lista en cuestion.
aficionados-subscribe@ejemplo.com
Envie un mensaje a esta direccion para suscribirse a la lista.
El gestor de listas de correo le respondera con una confirmacion
de suscripcion. No se le suscribira a la lista a menos que
responda a la peticion de confirmacion. De esta forma, un
usuario malicioso no podra poner su direccion en una o en muchas
listas de correo.
aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
Esta es una manera alternativa de la direccion de suscripcion.
Si desea suscribirse a la lista de correo con una direccion
distinta a aquella desde la que envia el mensaje, utilice esta
modalidad. En este caso, la direccion para suscribirse es
pepe@ejemplo.com. Notese que la peticion de confirmacion se
envia a Pepe, puesto que es su direccion la que va a anadirse a
la lista.
aficionados-unsubscribe@ejemplo.com
Para desuscribirse de una lista, envie un correo a esta
direccion desde la direccion que desea desuscribir de la lista.
De nuevo recibira una peticion de confirmacion, 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 direccion. De nuevo, es Pepe
quien recibira la peticion de confirmacion.
'Ordenes a trav'es de correo que pueden usar los propietarios de las listas
Se trata de ordenes que pueden usar los propietarios de listas para
administrar su lista.
aficionados-subscribe-pepe=ejemplo.com@ejemplo.com
Si un propietario de una lista envia un correo a la direccion
anterior, el recibira la peticion de confirmacion, y no Pepe.
Generalmente es mejor que los usuarios se suscriban ellos
mismos, pero a veces los propietarios de listas pueden desear
esta caracteristica, cuando tienen permiso de la persona
afectada y quieren resultar mas utiles.
aficionados-unsubscribe-pepe=ejemplo.com@ejemplo.com
Los propietarios de listas tambien pueden desuscribir a otros
usuarios.
aficionados-list@ejemplo.com
Para ver quien esta en la lista, envie un correo a esta
direccion. Solo funciona si la direccion del remitente del
correo coincide con un propietario de la lista. La direccion
"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 ordenes -subscribe y
-unsubscribe, solo que menos tedioso. Todo el que resulte
anadido 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 envian mensajes ni de
bienvenida, ni de despedida.
PLUGINS
Enemies of Carlotta admite plugins. Si no sabe programar en Python,
probablemente se puede saltar esta seccion.
Un plugin es un modulo de Python (fichero con un sufijo .py en el
nombre), situado en el directorio ~/.enemies-of-carlotta/plugins . Los
plugins se cargan automaticamente durante el arranque, si la version
declarada de su interfaz se ajusta con la implementada por Enemies of
Carlotta. La version de la interfaz se declara en la variable global
del modulo PLUGIN_INTERFACE_VERSION.
Los plugin pueden definir funciones que seran invocadas desde los
lugares apropiados del codigo EoC. Por el momento, la unica funcion de
enganche (hook) disponible es send_mail_to_subscribers_hook, que puede
manipular un mensaje antes de que sea enviado a los suscriptores. La
funcion 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 cuestion, y text es el texto completo del
mensaje de correo en su forma actual. La funcion debe devolver el
nuevo contenido del mensaje de correo.
FICHEROS
~/.enemies-of-carlotta
Aqui estan todos los ficheros relacionados con sus listas de
correo.
~/.enemies-of-carlotta/secret
Contrasena secreta que se usa para generar direcciones firmadas
para comprobacion de rebotes de correo y verificacion de
suscripcion.
~/.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 el.
~/.enemies-of-carlotta/aficionados@ejemplo.com/config
Fichero de configuracion de la lista de correo. Quiza tenga que
editar este fichero a mano si desea cambiar el estado de
moderacion de la lista o sus propietarios.
V'EASE TAMBI'EN
Visite la pagina de Enemies of Carlotta alojada en
http://www.iki.fi/liw/eoc/.
La traduccion de esta pagina ha corrido a cargo de Ivan Juanes
kerberos@gulic.org y de Ricardo Cardenes heimy@gulic.org como
parte de los proyectos del grupo Gulic.
ENEMIES-OF-CARLOTTA(1)