FreeBSD manual
download PDF document: qpopauth.8.pdf
QPOPAUTH(8) FreeBSD System Manager's Manual QPOPAUTH(8)
NAME
qpopauth -- manipulate POP authorization DB
SYNOPSIS
qpopauth [ -trace tracefile ] [ -debug ] [ -init [ -safe ] ]
[ -list [ user | ALL ] ] [ -delete user ]
[ -user user [ password ] ] [ -help ] [ -version ]
DESCRIPTION
The qpopauth program allows POP subscribers to add or change the secret
values used to generate their authentication credentials, or to verify
the existance of their records.
In addition, the super-user or master POP user can add, delete, or
reset credential data for a user, or list which records exist. Only
the super-user may initialize the database. qpopauth is useful only
when the APOP (or SCRAM) configuration option is defined. See the
INSTALL file in the Qpopper distribution for more information.
Under normal usage, qpopauth prompts for a new secret, just like the
passwd program. It then updates the authorization DB.
With the -user 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 switch, the super-user can create a new (or zero the
existing) authorization DB.
With the -list 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 switch, the super-user or master POP user can remove a
user entry from the authorization DB.
FILES
/usr/local/etc/qpopper/pop.auth.* POP authorization DB
ACKNOWLEDGEMENTS
This program was derived from MH 6.8.3
SEE ALSO
qpopper(8)
QPOPAUTH(8)