1
2cvm-vchkpw for authentication using vpopmail from
3http://www.inter7.com/vpopmail.html
4
5vpopmail is a virtual domain manager for qmail. Using this cvm you can
6authenticate against the user-data managed by vpopmail.
7
8
9CHANGES TO conf-cc AND conf-ld
10
11   cvm-vchkpw is linked against libvpopmail.a which is installed in
12   $vpopmailhome/lib/. Thus you need to add "-I$vpopmailhome/include" to
13   conf-cc and "-L$vpopmailhome/lib" to conf-ld.
14
15   If your vpopmail installation has mysql-support, you also have to add
16   "-L/usr/local/lib/mysql -R/usr/local/lib/mysql" to conf-ld.
17
18COMPILATION AND INSTALLATION
19
20   cvm-vchkpw has to be compiled as root because libvpopmail.a is only
21   readable by root as it contains the login-data for the user-database.
22
23   cvm-vchkpw should also be installed with restricted permissions:
24
25     -rwxr-x--- 1 root vchkpw 117455 Dec 14 13:30 cvm-vchkpw
26
27   where vchkpw is the group of the vpopmail-user.
28
29USAGE EXAMPLE
30
31runfile for daemontools:
32
33  exec softlimit -m 2000000 setuidgid vpopmail \
34     /usr/local/bin/cvm-vchkpw \
35     cvm-local:/service/cvm-vchkpw/socket
36
37
38