home | help 
NAME
     dtcpauth -- Manipulate POP Authorization DB

SYNOPSIS
     dtcpauth [-i] [--init]
     dtcpauth [-d] [--delete] user
     dtcpauth [-l] [--list] user | ALL
     dtcpauth [-u] [--user] user [password]

DESCRIPTION
     The  dtcpauth  allows  the super-user or master POP user to add, delete, or
     reset credential data for a user, or list which records  exist.   Only  the
     super-user may initialize the database.

     Under normal usage, dtcpauth prompts for a new secret, just like the passwd
     program.  It then updates the authorization DB.

     With  the --user or -u switch, the super-user or master POP user can create
     or reset credential data for the specified user.  This  switch  allows  the
     password  to  be  specified  on  the  command  line, which avoids the usual
     prompts and checks.  This is mostly useful in a batch environment, such  as
     in a script.

     With  the --init or -i switch, the super-user can create a new (or zero the
     existing) authorization DB.

     With the --list or -l switch, the super-user or master POP user can  verify
     the  presence  of	a  record for the indicated user, or list users who have
     records.  Users can verify the presence of  their	own  records  with  this
     switch.

     With  the	--delete or -d switch, the super-user or master POP user can re-
     move a user entry from the authorization DB.

RETURN VALUES
     dtcpauth will exit with positive value on errors.

FILES
     /usr/local/etc/qpopper/pop.auth
	       The APOP authorization database.

SEE ALSO
     dtcps(8), qpopauth(8)

HISTORY
     The dtcpauth command was written by Hajimu UMEMOTO <ume@mahoroba.org>.

BUGS
     dtcpauth was written in Ruby. :-)

				  Nov 28, 2002			     DTCPAUTH(8)
home | help