Index Index for
Section 8
Index Alphabetical
listing for M
Bottom of page Bottom of
page		 

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

  -init
      Initialize the database. You must be superuser to use this option.

  -convert
      Convert an existing APOP only database to the new format.	 You must be
      superuser to use this option.

  [-list [-type POP | APOP | IMAP]
      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.

  [-user name [-type POP | APOP | IMAP]
      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.

  -delete name
      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
  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

  /etc/pop.auth.*
      POP authorization database


SEE ALSO

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

Index Index for
Section 8
Index Alphabetical
listing for M
Top of page Top of
page