1cvm
2Credential Validation Modules
3Bruce Guenter <bruce@untroubled.org>
4Version 0.97
52015-01-31
6
7This package contains:
8- The reference source for the CVM interface.
9- Diagnostic and benchmark CVM clients.
10- A checkpassword interface CVM client.
11- A UNIX/POSIX system module (uses getpwnam).
12- A flat-file module.
13- A vmailmgr module.
14- MySQL, PgSQL, and SQLite modules.
15- A library for client writers.
16- A set of libraries for module writers.
17
18A mailing list has been set up to discuss this and other packages.
19To subscribe, send an email to:
20	bgware-subscribe@lists.untroubled.org
21A mailing list archive is available at:
22	http://lists.untroubled.org/?list=bgware
23
24Development versions of cvm are available at:
25	https://github.com/bruceg/cvm
26
27Requirements:
28
29- bglibs library package version 1.103 or later.
30- The vmailmgr modules should work with all versions of vmailmgr that
31  use CDB password tables, introduced in vmailmgr version 0.89 (only
32  tested with version 0.96.9)
33- libtool
34
35Installation:
36
37- Make sure the latest version of bglibs from
38  http://untroubled.org/bglibs/ is compiled and installed.
39- Build the sources by running "make"
40- After the package has been compiled, run the following commands as root:
41	make install
42  If you want to install in a different directory, run:
43	make install install_prefix=/prefix
44
45vmailmgr Configuration:
46
47- If your virtual domain password tables are stored in a file other than
48  passwd.cdb, set $VMAILMGR_PWFILE to that file name.
49
50- Set $QMAIL_ROOT to the base qmail directory (defaults to "/var/qmail").
51
52- Set $VMAILMGR_DEFAULT to the vmailmgr default username (defaults to "+").
53
54- Set $DEBUG (to anything) to see debugging output.
55
56- See http://untroubled.org/cvm/cvm.html for information on running
57  local or UDP server modules.
58
59Development of this version has been sponsored by FutureQuest, Inc.
60ossi@FutureQuest.net  http://www.FutureQuest.net/
61
62This program is Copyright(C) 2015 Bruce Guenter, and may be copied
63according to the GNU GENERAL PUBLIC LICENSE (GPL) Version 2 or a later
64version.  A copy of this license is included with this package.  This
65package comes with no warranty of any kind.
66
67The cvm-vmailmgr project was initiated at FutureQuest, Inc.  We are
68releasing it as an open-source project because we felt it would be
69useful to others, as well as to repay our debt of gratitude to the
70larger open-source community for the excellent packages we have enjoyed.
71
72For more details, you may contact FutureQuest, Inc. at:
73FutureQuest, Inc.
74PO BOX 623127
75Oviedo FL 32762-3127 USA
76http://www.FutureQuest.net/
77