NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

OPTIONS    [Toc]    [Back]

       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  system
       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    [Toc]    [Back]

       The mailauth program allows  a  POP,  IMAP,  or  APOP  (an
       alternate  authentication  method  for POP) user to change
       the secret value used  to  generate  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  transaction  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 Authorization 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    [Toc]    [Back]

       POP authorization database

SEE ALSO    [Toc]    [Back]

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



                                                      mailauth(8)