.TH VIRTUAL 8
.ad
.fi
.SH NOMBRE
virtual
\-
Agente de Entrega de Correo Postfix para Dominios Virtuales
.SH SINOPSIS
.na
.nf
\fBvirtual\fR [opciones genéricas del demonio Postfix]
.SH DESCRIPCIÓN
.ad
.fi
El agente de entrega de correo \fBvirtual\fR está diseñado para dar
cabida a servicios virtuales de alojamiento de correo. Basado
originalmente en el agente de entrega de correo local Postfix, este
agente busca destinatarios con concordancia de la dirección completa,
en lugar de utilizar el fichero \fBpassword\fR de UNIX para buscar
únicamente la parte local de la dirección.

Este agente de correo sólo entrega correo.  Otras características
como reenvío de correo, notificaciones "de-vacaciones", etc., deben
configurarse vía concordancias virtuales o vía mecanismos de
búsqueda similares.
.SH UBICACIÓN DEL BUZÓN
.na
.nf
.ad
.fi
La ubicación del buzón se controla mediante los parámetros de
configuración \fBvirtual_mailbox_base\fR y \fBvirtual_mailbox_maps\fR
(ver más abajo).
La tabla \fBvirtual_mailbox_maps\fR está ordenada por la dirección
completa del destinatario.

La ruta de acceso al buzón se construye de la siguiente forma:

.ti +2
\fB$virtual_mailbox_base/$virtual_mailbox_maps(\fIrecipient\fB)\fR

donde \fIrecipient\fR es la dirección completa del destinatario.
.SH  FORMATO DE BUZÓN UNIX
.na
.nf
.ad
.fi
Cuando la ubicación del buzón no termina con \fB/\fR, el mensaje
se entrega con el formato de buzón de UNIX. Este formato almacena
múltiples mensajes en un único fichero de texto.

El agente de entrega \fBvirtual\fR antepone una cabecera
"\fBFrom \fIsender time_stamp\fR" a cada mensaje, antepone un
(\fBDelivered-To:\fR) con la dirección del destinatario, antepone
un (\fBReturn-Path:\fR) con la dirección del remitente;
antepone un carácter \fB>\fR a las líneas que comienzan con
"\fBFrom \fR", y por último añade una línea en blanco al final
del mensaje.

El buzón permanece bloqueado con acceso exclusivo durante la entrega.
En caso de problemas, se intentará truncar el buzón a su longitud original.
.SH FORMATO MAILDIR DE QMAIL
.na
.nf
.ad
.fi
Cuando la ubicación del buzón termina en \fB/\fR, el mensaje se
entrega en formato \fBmaildir\fR de qmail. Este formato almacena
un mensaje por fichero.

El agente de entrega \fBvirtual\fR antepone una cabecera (\fBDelivered-To:\fR)
con la dirección del destinatario y antepone un (\fBReturn-Path:\fR)
con la dirección del remitente.

Por definición, el formato \fBmaildir\fR no requiere bloqueo de ficheros
ni al entregar correo, ni al recuperarlo.
.SH PROPIETARIO DEL BUZÓN
.na
.nf
.ad
.fi
El propietario del buzón se controla con las tablas \fBvirtual_uid_maps\fR
y \fBvirtual_gid_maps\fR, las cuales están ordenadas por la
dirección completa del destinatario. Cada tabla proporciona
una cadena con el identificador numérico de usuario (UID) y de grupo (GID),
respectivamente.

El parámetro \fBvirtual_minimum_uid\fR impone un límite inferior
al valor del ID numérico de usuario (UID) que puede especificarse
tanto en \fBvirtual_owner_maps\fR como en \fBvirtual_uid_maps\fR.
.SH SEGURIDAD
.na
.nf
.ad
.fi
El agente de entrega virtual no es sensible a la seguridad,
siempre y cuando las tablas donde se busca la información de los
identificadores de usuario (UID) y grupo (GID) de los destinatarios
estén protegidas adecuadamente. Este programa no está diseñado para
ejecutarse en modo \fBchroot\fR.
.SH ESTANDARES
.na
.nf
RFC 822 (ARPA Internet Text Messages)
.SH DIAGNÓSTICOS
.ad
.fi
El correo se devuelve cuando el destinatario no tiene buzón
o cuando el destinatario supera su cuota de disco. En el
resto de casos, el correo dirigido a un destinatario
existente es pospuesto y se registra (log) un aviso de advertencia
(warning).

Los problemas y las transacciones se registran a \fBsyslogd\fR(8).
Los ficheros de mensajes corruptos
se marcan de forma que el administrador de la cola
pueda moverlos a la cola \fBcorrupt\fR posteriormente.

Dependiendo de la configuración del parámetro \fBnotify_classes\fR,
el administrador del correo será notificado o no de devoluciones y
otros problemas.
.SH FALLOS CONOCIDOS
.ad
.fi
Este agente ignora silenciosamente las extensiones de las direcciones.

Postfix debería tener tablas de búsqueda capaces de devolver atributos
con múltiples resultados. Para evitar la necesidad de tener que mantener
tres tablas, utilice una base de datos LDAP o MYSQL.
.SH PARÁMETROS DE CONFIGURACIÓN
.na
.nf
.ad
.fi
Los siguientes parámetros del fichero \fBmain.cf\fR son especialmente
relevantes para este programa. Lea el fichero \fBmain.cf\fR de Postfix
para ver los detalles de modo de empleo y los valores predeterminados.
Utilice el comando \fBpostfix reload\fR tras realizar cualquier cambio
en la configuración.
.SH Entrega del Buzón
.ad
.fi
.IP \fBvirtual_mailbox_base\fR
Especifica una ruta que se antepondrá a la ruta de un buzón o de un \fBmaildir\fR.
Se trata de una medida de seguridad para asegurar que una concordancia fuera
de control en \fBvirtual_mailbox_maps\fR no ensucie el sistema de archivos
llenándolo de buzones.
Si bien puede configurarse como "/", no es recomendable.
.IP "\fBvirtual_mailbox_maps\fR  (no admite concordancia con expresiones regulares)"
Se buscan destinatarios bajo estas concordancias (maps) para
averiguar la ruta de acceso a sus buzones o  \fBmaildir\fR.
Si la ruta encontrada termina con una barra ("/"), se llevará
a cabo una retrega de tipo \fBmaildir\fR, en caso contrario
se asume que la ruta especifica un buzón de tipo UNIX.

Observe que a esta ruta se antepone \fBvirtual_mailbox_base\fR de
forma incondicional.
.IP \fBvirtual_minimum_uid\fR
Especifica el UID mínimo admisible como resultado de una búsqueda
en \fBvirtual_owner_maps\fR o en \fBvirtual_uid_maps\fR.
Los resultados con valores menores que el indicado serán rechazados,
y el mensaje será pospuesto.
.IP "\fBvirtual_uid_maps\fR (no admite concordancia con expresiones regulares)"
Se buscan destinatarios bajo estas concordancias (maps) para determinar el ID
de usuario (UID) a utilizar cuando se escribe en el buzón de destino.
.IP "\fBvirtual_gid_maps\fR (no admite concordancia con expresiones regulares)"
Se buscarán destinatarios en estas concordancias (maps) para determinar el ID
de grupo (GID) a utilizar cuando se escribe en el buzón de destino.
.SH "Controles de Bloqueo"
.ad
.fi
.IP \fBvirtual_mailbox_lock\fR
Indica el tipo de bloqueo a aplicar a los buzones de tipo UNIX:
\fBflock\fR, \fBfcntl\fR, \fBdotlock\fR o cualquier combinación de estos.
El método \fBdotlock\fR requiere que el UID o GID del destinatario
tenga permiso de escritura sobre el directorio padre donde se ubica
el fichero buzón.

Este parámetro se ignora en la entrega estilo \fBmaildir\fR,
debido a que este tipo de entrega resulta seguro sin necesidad
de bloqueos explícitos.

Utilice el comando \fBpostconf -l\fR para averiguar los métodos
de bloqueo disponibles en su sistema.
.IP \fBdeliver_lock_attempts\fR
Limita el número de intentos para lograr un bloqueo exclusivo sobre
un buzón de tipo UNIX.
.IP \fBdeliver_lock_delay\fR
Espacio de tiempo (predeterminado: segundos) entre sucesivos
intentos de adquirir bloqueo exclusivo sobre un buzón
de tipo UNIX. El retardo real es ligeramente aleatorio.
.IP \fBstale_lock_time\fR
Limita el tiempo después del cual se elimina un fichero
de bloqueo estropeado (aplicable solamente a buzones de
correo de tipo UNIX).
.SH "Controles de Recursos"
.ad
.fi
.IP \fBvirtual_destination_concurrency_limit\fR
Limita el número de entregas paralelas al mismo dominio
a través del agente de entrega \fBvirtual\fR.
El límite predeterminado se toma del parámetro
\fBdefault_destination_concurrency_limit\fR.
El límite lo fuerza el administrador de cola de Postfix.
.IP \fBvirtual_destination_recipient_limit\fR
Limita el número de destinatarios por entrega de mensaje
a través del agente de entrega \fBvirtual\fR.
El límite predeterminado se toma del parámetro
\fBdefault_destination_recipient_limit\fR.
El límite lo fuerza el administrador de cola de Postfix.
.IP \fBvirtual_mailbox_limit\fR
El tamaño máximo en bytes de un fichero mailbox o maildir.
Poner a cero para desabilitar el límite.
.SH HISTORIA
.na
.nf
.ad
.fi
Este agente de correo se basó originalmente en el agente
de entrega local Postfix. Las modificaciones consistieron
principalmente en eliminar código que o bien no era aplicable
o bien no era seguro en este contexto: aliases,
ficheros ~user/.forward, entrega a "|comando" o a /fichero/nombre.

La cabecera \fBDelivered-To:\fR aparece en el sistema \fBqmail\fR
de Daniel Bernstein.

La estructura \fBmaildir\fR aparece en el sistema \fBqmail\fR
de Daniel Bernstein.
.SH VER TAMBIEN
.na
.nf
bounce(8) informes de correo devuelto
syslogd(8) registro (log) del sistema
qmgr(8) administrador de la cola
.SH LICENCIA
.na
.nf
.ad
.fi
La licencia "Secure Mailer" debe distribuirse junto con este software.
.SH AUTOR(ES)
.na
.nf
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA

Andrew McNamara
andrewm@connect.com.au
connect.com.au Pty. Ltd.
Level 3, 213 Miller St
North Sydney 2060, NSW, Australia