--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/vmailmgr.html Wed Jan 16 22:39:43 2008 +0100
@@ -0,0 +1,79 @@
+<HTML>
+<HEAD>
+<TITLE>vmailmgr - a package to manage virtual mailboxes and aliases</TITLE>
+<LINK REV="made" HREF="mailto:root@porky.devel.redhat.com">
+</HEAD>
+
+<BODY>
+
+<!-- INDEX BEGIN -->
+<!--
+
+<UL>
+
+ <LI><A HREF="#NAME">NAME</A>
+ <LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
+ <LI><A HREF="#SEE_ALSO">SEE ALSO</A>
+ <LI><A HREF="#AUTHOR">AUTHOR</A>
+ <LI><A HREF="#HISTORY">HISTORY</A>
+</UL>
+-->
+<!-- INDEX END -->
+
+<P>
+<H1><A NAME="NAME">NAME</A></H1>
+<P>
+vmailmgr - a package to manage virtual mailboxes and aliases
+
+<P>
+<HR>
+<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>
+<P>
+This document describes the vmailmgr package which contains, among other
+things, a virtualizing password checking interface for qmail-pop3d. It is
+intended as a drop-in replacement for the standard checkpassword utility
+with several significant enhancements.
+
+<P>
+One of the goals of building this package was to provide a usable virtual
+mail interface that was efficient and as fully integrated into qmail as
+possible. This means that this package attempts to use the same control
+files that qmail uses to determine if a user is logging in via a virtual
+host. It also implies that all programs should be compiled for two reasons:
+
+<OL>
+<LI>
+<P>
+Compiled code will be more efficient than code executed by an interpreter,
+such as perl or java
+
+<LI>
+<P>
+There is no need for an interpreter to reside on the system once the code
+is compiled, eliminating concerns that such an interpreter could be used as
+an exploit in itself.
+
+</OL>
+<P>
+<HR>
+<H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>
+<P>
+<CODE>checkvpw(8),</CODE> <CODE>vaddalias(1),</CODE>
+<CODE>vadduser(1),</CODE> <CODE>vdelalias(1),</CODE>
+<CODE>vdeliver(1),</CODE> <CODE>vdeluser(1),</CODE>
+<CODE>vmailmgrd(8),</CODE> <CODE>vpasswd(1),</CODE> <CODE>vsetup(1)</CODE>
+
+<P>
+<HR>
+<H1><A NAME="AUTHOR">AUTHOR</A></H1>
+<P>
+Bruce Guenter <<EM>bruceg@em.ca</EM>>.
+
+<P>
+<HR>
+<H1><A NAME="HISTORY">HISTORY</A></H1>
+<P>
+<STRONG>vmailmgr</STRONG> used to be called <STRONG>checkvpw</STRONG>, named for the original ``core'' of the package.
+</BODY>
+
+</HTML>