mailauth(8)						      System Manager's Manual						       mailauth(8)

NAME

       mailauth  -  manipulate	alternate authorization database for Post Office Protocol (POP), Internet Message Access Protocol (IMAP), and APOP
       users.

SYNOPSIS

       /usr/sbin/mailauth [-init] [-convert] [-list [-type POP | APOP | IMAP]] [-delete name] [-user name [-type POP | APOP | IMAP]]

OPTIONS

       Initialize the database. You must be superuser to use this option.  Convert an existing APOP only database to the new format.  You must	be
       superuser to use this option.  Used to list the entries in the mailauth database. If no type is specified, all entries in the database will
       be displayed.  The display will consist of one column corresponding to the username and another column for the type of user. If a  type	is
       specified using the -type option, only entries for the corresponding type of user (POP, APOP, or IMAP) will be displayed.  Used by the sys-
       tem administrator to either add a user to the mailauth database, to change the password for the user, or to change the type  of	user.  The
       administrator  will  be	prompted for a new password and then a verification of the password. If the type is not explicitly specified and a
       previous entry does not exist, then it will default to APOP.  Used to delete the entry corresponding to name from the mailauth database.

DESCRIPTION

       The mailauth program allows a POP, IMAP, or APOP (an alternate authentication method for POP) user to change the secret value used to  gen-
       erate  their  authentication  credentials.  In addition, both the superuser and the user pop may use this program to either add or remove a
       user, or to print public information from it.  Only the superuser may initialize or convert the database.

       A user can change their own passwords or add themselves to the mailauth database by entering the mailauth command.   If	an  entry  already
       exists, the user is first prompted to enter the old password.  If the password does not correspond with the one in the database, the trans-
       action will be ended. Otherwise, the user will be prompted for a new password and a verification of the password. The user is  not  allowed
       to  change  the	type of user they are. For example, they cannot change themselves from a user using the APOP command during the POP Autho-
       rization State to a user using the Internet Message Access Protocol (IMAP).  If an entry does not already exist in the database,  the  user
       will be added as an APOP user.

       Under  normal  usage,  mailauth	prompts  for  a  new secret, just like the passwd program.  It then updates the POP authorization database
       accordingly.

FILES

       POP authorization database

SEE ALSO

       Command: imapd(8), mailusradm(8), pop3d(8)

																       mailauth(8)