.\"if n .pl +(135i-\n(.pu)
.de Id
.ds Rv \\$3
.ds Dt \\$4
..
.Id $Id: makevpopdb.8,v 1.1 1998/05/10 12:57:40 srb Exp $
.TH MAKEVPOPDB 1 \*(Dt BuGless
.rn SH Sh
.de SH
.br
.ne 11
.Sh "\\$1"
..
.rn SS Ss
.de SS
.br
.ne 10
.Ss "\\$1"
..
.rn TP Tp
.de TP
.br
.ne 9
.Tp \\$1
..
.rn RS Rs
.de RS
.na
.nf
.Rs
..
.rn RE Re
.de RE
.Re
.fi
.ad
..
.de Sx
.PP
.ne \\$1
.RS
..
.de Ex
.RE
.PP
..
.na
.SH NAME
makevpopdb \- Creates the vpop database for cucipop
.SH SYNOPSIS
.B /usr/local/sbin/makevpopdb
.I dbasefile
.ad
.SH DESCRIPTION
Makevpopdb creates the vpop database which is used by
.BR cucipop (8)
to determine authenticate virtually hosted popusers using both the
.B PASS
and
.B APOP
authentication methods.
.PP
Makevpopdb reads from stdin and will create and overwrite the
databasefile specified as the first argument.  The expected dataformat
on stdin is:
.Sx 1
virtual.dom.ain/user      cleartextpassword
.Ex
The entries must be separated from each other by a single tab, no
other random whitespace is allowed.
.SH FILES
.TP 2.3i
.TP
.B /usr/local/etc/vpop.db
typical virtual host authentication database used by
.BR cucipop (8)
.SH "SEE ALSO"
.na
.nh
.BR cucipop (8)
.hy
.ad
.SH BUGS
The input file format is a bit strict, too strict perhaps.  But since it's
being generated by a program in most cases, who cares?
.SH NOTES
When creating the database, the regular umask will be paid attention to.
It is critically important to make sure that the generated database is
not readable by anyone unauthorised, since
the generated database contains cleartext passwords (albeit very crudely
two-way encrypted).
.PP
In order to ensure seamless transitions to a new database, it is
necessary to create the new database in a different file as the final
dbase file, then rename it after the database has been created and filled.
.SH SOURCE
This program is part of the cucipop distribution.
.\"is available at ftp.informatik.rwth-aachen.de as
.\".BR pub/packages/cucipop/cucipop.tar.gz .
.\".SH MAILINGLIST
.\".RE
.\"If you would like to stay informed about new versions and official patches
.\"send a subscription request to
.\".RS
.\"cucipop-announce-request@cuci.nl
.\".RE
.\"(this is a readonly list).
.SH AUTHOR
Stephen R. van den Berg, Cubic Circle, The Netherlands
.RS
<srb@cuci.nl>
.\" @MY_ALT_MAIL_ADDR@
.RE
.\".if n .pl -(\n(.tu-1i)