POPAUTH(8)                                             POPAUTH(8)



NAME
       popauth -- manipulate POP authorization DB

SYNOPSIS
       popauth  [ -trace tracefile ] [ -debug ] [ -init [ -safe ]
       ]
               [ -list [ user | ALL ] ] [ -delete user ]
               [ -user user [ password ] ] [ -help ] [ -version ]


DESCRIPTION
       The  popauth  program  allows  POP  subscribers  to add or
       change the secret values used to generate their  authenti-
       cation  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.  popauth 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, popauth prompts for a new secret, just
       like the passwd program.  It then updates  the  authoriza-
       tion 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
       /etc/pop.auth.* POP authorization DB

ACKNOWLEDGEMENTS
       This program was derived from MH 6.8.3

SEE ALSO
       popper(8), poppassd(8)



                                                       POPAUTH(8)